Intégration Reddit Pixel : installation et aide

Suivez les étapes du Démarrage rapide.

Définissez ces paramètres dans Modules -> Reddit Pixel -> "Configure".

• "Enable Reddit Pixel". Active ou désactive le suivi Pixel dans le navigateur ; défaut : 0.

• Pixel ID. Stocke votre ID de Pixel Reddit depuis "Reddit Ads Manager" -> "Events Manager" ; défaut : "". Il doit comporter 4 à 128 caractères, uniquement des lettres, chiffres, traits de soulignement et tirets.

• "Exclude employee browsing". Arrête le suivi lorsqu'un employé connecté au back-office parcourt la boutique ; défaut : 1.

• "Respect marketing consent". Charge le suivi Reddit uniquement après le consentement marketing lorsque mprcookiesrevolution ou mprcookiebanner est actif ; défaut : 1.

• "Track PageVisit". Envoie un événement général de visite sur les pages suivies de la boutique ; défaut : 1.

• "Track ViewContent". Envoie des événements de consultation sur les pages produit si les données produit sont disponibles ; défaut : 1.

• "Track AddToCart". Envoie des événements d'ajout au panier après une augmentation de quantité réussie et confirmée ; défaut : 1.

• "Track AddToWishlist". Envoie des événements d'ajout à la liste de souhaits à partir d'ajouts réussis dont le succès est confirmé ; défaut : 1.

• "Track InitiateCheckout". Envoie l'entrée dans la commande comme événement Reddit personnalisé nommé InitiateCheckout ; défaut : 1.

• "Track Search". Envoie des événements de recherche sur les pages concernées lorsqu'une requête est présente ; défaut : 1.

• "Track Purchase". Envoie des événements d'achat à la confirmation de commande avec valeur, devise, produits, ID de transaction et ID de conversion ; défaut : 1.

• "Track SignUp". Envoie un événement d'inscription au prochain chargement de page après la création d'un compte client ; défaut : 1.

• "Track custom events". Active vos règles d'événements personnalisées JSON pour le suivi Pixel du navigateur ; défaut : 0.

• Règles d’événements personnalisés. Stocke le tableau JSON utilisé pour les règles de clic, d'URL, de contrôleur et d'événement DOM ; défaut : "".

• "Enable Conversions API events". Met les événements admissibles en file côté serveur et les envoie à Reddit avec des ID de conversion correspondants lorsque le transport les prend en charge ; défaut : 0.

• Token d’accès Conversions API. Stocke le jeton Reddit Conversions API généré dans "Reddit Ads Manager" -> "Events Manager" ; défaut : "".

• "Events testing ID". Active le mode test Reddit pour les charges utiles CAPI lorsque le champ est rempli ; défaut : "".

• "Queue batch limit". Détermine le nombre d'événements de conversion de la file traités par exécution, de 1 à 100 ; défaut : 20.

• "Persist consent withdrawals". Défaut : 0. Active un veto durable pour les événements d'achat et de formulaire de contact précédemment acceptés. Activez-le si vous avez besoin de conserver ces retraits.

Cliquez sur Enregistrer après avoir modifié le formulaire.

Le formulaire actuel propose aussi ces paramètres. Tous les interrupteurs de signaux sont sur Non par défaut. Activez uniquement les actions que vous souhaitez observer.

Les seuils partagés sont trois vues de galerie, un changement de déclinaison, un clic de détail, 45 secondes de présence et une temporisation des options de 1500 ms. Les compteurs de galerie, de déclinaison et de détail sont limités de 1 à 20. La durée est limitée de 5 à 600 secondes. La temporisation est limitée de 250 à 60000 ms. Par exemple :

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

Vous pouvez aussi fournir gallery_selectors, variant_selectors et detail_selectors. Gardez les valeurs par défaut sauf si votre thème exige d'autres sélecteurs. Ces signaux facultatifs nécessitent les mêmes contrôles de consentement, de politique employés et de responsabilité du suivi que les événements commerciaux.

Gardez les paramètres de consentement et d'exclusion des employés activés lors de la configuration initiale. Testez depuis un navigateur visiteur normal non marqué comme employé. Une session back-office connectée, une règle de trafic interne ou le refus d'un visiteur peut empêcher le suivi.

La couche de consentement partagée prend en charge les intégrations MPR et des adaptateurs CMP supplémentaires. Elle doit obtenir une décision marketing exploitable pour la destination. Une décision inconnue, périmée ou négative 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 navigateur et serveur. Supprimez les balises de thème dupliquées ou résolvez la responsabilité lorsqu'un autre module MPR gère le même compte.

L’envoi en production suit aussi la politique des transmissions sortantes. Un événement affiché en démonstration ou en aperçu n’est pas forcément transmis à votre compte publicitaire. Les achats et événements de formulaire côté serveur ne sont envoyés qu’avec le consentement donné par l’acheteur à ce moment-là ; une exécution cron ultérieure ne peut pas le remplacer.

L'en-tête de votre boutique fournit une configuration compatible avec le cache. Le module charge https://www.redditstatic.com/ads/pixel.js après validation des contrôles. Aucun widget classique n'apparaît en boutique. Le module prend en charge displayHeader, displayOrderConfirmation, actionValidateOrder, actionCustomerAccountAdd, displayFooter et displayBeforeBodyClosingTag.

Avec les interrupteurs correspondants activés, les visites envoient PageVisit, les pages produit ViewContent et les pages de recherche Search ; les ajouts confirmés au panier et à la liste de souhaits envoient les événements correspondants. L'entrée dans la commande envoie Reddit Custom avec customEventName=InitiateCheckout. La création de compte est marquée pour SignUp au prochain chargement de page admissible.

Les achats incluent les articles disponibles de la commande, les quantités, la valeur, la devise et les ID de transaction et de conversion. Les achats serveur et navigateur partagent la même identité d’achat lorsqu’elle est disponible. Les ajouts au panier et à la liste de souhaits nécessitent la confirmation d’un ajout réel ; un événement navigateur seul ne suffit pas.

Les événements serveur sont envoyés au point de terminaison Reddit https://ads-api.reddit.com/api/v2.0/conversions/events/PIXEL_ID avec le Pixel ID configuré. Les données de rapprochement envoyées dépendent de l'attribution d'origine et du consentement du visiteur. Les copies navigateur et serveur partagent un ID d'événement pour la déduplication lorsque les deux sont envoyées, mais tous les événements ne passent pas par les deux canaux.

Activez "Track custom events", collez un tableau JSON dans Règles d’événements personnalisés et enregistrez. Adaptez les sélecteurs et chemins à votre boutique. Utilisez les déclencheurs click, url, controller ou event. Une règle de contrôleur peut aussi inclure une liste modules. Les noms autorisent lettres, chiffres, traits de soulignement et tirets, jusqu'à 64 caractères. La limite est de 15 noms distincts. once limite une règle pendant l'exécution de la page actuelle.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprreddit:sizeGuideOpen",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

Déclenchez la règle DOM depuis votre thème après l'initialisation du suivi :

document.dispatchEvent(new CustomEvent('mprreddit:sizeGuideOpen'));

Le drapeau capi de chaque règle envoie une copie serveur via le pont personnalisé. Le pont accepte Custom avec customEventName, contrôle que la règle est configurée et exige un ID d'événement ainsi que le consentement actuel du visiteur. Sans eux, l'événement est retenu.

Pour la règle de clic, les attributs de données pris en charge peuvent remplacer value, currency, num_items et event_id, par exemple :

<button class="track-reddit-demo" data-reddit-param-value="12.50"
        data-mprreddit-param-currency="EUR">Track custom action</button>

Utilisez un sélecteur de clic correspondant dans votre règle. L'ancien exemple d'attributs product_id et product_category n'est pas exploité par le runtime actuel. Un événement DOM peut fournir les valeurs commerciales prises en charge dans detail.params. Placez les paramètres descriptifs statiques dans la règle elle-même.

La tâche send_reddit_conversions est enregistrée avec la planification every:300. Elle doit être exécutée toutes les cinq minutes. Votre exécuteur cron MPR partagé doit exécuter les tâches dues ; la déclaration seule ne lance aucun worker. La limite de lot plafonne les lignes de file par exécution de 1 à 100, avec 20 par défaut.

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 des tâches et vérifiez les horodatages et l'état de la file sur la page de configuration de ce module.

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

Pour Envoyer une sonde API, saisissez un "Events testing ID" et disposez d'un véritable événement en attente d'un acheteur ayant donné son consentement. Sans ID de test, consentement actuel ou événement exploitable en file, la sonde est refusée ; elle ne crée jamais d'achat fictif. Videz "Events testing ID" lorsque vous êtes prêt pour les événements de production.

1. Vérifiez les avis de configuration requise, la responsabilité du suivi et la bannière d'intégrité.
2. Utilisez un navigateur visiteur normal et accordez le consentement marketing via votre CMP configurée.
3. Ouvrez un produit, effectuez une recherche et ajoutez un article au panier avec succès. Vérifiez le chargement du SDK et les requêtes d'événements correspondantes dans le panneau réseau du navigateur.
4. Consultez les diagnostics d'événements Reddit ou Pixel Helper, si disponible dans votre environnement de test.
5. Pour les achats, utilisez un parcours de test autorisé et inspectez l'événement navigateur, l'ID de conversion et la ligne de file.
6. Pour l'envoi serveur, exécutez le planificateur configuré et vérifiez le résultat en file. Un appel navigateur accepté par votre boutique n'est pas forcément parvenu à Reddit.

Si aucun script ne se charge, vérifiez "Enable Reddit Pixel", la syntaxe de Pixel ID, le consentement, les marqueurs employés, la responsabilité, la politique sortante et les bloqueurs de scripts. Si les événements panier ou liste de souhaits manquent, inspectez les signaux de réussite et les données produit. Un clic seul ne suffit pas. Utilisez des règles personnalisées pour les interactions distinctes, sans présenter un clic comme un achat ou un ajout au panier prouvé.

Si les lignes CAPI échouent ou restent retenues, vérifiez le jeton, la destination Pixel, le consentement enregistré, le schéma de file et l'exécution cron. Les règles personnalisées exigent du JSON et des sélecteurs valides. Cette version ne fournit pas l'ancien utilitaire window.mprredditTrack.

Désactivez les interrupteurs navigateur et serveur et enregistrez pour arrêter le suivi en conservant la configuration. Désinstallez depuis "Module Manager" pour supprimer les paramètres, entrées de menu et tâches enregistrées du module.

La désinstallation appelle le nettoyage partagé de la file de conversions. La table partagée est conservée tant qu'un autre module de conversion l'utilise et peut être supprimée au retrait du dernier utilisateur. Exportez les diagnostics nécessaires avant de désinstaller. Ne supposez pas que la désinstallation supprime les événements déjà envoyés à la plateforme publicitaire ou efface tout le stockage d'attribution du navigateur.

Nécessite PrestaShop 1.6.0.0 ou ultérieur et PHP 7.1 ou ultérieur.