Documentation

Installer le snippet

Ajoutez le script asynchrone sur chaque page, idéalement dans le head. Il charge la configuration signée de votre identifiant de tracking, respecte le consentement et ne bloque jamais le rendu. Remplacez TRACKING_ID par l’identifiant à six caractères de votre tableau de bord.

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

Envoyer des événements navigateur

Les événements standard (page_view, view_item, add_to_cart, begin_checkout, purchase, generate_lead, sign_up, subscribe, start_trial, contact, book_appointment, download, search, login) portent des paramètres validés ; les événements personnalisés utilisent des noms en snake_case minuscule.

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" }]); // haché côté client avant le transport

API serveur et conversions hors ligne

Créez une clé de source dans Paramètres → Clés de source serveur et envoyez des événements depuis votre backend, votre CRM ou votre caisse. Fournissez le même identifiant de commande que l’événement navigateur pour la déduplication ; ajoutez props.offline pour les conversions hors ligne.

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"}}]}'

Intégration du consentement

Utilisez une CMP prise en charge (TCF 2.2, GPP/GPC, Cookiebot, OneTrust, Usercentrics) — le tracker la lit automatiquement — ou appelez l’API de consentement depuis votre propre bandeau. Finalités : necessary, analytics, marketing, personalization. Un retrait arrête tout immédiatement.

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

Destinations

Chaque destination dispose d’un assistant guidé : identifiants, identifiants d’accès dans le coffre-fort ou OAuth, validation par le fournisseur, mapping des événements avec des valeurs par défaut vérifiées, un véritable événement de test, lint, diff et publication soumise à approbation. Navigateur et serveur partagent un même identifiant d’événement ; les achats ajoutent l’identifiant de commande.

• 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, postbacks d’affiliation (13 presets), webhooks

Plateformes e-commerce

Shopify (application avec webhooks de commande et web pixel), WooCommerce (plugin avec webhooks de commande signés) et Shopware 6 (application avec script de boutique et webhooks de commande) envoient des événements d’achat et de remboursement vérifiés, avec identifiants de commande. Installez le plugin, collez l’identifiant de tracking et la clé de source, c’est terminé.

• Source vérifiée : les événements sont marqués source_verified et utilisés comme conversion de référence
• Les remboursements créent des événements à valeur négative pour les fournisseurs qui les prennent en charge
• Les achats navigateur issus du thème sont dédupliqués par identifiant de commande

Centre de confidentialité et demandes d’exercice des droits

Les durées de conservation par type de données, les versions de politique de consentement par site et les demandes des personnes concernées (export, suppression, limitation, rectification, opposition, portabilité) sont gérées dans Consentement et confidentialité. Les demandes utilisent uniquement des identifiants hachés et produisent un rapport audité.