Reddit, Pixel und Conversions API

Server-Side-Conversion-Tracking via Reddit Conversions API. Reddit-Pixel-ID kombiniert mit Conversion-Access-Token. Optional Hybrid-Modus mit Browser-Reddit-Pixel für First-Party-Cookies, dedupliziert über conversionId.

Voraussetzungen

• Reddit-Ads-Manager-Account mit Admin-Rolle auf dem Ad-Account.
• Existierender Reddit-Pixel an deiner Domain.
• Etwa 5 Minuten.

1. Reddit-Pixel-ID finden

• Reddit Ads Manager öffnen (ads.reddit.com).
• Events Manager → Pixel.
• Reddit-Pixel für diese Domain auswählen. Falls keiner existiert, via Neue Event-Quelle hinzufügen → Reddit-Pixel anlegen.
• Pixel-ID (Format a2_abc123def456) steht im Pixel-Header. Inklusive a2_-Prefix kopieren.

2. Conversion-Access-Token generieren

• Auf derselben Pixel-Detail-Seite: Conversions API → Access-Token generieren.
• Reddit liefert einen langlebigen Bearer-Token, scoped auf den Pixel. Im Normalbetrieb läuft er nicht ab, kann aber manuell revoked werden.
• Der Token wird nur EINMAL angezeigt. Sofort kopieren. Es gibt keinen "später-abrufen"-Mechanismus, du müsstest revoken und neu generieren.

3. Credentials in Beaconry eintragen

WordPress-Admin → Beaconry → Tracking → Reddit. Pixel-ID und Access-Token einfügen, speichern.

Der Token wird mit AES-256-GCM verschlüsselt gespeichert (gekoppelt an deine WordPress-Auth-Salts). Konstanten-Variante: BCNR_REDDIT_PIXEL_ID und BCNR_REDDIT_ACCESS_TOKEN in wp-config.php.

4. Test-Event versenden

Klick Reddit-Test-Event senden. Beaconry feuert ein synchrones PageVisit via CAPI und meldet die Antwort inline.

HTTP 200 ohne Fehler heißt: Credentials passen. Das Event taucht in Events Manager → Pixel → Diagnostics innerhalb von etwa 10 Minuten auf. Reddit hat keine Echtzeit-Test-Ansicht wie Metas Test Events, der Diagnostics-Tab ist die Stelle, die du beobachtest.

Über Reddits Click-ID

Reddit hängt ?rdt_cid=... (die Reddit Click ID) an jede Ad-Klick-Landing-URL. Beaconry fängt sie beim ersten Page-Load und persistiert sie im nl_ext-Cookie. Server-Side-Events tragen dann die Click-ID für saubere Attribution. Ohne erfasste rdt_cid fällt Reddit auf gehashte PII plus IP und User-Agent zurück.

Hybrid-Modus, Reddit Pixel

Server-Side-CAPI allein deckt 100 Prozent der zustimmenden Besucher. Hybrid-Modus lädt den Browser-Reddit-Pixel (www.redditstatic.com/ads/pixel.js) parallel, damit Reddit die First-Party-Cookies des Besuchers sieht. Beaconry sendet dieselbe conversionId von beiden Seiten, Reddit dedupliziert gegen Doppel-Counting.

Aktivieren in Beaconry → Tracking → Reddit → Hybrid-Modus. Bessere Match-Rate, etwas mehr Bytes für den Besucher. Standardmäßig aus.

Was automatisch versendet wird

Beaconry mappt GA4-kanonische Events auf Reddits Standard-Event-Vokabular:

Alle Payloads tragen gehashte PII (em, ph, externalId), die erfasste rdt_cid sobald verfügbar, plus IP und User-Agent.

Troubleshooting

• "401 Unauthorized": Token revoked oder unter einem anderen Pixel generiert. Auf der Pixel-Detail-Seite neu generieren und in Beaconry austauschen.
• "400 invalid_event_name": ein Custom-Event-Name wurde gesendet, der nicht zu Reddits Standard-Vokabular gehört. Beaconry sendet nur Standard-Namen aus der Tabelle oben. Custom NLData.track()-Events mit Nicht-Standard-Namen werden auf Custom gemappt mit dem Original-Namen in customEventName.
• Diagnostics-Tab zeigt "matched: false": die PII des Besuchers konnte nicht gematcht werden. Beaconry sendet gehashte E-Mail und Telefon, sobald WooCommerce oder ein Formular sie liefert. Anonyme PageVisits ohne Click-ID und ohne PII können nicht attribuiert werden, das ist erwartet.
• Counter springt nach Aktivieren des Hybrid-Modus: Dedup-Mismatch auf conversionId. Prüfen, dass dieselbe ID in Beaconry und im Reddit-Pixel-Debugger für dieselbe Session geloggt ist.