AdRoll Pixel-Integration: Einrichtung und Hilfe

1. Laden Sie die ZIP unter Modul > "Module Manager" hoch, installieren Sie sie und öffnen Sie anschließend AdRoll Pixel Integration > "Configure".
2. Geben Sie "Advertiser ID" aus adroll_adv_id und Pixel-ID aus adroll_pix_id ein.
3. Prüfen Sie "Track pageView", "Track productView" und die übrigen Ereigniseinstellungen.
4. Setzen Sie "Enable AdRoll Pixel" auf Ja und klicken Sie auf Speichern.
5. Prüfen Sie unter AdRoll-Tracking-Bereitschaft, ob die IDs gültig sind und die Tracking-Zuständigkeit geklärt ist.
6. Erteilen Sie in einem Besucherbrowser die Marketingeinwilligung und öffnen Sie eine Produktseite.
7. Prüfen Sie, ob roundtrip.js geladen und das Ereignis productView in der Browser- oder AdRoll-Diagnose ausgegeben wird.

Alle Optionen werden unter Modul -> AdRoll Pixel -> "Configure" eingestellt.

• "Enable AdRoll Pixel" (ENABLED). Schaltet das Browser-Tracking ein oder aus; Standard: 0.
• "Advertiser ID" (ADV_ID). Speichert den Wert aus adroll_adv_id in Ihrem AdRoll-Pixelcode; Standard: empty.
• Pixel-ID (PIX_ID). Speichert den Wert aus adroll_pix_id in Ihrem AdRoll-Pixelcode; Standard: empty.
• "Exclude employee browsing" (EXCLUDE_EMPLOYEES). Verhindert Tracking, während ein angemeldeter Back-Office-Mitarbeiter den Shop besucht; Standard: 1.
• "Track pageView" (TRACK_PAGE_VIEW). Sendet ein allgemeines Seitenaufrufereignis auf erfassten Shop-Seiten; Standard: 1.
• "Track productView" (TRACK_PRODUCT_VIEW). Sendet Produktseitenaufrufe mit Produktdaten, wenn das aktuelle Produkt erkannt werden kann; Standard: 1.
• "Track addToCart" (TRACK_ADD_CART). Sendet Warenkorbzugänge, die anhand bestätigter erfolgreicher Warenkorbantworten und Mengenerhöhungen erkannt werden; Standard: 1.
• "Track addToWishlist" (TRACK_ADD_WISHLIST). Sendet Zugänge zur Wunschliste, die anhand bestätigter erfolgreicher Wunschlistensignale erkannt werden; Standard: 1.
• "Track initiateCheckout" (TRACK_INITIATE_CHECKOUT). Sendet Ereignisse zum Beginn des Bestellvorgangs auf erkannten Einstiegsseiten mit gültigem Warenkorb; Standard: 1.
• "Track search" (TRACK_SEARCH). Sendet Suchereignisse, wenn eine Suchanfrage aus s, search_query oder q verfügbar ist; Standard: 1.
• "Track purchase" (TRACK_PURCHASE). Sendet Kaufereignisse über den Hook displayOrderConfirmation mit Bestellkontext; Standard: 1.
• "Track signUp" (TRACK_SIGNUP). Sendet nach Erstellung eines Kundenkontos ein Registrierungsereignis; Standard: 1.
• "Track custom events" (TRACK_CUSTOM_EVENTS). Aktiviert Ihre benutzerdefinierten Browser-Ereignisregeln; Standard: 0.
• Regeln für benutzerdefinierte Events (CUSTOM_EVENTS). Speichert das JSON-Array für benutzerdefiniertes Tracking von Klicks, URLs, Controllern oder DOM-Ereignissen; Standard: empty.

Klicken Sie auf Speichern. "Advertiser ID" und Pixel-ID akzeptieren jeweils 4 bis 128 Buchstaben, Zahlen, Unterstriche oder Bindestriche. Kopieren Sie die Werte aus adroll_adv_id und adroll_pix_id Ihrer tatsächlichen AdRoll-Pixeleinrichtung. Das aktuelle Formular bietet "Respect marketing consent" nicht mehr an; die Marketingeinwilligung ist immer erforderlich.

Das aktuelle Formular bietet außerdem diese Einstellungen. Alle Signalschalter stehen standardmäßig auf Nein. Aktivieren Sie nur die Aktionen, die Sie beobachten möchten.

Die gemeinsamen Schwellenwerte sind drei Galerieansichten, ein Variantenwechsel, ein Detailklick, 45 Sekunden Verweildauer und eine Optionsdrosselung von 1500 ms. Galerie-, Varianten- und Detailanzahlen sind auf 1 bis 20 begrenzt. Die Verweildauer ist auf 5 bis 600 Sekunden begrenzt. Die Drosselung ist auf 250 bis 60000 ms begrenzt. Beispiel:

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

Sie können außerdem gallery_selectors, variant_selectors und detail_selectors angeben. Behalten Sie die Standardwerte bei, sofern Ihr Theme keine anderen Selektoren benötigt. Diese optionalen Signale erfordern wie Commerce-Ereignisse Prüfungen von Einwilligung, Mitarbeiterrichtlinie und Tracking-Zuständigkeit.

"Phone target", "Chat target", "Form target" und "Engagement target" sind vom AdRoll-Konto vergebene Segmentkennungen. Verwenden Sie die genaue Segmentkennung statt einer beschreibenden Bezeichnung. Diese Signale verwenden Aufrufe zur Zielgruppenzugehörigkeit und erfinden keine Lead- oder Kaufwerte.

Lassen Sie den Mitarbeiterausschluss während der ersten Einrichtung aktiviert. Das Modul setzt die Marketingeinwilligung automatisch voraus. Testen Sie mit einem normalen Besucherbrowser, der nicht als Mitarbeiter markiert ist. Eine angemeldete Back-Office-Sitzung, eine Regel für internen Datenverkehr oder ein Widerspruch des Besuchers kann das Tracking unterdrücken.

Die gemeinsame Einwilligungsschicht unterstützt MPR-Einwilligungsintegrationen und weitere CMP-Adapter. Sie muss eine verwendbare Marketingentscheidung für das Ziel erhalten. Eine unbekannte, veraltete oder abgelehnte Entscheidung kann Ereignisse zurückhalten. Das Modul stellt kein Cookie-Banner bereit. Eine ältere Einwilligungspräferenz setzt eine aktuelle Ablehnung eines erkannten CMP nicht außer Kraft.

Das Modul muss im gemeinsamen Tracking-Koordinator für das konfigurierte Ziel zuständig sein. Eine fehlende, mehrdeutige oder widersprüchliche Zuständigkeit kann Browser- und Serverübermittlungen zurückhalten. Entfernen Sie doppelte Theme-Tags oder klären Sie die Zuständigkeit, wenn ein anderes MPR-Modul dasselbe Konto verwaltet.

Der Versand im Produktivbetrieb folgt außerdem der Richtlinie für ausgehende Übermittlungen. Ein in Demo oder Vorschau angezeigtes Ereignis wird nicht unbedingt an Ihr Werbekonto übermittelt. Käufe und serverseitige Formularereignisse werden nur mit der Einwilligung gesendet, die der Käufer damals gegeben hat; ein späterer Cron-Lauf kann diese Einwilligung nicht ersetzen.

Das Modul lädt https://s.adroll.com/j/roundtrip.js nach den Prüfungen von Einwilligung, Mitarbeiterstatus, Zielzuständigkeit und ausgehenden Übertragungen. Es verknüpft das SDK mit der konfigurierten "Advertiser ID" und Pixel-ID. Eine unbekannte bereits vorhandene AdRoll-Warteschlange oder ein Loader kann die Übermittlung zurückhalten.

Die aktivierte Ereignismenge umfasst pageView, productView, addToCart, addToWishlist, initiateCheckout, search, signUp und purchase. Produkt- und Warenkorbdaten können, sofern verfügbar, Produkt- und Varianten-IDs, Namen, Kategorien, Währung und Inhalts-IDs enthalten. Kaufdaten können Bestellreferenz, conversion_value, Währung, Artikelanzahl und Produktzeilen enthalten.

Das Modul verwendet displayHeader, displayOrderConfirmation, actionCustomerAccountAdd, displayFooter, Käuferinitialisierung und Hooks für Mitarbeitermarkierungen. Die Registrierung wird bei der Kontoerstellung markiert und beim nächsten zulässigen Seitenaufruf in der eigenen Sitzung des Besuchers gesendet. Automatische Warenkorb- und Wunschlistenereignisse werden erst gesendet, wenn der Shop einen erfolgreichen Vorgang meldet, nicht bei einem einfachen Klick auf eine Schaltfläche.

Das Modul sendet Ereignisse mit adroll.track. Käufe werden nur im Browser übertragen. Es gibt weder ein öffentliches Servertoken noch einen Hintergrunddienst für Serverereignisse oder eine serverseitige Formularübermittlung. Das Modul fügt kein sichtbares Shop-Widget hinzu. Ein Demo-Monitor zeigt eine Vorschau; prüfen Sie den Eingang echter Ereignisse in AdRoll.

Aktivieren Sie "Track custom events", fügen Sie ein JSON-Array in Regeln für benutzerdefinierte Events ein und speichern Sie. Passen Sie Selektoren und Pfade an Ihren Shop an. Verwenden Sie die Auslöser click, url, controller oder event. Eine Controller-Regel kann auch eine Liste modules enthalten. Ereignisnamen erlauben Buchstaben, Zahlen, Unterstriche und Bindestriche mit bis zu 64 Zeichen. Das Limit beträgt 15 unterschiedliche Namen. once begrenzt eine Regel innerhalb ihrer aktuellen Seitenlaufzeit.

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

Lösen Sie die DOM-Regel nach der Tracking-Initialisierung über Ihr Theme aus:

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

Ersetzen Sie ACCOUNT_ISSUED_SEGMENT_ID durch die tatsächliche Segment-ID, wenn Ihre Event-JS-Match-Zielgruppe eine benötigt. Andere Regeln können einen unterstützten benutzerdefinierten Ereignisnamen ohne Segment verwenden. Um eine zielgruppenbezogene pageView-Regel zu senden, ist ein gültiges params.segment_name erforderlich.

Reservierte Commerce-Ereignisse wie purchase, addToCart, productView, initiateCheckout, addToWishlist, search, productSearch und signUp werden als benutzerdefinierte Regeln abgelehnt. Verwenden Sie stattdessen deren eigene Steuerelemente.

Benutzerdefinierte params akzeptieren segment_name, property, product_id und product_category, jeweils auf 128 Zeichen begrenzt. Segment-IDs akzeptieren Buchstaben, Zahlen, Unterstriche und Bindestriche. Belassen Sie diese Werte in der JSON-Regel. Die aktuelle Laufzeit liest keine beliebigen Klick-Datenattribute und führt DOM-detail.params nicht zusammen.

URL-Regeln prüfen die vollständige URL; eine Bedingung wie utm_campaign=adroll wird daher unterstützt. Um eine Controller-Regel auf ein Front-Modul zu beschränken, verwenden Sie controllers: ["order"] und modules: ["ps_checkout"] nur, wenn diese Werte Ihrem tatsächlichen Seitenkontext entsprechen.

1. Speichern Sie beide IDs und prüfen Sie AdRoll-Tracking-Bereitschaft, Hinweise zur erforderlichen Konfiguration und das Integritätsbanner.
2. Verwenden Sie einen Besucherbrowser ohne Mitarbeitermarkierungen und erteilen Sie die Marketingeinwilligung.
3. Öffnen Sie ein Produkt und prüfen Sie, ob das AdRoll-SDK geladen und productView ausgegeben wird.
4. Fügen Sie ein Produkt erfolgreich hinzu und prüfen Sie addToCart.
5. Schließen Sie eine autorisierte Testbestellung ab und prüfen Sie Kaufwert, Währung und Referenz in der Browser- und AdRoll-Diagnose. Sie können PixelPal verwenden, sofern es in Ihrer Testumgebung verfügbar ist.

Wird kein Skript geladen, prüfen Sie Hauptschalter, IDs, Einwilligungsentscheidung, Richtlinie für internen Datenverkehr, Zuständigkeit, Richtlinie für ausgehende Übertragungen, doppelte AdRoll-Snippets und Browserblockierung. Scheitern benutzerdefinierte Regeln, prüfen Sie Selektor, JSON, reservierte Ereignisnamen und die echte Segmentkennung. Fehlen Kontaktsignale, prüfen Sie, ob ein unterstützter Chatstart oder Beleg eines erfolgreichen Formulars vorliegt. Ein Klick allein reicht für diese Signale nicht aus.

Deaktivieren Sie "Enable AdRoll Pixel" und speichern Sie, um die Ausgabe zu stoppen und die Einstellungen zu behalten. Deinstallieren Sie über "Module Manager", um Modulmenü und Konfigurationseinträge zu entfernen. Die Deinstallationsmethode entfernt keine bereits von AdRoll empfangenen Ereignisse und leert nicht den gesamten SDK-Browserspeicher.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.