Reddit Pixel-Integration: Einrichtung und Hilfe

Folgen Sie den Schritten im Schnellstart.

Legen Sie diese Werte unter Module -> Reddit Pixel -> "Configure" fest.

• "Enable Reddit Pixel". Schaltet das Pixel-Tracking im Browser ein oder aus; Standard: 0.

• Pixel ID. Speichert Ihre Reddit-Pixel-ID aus "Reddit Ads Manager" -> "Events Manager"; Standard: "". Sie muss 4 bis 128 Zeichen enthalten, ausschließlich Buchstaben, Zahlen, Unterstriche und Bindestriche.

• "Exclude employee browsing". Stoppt das Tracking, wenn ein im Backoffice angemeldeter Mitarbeiter den Shop besucht; Standard: 1.

• "Respect marketing consent". Lädt das Reddit-Tracking erst nach Marketingeinwilligung, wenn mprcookiesrevolution oder mprcookiebanner aktiv ist; Standard: 1.

• "Track PageVisit". Sendet ein allgemeines Seitenbesuchsereignis auf erfassten Shopseiten; Standard: 1.

• "Track ViewContent". Sendet Produktansichtsereignisse auf Produktseiten, wenn Produktdaten verfügbar sind; Standard: 1.

• "Track AddToCart". Sendet Warenkorb-Hinzufügungsereignisse nach bestätigter erfolgreicher Mengenerhöhung; Standard: 1.

• "Track AddToWishlist". Sendet Wunschlisten-Hinzufügungsereignisse anhand bestätigter erfolgreicher Hinzufügungen zur Wunschliste; Standard: 1.

• "Track InitiateCheckout". Sendet den Checkout-Einstieg als benutzerdefiniertes Reddit-Ereignis namens InitiateCheckout; Standard: 1.

• "Track Search". Sendet Suchereignisse auf suchbezogenen Seiten, wenn eine Suchanfrage vorhanden ist; Standard: 1.

• "Track Purchase". Sendet Kaufereignisse bei der Bestellbestätigung mit Bestellwert, Währung, Produkten, Transaktions-ID und Conversion-ID; Standard: 1.

• "Track SignUp". Sendet ein Registrierungsereignis beim nächsten Laden einer Seite nach der Erstellung eines Kundenkontos; Standard: 1.

• "Track custom events". Aktiviert Ihre benutzerdefinierten JSON-Ereignisregeln für das Pixel-Tracking im Browser; Standard: 0.

• Benutzerdefinierte Ereignisregeln. Speichert das JSON-Array für Klick-, URL-, Controller- und DOM-Ereignisregeln; Standard: "".

• "Enable Conversions API events". Stellt zulässige Ereignisse serverseitig in die Warteschlange und sendet sie mit übereinstimmenden Conversion-IDs an Reddit, soweit der Transport diese unterstützt; Standard: 0.

• Conversions-API-Access-Token. Speichert das in "Reddit Ads Manager" -> "Events Manager" erzeugte Reddit-Conversions-API-Token; Standard: "".

• "Events testing ID". Aktiviert bei ausgefülltem Feld den Reddit-Testmodus für CAPI-Nutzdaten; Standard: "".

• "Queue batch limit". Bestimmt die Anzahl verarbeiteter Conversion-Ereignisse aus der Warteschlange pro Durchlauf, von 1 bis 100; Standard: 20.

• "Persist consent withdrawals". Standard: 0. Aktiviert ein dauerhaftes Veto für zuvor angenommene Kauf- und Kontaktformularereignisse. Aktivieren Sie dies, wenn Widerrufe dauerhaft gespeichert werden müssen.

Klicken Sie nach Änderungen am Formular auf Speichern.

Das aktuelle Formular bietet auch 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 Detailzähler 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 auch 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 Handelsereignisse Prüfungen von Einwilligung, Mitarbeiterrichtlinie und Tracking-Zuständigkeit.

Lassen Sie bei der Ersteinrichtung Einwilligungs- und Mitarbeiterausschlusseinstellungen aktiviert. Testen Sie in einem normalen Besucherbrowser ohne Mitarbeiterkennzeichnung. Eine angemeldete Backoffice-Sitzung, eine Regel für internen Traffic oder ein Besucher-Opt-out kann das Tracking unterdrücken.

Die gemeinsame Einwilligungsschicht unterstützt MPR-Einwilligungsintegrationen und zusätzliche CMP-Adapter. Sie muss eine nutzbare Marketingentscheidung für das Ziel erhalten. Eine unbekannte, veraltete oder ablehnende Entscheidung kann Ereignisse zurückhalten. Das Modul stellt kein Cookie-Banner bereit. Eine alte Einwilligungspräferenz überstimmt keine aktuelle Ablehnung einer erkannten CMP.

Das Modul muss im gemeinsamen Tracking-Koordinator für das konfigurierte Ziel zuständig sein. Fehlende, mehrdeutige oder widersprüchliche Zuständigkeit kann Browser- und Serverzustellung 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.

Der Header Ihres Shops stellt eine cacheverträgliche Konfiguration bereit. Das Modul lädt https://www.redditstatic.com/ads/pixel.js nach erfolgreichen Prüfungen. Es erscheint kein gewöhnliches Shop-Widget. Das Modul unterstützt displayHeader, displayOrderConfirmation, actionValidateOrder, actionCustomerAccountAdd, displayFooter und displayBeforeBodyClosingTag.

Bei aktivierten Schaltern senden Seitenbesuche PageVisit, Produktseiten ViewContent und Suchseiten Search; bestätigte Warenkorb- und Wunschlisten-Hinzufügungen senden die zugehörigen Ereignisse. Der Checkout-Einstieg sendet Reddit Custom mit customEventName=InitiateCheckout. Die Kontoerstellung wird für SignUp beim nächsten zulässigen Seitenladen vorgemerkt.

Käufe enthalten die verfügbaren Bestellartikel, Mengen, den Wert, die Währung, Transaktions-ID und Conversion-ID. Server- und Browserkäufe verwenden dieselbe Kaufidentität, soweit verfügbar. Warenkorb- und Wunschlistenaktionen benötigen die Bestätigung einer tatsächlichen Hinzufügung; ein Browserereignis allein reicht nicht aus.

Serverereignisse gehen mit der konfigurierten Pixel ID an den Reddit-Endpunkt https://ads-api.reddit.com/api/v2.0/conversions/events/PIXEL_ID. Welche Abgleichsdaten gesendet werden, hängt von der ursprünglichen Attribution und Einwilligung des Besuchers ab. Browser- und Serverkopie teilen sich zur Deduplizierung eine Ereignis-ID, wenn beide gesendet werden, aber nicht jedes Ereignis wird über beide Wege gesendet.

Aktivieren Sie "Track custom events", fügen Sie ein JSON-Array in Benutzerdefinierte Ereignisregeln ein und speichern Sie. Passen Sie Selektoren und Pfade an Ihren Shop an. Verwenden Sie die Auslöser click, url, controller oder event. Eine Controllerregel kann auch eine modules-Liste enthalten. Ereignisnamen erlauben bis zu 64 Buchstaben, Zahlen, Unterstriche und Bindestriche. Maximal sind 15 verschiedene Namen zulässig. once begrenzt eine Regel innerhalb der aktuellen Seitenlaufzeit.

[
  {
    "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
  }
]

Lösen Sie die DOM-Regel nach der Tracking-Initialisierung aus Ihrem Theme aus:

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

Das capi-Flag jeder Regel sendet eine Serverkopie über die benutzerdefinierte Brücke. Die Brücke akzeptiert Custom mit customEventName, prüft, ob die Regel konfiguriert ist, und benötigt eine Ereignis-ID sowie die aktuelle Einwilligung des Besuchers. Fehlt eine dieser Voraussetzungen, wird das Ereignis zurückgehalten.

Bei der Klickregel können unterstützte Datenattribute value, currency, num_items und event_id überschreiben, zum Beispiel:

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

Verwenden Sie in Ihrer Regel einen passenden Klickselektor. Das ältere Attributbeispiel mit product_id und product_category wird von der aktuellen Laufzeit nicht verarbeitet. Ein DOM-Ereignis kann unterstützte Handelswerte in detail.params übergeben. Statische beschreibende Parameter gehören in die Regel selbst.

Die Aufgabe send_reddit_conversions ist mit dem Zeitplan every:300 registriert und wird alle fünf Minuten fällig. Ihr gemeinsamer MPR-Cron-Runner muss fällige Aufgaben ausführen; die Zeitplandeklaration allein startet keinen Worker. Das Stapellimit begrenzt die Warteschlangenzeilen je Verarbeitungslauf auf 1 bis 100, standardmäßig 20.

Das Modul enthält keinen eigenständigen Einstiegspunkt cron.php. Verwenden Sie den bereits für Ihren Shop konfigurierten gemeinsamen Scheduler. Bestätigen Sie dort die Aufgabenausführung und prüfen Sie Zeitstempel und Status der Warteschlange auf der Konfigurationsseite dieses Moduls.

Die Diagnose umfasst Bereitschaftsprüfungen, Warteschlangenzähler, aktuelle Zeilen, API-Probe senden und Fehlgeschlagene Events erneut versuchen. Beheben Sie die Fehlerursache vor dem Wiederholen. Das Zurücksetzen fehlgeschlagener Zeilen auf ausstehend umgeht keine aktuellen Prüfungen von Einwilligung, Mitarbeiterrichtlinie, Kontozuständigkeit oder Ziel.

Geben Sie für API-Probe senden eine "Events testing ID" an und sorgen Sie für ein echtes ausstehendes Ereignis eines Käufers, der eingewilligt hat. Ohne Test-ID, aktuelle Einwilligung oder ein nutzbares Ereignis in der Warteschlange wird die Probe abgelehnt; sie erzeugt nie einen fiktiven Kauf. Leeren Sie "Events testing ID", sobald Sie für Produktionsereignisse bereit sind.

1. Prüfen Sie Hinweise auf erforderliche Konfiguration, Tracking-Zuständigkeit und Integritätsbanner.
2. Verwenden Sie einen normalen Besucherbrowser und erteilen Sie die Marketingeinwilligung über Ihre konfigurierte CMP.
3. Öffnen Sie ein Produkt, führen Sie eine Suche durch und fügen Sie erfolgreich einen Artikel zum Warenkorb hinzu. Prüfen Sie das Laden des SDK und die entsprechenden Ereignisanfragen im Netzwerkbereich des Browsers.
4. Prüfen Sie die Reddit-Ereignisdiagnose oder Pixel Helper, sofern in Ihrer Testumgebung verfügbar.
5. Verwenden Sie für Käufe einen autorisierten Testablauf und prüfen Sie Browserereignis, Conversion-ID und Warteschlangenzeile.
6. Führen Sie für die Serverzustellung den konfigurierten Scheduler aus und prüfen Sie das Warteschlangenergebnis. Ein von Ihrem Shop angenommener Browseraufruf hat Reddit nicht unbedingt erreicht.

Wenn kein Skript lädt, prüfen Sie "Enable Reddit Pixel", Syntax der Pixel ID, Einwilligungsstatus, Mitarbeitermarkierungen, Zuständigkeit, Richtlinie für ausgehende Übertragungen und Skriptblocker. Fehlen Warenkorb- oder Wunschlistenereignisse, prüfen Sie Erfolgssignale und Produktdaten. Ein Klick allein reicht nicht. Nutzen Sie eigene Regeln für gesonderte Interaktionen, ohne einen Klick als nachgewiesenen Kauf oder tatsächliche Warenkorb-Hinzufügung zu deklarieren.

Wenn CAPI-Zeilen fehlschlagen oder zurückgehalten bleiben, prüfen Sie Token, Pixel-Ziel, gespeicherte Einwilligung, Warteschlangenschema und Cron-Ausführung. Eigene Regeln erfordern gültiges JSON und gültige Selektoren. Diese Version stellt den früheren Helfer window.mprredditTrack nicht bereit.

Schalten Sie Browser- und Serverschalter aus und speichern Sie, um das Tracking bei erhaltener Konfiguration zu stoppen. Deinstallieren Sie das Modul im "Module Manager", um Einstellungen, Menüeinträge und registrierte Aufgaben zu entfernen.

Die Deinstallation ruft die gemeinsame Conversion-Warteschlangenbereinigung auf. Die gemeinsame Tabelle bleibt erhalten, solange ein anderes Conversion-Modul sie verwendet, und kann nach Entfernen des letzten Nutzers gelöscht werden. Exportieren Sie benötigte Diagnosedaten vor der Deinstallation. Gehen Sie nicht davon aus, dass sie bereits an die Werbeplattform gesendete Ereignisse entfernt oder den gesamten Attributionsspeicher im Browser leert.

Erfordert PrestaShop 1.6.0.0 oder neuer und PHP 7.1 oder neuer.