Snapchat Conversions API
Diese Anleitung erklärt, wie Sie die Conversions API-Ereignisse konfigurieren, die AdTarget an Snapchat sendet, wenn Nutzer Ihrem Telegram-Kanal beitreten.
Wann werden Events gesendet?
AdTarget sendet ein Event an Snapchat nur für attribuierte Beitritte — also Beitritte, bei denen AdTarget den Telegram-Beitritt einem bestimmten Anzeigenklick auf Ihrer Landingpage zuordnen kann. Dafür muss der invite_link im Telegram-Webhook vorhanden sein.
Events werden gesendet, wenn ein Nutzer auf Ihren getrackten Einladungslink klickt und Telegram dies im Webhook meldet (zuverlässig bei privaten Kanälen).
Events werden NICHT gesendet für organische Beitritte — Nutzer, die Ihren Kanal über die Suche, direkte Links oder weitergeleitete Nachrichten finden. Diese Beitritte erscheinen weiterhin in Ihrem AdTarget-Dashboard, werden aber als „organisch” markiert.
Einschränkung bei öffentlichen Kanälen: Aufgrund einer Einschränkung der Telegram-API können selbst Nutzer, die auf Ihren getrackten Link klicken, bei öffentlichen Kanälen als organische Beitritte behandelt werden. Die Telegram-App (insbesondere Android) wandelt Einladungslink-Beitritte bei öffentlichen Kanälen oft in „direkte Beitritte” um und entfernt dabei die Attributionsdaten. Mehr erfahren →
Verfügbare Event-Typen
AdTarget ordnet seine Event-Typen den Standard-Events von Snapchat zu:
| AdTarget-Event | Snapchat-Event | Ideal für | Snapchat-Optimierung |
|---|---|---|---|
| Lead | SIGN_UP | Lead-Generierungs-Kampagnen | Optimiert für Anmeldungen |
| Purchase | PURCHASE | Kauforientierte Kampagnen | Optimiert für Kaufaktionen |
| CompleteRegistration | SIGN_UP | Registrierungsorientierte Kampagnen | Optimiert für Anmeldungen |
| Subscribe | SUBSCRIBE | Abonnement-Kampagnen | Optimiert für Abonnement-Absicht |
| Custom | CUSTOM_EVENT_1 | Spezialisiertes Tracking | Benutzerdefinierte Optimierung |
Das richtige Event wählen
Lead-Gen-Anzeigen schalten? Verwenden Sie Lead (wird auf Snapchats SIGN_UP abgebildet) — Dies teilt Snapchat mit: „Diese Person hat sich angemeldet / ist ein Lead geworden”.
Produkt oder Dienstleistung verkaufen? Verwenden Sie Purchase (wird auf PURCHASE abgebildet) — Ideal, wenn Sie möchten, dass Snapchat für Käufer optimiert. Kombinieren Sie es mit value und currency in der Conversion-Konfiguration Ihres Kanals für wertbasierte Optimierung.
Registrierungs-Kampagnen durchführen? Verwenden Sie CompleteRegistration (wird auf SIGN_UP abgebildet) — Signalisiert eine abgeschlossene Registrierungsaktion.
Kanal-Abonnement bewerben? Verwenden Sie Subscribe (wird auf SUBSCRIBE abgebildet) — Entspricht der Nutzeraktion (Beitreten = Abonnieren).
Nicht-Standard-Event benötigt? Verwenden Sie Custom (wird auf CUSTOM_EVENT_1 abgebildet) — Für spezialisierte Tracking-Szenarien, die nicht in die Standardtypen passen.
Tipp: Stimmen Sie Ihren Event-Typ mit dem Kampagnenziel im Snapchat Ads Manager ab, um die besten Ergebnisse zu erzielen.
Events konfigurieren
Event-Typen werden pro Kanal konfiguriert. Jeder Kanal hat standardmäßig CompleteRegistration, wenn er erstmals erkannt wird.
Um den Event-Typ eines Kanals zu ändern:
- Gehen Sie zu den Settings Ihrer Website → Tab Channels
- Klicken Sie auf Setup (oder Edit) in der Kanalzeile
- Wählen Sie Ihren Event-Typ im Dialog
- Klicken Sie auf Save
Event-Parameter
Jedes Event, das AdTarget an Snapchat sendet, enthält diese Parameter:
Pflichtparameter
| Parameter | Beschreibung |
|---|---|
event_type | Der Snapchat-Event-Name (SIGN_UP, PURCHASE, etc.) |
timestamp | ISO 8601-Zeitstempel des Beitritts (Millisekunden) |
event_tag | Tag für die Event-Kategorisierung |
Attributionsparameter
| Parameter | Beschreibung |
|---|---|
sc_click_id | Die Snapchat Click ID (ScCid) vom Anzeigenklick |
Nutzerdaten
| Parameter | Quelle | Gehasht? |
|---|---|---|
hashed_external_id | Telegram-Benutzer-ID | Ja (SHA-256) |
hashed_ip_address | IP vom Landingpage-Besuch | Nein (wird unverändert gesendet) |
user_agent | Browser vom Landingpage-Besuch | Nein (wird unverändert gesendet) |
Die external_id (Telegram-Benutzer-ID) wird vor dem Senden SHA-256-gehasht, wie von Snapchat verlangt. IP-Adresse und User Agent werden gemäß den Spezifikationen der Snapchat Conversions API unverändert gesendet.
Benutzerdefinierte Felder
| Parameter | Beschreibung |
|---|---|
price | Event-Wert (falls pro Kanal konfiguriert) |
currency | Währungscode (Standard: "USD") |
description | Kanaltitel oder benutzerdefinierter Name aus der Kanalkonfiguration |
Event-Deduplizierung
AdTarget fügt jedem Event eine eindeutige event_id hinzu, um Duplikate zu verhindern:
event_id: "adtarget_{conversion_id}"Dies stellt sicher, dass dieselbe Conversion nicht doppelt gezählt wird, selbst bei erneutem Versuch.
Events testen
Test in Produktion
Der zuverlässigste Weg, End-to-End zu testen:
- Klicken Sie auf Ihre eigene Snapchat-Anzeige (oder verwenden Sie eine Testanzeige)
- Besuchen Sie Ihre Landingpage
- Treten Sie Ihrem Telegram-Kanal über den getrackten Einladungslink bei
- Prüfen Sie den Snapchat Events Manager innerhalb von 5-10 Minuten
Im Snapchat Ads Manager verifizieren
- Gehen Sie zum Events Manager
- Wählen Sie Ihren Pixel
- Suchen Sie Ihren Event-Typ mit aktuellen Zeitstempeln
- Überprüfen Sie, ob das Event als „Received” angezeigt wird
Event-Zuordnung
Snapchat ordnet Ihre Events Nutzern für die Attribution zu. Höhere Übereinstimmungsqualität bedeutet bessere Optimierung.
Faktoren der Übereinstimmungsqualität
| Faktor | Auswirkung |
|---|---|
| ScCid vorhanden | Hoch - Direkte Klick-Attribution |
| User Agent + IP | Mittel - Probabilistische Zuordnung |
| External ID | Mittel - Geräteübergreifende Zuordnung |
Übereinstimmungsqualität verbessern
- ScCid erfassen: Stellen Sie sicher, dass die URL Ihrer Landingpage den
ScCid-Parameter beibehält - Events zeitnah senden: Kürzere Zeit zwischen Klick und Conversion verbessert die Zuordnung
- Konsistente User Journey: Halten Sie Nutzer auf Ihrer Domain, bevor Sie sie zu Telegram weiterleiten
Häufige Event-Konfigurationen
Lead-Generierung
AdTarget Event: Lead → Snapchat Event: SIGN_UP
When: User joins channel
Use Case: "Get subscribers" campaignsKauf-Tracking
AdTarget Event: Purchase → Snapchat Event: PURCHASE
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimizationInhalts-Abonnement
AdTarget Event: Subscribe → Snapchat Event: SUBSCRIBE
When: User joins channel
Use Case: "Subscribe to channel" campaignsFehlerbehebung
Events stimmen nicht überein?
- Prüfen Sie, ob
ScCidin der Landingpage-URL enthalten ist - Überprüfen Sie, ob der Snapchat Pixel auch auf der Landingpage ist
- Stellen Sie sicher, dass Cookies nicht blockiert sind
Niedrige Event-Übereinstimmungsrate?
- Reduzieren Sie die Zeit zwischen Klick und Conversion
- Überprüfen Sie, ob
ScCidaus der URL erfasst wird - Stellen Sie sicher, dass IP und User Agent verfügbar sind
Doppelte Events?
- AdTarget handhabt die Deduplizierung automatisch über
event_id - Falls Sie Duplikate sehen, kontaktieren Sie den Support
Best Practices
- Event-Typ mit Kampagnenziel abgleichen für bessere Optimierung
- Denselben Event-Typ konsistent verwenden innerhalb einer Kampagne
- Event-Zustellung überwachen im Snapchat Events Manager regelmäßig
- Vor der Skalierung testen des Werbebudgets
Nächste Schritte
Ihre Snapchat-Integration ist abgeschlossen! Starten Sie Ihre Anzeigen und beobachten Sie, wie Ihre Conversions in Snapchat eintreffen.
Brauchen Sie Hilfe bei der Optimierung? Kontaktieren Sie unser Support-Team.