Snapchat, Snap Pixel und Conversions API

Server-Side-Conversion-Tracking für Snapchat Ads. Snap-Pixel-ID kombiniert mit Conversions-API-Token. Optional Hybrid-Modus, der den Browser-Snap-Pixel parallel lädt für First-Party-Cookies. Dedupliziert über event_id im 48-Stunden-Fenster von Snapchat.

Voraussetzungen

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

1. Snap-Pixel-ID finden

• Snapchat Ads Manager öffnen (ads.snapchat.com).
• Events Manager → Web Events.
• Snap-Pixel für diese Domain auswählen. Falls keiner existiert, via + Neuer Pixel anlegen.
• Pixel-ID (UUID-Format, 36 Zeichen mit Bindestrichen) steht im Pixel-Header. Kopieren.

2. Langlebigen CAPI-Token generieren

• Auf derselben Pixel-Detail-Seite: Einstellungen → Conversions API → Token generieren.
• Snapchat liefert einen langlebigen Token, scoped auf den Pixel mit dem snapchat-marketing-api-Claim. 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 → Snapchat. Snap-Pixel-ID und CAPI-Token einfügen, speichern.

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

4. (Optional) Test-Event-Code setzen

Snapchats CAPI akzeptiert ein test_event_code-Feld pro Event. In Events Manager → Test-Events den SC_TEST_*-Code für deinen Pixel kopieren. In Beaconry einfügen. Solange gesetzt, landen alle Events in Test-Events statt live zu gehen. Code vor dem Kampagnen-Start entfernen.

5. Test-Event versenden

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

HTTP 200 mit "status": "SUCCESS" heißt: Credentials passen. Mit Test-Event-Code landet das Event innerhalb von Sekunden in Events Manager → Test-Events. Ohne Code aggregiert Snapchat mit bis zu 30 Minuten Latenz, bevor das Event im Reporting auftaucht.

Über die Click-ID

Snapchat hängt ?sc_at=... (die Snap Click ID) an jede Ad-Klick-Landing-URL. Beaconry fängt sie beim ersten Page-Load und persistiert sie im nl_ext-Cookie neben fbclid, gclid, ttclid und msclkid. Jedes Server-Side-Event trägt dann click_id für saubere Attribution. Ohne sc_at auf der Session fällt Snapchat auf gehashte PII zurück (E-Mail, Telefon), das funktioniert weiterhin, aber mit niedrigerer Confidence.

Hybrid-Modus, Snap Pixel

Server-Side-CAPI allein deckt 100 Prozent der zustimmenden Besucher. Hybrid-Modus lädt den Browser-Snap-Pixel (sc-static.net/scevent.min.js) parallel, damit Snapchat das First-Party-_scid-Cookie sieht. Beaconry sendet dieselbe Per-Event-event_id von beiden Seiten. Snapchat dedupliziert gegen Doppel-Counting innerhalb eines 48-Stunden-Fensters.

Aktivieren in Beaconry → Tracking → Snapchat → 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 Snapchats Standard-Event-Vokabular:

Alle Payloads tragen gehashte PII (em, ph, ge, age, fn, ln, ct, st, zp, country) plus First-Party-Identifier (_scid sobald verfügbar, IP und User-Agent).

Troubleshooting

• "AUTHORIZATION_FAILED": Token revoked oder unter einem anderen Pixel generiert. Auf der Pixel-Settings-Seite neu generieren und in Beaconry austauschen.
• "INVALID_PIXEL_ID": Pixel-ID hat die UUID-Bindestriche verloren. Snap akzeptiert nur das kanonische UUID-Format. Aus Events Manager neu kopieren, mit Bindestrichen einfügen.
• Events angenommen, aber keine Attribution: Besucher kam ohne ?sc_at=.... Direkte Besuche haben keine. Snapchats PII-Fallback braucht gehashte E-Mail oder Telefonnummer im Event, die Beaconry automatisch sendet, sobald WooCommerce oder ein Formular sie liefert.
• Counter springt nach Aktivieren des Hybrid-Modus: Dedup läuft über ein 48-Stunden-Fenster pro event_id. Prüfen, dass dieselbe ID in Beaconry und im Snap-Pixel-Debugger für dieselbe Session geloggt ist.