Outbrain Pixel + S2S Postback : installation et aide

1. Téléversez et installez le ZIP dans Modules > "Module Manager", puis ouvrez Outbrain Pixel + S2S Postback > "Configure".
2. Saisissez Marketer ID Outbrain, en séparant plusieurs ID par des virgules si nécessaire.
3. Vérifiez les interrupteurs de suivi des événements et Nom de l’événement d’achat.
4. Réglez "Enable Outbrain Pixel" sur Oui et cliquez sur Enregistrer.
5. Accordez le consentement marketing dans un navigateur de visiteur ordinaire et ouvrez un produit.
6. Vérifiez que obtp.js se charge et que l’événement navigateur "View Content" est émis.
7. Si vous utilisez S2S, vérifiez d’abord que les visiteurs arrivent avec des identifiants de clic Outbrain et que le consentement de l’acheteur est enregistré, puis activez "Enable S2S postback events" et recherchez un véritable achat dans la file et dans les rapports Outbrain.

Définissez ces paramètres dans Modules > Outbrain Pixel + S2S Postback > "Configure".

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

• Marketer ID Outbrain. Stocke un Marketer ID alphanumérique de 10 à 50 caractères ou un ID décimal existant de 32 chiffres maximum; valeur par défaut: empty. Plusieurs ID peuvent être séparés par des virgules.

• "Exclude employees". Arrête le suivi lorsqu’un employé connecté au back-office consulte la boutique; valeur par défaut: 1.

• "Respect cookie consent". Attend le consentement marketing de mprcookiesrevolution ou mprcookiebanner lorsque l’un de ces modules est actif; valeur par défaut: 1.

• "Track PageView". Envoie l’événement Outbrain PAGE_VIEW depuis l’en-tête de page; valeur par défaut: 1.

• "Track View Content". Envoie l’événement de consultation de produit sur les pages produit; valeur par défaut: 1.

• "Track View Category". Envoie les événements de consultation de catégorie lorsqu’une catégorie courante est détectée; valeur par défaut: 1.

• "Track Add To Cart". Envoie les événements navigateur d’ajout au panier après des ajouts réussis confirmés; valeur par défaut: 1.

• "Track Checkout". Envoie l’événement de début de commande lorsque le module détecte la page de début de commande et que le panier contient des produits; valeur par défaut: 1.

• "Track Purchase". Envoie les événements d’achat à la confirmation de commande et peut mettre en file les postbacks d’achat S2S; valeur par défaut: 1.

• "Track Search". Envoie les événements de recherche sur le contrôleur de recherche lorsque s ou search_query est présent; valeur par défaut: 1.

• "Track Add To Wishlist". Envoie les événements de liste de souhaits après des ajouts réussis confirmés; valeur par défaut: 1.

• "Track Sign Up". Envoie un événement d’inscription après la création d’un nouveau compte client; valeur par défaut: 1.

• Nom de l’événement d’achat. Définit le nom d’événement Outbrain utilisé pour les achats; valeur par défaut: Purchase.

• "Track custom events". Active les règles de conversion personnalisées définies en JSON; valeur par défaut: 0.

• Règles d'événements personnalisés. Stocke le tableau JSON des règles personnalisées de clic, d’URL, de contrôleur ou d’événement DOM; valeur par défaut: empty.

• "Enable S2S postback events". Met en file les événements de conversion admissibles côté serveur lorsqu’un ID de clic Outbrain est disponible; valeur par défaut: 0.

• "S2s Test Click Id". Champ conservé pour compatibilité ; valeur par défaut : vide. La sonde d’achat de production est désactivée.

• "Legacy IP/user-agent preference". Valeur par défaut : 1. Préférence conservée pour compatibilité. Les adresses IP et les user-agents ne sont ni mis en file ni envoyés.

• "Queue batch limit". Définit le nombre d’événements de conversion en file traités par le processeur cron à chaque exécution; valeur par défaut: 20. Plage autorisée : 1-1000.

• "Persist marketing consent withdrawals". Valeur par défaut : 0. Enregistrez les retraits du consentement marketing pour que les événements en file les respectent.

Cliquez sur Enregistrer. Nom de l’événement d’achat vaut Purchase par défaut. Faites correspondre les noms au compte Outbrain. Le module laisse la configuration des campagnes et les rapports dans ce compte externe.

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

Les seuils partagés sont de trois vues de galerie, un changement de variante, un clic sur un détail, une présence de 45 secondes et un intervalle minimal de 1500 ms pour les options. Les nombres de vues de galerie, de variantes et de détails sont limités de 1 à 20. Le temps de présence est limité de 5 à 600 secondes. L’intervalle est limité 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. Conservez les valeurs par défaut sauf si votre thème nécessite d’autres sélecteurs. Ces signaux facultatifs nécessitent des vérifications de consentement, de politique relative aux employés et de responsabilité du suivi, comme les événements commerciaux.

Laissez les paramètres de consentement et d’exclusion des employés activés pendant la configuration initiale. Testez dans un navigateur de visiteur ordinaire qui n’est pas identifié comme employé. Une session back-office connectée, une règle de trafic interne ou un refus du visiteur peut bloquer le suivi.

La couche de consentement partagée prend en charge les intégrations de consentement 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 prévaut pas sur 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 l’envoi depuis le navigateur et le serveur. Supprimez les balises en double du thème 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. La transmission des événements de démonstration et d'aperçu à votre compte publicitaire dépend de cette politique. 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.

Lorsque cela est autorisé, le module charge https://amplify.outbrain.com/cp/obtp.js. Le module n’ajoute pas de widget classique destiné aux clients. Il envoie les événements navigateur activés de page, produit, catégorie, ajout au panier confirmé, début de commande, achat, recherche, ajout à la liste de souhaits confirmé, inscription et événements personnalisés configurés, avec le contexte produit et commande disponible.

Les visites de page utilisent PAGE_VIEW. Les autres noms intégrés sont View Content, View Category, Add To Cart, Checkout, votre nom d’achat configuré, Search, Add To Wishlist et Sign Up. Le contexte d’achat comprend la valeur de commande, la devise, la référence et les articles, selon leur disponibilité.

Vous pouvez saisir plusieurs Marketer ID séparés par des virgules, par exemple 123456, 789012. Chaque destination possède ses propres contrôles de responsabilité du suivi.

Le moteur d’exécution accepte ob_click_id, OutbrainClickId, outbrain_click_id et dicbo depuis les URL d’arrivée et stocke une valeur valide dans mproutbr_ob_click_id pendant 90 jours après les contrôles d’autorisation. Utilisez la véritable substitution de clic de votre campagne, par exemple :

https://www.example.com/product.html?ob_click_id={{ob_click_id}}

Le suivi navigateur peut fonctionner sans attribution des clics. Les postbacks serveur l’exigent. PageView reste exclusivement dans le navigateur.

Activez "Track custom events", saisissez un tableau JSON dans Règles d'événements personnalisés et enregistrez. Utilisez les noms exacts des événements du compte, de 1 à 100 lettres, chiffres, espaces ou traits d’union. Les traits de soulignement sont rejetés pour les noms personnalisés. Ces exemples couvrent les déclencheurs de clic, d’URL, de contrôleur et d’événement DOM. Les règles de contrôleur peuvent restreindre un module front-office avec modules.

[
  {
    "event": "Gallery Browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "once": false,
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Landing Page View",
    "trigger": "url",
    "contains": [
      "/sale"
    ],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Contact Page View",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "modules": [],
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  },
  {
    "event": "Lead",
    "trigger": "event",
    "dom_event": "mproutbr:lead",
    "s2s": false,
    "params": {
      "property": "custom_interaction"
    }
  }
]

Déclenchez la règle DOM après l’initialisation :

document.dispatchEvent(new CustomEvent('mproutbr:lead'));

Les règles d’URL examinent le chemin. Les fragments de requête tels que utm_campaign=outbrain ne correspondent pas à un chemin. once limite les déclenchements répétés de clic ou de DOM dans l’exécution actuelle.

Les exemples définissent s2s sur false pour un suivi des interactions uniquement dans le navigateur. Le pont front-office ne peut mettre en file les événements admissibles qu’avec un reçu d’occurrence émis par le serveur, lié à la session native de l’acheteur et à l’autorisation actuelle. Un jeton ou de simples données produit arbitraires envoyées ne suffisent pas.

Conservez les paramètres statiques pris en charge dans params. Le code de déclenchement actuel ne fusionne pas les valeurs arbitraires data-outbrain-param-* ni les detail.params du DOM. Aucun assistant window.mproutbrTrack n’est exposé.

Activez "Enable S2S postback events" uniquement lorsque les identifiants de clic Outbrain et le consentement des acheteurs sont enregistrés. À la validation de la commande, le module enregistre ces données et met l’achat en file pour le serveur. Le postback est envoyé à https://tr.outbrain.com/unifiedPixel avec les valeurs d’attribution et d’événement autorisées. Il ne transmet ni l’adresse IP ni le user-agent.

Outbrain ne peut pas dédupliquer un achat envoyé à la fois par le navigateur et par le serveur ; le module utilise donc un seul canal par achat. Lorsque S2S est activé, la page de confirmation de commande n’envoie aucun achat navigateur et met seulement le postback serveur en file ; un achat sans ID de clic ni consentement enregistré n’est donc pas envoyé du tout. Lorsque S2S est désactivé, l’achat est envoyé par le navigateur sur la page de confirmation de commande.

La tâche send_outbrain_conversions est enregistrée avec la planification every:300. Elle arrive à échéance toutes les cinq minutes. Votre exécuteur cron MPR partagé doit exécuter les tâches dues ; la déclaration du calendrier seule ne lance pas de processus de traitement. La limite de lot borne les lignes de file par exécution de 1 à 1000, avec une valeur par défaut de 20.

Utilisez le planificateur partagé configuré pour votre boutique ; le module ne possède pas de point d'entrée cron.php autonome. Consultez l'exécution des tâches dans ce planificateur, ainsi que les horodatages et le statut de la file sur la page de configuration du module.

Les diagnostics comprennent les contrôles de disponibilité, les compteurs de file, les lignes récentes, Envoyer une sonde S2S 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 les contrôles actuels de consentement, de politique relative aux employés, de responsabilité du compte ou de destination.

La tâche a un délai d’expiration de 30 secondes. Envoyer une sonde S2S est désactivé car Outbrain n’a pas de mode de test qui garde les conversions de test hors de vos rapports. Remplir le champ de clic de test n’envoie aucun achat de test.

1. Vérifiez les champs requis, la disponibilité, l’intégrité et la responsabilité pour chaque Marketer ID.
2. Utilisez un navigateur de visiteur ordinaire, accordez le consentement marketing et ouvrez un produit.
3. Vérifiez que obtp.js se charge et que l’événement navigateur attendu est émis.
4. Effectuez un véritable ajout au panier réussi et examinez l’événement.
5. Pour S2S, vérifiez un véritable achat autorisé attribué à une publicité. Examinez son reçu, le résultat en file, l’exécution cron et les rapports Outbrain.

Si le pixel navigateur est absent, vérifiez l’interrupteur d’activation, les Marketer ID, le consentement, la politique relative aux employés, la politique des transmissions sortantes, les balises en double et les blocages du navigateur. Si les achats S2S sont absents, vérifiez l’attribution des clics et le consentement enregistré de l’acheteur. N’attendez pas de repli vers l’achat navigateur lorsque S2S est activé. Avant de réinitialiser les lignes échouées, vérifiez si l’envoi est parvenu à Outbrain, car un postback répété peut compter l’achat deux fois.

Si une règle personnalisée échoue, validez le nom exact de l’événement et le JSON. Utilisez des conditions sur le chemin pour les déclencheurs d’URL. Pour les événements personnalisés serveur, examinez le reçu émis par le serveur et sa liaison plutôt que de fournir un reçu inventé depuis JavaScript.

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

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 lorsque le dernier utilisateur est retiré. Exportez les diagnostics nécessaires avant la désinstallation. Ne supposez pas que la désinstallation supprime les événements déjà envoyés à la plateforme publicitaire ou efface toutes les données d’attribution du navigateur.

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