Ce guide explique comment mettre en place le Smart Pixel d'ActiveTrail (Track3) sur votre site. Le pixel suit tout le parcours client : la consultation des produits et des catégories, la gestion du panier et la commande finale. Il suit aussi les inscriptions et les connexions, les prospects et les opportunités B2B, et tout événement personnalisé que vous définissez.
Les données qu'il recueille alimentent vos automations marketing, votre segmentation et l'analyse de vos ventes en temps réel.
Chaque événement ci-dessous comporte un tableau récapitulatif, un exemple de code pour votre développeur (le même code fonctionne dans une balise Custom HTML de Google Tag Manager), et des remarques à l'intention du responsable marketing.
Créer votre pixel
- Allez dans Intégrations → Smart Pixel.
- Cliquez sur Add New Pixel.
- Saisissez le Site Name (MYSTORE, par exemple) et la Domain URL, l'adresse de votre site (https://www.mystore.com, par exemple).
- Vous obtenez le code de votre pixel. Ajoutez-le à chaque page que vous souhaitez suivre, juste avant la balise fermante
</head>.
Pour en savoir plus sur la création d'un pixel, voir Produire un Smart Pixel.
Le code de base (initialisation)
Avant qu'un événement puisse être envoyé, le code de base doit être chargé une fois sur la page. Il définit l'identifiant de votre site et l'adresse à laquelle les données sont transmises, et charge la bibliothèque qui écoute les événements. Votre code de pixel ressemble à ceci, avec votre propre identifiant de site à la place de YOUR-SITE-ID :
<script type='text/javascript'>var _atsc_paq = _atsc_paq || [];
(function () {_atsc_paq.push(['setCookieDomain', 'atsc.activetrail.com']);
_atsc_paq.push(['setSiteId', 'YOUR-SITE-ID']); // your site ID
_atsc_paq.push(['setUserId', '_atscid']); // always exactly this
_atsc_paq.push(['setTrackerUrl', '//atsc.activetrail.com/api/Track3']);
_atsc_paq.push(['trackPageView']);
var atsc_d = document, atsc_g = atsc_d.createElement('script'), atsc_s = atsc_d.getElementsByTagName('script')[0]; atsc_g.type = 'text/javascript'; atsc_g.async = true; atsc_g.defer = true; atsc_g.src = '//atsc.activetrail.com/Scripts/atsc3.min.js'; atsc_s.parentNode.insertBefore(atsc_g, atsc_s);})();</script>
C'est la première étape : si le code de base ne se charge pas, aucun autre événement n'est envoyé. Il se charge de façon asynchrone et ne ralentit donc pas votre site.
Une règle absolue : laissez toujours setUserId('_atscid') exactement tel quel, partout où il apparaît. Ne le remplacez jamais par un identifiant d'utilisateur, que le visiteur soit connecté ou non.
Les événements en un coup d'œil
| Événement | TypeId | Ce qu'il suit | Commande |
|---|---|---|---|
| PageView | 4 | La vue d'une page (envoyée par le code de base) | trackPageView
|
| ViewTime | 7 | Le temps passé sur la page (désactivé jusqu'à ce que vous l'activiez) | setViewTimeListener
|
| Register | 8 | Inscription ou connexion : identifie le visiteur comme contact | logRegisterUser
|
| Logout | 9 | La déconnexion | logOut
|
| Click | 12 | Un clic sur un lien externe ou un téléchargement de fichier | addListener, trackLink
|
| ProductPageView | 10 | La vue d'une page produit | setEcommerceView
|
| CategoryPageView | 11 | La vue d'une page catégorie | setEcommerceView
|
| Cart | 6 | La mise à jour du panier | trackEcommerceCartUpdate
|
| Order | 5 | Une commande finalisée | trackEcommerceOrder
|
| Lead | 13 | Un prospect dans un processus de vente (visiteurs identifiés uniquement) | trackLead
|
| Opportunity | 14 | Une opportunité commerciale (visiteurs identifiés uniquement) | trackOpportunity
|
| Action | 3 | N'importe quel événement personnalisé | trackEvent
|
PageView : la vue d'une page (TypeId 4)
L'événement le plus simple. Le code de base l'envoie automatiquement à chaque chargement de page, avec l'adresse de la page et la page d'origine. Vous n'avez pas à l'ajouter vous-même, sauf sur les sites monopages (voir Les sites monopages).
| Quand il est envoyé | Automatiquement, à chaque chargement de page (quand trackPageView s'exécute). |
|---|---|
| Paramètres obligatoires | Aucun. L'adresse et la page d'origine sont relevées automatiquement. |
| Paramètres facultatifs | Un titre de page personnalisé, les paramètres UTM (utm_source, utm_medium, etc.) et un objet de données (par exemple pageType, category). |
| Déclencheur dans Google Tag Manager | Aucun : il fait partie du code de base, exécuté sur chaque page. Sur un site monopage, relancez-le à chaque changement de route. |
Pour le responsable marketing : cet événement alimente toutes les données de visite et de source de trafic (UTM). Vérifiez avec vos développeurs qu'il se déclenche sur chaque page.
_atsc_paq.push(['trackPageView']);
// With a custom title
_atsc_paq.push(['trackPageView', 'Custom title']);
// With additional information
_atsc_paq.push(['trackPageView', 'Custom title', {
pageType: 'article',
category: 'Technology'
}]);
ViewTime : le temps passé sur la page (TypeId 7)
Mesure combien de temps un visiteur est resté sur la page. Il est envoyé automatiquement quand le visiteur quitte la page (il ferme l'onglet, passe à un autre onglet ou quitte le site), mais seulement si vous avez activé la fonctionnalité au préalable.
| Quand il est envoyé | Automatiquement, quand le visiteur quitte la page ou l'onglet, uniquement si setViewTimeListener(true) a été appelé auparavant. La fonctionnalité est désactivée par défaut. |
|---|---|
| Paramètres obligatoires | Aucun. Le temps est calculé entre le premier chargement de la page et le départ du visiteur. |
| Paramètres facultatifs | Aucun. |
| Déclencheur dans Google Tag Manager | Aucun déclencheur manuel : c'est un écouteur que vous activez une fois. |
Désactivé par défaut : sans appel à setViewTimeListener(true), aucune donnée de temps passé n'est transmise.
Pour le responsable marketing : sur un site monopage (une application web sans rechargement), le temps mesuré est le temps total passé sur le site, et non le temps passé sur chaque page. S'il vous faut le temps par écran, demandez à vos développeurs une mise en place adaptée (voir Les sites monopages).
_atsc_paq.push(['setViewTimeListener', true]); // turn it on once
_atsc_paq.push(['trackPageView']); // ViewTime is sent automatically when the visitor leaves
Register : inscription et connexion (TypeId 8)
Marque qu'un visiteur s'est inscrit sur votre site ou s'y est connecté, et rattache le visiteur anonyme à un contact ActiveTrail, nouveau ou existant. Sans cet événement, les actions suivantes (un panier, un prospect, une opportunité) ne peuvent pas être rattachées à un contact identifié.
| Quand il est envoyé | À la validation d'une nouvelle inscription sur le site, et à chaque connexion réussie, pour qu'ActiveTrail reconnaisse le visiteur. |
|---|---|
| Paramètres obligatoires | externalId (l'identifiant externe) et externalName (le nom externe), si votre compte utilise l'External ID ; et au moins l'un des deux, email ou mobile. |
| Paramètres facultatifs | Prénom, nom, adresse, téléphone, date de naissance, subscriptionStatus (l'accord de la personne pour recevoir vos envois : true par défaut, false si elle n'en veut pas) et champs personnalisés. |
| Déclencheur dans Google Tag Manager | « Formulaire envoyé avec succès » (inscription) et « connexion réussie », en général après la réponse positive du serveur. |
Envoyez Register à l'inscription et à chaque connexion. L'envoyer une seule fois, à l'inscription, ne suffit pas.
Pour le responsable marketing : c'est l'événement déterminant pour le marketing. C'est lui qui identifie les personnes dans la durée, construit leur historique d'achat et vous permet de leur envoyer le bon message. Soignez particulièrement subscriptionStatus, qui enregistre l'accord de la personne pour recevoir vos messages marketing.
// logRegisterUser(externalId, externalName, email, mobile, customData)
_atsc_paq.push(['logRegisterUser',
'12345678-1234-1234-1234-123456789012', // externalId
'987654321', // externalName
'user@example.com', // email
'+972500000000', // mobile
{
firstName: 'Israel',
lastName: 'Israeli',
subscriptionStatus: true // false = doesn't agree to receive mailings
}
]);
Logout : la déconnexion (TypeId 9)
Efface l'identification du visiteur du cookie du navigateur : ses actions suivantes redeviennent anonymes, jusqu'à ce qu'il se connecte ou s'inscrive.
| Quand il est envoyé | Chaque fois que le visiteur se déconnecte de son compte. |
|---|---|
| Paramètres obligatoires | Aucun. |
| Paramètres facultatifs | Aucun. |
| Déclencheur dans Google Tag Manager | Un clic sur le bouton Déconnexion ou Se déconnecter. |
Pour le responsable marketing : veillez à ce que l'événement parte avant que le site ne déconnecte réellement le visiteur (avant une redirection vers la page d'accueil, par exemple). Sinon, il risque de ne pas avoir le temps d'être envoyé.
_atsc_paq.push(['logOut']);
Click : lien externe ou téléchargement (TypeId 12)
Suit les clics sur les liens qui mènent vers un autre site, et les téléchargements de fichiers (PDF, documents, etc.). Vous pouvez suivre tout le site automatiquement, ou seulement une zone précise de la page.
| Quand il est envoyé | Au clic sur un lien externe ou sur un lien de téléchargement. |
|---|---|
| Paramètres obligatoires | L'un des deux : download (l'adresse du fichier) ou link (l'adresse du lien externe). |
| Paramètres facultatifs | Un objet de données apportant d'autres informations sur le lien. |
| Déclencheur dans Google Tag Manager | Recommandé : le suivi automatique (addListener) sur toute la page, pour ne pas avoir à baliser chaque lien. Pour ne suivre qu'une zone (le menu principal, par exemple), rattachez le suivi à cet élément. |
Pour le responsable marketing : utile pour mesurer les sorties vers les réseaux sociaux et les partenaires (affiliés), ainsi que les téléchargements de catalogues et de fiches techniques : de bons indices de ce qui intéresse vos visiteurs.
// Automatic tracking of all links on the page (recommended, one-time code)
_atsc_paq.push(['addListener', document]);
// Or: manual tracking of a specific link
document.getElementById('externalLink').addEventListener('click', function () {
_atsc_paq.push(['trackLink', this.href, 'link']);
});
ProductPageView : la vue d'une page produit (TypeId 10)
Désigne la page en cours comme une page produit de votre boutique. Elle est reconnue automatiquement quand une catégorie et un identifiant de produit sont transmis avec la vue de page.
| Quand il est envoyé | À chaque chargement d'une page produit. setEcommerceView doit être appelé avant trackPageView, jamais après. |
|---|---|
| Paramètres obligatoires | L'identifiant du produit et la catégorie. |
| Paramètres facultatifs | Le SKU, le prix, la devise, et d'autres informations comme la marque, la couleur ou la taille. |
| Déclencheur dans Google Tag Manager | Sur chaque page produit, transmettez d'abord les données du produit, et seulement ensuite la vue de page. L'idéal est que vos développeurs prennent ces données (identifiant, catégorie, prix) dans la couche de données de la page. |
L'erreur la plus courante : appeler trackPageView avant setEcommerceView. Le bon ordre est toujours setEcommerceView d'abord, puis trackPageView.
Pour le responsable marketing : cet événement vous permet d'analyser quels produits sont consultés, de faire du reciblage dynamique et de voir ce qui intéresse vos visiteurs. C'est aussi la base des automations de navigation abandonnée.
// setEcommerceView(sku, productId, category, price)
// Step 1: set the product data, before trackPageView
_atsc_paq.push(['setEcommerceView',
'SKU-001', // SKU (optional)
'PROD-001', // product ID (required): the ID, not the product name
'Electronics', // category (required)
99.99 // price (optional, a number)
]);
_atsc_paq.push(['setCustomData', { currency: 'USD' }]);
// Step 2: only now send the page view
_atsc_paq.push(['trackPageView']);
CategoryPageView : la vue d'une page catégorie (TypeId 11)
Désigne la page en cours comme une page catégorie ou un catalogue de produits, et non comme un produit isolé. Elle est reconnue automatiquement quand seule une catégorie est transmise, sans identifiant de produit.
| Quand il est envoyé | À chaque chargement d'une page catégorie. setEcommerceView doit être appelé avant trackPageView, en laissant vides les champs du produit (SKU, identifiant, prix). |
|---|---|
| Paramètres obligatoires | Le nom de la catégorie. |
| Paramètres facultatifs | Un objet de données apportant d'autres informations sur la catégorie. |
| Déclencheur dans Google Tag Manager | Le même que pour une page produit, avec les champs du produit laissés vides. |
Pour le responsable marketing : montre quelles catégories ou quels rayons sont les plus consultés, ce qui vous aide à bâtir vos campagnes autour des centres d'intérêt de vos visiteurs.
_atsc_paq.push(['setEcommerceView',
null, // SKU: empty
null, // product ID: empty
'Electronics', // category (required)
null // price: empty
]);
_atsc_paq.push(['trackPageView']);
Les chaînes vides ('') fonctionnent également, mais null ou undefined est recommandé pour un paramètre facultatif laissé vide.
Cart : la mise à jour du panier (TypeId 6)
Envoyé quand le panier change : un produit est ajouté ou retiré, ou une quantité change. Il rend compte de l'état actuel du panier, et non d'un achat finalisé.
| Quand il est envoyé | À chaque changement dans le panier. |
|---|---|
| Paramètres obligatoires | Le montant du panier (revenue), et pour chaque produit : son identifiant et son nom. |
| Paramètres facultatifs | La devise, les coordonnées du client (nom, e-mail, téléphone), le détail du panier (coupon, adresse de livraison, nombre d'articles) et des champs personnalisés. |
| Déclencheur dans Google Tag Manager | Un événement personnalisé « panier mis à jour », que votre site envoie à chaque changement. |
Le visiteur doit déjà être identifié (par Register, par exemple). S'il est encore anonyme, l'événement de panier n'est pas enregistré.
Pour le responsable marketing : fait apparaître les paniers abandonnés et les ajouts ou retraits d'articles : c'est la base de vos campagnes de relance de panier.
// Clear the cart saved in tracking, then add the current items again
_atsc_paq.push(['clearEcommerceCart']);
// addEcommerceItem(productId, name, category, price, quantity)
_atsc_paq.push(['addEcommerceItem', 'PROD-001', 'Product 1', 'Electronics', 99.99, 1]);
_atsc_paq.push(['addEcommerceItem', 'PROD-003', 'Product 3', 'Electronics', 29.99, 1]);
_atsc_paq.push(['setCustomData', { currency: 'USD' }]);
_atsc_paq.push(['trackEcommerceCartUpdate', 129.98]); // cart total
Order : une commande finalisée (TypeId 5)
L'événement le plus important pour mesurer vos conversions : il marque qu'un achat a été finalisé, en général sur la page « Merci pour votre commande ».
| Quand il est envoyé | Quand la commande est validée ou finalisée, en général sur la page de confirmation. |
|---|---|
| Paramètres obligatoires | Un numéro de commande unique, le montant total (revenue), et pour chaque produit : son identifiant et son nom. |
| Paramètres facultatifs | La devise, les coordonnées du client, le nom de la commande, le coupon, l'adresse de livraison, le statut de la commande, et les indicateurs createContact et subscriptionStatus (créer ou non un contact, et l'accord de la personne pour recevoir vos envois). |
| Déclencheur dans Google Tag Manager | Le chargement de la page « Merci » ou « Confirmation de commande », une seule fois par commande (et non à chaque actualisation). |
- Une fois la commande envoyée, les articles du panier enregistrés par le suivi sont supprimés automatiquement, pour éviter un double comptage. Pour une autre commande, ajoutez de nouveau les produits.
- Veillez à ce que l'événement ne reparte pas si la page de confirmation est actualisée : la même commande serait comptée deux fois.
Pour le responsable marketing : c'est l'événement qui mesure le retour sur investissement de chaque campagne. Il alimente les rapports de chiffre d'affaires et de conversion, et il est rattaché automatiquement aux paramètres UTM de la campagne qui a amené le visiteur.
// Add the purchased products
_atsc_paq.push(['addEcommerceItem', 'PROD-001', 'Product 1', 'Electronics', 99.99, 2]);
_atsc_paq.push(['addEcommerceItem', 'PROD-002', 'Product 2', 'Accessories', 29.99, 1]);
_atsc_paq.push(['setCustomData', {
currency: 'USD',
createContact: true, // create a contact if it doesn't exist
subscriptionStatus: true // whether the person agreed to receive mailings
}]);
// trackEcommerceOrder(orderId, total, subtotal, tax, shipping, discount)
_atsc_paq.push(['trackEcommerceOrder', 'ORDER-12345', 102.99, 99.99, 8.00, 5.00, 10.00]);
Lead : un prospect dans un processus de vente (TypeId 13)
Pour les processus de vente qui ne relèvent pas du e-commerce classique, comme le B2B : il marque la création d'un prospect, avec une date d'achat prévue et un montant potentiel. Usage typique : un formulaire « Laissez-nous vos coordonnées » ou « Demander un devis ».
| Quand il est envoyé | Quand un visiteur identifié (après Register, par exemple) laisse un prospect, par exemple via un formulaire de contact en vue d'un achat futur. |
|---|---|
| Paramètres obligatoires | Un identifiant de prospect unique (leadId), la date d'achat prévue, le type d'emplacement (Online, Offline ou Unknown), et l'identifiant externe de la personne (externalId) dans l'objet de données personnalisées. |
| Paramètres facultatifs | Le nom du prospect, le montant total, les coordonnées du client, le coupon, l'adresse, le statut du prospect, et les indicateurs createContact et subscriptionStatus. Vous pouvez aussi y joindre des produits. |
| Déclencheur dans Google Tag Manager | L'envoi réussi d'un formulaire de contact ou de demande de devis. |
- Le visiteur doit déjà être identifié (par Register, par exemple). Sinon, l'événement n'est pas enregistré. C'est le fonctionnement prévu, et non un dysfonctionnement.
- Contrairement à une commande, un prospect ne vide pas le panier enregistré par le suivi.
Pour le responsable marketing : utile aux entreprises au cycle de vente long (B2B, conseil en image, conseil) : vous pouvez suivre vos prospects dans l'entonnoir de vente, et pas seulement les achats immédiats.
// trackLead(leadId, expectedPurchaseDate, locationType, customData)
_atsc_paq.push(['trackLead',
'LEAD-1001', // lead ID (required)
'2026-09-15', // expected purchase date (required)
1, // locationType: 0 = Unknown, 1 = Online, 2 = Offline
{
externalId: 'CUST-42', // the person's external ID (required)
leadname: 'Inquiry from the website',
revenue: 1500.00,
email: 'jane@example.com',
createContact: true,
subscriptionStatus: true
}
]);
Opportunity : une opportunité commerciale (TypeId 14)
Une étape plus avancée que le prospect : elle marque une affaire concrète en cours de conclusion, par exemple une grosse affaire en négociation. Sa structure est presque identique à celle de Lead.
| Quand il est envoyé | Quand un visiteur identifié atteint une étape avancée de la vente (après un appel commercial ou un devis, par exemple). |
|---|---|
| Paramètres obligatoires | Un identifiant d'opportunité unique (opportunityId), la date d'achat prévue, le type d'emplacement (Online, Offline ou Unknown), et l'identifiant externe de la personne (externalId). |
| Paramètres facultatifs | Le nom de l'opportunité, le montant total, les coordonnées du client, le coupon, l'adresse, le statut, et les indicateurs createContact et subscriptionStatus. Vous pouvez aussi y joindre des produits. |
| Déclencheur dans Google Tag Manager | En général pas depuis le site lui-même, mais depuis votre CRM ou votre outil commercial (ou un formulaire interne), quand l'affaire atteint cette étape. |
- Comme pour Lead, le visiteur doit déjà être identifié. Sinon, l'événement est rejeté.
- Cet événement vient en général d'un système interne ou d'un CRM, et non du visiteur sur votre site. Convenez avec vos équipes techniques et commerciales de qui en a la charge.
Pour le responsable marketing : utile surtout aux équipes commerciales B2B qui veulent relier les étapes de l'entonnoir (prospect → opportunité → affaire conclue) aux mêmes données marketing et aux mêmes sources de trafic (UTM).
// trackOpportunity(opportunityId, expectedPurchaseDate, locationType, customData)
_atsc_paq.push(['trackOpportunity',
'OPP-2001', // opportunity ID (required)
'2026-11-01', // expected purchase date (required)
2, // locationType: 0 = Unknown, 1 = Online, 2 = Offline
{
externalId: 'CUST-42', // external ID (required)
opportunityname: 'Organizational deal',
revenue: 25000.00,
createContact: true,
subscriptionStatus: true
}
]);
Action : un événement personnalisé (TypeId 3)
Un événement souple, pour toute interaction que vous souhaitez mesurer et que les autres événements ne couvrent pas : un clic sur un bouton, le visionnage d'une vidéo, l'ouverture d'un pop-up, l'envoi d'un formulaire de contact.
| Quand il est envoyé | À toute action que vous jugez importante pour votre activité : un clic sur Contactez-nous ou la fin d'une vidéo, par exemple. |
|---|---|
| Paramètres obligatoires | Une catégorie (« Bouton » ou « Vidéo », par exemple), l'action, qui est toujours le texte fixe Action, et le nom de l'événement (« Envoi du formulaire », par exemple). |
| Paramètres facultatifs | Aucun. |
| Déclencheur dans Google Tag Manager | Le plus courant à mettre en place dans GTM : un déclencheur de clic sur un élément, ou un événement personnalisé que votre site envoie à la couche de données. |
Pour le responsable marketing : c'est la façon la plus souple de mesurer des objectifs précis (micro-conversions) qui n'ont pas d'événement dédié. Convenez à l'avance de noms de catégorie et d'événement clairs avec votre équipe technique, pour que tout le monde emploie les mêmes.
// trackEvent(category, 'Action', name): 'Action' is always fixed
_atsc_paq.push(['trackEvent',
'Button', // category
'Action', // always fixed
'Submit Form' // event name: also required to trigger automations
]);
Pour démarrer une automation depuis un événement personnalisé, voir Les déclencheurs d'automation du Smart Pixel.
Les règles générales
L'ordre des commandes (très important)
- Sur une page produit ou catégorie, appelez toujours
setEcommerceViewavanttrackPageView. - Définissez les données personnalisées (
setCustomData) avant d'envoyer l'événement lui-même. - Ajoutez les produits du panier ou de la commande (
addEcommerceItem) avanttrackEcommerceOrderoutrackEcommerceCartUpdate.
La devise
Définissez la devise avec setCustomData({ currency: 'USD' }). Elle s'applique aux événements de commande, de panier et de vue produit (pas aux vues de catégorie).
Les paramètres UTM (suivi des campagnes)
Les paramètres UTM (utm_source, utm_medium, utm_campaign, utm_term, utm_keyword, utm_content) sont relevés automatiquement dans l'adresse de la page et transmis avec chaque événement, commandes et paniers compris. Vous n'avez pas à les définir vous-même.
Pour le responsable marketing : veillez à ce que tous vos liens de campagne (réseaux sociaux, newsletters, Google Ads, etc.) emploient des paramètres UTM cohérents. C'est ce qui permet d'attribuer vos commandes et vos prospects à la campagne qui les a amenés.
D'autres règles
- Une fois une commande envoyée, les articles du panier enregistrés par le suivi sont supprimés automatiquement (pour éviter un double comptage). Lead et Opportunity, eux, ne vident pas le panier.
- Les événements Cart, Lead et Opportunity exigent que le visiteur soit identifié comme un contact existant. Les événements d'un visiteur anonyme sont rejetés et ne sont pas enregistrés.
- Les données personnalisées (
setCustomData) sont « persistantes » : elles continuent d'être envoyées avec les événements suivants jusqu'à ce que vous les réinitialisiez. Pour les effacer, appelezsetCustomData({})avec un objet vide.
Vérifier que le suivi fonctionne
Pour vérifier que vos événements partent correctement :
- L'onglet Réseau : ouvrez les outils de développement du navigateur (F12) → onglet Réseau, et filtrez sur
Track3. Une requête doit apparaître pour chaque événement. - Le mode débogage : activez-le une fois, et chaque requête de suivi s'affiche en direct dans la console du navigateur. Très pratique pour les tests.
// Turn on debug mode: every tracking request is printed to the console
_atsc_paq.push(['setDebugMode', true]);
// Turn it off when you're done checking
_atsc_paq.push(['setDebugMode', false]);
Pour vérifier que le pixel est installé sur votre site, voir Vérifier que le Smart Pixel est installé.
Problèmes courants et solutions
| Problème | Cause possible | Solution |
|---|---|---|
| Aucune requête de suivi n'est envoyée | La bibliothèque ne s'est pas chargée, l'identifiant de site est erroné, ou une erreur JavaScript bloque l'exécution | Vérifiez que le code de base est bien sur la page, puis l'identifiant de site et la console |
| Les événements n'apparaissent pas dans les rapports | Un TypeId erroné ou un paramètre obligatoire manquant | Comparez avec les paramètres obligatoires du tableau de chaque événement |
| Les événements de commerce ne fonctionnent pas | Les produits n'ont pas été ajoutés avant l'envoi de la commande | Appelez addEcommerceItem avant trackEcommerceOrder
|
| La vue de produit ou de catégorie n'est pas reconnue | setEcommerceView est appelé après trackPageView
|
Déplacez setEcommerceView avant trackPageView
|
| Les données personnalisées ne sont pas transmises | setCustomData est appelé après l'événement |
Appelez setCustomData avant d'envoyer l'événement |
Les sites monopages (React, Vue, Angular)
Sur une application monopage (SPA), passer d'une « page » à l'autre ne recharge pas le navigateur. Transmettez ces règles à votre équipe de développement :
- Ne chargez le code de base qu'une seule fois, au démarrage de l'application, et non à chaque changement d'écran.
- Envoyez
trackPageViewà chaque changement de route : le pixel ne le détecte pas automatiquement. - Sur les pages produit et catégorie, définissez les données de commerce (
setEcommerceView) avanttrackPageView, à chaque changement de route. setUserIdreste toujours'_atscid', avant comme après la connexion.- Envoyez Register juste après une connexion réussie, pour que le visiteur soit identifié.
- Videz le panier enregistré par le suivi (
clearEcommerceCart) quand le visiteur quitte la page du panier ou du paiement, selon le besoin.
Pour le responsable marketing : si votre site est une application monopage, assurez-vous que votre équipe technique envoie une vue de page à chaque changement d'écran. Sans cela, vos rapports de visite seront incomplets.
Exemple : le suivi des pages avec React Router.
import { useEffect } from 'react';
import { useLocation } from 'react-router-dom';
function App() {
const location = useLocation();
useEffect(() => {
if (window._atsc_paq) {
window._atsc_paq.push(['trackPageView', document.title]);
}
}, [location]);
return <YourApp />;
}
Les erreurs à éviter
- Définir les données du produit après la vue de page. À éviter :
trackPageViewavantsetEcommerceView. Correct : toujourssetEcommerceViewd'abord, puistrackPageView. - Ne pas vider le panier entre deux commandes. Si vous suivez plusieurs commandes d'affilée, veillez à ce que les articles de la commande précédente ne se reportent pas sur la suivante. Le pixel les efface automatiquement après
trackEcommerceOrder; pour Cart, effacez-les vous-même selon le besoin. - Changer la valeur de setUserId. À éviter :
setUserId(user.id)ou toute autre valeur. Correct :setUserId('_atscid'), toujours, sans exception. - Définir les données personnalisées après l'événement. Appelez
setCustomDataavant d'envoyer l'événement (trackPageView,trackEcommerceOrder, etc.), sans quoi les données ne sont pas transmises. - Ne pas ajouter les produits avant une commande ou une mise à jour du panier. Appelez
addEcommerceItemavanttrackEcommerceOrderoutrackEcommerceCartUpdate. - Oublier de suivre les pages d'une application monopage. Envoyez
trackPageViewà chaque changement de route, et pas seulement au premier chargement. - Utiliser des chaînes vides au lieu de null. Pour un paramètre facultatif laissé vide (comme les champs produit d'une page catégorie), transmettez
nullouundefinedplutôt qu'une chaîne vide, même si celle-ci fonctionne aussi.