Skip to Content
Tracke deine Telegram-Conversions mit Meta Ads — starte in wenigen Minuten!
Snapchat-IntegrationConversions API

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-EventSnapchat-EventIdeal fürSnapchat-Optimierung
LeadSIGN_UPLead-Generierungs-KampagnenOptimiert für Anmeldungen
PurchasePURCHASEKauforientierte KampagnenOptimiert für Kaufaktionen
CompleteRegistrationSIGN_UPRegistrierungsorientierte KampagnenOptimiert für Anmeldungen
SubscribeSUBSCRIBEAbonnement-KampagnenOptimiert für Abonnement-Absicht
CustomCUSTOM_EVENT_1Spezialisiertes TrackingBenutzerdefinierte 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:

  1. Gehen Sie zu den Settings Ihrer Website → Tab Channels
  2. Klicken Sie auf Setup (oder Edit) in der Kanalzeile
  3. Wählen Sie Ihren Event-Typ im Dialog
  4. Klicken Sie auf Save

Event-Parameter

Jedes Event, das AdTarget an Snapchat sendet, enthält diese Parameter:

Pflichtparameter

ParameterBeschreibung
event_typeDer Snapchat-Event-Name (SIGN_UP, PURCHASE, etc.)
timestampISO 8601-Zeitstempel des Beitritts (Millisekunden)
event_tagTag für die Event-Kategorisierung

Attributionsparameter

ParameterBeschreibung
sc_click_idDie Snapchat Click ID (ScCid) vom Anzeigenklick

Nutzerdaten

ParameterQuelleGehasht?
hashed_external_idTelegram-Benutzer-IDJa (SHA-256)
hashed_ip_addressIP vom Landingpage-BesuchNein (wird unverändert gesendet)
user_agentBrowser vom Landingpage-BesuchNein (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

ParameterBeschreibung
priceEvent-Wert (falls pro Kanal konfiguriert)
currencyWährungscode (Standard: "USD")
descriptionKanaltitel 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:

  1. Klicken Sie auf Ihre eigene Snapchat-Anzeige (oder verwenden Sie eine Testanzeige)
  2. Besuchen Sie Ihre Landingpage
  3. Treten Sie Ihrem Telegram-Kanal über den getrackten Einladungslink bei
  4. Prüfen Sie den Snapchat Events Manager innerhalb von 5-10 Minuten

Im Snapchat Ads Manager verifizieren

  1. Gehen Sie zum Events Manager
  2. Wählen Sie Ihren Pixel
  3. Suchen Sie Ihren Event-Typ mit aktuellen Zeitstempeln
  4. Ü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

FaktorAuswirkung
ScCid vorhandenHoch - Direkte Klick-Attribution
User Agent + IPMittel - Probabilistische Zuordnung
External IDMittel - Geräteübergreifende Zuordnung

Übereinstimmungsqualität verbessern

  1. ScCid erfassen: Stellen Sie sicher, dass die URL Ihrer Landingpage den ScCid-Parameter beibehält
  2. Events zeitnah senden: Kürzere Zeit zwischen Klick und Conversion verbessert die Zuordnung
  3. 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" campaigns

Kauf-Tracking

AdTarget Event: Purchase → Snapchat Event: PURCHASE When: User joins channel Use Case: "Buy now" campaigns with value-based optimization

Inhalts-Abonnement

AdTarget Event: Subscribe → Snapchat Event: SUBSCRIBE When: User joins channel Use Case: "Subscribe to channel" campaigns

Fehlerbehebung

Events stimmen nicht überein?

  • Prüfen Sie, ob ScCid in 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 ScCid aus 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

  1. Event-Typ mit Kampagnenziel abgleichen für bessere Optimierung
  2. Denselben Event-Typ konsistent verwenden innerhalb einer Kampagne
  3. Event-Zustellung überwachen im Snapchat Events Manager regelmäßig
  4. 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.

Last updated on

Snapchat Conversions API | AdTarget Docs