TikTok Events API: Pixel und Server richtig kombinieren
Warum der TikTok-Pixel allein viele Käufe verpasst, welche Daten die Events API braucht und welche zwei Wege es für Shopify- und WooCommerce-Shops gibt.
TikTok-Kampagnen laufen, im Shop kommen Bestellungen an, aber im TikTok Ads Manager steht nur ein Bruchteil davon. Die Kampagnen-Optimierung arbeitet dann mit einem verzerrten Bild: Anzeigen, die verkaufen, sehen schwach aus, und der Algorithmus lernt aus zu wenigen Signalen.
Die Ursache liegt selten im Shop, sondern im Weg, den die Daten nehmen. Ein reiner Browser-Pixel ist bei TikTok besonders anfällig. Die Events API ergänzt ihn um einen zweiten Kanal vom Server aus.
Warum der Pixel bei TikTok so viel verliert
TikTok wird überwiegend auf dem Smartphone genutzt, und ein großer Teil der Nutzer ist auf iOS unterwegs. Das bringt gleich mehrere Hürden zusammen:
- In-App-Browser. Der Klick auf eine Anzeige öffnet den Shop meist innerhalb der TikTok-App. Wechselt die Person später in Safari oder Chrome, um dort zu kaufen, ist die Verbindung zur Anzeige im Browser oft weg.
- iOS-Einschränkungen. Wer dem App-Tracking widerspricht, fällt aus Zielgruppen und Conversion-Daten heraus, soweit diese nur aus dem Browser stammen.
- Browserschutz. Safari begrenzt die Lebensdauer von Cookies, die per JavaScript gesetzt werden. Mehr dazu im Beitrag zu Safari ITP.
- Werbeblocker. Sie unterdrücken das Pixel-Skript häufig komplett.
Keiner dieser Effekte erzeugt eine Fehlermeldung. Das Ereignis kommt einfach nicht an.
Was die Events API anders macht
Die Events API ist die serverseitige Schnittstelle von TikTok. Statt dass der Browser das Ereignis direkt an TikTok schickt, sendet Ihr Server es – in der Regel ein Server-Container, der die Daten aus dem Shop erhält, prüft und weiterreicht.
Inhaltlich kann die Events API dasselbe wie der Pixel: Conversions messen, Zielgruppen aufbauen, dynamische Produktanzeigen und die Kampagnen-Optimierung mit Daten versorgen. Der Unterschied liegt in der Zustellung: Eine Anfrage vom Server wird weder vom Werbeblocker noch vom Browserschutz abgefangen.
Dazu kommt Kontrolle. Sie entscheiden auf dem Server, welche Felder TikTok erhält, und können Daten weglassen, kürzen oder anreichern, bevor sie Ihr System verlassen.
Pixel oder Server? Beides.
TikTok selbst empfiehlt, Pixel und Events API parallel zu betreiben. Das hat einen praktischen Grund: Der Browser kennt Dinge, die der Server nicht kennt, etwa den Klick auf die Anzeige. Der Server kennt dafür die verlässliche Bestellung.
Damit Käufe nicht doppelt gezählt werden, muss TikTok erkennen, dass ein Browser- und ein Server-Ereignis zusammengehören. Dafür tragen beide denselben Ereignisnamen und dieselbe Ereignis-ID. Bei Käufen bietet sich die Bestellnummer als Grundlage an. Wie Deduplizierung allgemein funktioniert und wo sie scheitert, beschreibt der Beitrag zur Event-Deduplizierung.
- Klickttclid landet in der URL
- PixelBrowser meldet Kauf mit Ereignis-ID
- Events APIServer meldet denselben Kauf
- TikTokgleiche ID, einmal gezählt
Welche Daten die Zuordnung verbessern
TikTok muss ein Server-Ereignis einer Person zuordnen, die eine Anzeige gesehen oder geklickt hat. Je mehr passende Merkmale vorliegen, desto besser gelingt das.
| Merkmal | Herkunft | Hinweis |
|---|---|---|
Click-ID (ttclid) |
URL nach dem Anzeigenklick | 30 Tage gültig, sollte gespeichert und mitgesendet werden |
| E-Mail-Adresse | Checkout | kleingeschrieben und per SHA-256 gehasht |
| Telefonnummer | Checkout | normalisiert und per SHA-256 gehasht |
| Kunden-ID | Shop-System | gehasht, falls personenbezogen |
| IP-Adresse und User-Agent | Anfrage des Browsers | verbessern die Zuordnung, sind aber personenbezogen |
Die Click-ID ist das wichtigste Feld. Sie landet beim Klick in der URL und muss von dort bis zum Kauf erhalten bleiben – idealerweise in einem Cookie, das Ihr Server auf Ihrer eigenen Domain setzt. Fehlt sie, bleibt TikTok nur der Abgleich über gehashte Kundendaten.
Das Prinzip ist dasselbe wie bei Meta. Wer dort schon an der Event Match Quality gearbeitet hat, kann die gleichen Datenquellen für TikTok nutzen.
Zwei Wege zur Einrichtung
Für Shopify- und WooCommerce-Shops gibt es im Wesentlichen zwei Ansätze.
Über einen Server-Container (Google Tag Manager). Die Ereignisse aus dem Web-Container oder einer Shop-Integration laufen in den Server-Container. Dort sendet ein TikTok-Tag sie an die Events API. Derselbe Container beliefert auf Wunsch auch GA4, Google Ads und Meta.
Über ein gehostetes Gateway. TikTok bietet ein Events API Gateway an, das Anbieter wie Stape als verwalteten Dienst betreiben. Es nimmt die Pixel-Ereignisse entgegen und leitet sie serverseitig weiter, ohne dass Sie Tags im Server-Container konfigurieren müssen. Voraussetzung ist ein bereits funktionierender Pixel.
| Server-Container | Gateway | |
|---|---|---|
| Aufwand bei der Einrichtung | höher, Web- und Server-Container nötig | gering |
| Weitere Plattformen | ja, alle aus einer Datenquelle | nur TikTok |
| Daten anreichern und filtern | flexibel | eingeschränkt |
| Laufende Pflege | Container und Tags | überwiegend beim Anbieter |
Das Gateway ist ein schneller Einstieg, wenn TikTok der einzige Kanal ist, der serverseitig laufen soll. Sobald Google und Meta ohnehin über einen Server-Container gehen, ist TikTok dort meist besser aufgehoben: gleiche Bestelldaten, gleiche Consent-Prüfung, eine Stelle für die Fehlersuche.
Consent und Datenschutz
Die Events API ändert nichts daran, dass für Werbe-Tracking in der Regel eine Einwilligung nötig ist. Der Consent-Status muss bis auf den Server durchgereicht werden, und ohne Einwilligung für Marketing sollte kein Ereignis an TikTok gehen.
Gehashte E-Mail-Adressen, IP-Adressen und Click-IDs sind personenbezogene Daten. Welche Felder Sie übermitteln dürfen, wie die Datenschutzerklärung das abbilden muss und wie die Übermittlung an TikTok einzuordnen ist, braucht eine rechtliche Prüfung im Einzelfall. Einen Überblick über die technischen Stellschrauben gibt die Seite zu DSGVO und Server-Side Tracking.
Nach der Einrichtung prüfen
Ein paar Punkte zeigen schnell, ob das Setup trägt:
- Ereignisse im Events Manager. Erscheinen Käufe sowohl aus dem Browser als auch vom Server?
- Deduplizierung. Wird ein Kauf einmal gezählt, nicht zweimal?
- Click-ID. Enthalten Server-Ereignisse nach einem Anzeigenklick die
ttclid? - Abgleich mit dem Shop. Liegt die Zahl der Käufe in TikTok in einem stabilen Verhältnis zu den Bestellungen im Backend?
- Consent. Gehen ohne Einwilligung tatsächlich keine Ereignisse raus?
Diese Prüfung ist keine einmalige Sache. Theme-Updates, neue Apps oder ein geänderter Checkout können einzelne Felder still verschwinden lassen.
Fazit
Bei TikTok trifft ein mobiles, stark iOS-lastiges Publikum auf In-App-Browser und kurzlebige Cookies. Ein Pixel allein sieht dort zu wenig. Die Events API ergänzt ihn vom Server aus, die Deduplizierung über eine gemeinsame Ereignis-ID verhindert doppelte Käufe, und Click-ID plus gehashte Kundendaten sorgen für die Zuordnung.
Wie wir TikTok in ein bestehendes Server-Setup einbinden, lesen Sie unter TikTok Events API sowie für Ihr Shopsystem unter Shopify Server-Side Tracking und WooCommerce Server-Side Tracking. Für Ihr Setup: Erstgespräch anfragen.
Häufige Fragen
Ersetzt die TikTok Events API den TikTok-Pixel?
Nein. TikTok empfiehlt, Pixel und Events API parallel zu betreiben: Der Browser kennt etwa den Klick auf die Anzeige, der Server die verlässliche Bestellung.
Wie verhindere ich doppelt gezählte Käufe bei Pixel und Events API?
Browser- und Server-Ereignis müssen denselben Ereignisnamen und dieselbe Ereignis-ID tragen. Bei Käufen bietet sich die Bestellnummer als Grundlage an.
Was ist die ttclid und warum ist sie wichtig?
Die ttclid ist die Click-ID, die beim Anzeigenklick in der URL landet. Sie ist das wichtigste Feld für die Zuordnung und sollte bis zum Kauf erhalten bleiben, idealerweise in einem Cookie, das Ihr Server auf Ihrer eigenen Domain setzt.
Brauche ich für die TikTok Events API eine Einwilligung?
In der Regel ja. Die Events API ändert nichts daran, dass für Werbe-Tracking meist eine Einwilligung nötig ist; ohne Einwilligung für Marketing sollte kein Ereignis an TikTok gehen.
Server-Side Tracking für Ihren Shopify- oder WooCommerce-Shop?
Unverbindliches Erstgespräch: Wir klären in 20 Minuten, was Ihrem Tracking fehlt und welches Paket passt.
Erstgespräch anfragen