TikTok-Events-API mit Beaconry: ttclid rein, vierzehn Events raus

TikTok-Events-API 2.0 über den WordPress-REST-Endpoint. Pixel-ID + Access-Token, ttclid auto-captured aus URL, alle 14 Standard-Events out of the box. Keine von TikToks "Recommended"-DSGVO-riskanten Defaults nötig.

Setup, zwei Strings

Pixel-ID und Access-Token. Beide in TikTok Ads Manager → Tools → Events → Web Events generieren. Verbindungsmethode "TikTok Pixel + Events API (Recommended)" wählen, damit Hybrid-Modus verfügbar bleibt. Den Browser-Pixel-HTML-Snippet überspringen, Beaconry braucht ihn nicht.

Beide in Beaconry → Tracking → TikTok einfügen, speichern. "TikTok-Test-Event senden" klicken. HTTP 200 mit code: 0 heißt: Credentials passen.

ttclid: TikToks stärkstes Attributions-Signal

Wenn ein Besucher von einer TikTok-Anzeige landet, hat die URL ?ttclid=.... Beaconry fängt ihn beim allerersten Page-View, persistiert ihn im nl_ext-First-Party-Cookie (consent-gated, 90 Tage Expiry, gescopet auf deine Domain). Jedes nachfolgende Server-Side-Event enthält ttclid im Events-API-Payload, egal wie viele Seiten der Besucher dazwischen browste.

Für TikToks Matching ist ttclid das stärkste Signal. Besser als gehashte PII, besser als IP+UA. Wenn du nur ein Signal senden könntest, wäre ttclid die richtige Wahl. Beaconry sendet ttclid plus alles andere, also musst du nicht wählen.

14 Events out of the box

Alle 14 TikTok-Standard-Events sind unterstützt mit Auto-Mapping von WordPress-Events. Die meistgenutzten:

• Pageview bei jedem zustimmenden Page-Load.
• ViewContent bei 50 % Scroll + 10 Sekunden Engagement.
• AddToCart, InitiateCheckout, AddPaymentInfo, CompletePayment aus WooCommerce.
• Lead aus Kadence-/Fluent-Form-Submissions.
• CompleteRegistration aus WP-User-Register-Hook.
• Subscribe aus Newsletter-Form-Events.
• Plus Search, Contact, Download, ClickButton, AddToWishlist für Nischen-Fälle.

Was Beaconry für dich auf AUS setzt

TikToks Onboarding-Wizard versucht drei DSGVO-riskante Toggles default-on zu schalten. Beaconrys Defaults umgehen sie alle:

• Automatic Advanced Matching aus. Beaconry hashed dieselben Felder server-side unter deiner Kontrolle, nur bei tatsächlichen Form-Submits.
• First-Party-Cookies (TikTok-managed) aus. Das _ttp-Cookie wird nur gesetzt, wenn du Hybrid-Modus explizit aktivierst, und auch dann via dem consent-gated nl-data-gate.
• Enhanced Data Postback aus. Beaconrys Events sind explizit und auditierbar, kein opaker "zusätzlicher Kontext" wird gesendet.

Du musst diese Toggles innerhalb von TikToks UI selbst setzen (Beaconry kann keine Meta- oder TikTok-seitigen Settings togglen), aber die Doku macht klar, was abzuschalten ist. Siehe den TikTok-Events-API-Artikel für den vollen Walkthrough.

Hybrid-Modus, optional

Für TikTok lädt der Hybrid-Modus den Browser-Pixel parallel zum Server-Side-Dispatch. Beide feuern dasselbe Event mit derselben event_id, TikTok dedupliziert innerhalb eines 24-Stunden-Fensters. Match-Rate-Boost, wenn die First-Party-Cookies (_ttp) des Besuchers verfügbar werden.

Default aus, empfohlen an für Retail-B2C-Audiences mit niedrigen Adblock-Quoten. Überspringen für B2B- und Dev-Audiences (der Browser-Pixel wird eh geblockt).

Was du in TikTok noch konfigurierst

• Test-Event-Code fürs Staging. In TikTok Events Manager → Test Events generieren. In Beaconrys Test-Event-Code-Feld einfügen. Vor dem Launch entfernen.
• Conversion-Attributions-Fenster, gesetzt in deiner Kampagnen-Konfiguration. TikTok-Default ist 7-Tage-Click + 1-Tag-View; B2B-Kampagnen profitieren oft von 28-Tage-Click-Fenstern.

Fazit

TikTok mit Beaconry ist das sauberste der fünf Kanäle: zwei Strings einzufügen, ttclid auto-captured, 14 Events automatisch gemappt, keine von TikToks invasiven Defaults nötig. Der Artikel zu TikTok-Onboarding-Defaults deckt die Konfigurations-Wahlen in TikToks UI ab; dieser Artikel ist darüber, was Beaconry auf deiner Seite tut.