TikTok Events API

Diese Anleitung erklärt, wie Sie die Events API-Ereignisse konfigurieren, die AdTarget an TikTok sendet, wenn Nutzer Ihrem Telegram-Kanal beitreten.

Wann werden Events gesendet?

AdTarget sendet ein Event an TikTok 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.

Verfügbare Event-Typen

AdTarget ordnet seine Event-Typen den Standard-Events von TikTok zu:

Das richtige Event wählen

Lead-Gen-Anzeigen schalten? Verwenden Sie Lead (wird auf TikToks SubmitForm abgebildet) — Dies teilt TikTok mit: „Diese Person hat ein Formular abgeschickt / ist ein Lead geworden”.

Produkt oder Dienstleistung verkaufen? Verwenden Sie Purchase — Ideal, wenn Sie möchten, dass TikTok 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 — Signalisiert eine abgeschlossene Registrierungsaktion.

Kanal-Abonnement bewerben? Verwenden Sie Subscribe — Entspricht der Nutzeraktion (Beitreten = Abonnieren).

Nicht-Standard-Event benötigt? Verwenden Sie Custom — Erlaubt Ihnen, einen eigenen Event-Namen für spezialisierte Tracking-Szenarien zu definieren.

Tipp: Stimmen Sie Ihren Event-Typ mit dem Kampagnenziel im TikTok 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 TikTok sendet, enthält diese Parameter:

Pflichtparameter

Attributionsparameter

Nutzerdaten

Die external_id (Telegram-Benutzer-ID) wird vor dem Senden SHA-256-gehasht, wie von TikTok verlangt. IP-Adresse und User Agent werden gemäß den Spezifikationen der TikTok Events API unverändert gesendet.

Event-Eigenschaften

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 TikTok-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 TikTok Events Manager innerhalb von 5-10 Minuten

Im TikTok Ads Manager verifizieren

1. Gehen Sie zu Assets → Events → Web Events → Manage
2. Prüfen Sie den Tab Events
3. Suchen Sie Ihren Event-Typ mit aktuellen Zeitstempeln
4. Überprüfen Sie, ob das Event als „Received” angezeigt wird

Event-Zuordnung

TikTok ordnet Ihre Events Nutzern für die Attribution zu. Höhere Übereinstimmungsqualität bedeutet bessere Optimierung.

Faktoren der Übereinstimmungsqualität

Übereinstimmungsqualität verbessern

1. ttclid erfassen: Stellen Sie sicher, dass die URL Ihrer Landingpage den ttclid-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 → TikTok Event: SubmitForm
When: User joins channel
Use Case: "Get subscribers" campaigns

Kauf-Tracking

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

Inhalts-Abonnement

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

Fehlerbehebung

Events stimmen nicht überein?

• Prüfen Sie, ob ttclid in der Landingpage-URL enthalten ist
• Überprüfen Sie, ob der TikTok 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 ttclid 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 TikTok Events Manager regelmäßig
4. Vor der Skalierung testen des Werbebudgets

Nächste Schritte

Ihre TikTok-Integration ist abgeschlossen! Starten Sie Ihre Anzeigen und beobachten Sie, wie Ihre Conversions in TikTok eintreffen.

Brauchen Sie Hilfe bei der Optimierung? Kontaktieren Sie unser Support-Team.