Documentazione

Installa lo snippet

Aggiungi lo script asincrono a ogni pagina, idealmente nell’head. Carica la configurazione firmata per il tuo tracking ID, rispetta il consenso e non blocca mai il rendering. Sostituisci TRACKING_ID con l’ID di sei caratteri della tua dashboard.

<script async src="https://cdn.track.site/v1/tracker.js" data-site-id="TRACKING_ID"></script>

Invia eventi browser

Gli eventi standard (page_view, view_item, add_to_cart, begin_checkout, purchase, generate_lead, sign_up, subscribe, start_trial, contact, book_appointment, download, search, login) trasportano parametri validati; gli eventi personalizzati usano nomi in snake_case minuscolo.

window.tsq = window.tsq || [];
tsq.push(["track", "purchase", { order_id: "A1001", currency: "EUR", value: 129.9, items: [{ item_id: "SKU-1", price: 99.9, quantity: 1 }] }]);
tsq.push(["identify", { user_id: "u_42", email: "customer@example.com" }]); // hash calcolato lato client prima dell'invio

API server e conversioni offline

Crea una source key in Impostazioni → Source key server e invia eventi dal tuo backend, CRM o POS. Fornisci lo stesso ID ordine dell’evento browser per la deduplicazione; aggiungi props.offline per le conversioni offline.

curl -X POST https://api.track.site/v1/s \
  -H "Authorization: Bearer tsk_..." -H "Content-Type: application/json" \
  -d '{"events":[{"name":"purchase","ts":1767225600000,"props":{"offline":true},"commerce":{"order_id":"A1001","currency":"EUR","value":129.9},"user_data":{"email":"customer@example.com"},"click_ids":{"gclid":"Cj0K..."},"consent":{"granted":["necessary","marketing"],"source":"crm"}}]}'

Integrazione del consenso

Usa una CMP supportata (TCF 2.2, GPP/GPC, Cookiebot, OneTrust, Usercentrics), che il tracker legge automaticamente, oppure chiama l’API di consenso dal tuo banner. Finalità: necessary, analytics, marketing, personalization. La revoca ferma tutto immediatamente.

tsq.push(["consent", { granted: ["necessary", "analytics", "marketing"], source: "api", policy_version: "2026-09" }]);

Destinazioni

Ogni destinazione ha una procedura guidata: identificatori, credenziali nel vault o OAuth, validazione del vendor, mappatura degli eventi con valori predefiniti verificati, un evento di test reale, lint, diff e pubblicazione soggetta ad approvazione. Browser e server condividono un unico ID evento; gli acquisti aggiungono l’ID ordine.

• Meta, Google Ads/YouTube, GA4, TikTok, Microsoft, LinkedIn, Reddit, Pinterest, Snapchat
• X, Taboola, Outbrain, Amazon Ads, Spotify, Quora
• Yahoo DSP, The Trade Desk, Google Marketing Platform, AdRoll, Criteo, postback di affiliazione (13 preset), webhook

Piattaforme e-commerce

Shopify (app con webhook degli ordini e web pixel), WooCommerce (plugin con webhook degli ordini firmati) e Shopware 6 (app con script storefront e webhook degli ordini) inviano eventi di acquisto e rimborso verificati con ID ordine. Installa il plugin, incolla tracking ID e chiave sorgente, fatto.

• Sorgente verificata: gli eventi vengono contrassegnati come source_verified e usati come conversione autorevole
• I rimborsi creano eventi con valore negativo per i fornitori che li supportano
• Gli acquisti browser dal tema vengono deduplicati tramite l’ID ordine

Centro privacy e DSAR

Periodi di conservazione per tipo di dato, versioni della policy di consenso per sito e richieste degli interessati (esportazione, cancellazione, limitazione, rettifica, opposizione, portabilità) vengono gestiti in Consenso e privacy. Le richieste usano solo identificativi con hash e producono un report tracciato.