Das TikTok-Pixel und die Events API auf Shopify einrichten

Wie fügst du das TikTok-Pixel zu Shopify hinzu?

Installiere die TikTok-App für Shopify, verbinde deine TikTok-Konten und wähle eine Datenfreigabestufe: Standard ergänzt das TikTok Pixel, während Enhanced und Maximum TikToks Events API und Advanced Matching ergänzen, alles ohne Code. Nutze stattdessen eine Tracking-App, wenn du mehrere Pixel brauchst oder jedes Ereignis sehen willst, das TikTok erhält, und halte einen Sender pro Pixel ein.

TikToks eigene Einrichtungsanleitung (zuletzt aktualisiert im Februar 2025) beschreibt die Schritte. Shopifys Seiten zu TikTok behandeln TikTok Shop statt des Pixels, TikToks Hilfezentrum ist hier also die Referenz.

1. Installiere TikToks App aus dem Shopify App Store und öffne dann TikTok unter Sales channels in deinem Shopify-Admin.
2. Verbinde oder erstelle die von der App verlangten TikTok-Konten, einschließlich deines Kontos TikTok for Business und TikTok Ads Manager.
3. Wähle deine Datenfreigabestufe: Standard, Enhanced oder Maximum.
4. Klicke auf Create Pixel, um ein neues Pixel zu erstellen, oder wähle ein bestehendes.
5. Klicke auf Set Up, füge deinen Unternehmensstandort unter Company Information hinzu, und klicke auf Confirm.

Die App installiert das Pixel für dich, es gibt also nichts einzufügen. Ist TikToks Basis-Code aus einer früheren Einrichtung noch in deinem Theme oder einem benutzerdefinierten Pixel, entferne ihn, sonst wird jedes Ereignis doppelt gesendet.

Welche Datenfreigabestufe solltest du wählen?

Enhanced oder Maximum, außer du willst weniger Daten mit TikTok teilen: Nur diese Stufen enthalten die Events API, die TikTok empfiehlt, neben dem Pixel laufen zu lassen. Standard ist das Pixel für sich allein.

Quelle: TikToks Artikel zur Datenfreigabe (zuletzt aktualisiert im Februar 2025), geprüft am 24. September 2026.

Advanced Matching sendet Kundendaten wie E-Mail-Adresse und Telefonnummer mit deinen Ereignissen, damit TikTok sie TikTok-Nutzerinnen zuordnen kann. Als TikTok seine Shopify-Integration im August 2023 erweiterte, bat es bestehende Nutzer, in der TikTok-App zu prüfen, ob ihre Stufe Enhanced oder Maximum war (TikTok). Höhere Stufen teilen mehr Daten deiner Kundschaft, stelle also sicher, dass deine Datenschutzerklärung abdeckt, was du wählst.

Was ergänzt die Events API?

Eine Server-zu-Server-Kopie deiner Ereignisse, sodass eine Conversion TikTok auch erreicht, wenn das Browser-Pixel scheitert. TikTok empfiehlt sie als zweiten Kanal neben dem Pixel, nicht als Ersatz, mit deduplizierten Kopien.

TikToks Begründung: Verbindungsprobleme und Unterschiede zwischen Browsern kosten das Pixel manche Conversions, und mit beiden Kanälen kommen Ereignisse weiterhin über einen an, wenn der andere scheitert (About Events API, Web-Einrichtungsanleitung). Ein Serverereignis ist nur so nützlich wie das, was es trägt:

• Ein Zugriffstoken. Du erzeugst es in TikTok Events Manager, aus den Settings deines Pixels.
• Die Ereignis-ID des Pixels. Eine Serverkopie mit demselben Ereignisnamen und derselben Ereignis-ID wie die Browser-Kopie zählt einmal. Ohne sie kann TikTok beide zählen.
• Match-Details. TikTok gleicht Web-Ereignisse anhand der TikTok-Klick-ID (ttclid), Advanced-Matching-Daten wie E-Mail und Telefon, sowie Signalen wie IP-Adresse und User-Agent ab. Seine Einrichtungsanleitung bittet dich außerdem, die Klick-ID und Cookies zu senden, und First-Party-Cookies sowie Automatic Advanced Matching im Tab Settings des Pixels einzuschalten.

Was die Events API nicht kann, ist Kundschaft zurückzuholen, die Tracking abgelehnt hat. Ihre Ereignisse von einem Server statt einem Browser zu senden, macht sie nicht eingewilligt. Mehr dazu, was Serverereignisse ändern, und was nicht: serverseitiges Tracking auf Shopify.

Wie richtest du es mit einer Tracking-App ein?

Verbinde die App mit deinem Pixel über einen Events-API-Zugriffstoken, und stelle sicher, dass nichts anderes an dieses Pixel sendet. Eine Tracking-App verdient sich ihren Platz, wenn du mehrere Pixel betreibst oder jedes Ereignis sehen willst, das TikTok erhält.

cPixel, das wir bauen, sendet TikToks Ereignisse von seinen Servern über die Events API: Seitenaufrufe, Produktansichten, Suchen, Add-to-Carts, Checkouts, hinzugefügte Zahlungsdetails und den Kauf. Es baut den Kauf aus Shopifys Bestellung, er hängt also nicht davon ab, dass die Dankeseite lädt. Sein Storefront-Tag, das läuft, wenn cPixels App-Embed im Theme an ist, ergänzt allein den Seitenaufruf aus dem Browser, gepaart mit der Serverkopie unter einer Ereignis-ID. Ereignisse tragen die Details, nach denen TikTok abgleicht, wo cPixel sie hat: gehashte E-Mail und Telefon, sobald die Kundschaft sie angegeben hat, gehashte Shopify-Kunden- und Geräte-IDs, das Cookie _ttp, die Klick-ID ttclid, sowie IP-Adresse und User-Agent.

In cPixels Einrichtung fügst du den Pixel-Code (TikTok nennt ihn Pixel-ID) und das Events-API-Zugriffstoken ein, das cPixel verlangt. Mit gespeichertem Testereignis-Code (optional) sendet Verbindung testen ein echtes Testereignis; echte Bestellungen tragen den Code nie. Sobald Ereignisse fließen, zeigt cPixels Live-Ansicht jede Sendung mit TikToks Antwort. Du kannst mehrere TikTok-Pixel verbinden, jedes gleich eingerichtet. Schritt für Schritt: TikTok mit cPixel verbinden.

Sendet die TikTok-App weiterhin an dasselbe Pixel, beantworte cPixels Frage Ist die offizielle TikTok-App ebenfalls installiert? mit Ja, was cPixels Senden an dieses Pixel stoppt, oder verbinde cPixel mit einem anderen Pixel. Behalte die TikTok-App so oder so; die Regel ist ein Sender pro Pixel. Mehr über cPixel, das Shopify-Käufe an sieben Werbeplattformen sendet.

Warum zählt TikTok Käufe doppelt?

Weil zwei Kopien eines Kaufs dasselbe Pixel erreichten, ohne denselben Ereignisnamen und dieselbe Ereignis-ID zu tragen, TikTok konnte also nicht erkennen, dass es eine Bestellung war. Das bedeutet meist, dass zwei Tools an ein Pixel senden.

TikToks Regel, aus seiner Entwicklerdokumentation (geprüft am 24. September 2026): Ereignisse mit demselben Pixel, Ereignisnamen und derselben event_id sind Duplikate. TikTok behält das erste, verwirft innerhalb von 48 Stunden danach empfangene Kopien und versucht, Details aus einer innerhalb von 5 Minuten empfangenen Kopie in das erste zu übernehmen. Sein Hilfeartikel zu Ereignisdeduplizierung (zuletzt aktualisiert im Mai 2025) nennt dasselbe 48-Stunden-Fenster.

Hat die Serverkopie keine Ereignis-ID, greift TikTok auf das Cookie _ttp zurück, mit Grenzen: Es verwirft ein Serverereignis nur, wenn ein Browser-Ereignis mit demselben Pixel, Ereignis und Cookie bis zu 5 Minuten früher ankam, und es verwirft nie ein Browser-Ereignis.

Metas Regel und die Prüfungen für ein Meta-Pixel stehen in TikTok und Meta zählen Käufe doppelt.

Wie testest du TikTok-Ereignisse?

Sende Testereignisse aus dem Tab Test Events im TikTok Events Manager, während du einrichtest. Gib dann eine echte Bestellung auf und prüfe die Verbindungsmethode jedes Ereignisses auf dem Overview-Tab des Pixels: Browser, Server, oder Server & Browser.

1. Öffne im TikTok Events Manager dein Pixel und seinen Tab Test Events, wo du Browser- und Serverereignisse testen und danach filtern kannst (TikTok).
2. Kopiere für Serverereignisse den Testcode aus Test Events und sende ihn mit deinen Anfragen als test_event_code. Testereignisse erscheinen unter Event Activity, mit etwaigen Payload-Problemen. Entferne den Code, bevor du live gehst (Verifizierungsanleitung).
3. Gib eine echte Bestellung auf.
4. Lies auf dem Tab Overview des Pixels die Connection Method jedes Ereignisses. Server & Browser zählt ein über beide Kanäle empfangenes Ereignis einmal. Bleibt diese Zahl niedrig, während beide Kanäle das Ereignis senden, prüfe, ob beide Kopien dieselbe Ereignis-ID tragen.
5. Prüfe den Tab Diagnostics, der Probleme listet, die TikTok gefunden hat, und wie schwerwiegend sie sind.

TikTok sagt, Ereignisdaten würden nicht in Echtzeit gezeigt. Gib bis zu 10 Minuten, bis sich Ereigniszahlen aktualisieren, und bis zu 2 Stunden, bis ein Ereignis vollständig verarbeitet ist, bevor du entscheidest, dass etwas kaputt ist (TikTok). Ein Ereignis zeigt sich außerdem erst als aktiv, sobald es gefeuert hat: In einem Community-Thread von 2023 sah eine Händlerin, die TikToks App nutzte, nur Seitenaufrufe als aktiv markiert, die übrigen Ereignisse erschienen erst, nachdem Produktansichten und Add-to-Carts geschehen waren.

Zeigt TikTok Pixel Helper nichts an, sind die Ursachen dieselben wie bei Meta: siehe TikTok Pixel Helper zeigt nichts an.

Häufig gestellte Fragen

CompletePayment oder Purchase?

Purchase, für alles, was du jetzt einrichtest. TikTok benannte CompletePayment ab dem 1. Mai 2025 für Web-Ereignisse in Purchase um, und die Liste der unterstützten Ereignisse der Events API zeigt jetzt Purchase. Bestehende Setups müssen sich nicht ändern: TikTok wandelt die alten Namen automatisch um und zeigt die neuen im Reporting (Aktualisierte Standardereignisse). Welchen Namen du auch nutzt, sende denselben vom Pixel und der Events API, weil der Name Teil von TikToks Dedup-Schlüssel ist. cPixel sendet weiterhin CompletePayment, was TikTok akzeptiert und als Purchase meldet; es sendet den Kauf nur von seinem Server, es gibt also keine Browser-Kopie, deren Name übereinstimmen müsste.

Was ist ttclid?

TikToks Klick-ID, ein Parameter, den TikTok der Adresse deiner Landingpage hinzufügt, wenn jemand auf deine Anzeige klickt. Das TikTok Pixel speichert sie in einem First-Party-Cookie namens ttclid, und TikTok empfiehlt dringend, sie mit jedem Events-API-Ereignis zu senden, damit sich Conversions auf den Klick zurückführen lassen. Speicherst du sie selbst, schlägt TikTok vor, sie mindestens 28 Tage zu behalten und bei einem neueren Klick zu ersetzen (Send TikTok Click ID). Ihr Begleiter, das Cookie _ttp, hält einen Identifikator für den Browser. TikTok sagt, beide Cookies hielten 13 Monate ab ihrer letzten Nutzung, und First-Party-Cookies sind in den Einstellungen des Pixels standardmäßig an (Cookies).

Kann ich das Pixel von Hand hinzufügen?

Ja, als benutzerdefiniertes Pixel unter Settings → Customer events, das Checkout und Dankeseite erreicht. Shopify merkt an, dass benutzerdefinierte Pixel JavaScript brauchen und von Shopify nicht unterstützt werden (Benutzerdefinierte Pixel). In dein Theme eingefügter Code läuft nur auf Nicht-Checkout-Seiten, und Additional scripts laufen auf der Dankeseite nicht mehr (Additional scripts laufen nicht mehr). Ein von Hand hinzugefügtes Pixel sendet nur aus dem Browser, da die Events API einen Server braucht. Verschiebst du ein Pixel, entferne die alte Kopie: Shopify nennt das mehrfache Tracken desselben Ereignisses ein häufiges Migrationsproblem (Pixel migrieren).