Intégration Criteo OneTag : installation et aide

1. Importez et installez le ZIP dans "Modules" > "Module Manager", puis ouvrez Criteo OneTag Integration > "Configure".
2. Saisissez Partner ID Criteo dans Paramètres Criteo OneTag.
3. Vérifiez "Track home page", "Track product views" et les autres interrupteurs d’événements.
4. Gardez les contrôles initiaux de consentement et d’employés activés, réglez "Enable Criteo OneTag" sur Oui et cliquez sur Enregistrer.
5. Accordez le consentement marketing dans un navigateur de visiteur et ouvrez une fiche produit.
6. Vérifiez que le chargeur Criteo et l’événement viewItem sont émis.
7. Pour les achats serveur facultatifs, configurez la région et les ID de page API attribués par Criteo, puis examinez une commande autorisée via la file et le planificateur.

Ouvrez "Modules" > "Module Manager" > Criteo OneTag Integration > "Configure".

• "Enable Criteo OneTag". Interrupteur principal du suivi OneTag dans le navigateur ; valeur par défaut : 0.
• Partner ID Criteo. Valeur numérique du compte Criteo issue de votre configuration OneTag, de 4 à 20 chiffres ; valeur par défaut : "".
• "Exclude logged-in employees". Empêche la navigation des employés du Back Office d’influencer les audiences Criteo pendant les tests ; valeur par défaut : 1.
• "Respect marketing consent". Utilise les modules de consentement MPR comme protection de consentement marketing avant l’exécution du suivi ; valeur par défaut : 1.
• "Send hashed customer identifiers". Envoie l’ID client et l’e-mail hachés en SHA-256 pour les clients connectés lorsque le suivi est autorisé ; valeur par défaut : 0.
• "Track home page". Envoie viewHome sur la page d’accueil de la boutique ; valeur par défaut : 1.
• "Track product views". Envoie viewItem sur les fiches produit ; valeur par défaut : 1.
• "Track category listings". Envoie viewCategory sur les pages de catégorie et de liste ; valeur par défaut : 1.
• "Track search results". Envoie viewSearchResult avec les mots-clés de recherche et les ID de produits visibles ; valeur par défaut : 1.
• "Track basket and checkout starts". Envoie viewBasket sur les pages de panier et de commande ; valeur par défaut : 1.
• "Track add to cart". Envoie addToCart à partir d’ajouts au panier PrestaShop confirmés comme réussis ; valeur par défaut : 1.
• "Track purchases". Envoie trackTransaction côté navigateur et est aussi requis pour les événements d’achat côté serveur ; valeur par défaut : 1.
• "Track custom trigger rules". Active les règles de déclenchement JSON supplémentaires enregistrées dans le champ de déclencheurs personnalisés ; valeur par défaut : 0.
• Règles de déclencheur personnalisé. Tableau JSON de règles de déclenchement Criteo personnalisées ; valeur par défaut : "".
• "Enable server-side purchase tracking". Met les achats en file lors de la validation de commande pour leur envoi à l’API Criteo Retail Media ; valeur par défaut : 0.
• "Server-side region". Sélectionne la région du point de terminaison Criteo Retail Media, eu ou us ; valeur par défaut : eu.
• Page ID desktop côté serveur. ID de page API Criteo utilisé pour les appels d’achat sur ordinateur ; valeur par défaut : trackTransactionApiDesktop.
• Page ID mobile côté serveur. ID de page API Criteo utilisé pour les appels d’achat sur mobile et tablette ; valeur par défaut : trackTransactionApiMobile.
• "Forward IP address and user agent". Ajoute les en-têtes X-Forwarded-For et User-Agent aux appels serveur pour la correspondance d’attribution ; valeur par défaut : 1.
• "Server-side queue batch limit". Nombre maximal d’événements Criteo en file envoyés par exécution cron, de 1 à 100 ; valeur par défaut : 20.

Cliquez sur Enregistrer. Vous pouvez installer avant de disposer d’un Partner ID, mais laissez le suivi désactivé jusqu’à la saisie d’un ID valide. Utilisez la région et les ID de page API attribués par Criteo avant d’activer les achats serveur.

Gardez les paramètres de consentement et d’exclusion des employés activés pendant la configuration initiale. Testez depuis un navigateur de visiteur ordinaire non marqué comme employé. Une session Back Office connectée, une règle de trafic interne ou un refus du visiteur peut empêcher le suivi.

La couche de consentement partagée prend en charge les intégrations de consentement MPR et d’autres adaptateurs CMP. Elle doit obtenir une décision marketing exploitable pour la destination. Une décision inconnue, périmée ou refusée peut retenir les événements. Le module ne fournit pas de bannière de cookies. Une ancienne préférence de consentement ne remplace pas un refus actuel d’une CMP détectée.

Le module doit être responsable de la destination configurée dans le coordinateur de suivi partagé. Une responsabilité absente, ambiguë ou conflictuelle peut retenir les envois du navigateur et du serveur. Supprimez les balises de thème en double ou résolvez la responsabilité lorsqu’un autre module MPR gère le même compte.

L’envoi en production suit aussi la politique de trafic sortant, et les boutiques de démonstration ou d’aperçu n’envoient pas d’événements à votre compte Criteo. Les achats et les événements de formulaire côté serveur ne sont envoyés qu’avec le consentement enregistré au moment de la commande ou du formulaire ; une exécution cron ultérieure ne vaut jamais consentement.

Lorsqu’il est autorisé, le module charge https://dynamic.criteo.com/js/ld/ld.js?a=PARTNER_ID et prépare criteo_q. Il envoie votre compte, le type d’appareil et l’événement OneTag pertinent. Les types d’appareil sont d pour ordinateur, m pour mobile et t pour tablette.

Les événements standard sont viewHome, viewItem, viewCategory, viewSearchResult, viewBasket, addToCart et trackTransaction. Les données produit peuvent inclure l’ID catalogue, le produit parent, le prix, la disponibilité et le chemin de catégorie. Les listes peuvent inclure les ID visibles et le numéro de page. Les événements de panier utilisent les lignes de panier disponibles. Les achats utilisent la référence de commande, les articles, quantités et devise.

"Send hashed customer identifiers" est désactivé initialement. Une fois activé, le contexte visiteur privé peut fournir un ID client haché en SHA-256 et un e-mail normalisé. Le consentement actuel à la mise en correspondance est vérifié séparément. Un compte connecté n’autorise pas à lui seul ces données de correspondance.

La balise demande les données propres au visiteur au point de terminaison evidence du module, qui relie le visiteur du navigateur à sa session invité PrestaShop. Gardez ce point de terminaison accessible (ne le bloquez pas et ne le mettez pas en cache). Les actualisations de la page produit et les ajouts au panier peuvent mettre à jour les données du catalogue.

Vous pouvez reconnaître une séquence de file typique comme celle-ci. Ne collez pas de balise supplémentaire dans votre thème tant que le module est responsable de la destination :

criteo_q.push(
  {event: 'setAccount', account: 12345},
  {event: 'setSiteType', type: 'd'},
  {event: 'viewItem', item: '42', parent_item: '42', price: '19.99', availability: 1}
);

Activez "Track custom trigger rules", collez un tableau dans Règles de déclencheur personnalisé et enregistrez. Adaptez les sélecteurs et chemins à votre boutique :

[
  {
    "event": "viewItem",
    "label": "Gallery browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "page_id_type": "product",
    "params": {
      "interaction": "gallery_browse",
      "source": "product_gallery"
    },
    "once": false
  },
  {
    "event": "viewCategory",
    "label": "Sale landing page",
    "trigger": "url",
    "contains": [
      "sale"
    ],
    "page_id_type": "category",
    "params": {
      "section": "sale"
    }
  },
  {
    "event": "viewBasket",
    "label": "Checkout start",
    "trigger": "controller",
    "controllers": [
      "order",
      "orderopc"
    ],
    "page_id_type": "basket"
  },
  {
    "event": "viewItem",
    "label": "Size guide",
    "trigger": "event",
    "dom_event": "mprcriteo:custom",
    "page_id_type": "product"
  }
]

Déclenchez l’exemple DOM depuis votre thème :

document.dispatchEvent(new CustomEvent('mprcriteo:custom'));

Les règles personnalisées fonctionnent pour viewHome, viewItem, viewCategory, viewSearchResult et viewBasket. Le module envoie lui-même addToCart et trackTransaction lors de vrais ajouts au panier et de vraies commandes : les règles personnalisées portant ces deux noms sont acceptées mais ne se déclenchent jamais.

Le gestionnaire de déclenchement utilise les params configurés et les articles courants disponibles. Il ne fusionne pas de détails DOM arbitraires. Les conditions URL examinent l’URL complète. Les règles de contrôleur peuvent aussi inclure des noms de modules.

Les ID de page du navigateur suivent ces correspondances. Les ID mobiles couvrent aussi les contextes tablette :

Gardez "Track purchases" activé. Configurez "Enable server-side purchase tracking", "Server-side region" et les ID de page ordinateur/mobile. Les valeurs par défaut sont eu, trackTransactionApiDesktop et trackTransactionApiMobile. Les ID de page API acceptent lettres, chiffres, traits de soulignement, deux-points et traits d’union. Des valeurs comme trackTransaction_API_desktop sont acceptées syntaxiquement, mais utilisez les ID attribués à votre intégration.

Les points de terminaison régionaux sont :

La validation de commande capture le consentement d’origine et les faits relatifs à l’acheteur. Un événement serveur admissible utilise l’ID invité du panier réel de la commande comme identité visiteur du commerçant. Les hachages facultatifs de correspondance et les en-têtes IP/agent utilisateur transmis nécessitent leurs paramètres et autorisations respectifs. L’envoi serveur est limité aux achats ; ce n’est pas une API générale d’événements personnalisés.

L’envoi des achats utilise un registre partagé pour que le navigateur et le serveur n’envoient pas tous deux la même commande ; ne vous attendez pas à voir chaque commande sur les deux canaux. Un achat est retenu s’il manque le consentement de l’acheteur, les données de commande enregistrées au moment de l’achat, le réglage de destination ou les valeurs de la commande.

La tâche send_criteo_retailmedia_conversions est enregistrée avec le calendrier every:300. Elle devient exigible toutes les cinq minutes. Votre exécuteur cron MPR partagé doit exécuter les tâches arrivées à échéance ; la déclaration du calendrier seule ne lance pas de worker. Le paramètre "Server-side queue batch limit" limite les lignes de file par exécution de traitement, de 1 à 100, avec une valeur par défaut de 20.

Le module ne fournit pas de point d’entrée autonome cron.php. Utilisez le planificateur partagé déjà configuré pour votre boutique. Confirmez-y l’exécution de la tâche et vérifiez les horodatages et statuts de la file sur la page de configuration du module.

Les diagnostics comprennent les contrôles de préparation, les compteurs de file, les lignes récentes, Envoyer une sonde API et Réessayer les événements échoués. Résolvez la cause de l’échec avant de réessayer. Remettre les lignes échouées en attente ne contourne pas le consentement actuel, la politique des employés, la responsabilité du compte ou les contrôles de destination.

Envoyer une sonde API n’envoie ni requête API ni achat de test. Réessayer les événements échoués remet les éléments échoués admissibles de la file à disposition pour une nouvelle tentative après correction de la cause.

1. Vérifiez le Partner ID, la préparation, l’intégrité, le consentement et la responsabilité de la destination.
2. Depuis un navigateur de visiteur ordinaire, accordez le consentement marketing et ouvrez l’accueil, un produit, une catégorie, une recherche et le panier.
3. Vérifiez le chargeur et l’événement OneTag correspondant à chaque type de page activé.
4. Ajoutez un article avec succès et vérifiez que l’ajout au panier utilise des données catalogue valides.
5. Passez une commande de test. Examinez l’identifiant d’achat, les valeurs, le consentement de l’acheteur enregistré et le canal d’envoi utilisé.
6. Pour les achats serveur, vérifiez que la tâche planifiée s’exécute et examinez la réponse de la file et les diagnostics du compte Criteo.

Si OneTag est absent, vérifiez l’interrupteur d’activation, le Partner ID numérique, la décision de consentement, la politique des employés, la responsabilité, la politique de trafic sortant, les files en double, les bloqueurs du navigateur et la requête vers le point de terminaison evidence. Si une règle personnalisée ne se déclenche jamais, vérifiez si elle utilise addToCart ou trackTransaction, que les règles personnalisées ne peuvent pas envoyer.

Si l’envoi serveur échoue, vérifiez la région et les ID de page attribués par Criteo, l’autorisation d’origine de l’acheteur, l’identité native d’invité, les données de commande et l’exécution du planificateur. Modifier la destination ou la région après admission peut retenir les lignes existantes. Ce module ne configure pas pour vous les campagnes, créations, enchères, audiences ou flux produits.

Désactivez "Enable Criteo OneTag" et "Enable server-side purchase tracking", puis enregistrez pour arrêter le suivi tout en conservant votre configuration. Désinstallez depuis "Module Manager" pour retirer les entrées de menu, les tâches enregistrées et la configuration du module.

La désinstallation supprime le menu, la tâche planifiée et les réglages du module. Les tables partagées de file et d’achats utilisées par d’autres modules de suivi restent en place : exportez d’abord les enregistrements nécessaires. La désinstallation ne peut pas supprimer les événements déjà reçus par Criteo.

Nécessite PrestaShop 1.6.0.0 ou une version ultérieure et PHP 7.1 ou une version ultérieure.