Taboola Pixel + S2S Postback — Dokumentation

Verfolgen Sie Besuche aus Taboola Realize und E-Commerce-Aktionen in Ihrem PrestaShop-Shop. Das Modul fügt den Taboola Browser-Pixel hinzu, unterstützt optionale Server-to-Server-Postbacks und ermöglicht Ihnen, eigene Conversion-Events für Shop-Interaktionen anzulegen, die für Ihre Kampagnen wichtig sind.

Kompatibilität

Kompatibel mit PrestaShop 1.6 bis 9.0 (latest) und PHP 7.1+. Wir unterstützen auch weiterhin kommende PrestaShop-Versionen.

Einrichtung

1. Installieren Sie das Modul und öffnen Sie Modules -> Taboola Pixel -> Configure.
2. Fügen Sie Ihre numerische Taboola Account ID aus Taboola Realize ein.
3. Aktivieren Sie Taboola Pixel.
4. Wählen Sie aus, welche E-Commerce-Events ausgelöst werden sollen.
5. Optional: Aktivieren Sie S2S postback events, wenn Ihre Taboola-Kampagnen eine Click-ID übergeben.
6. Optional: Fügen Sie eigene Event-Regeln für Klicks, URLs, Controller oder JavaScript-Events hinzu.

Die Account ID muss numerisch sein:

ACCOUNT_ID=1234567

Das Modul wird mit diesen Standard-Eventnamen installiert:

product_view
collection_view
add_to_cart
start_checkout
make_purchase
search_submitted
add_to_wish_list
complete_registration

Haupteinstellungen

Die Konfigurationsseite enthält diese Händler-Einstellungen:

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

Sinnvolle Standardwerte:

• Mitarbeiter ausschließen: verhindert Front-Office-Tracking, während ein angemeldeter Back-Office-Mitarbeiter surft.
• Cookie-Einwilligung respektieren: wartet auf Marketing-Einwilligung, wenn mprcookiesrevolution oder mprcookiebanner aktiv ist.
• Queue-Batch-Limit: verarbeitet standardmäßig bis zu 20 wartende S2S-Events pro Durchlauf. Der zulässige Bereich liegt bei 1 bis 1000.

Events

Integrierte Browser-Events sind:

• Seitenaufruf: page_view
• Produktansicht: product_view
• Kategorie- oder Kollektionsansicht: collection_view
• In den Warenkorb legen: add_to_cart
• Checkout starten: start_checkout
• Kauf: make_purchase
• Suche: search_submitted
• Zur Wunschliste hinzufügen: add_to_wish_list
• Kundenregistrierung: complete_registration

Das Kauf-Tracking nutzt die Bestellbestätigungsseite und sendet, sofern verfügbar, Bestellwerte wie Umsatz, Währung, Menge und Bestell-ID.

Server-To-Server Postbacks

S2S-Postbacks sind optional. Das Browser-Pixel-Tracking kann auch ohne sie laufen.

Für die S2S-Attribution müssen Taboola-Kampagnen-Landing-URLs einen dieser Click-ID-Parameter enthalten:

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

Das Front-Script speichert die Click-ID für die spätere Attribution in diesen Cookies:

mprtbpx_tblci
taboola_click_id

S2S-Postbacks werden über diesen Endpunkt an Taboola gesendet:

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

Die Postback-Abfrage kann Folgendes enthalten:

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

Das Feld Test tblci akzeptiert Buchstaben, Zahlen, Punkte, Unterstriche, Doppelpunkte und Bindestriche:

S2S_TEST_CLICK_ID=abc.DEF_123-456:789

Eigene Events

Aktivieren Sie Track custom events, wenn Sie zusätzliche Conversion-Punkte senden möchten, zum Beispiel Galerie-Nutzung, Lead-Buttons, Klicks auf den Filialfinder oder Landingpage-Besuche.

Eigene Event-Regeln verwenden JSON. Unterstützte Trigger sind:

click
url
controller
event

Beispiel für eine Klick-Regel:

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

Beispiel für eine URL-Regel:

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

Beispiel für eine Controller-Regel:

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

Beispiel für eine JavaScript-Event-Regel:

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

Ein Theme oder ein kleines eigenes Script kann dann das DOM-Event auslösen:

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

Bei Klick-Regeln kann das Modul außerdem Parameter aus angeklickten Elementen auslesen:

<a href="/contact"
   class="taboola-lead-button"
   data-taboola-param-property="lead_button"
   data-mprtbpx-param-location="product_page">
  Contact us
</a>

Diagnose

Die Konfigurationsseite zeigt Bereitschaftsprüfungen für:

• Taboola Account ID
• Browser-Tracking
• Name des Kauf-Events
• S2S-Postback-Status
• Eigene Event-Regeln
• tblci-Erfassung
• Queue-Tabelle

Außerdem werden S2S-Queue-Zähler angezeigt:

pending
sending
sent
failed

Sie können Send S2S probe verwenden, nachdem Sie eine echte tblci hinzugefügt haben, und Retry failed events, um fehlgeschlagene Postbacks wieder in die wartende Queue zu verschieben.

Technische Hinweise für Shop-Betreiber

Das Modul registriert diese PrestaShop-Hooks:

displayHeader
displayOrderConfirmation
actionValidateOrder
actionCustomerAccountAdd

Eine geplante Aufgabe verarbeitet wartende Taboola-Conversions:

send_taboola_conversions
schedule: every:300
timeout: 30

Normalerweise müssen Sie diese Werte nicht bearbeiten. Sie sind hier aufgeführt, damit Ihr Entwickler oder Hosting-Team schnell prüfen kann, ob das Modul installiert ist und an den erwarteten Stellen ausgeführt wird.