Toute la documentation

Taboola Pixel + S2S Postback — Documentation

Suivez les visites Taboola Realize et les actions e-commerce de votre boutique PrestaShop. Le module ajoute le Pixel navigateur Taboola, prend en charge les postbacks serveur à serveur en option et vous permet de créer des événements de conversion personnalisés pour les interactions de boutique importantes pour vos campagnes.

Compatibilité

Compatible avec PrestaShop 1.6 à 9.0 (latest) et PHP 7.1+. Nous continuons à prendre en charge les prochaines versions de PrestaShop.

Taboola Pixel + S2S Postback — Taboola pixel monitor Taboola Pixel + S2S Postback — Admin integrity

Configuration

  1. Installez le module et ouvrez Modules -> Taboola Pixel -> Configure.
  2. Collez votre Taboola Account ID numérique depuis Taboola Realize.
  3. Activez Taboola Pixel.
  4. Choisissez les événements e-commerce à déclencher.
  5. Facultatif : activez S2S postback events si vos campagnes Taboola transmettent un identifiant de clic.
  6. Facultatif : ajoutez des règles d’événements personnalisés pour les clics, les URL, les contrôleurs ou les événements JavaScript.

L’Account ID doit être numérique :

ACCOUNT_ID=1234567

Le module est installé avec ces noms d’événements par défaut :

product_view
collection_view
add_to_cart
start_checkout
make_purchase
search_submitted
add_to_wish_list
complete_registration
Taboola Pixel + S2S Postback — Taboola purchase tracking Taboola Pixel + S2S Postback — Admin readiness

Paramètres principaux

La page de configuration comprend ces paramètres marchand :

ENABLED=1
ACCOUNT_ID=1234567
EXCLUDE_EMPLOYEES=1
RESPECT_CONSENT=1
TRACK_PAGEVIEW=1
TRACK_VIEWCONTENT=1
TRACK_VIEWCATEGORY=1
TRACK_ADDTOCART=1
TRACK_STARTCHECKOUT=1
TRACK_PURCHASE=1
TRACK_SEARCH=1
TRACK_ADDTOWISHLIST=1
TRACK_SIGNUP=1
S2S_ENABLED=0
S2S_BATCH_LIMIT=20

Valeurs par défaut utiles :

  • Exclure les employés : arrête le suivi front-office lorsqu’un employé connecté au back-office navigue sur la boutique.
  • Respecter le consentement aux cookies : attend le consentement marketing lorsque mprcookiesrevolution ou mprcookiebanner est actif.
  • Limite de lot de la file d’attente : traite par défaut jusqu’à 20 événements S2S en attente par exécution. La plage acceptée va de 1 à 1000.
Taboola Pixel + S2S Postback — Admin taboola custom events Taboola Pixel + S2S Postback — Storefront order confirmation

Événements

Les événements navigateur intégrés comprennent :

  • Vue de page : page_view
  • Vue produit : product_view
  • Vue catégorie ou collection : collection_view
  • Ajout au panier : add_to_cart
  • Début du checkout : start_checkout
  • Achat : make_purchase
  • Recherche : search_submitted
  • Ajout à la liste d’envies : add_to_wish_list
  • Inscription client : complete_registration

Le suivi des achats utilise la page de confirmation de commande et envoie, lorsqu’elles sont disponibles, des valeurs de commande comme le chiffre d’affaires, la devise, la quantité et l’ID de commande.

Taboola Pixel + S2S Postback — Taboola click attribution Taboola Pixel + S2S Postback — Storefront view source

Server-To-Server Postbacks

Les postbacks S2S sont facultatifs. Le suivi par Pixel navigateur peut fonctionner sans eux.

Pour l’attribution S2S, les URL de landing page des campagnes Taboola doivent inclure l’un de ces paramètres d’identifiant de clic :

https://www.example.com/product-name?tblci=TABOOLA_CLICK_ID
https://www.example.com/product-name?taboola_click_id=TABOOLA_CLICK_ID

Le script front stocke l’identifiant de clic dans ces cookies pour l’attribution ultérieure :

mprtbpx_tblci
taboola_click_id

Les postbacks S2S sont envoyés à Taboola via cet endpoint :

https://trc.taboola.com/actions-handler/log/3/s2s-action

La requête de postback peut inclure :

click-id=TABOOLA_CLICK_ID
name=make_purchase
revenue=49.90
currency=EUR
quantity=2
orderid=1234

Le champ Test tblci accepte les lettres, les chiffres, les points, les underscores, les deux-points et les tirets :

S2S_TEST_CLICK_ID=abc.DEF_123-456:789
Taboola Pixel + S2S Postback — Admin config custom events

Événements personnalisés

Activez Track custom events lorsque vous souhaitez envoyer des points de conversion supplémentaires, comme la navigation dans une galerie, les boutons de lead, les clics sur le localisateur de boutiques ou les visites de landing pages.

Les règles d’événements personnalisés utilisent JSON. Les déclencheurs pris en charge sont :

click
url
controller
event

Exemple de règle de clic :

[
  {
    "event": "gallery_browse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "s2s": true,
    "once": false
  }
]

Exemple de règle d’URL :

[
  {
    "event": "landing_page_view",
    "trigger": "url",
    "contains": ["/sale", "utm_campaign=taboola"],
    "params": {
      "property": "taboola_landing"
    },
    "s2s": true
  }
]

Exemple de règle de contrôleur :

[
  {
    "event": "contact_page_view",
    "trigger": "controller",
    "controllers": ["contact"],
    "params": {
      "property": "contact"
    },
    "s2s": true
  }
]

Exemple de règle d’événement JavaScript :

[
  {
    "event": "lead",
    "trigger": "event",
    "dom_event": "mprtbpx:custom",
    "params": {
      "property": "lead_form"
    },
    "s2s": true
  }
]

Un thème ou un petit script personnalisé peut ensuite déclencher l’événement DOM :

document.dispatchEvent(new CustomEvent('mprtbpx:custom', {
  detail: {
    params: {
      value: 1,
      currency: 'EUR'
    }
  }
}));

Pour les règles de clic, le module peut aussi lire des paramètres depuis les éléments cliqués :

<a href="/contact"
   class="taboola-lead-button"
   data-taboola-param-property="lead_button"
   data-mprtbpx-param-location="product_page">
  Contact us
</a>
Taboola Pixel + S2S Postback — Admin config events

Diagnostics

La page de configuration affiche des vérifications de disponibilité pour :

  • Taboola Account ID
  • Suivi navigateur
  • Nom de l’événement d’achat
  • Statut du postback S2S
  • Règles d’événements personnalisés
  • Capture de tblci
  • Table de file d’attente

Elle affiche également les compteurs de file d’attente S2S :

pending
sending
sent
failed

Vous pouvez utiliser Send S2S probe après avoir ajouté un vrai tblci, et Retry failed events pour remettre les postbacks échoués dans la file d’attente en attente.

Taboola Pixel + S2S Postback — Admin config pixel

Notes techniques pour les propriétaires de boutique

Le module enregistre ces hooks PrestaShop :

displayHeader
displayOrderConfirmation
actionValidateOrder
actionCustomerAccountAdd

Une tâche planifiée traite les conversions Taboola en file d’attente :

send_taboola_conversions
schedule: every:300
timeout: 30

En général, vous n’avez pas besoin de modifier ces valeurs. Elles sont listées ici afin que votre développeur ou votre équipe d’hébergement puisse confirmer rapidement que le module est installé et fonctionne aux emplacements attendus.

Taboola Pixel + S2S Postback — Admin config s2s
Retour en haut