TikTok Pixel und Events API in Shopify einrichten und prüfen

Stand: 9. November 2026

Die TikTok-App für Shopify bindet den TikTok Pixel ohne Code-Änderung in deinen Shop ein. Je nach Datenfreigabe-Stufe sendet sie Events laut TikTok zusätzlich über die Events API, also von Server zu Server. Welche Stufe das tut, beschreibt TikTok in zwei Hilfeartikeln unterschiedlich. Deshalb gehört zur Einrichtung immer eine Prüfung: Kommt der Kauf aus dem Browser, vom Server oder von beiden, und zählt TikTok ihn nur einmal?

Das Wichtigste in Kürze

Pixel und Events API: der Unterschied

TikTok Pixel TikTok Events API
Wo es läuft im Browser der Besucher zwischen Server und TikTok
Was verloren gehen kann Events durch Werbeblocker, Verbindungsprobleme oder Browser-Einschränkungen Events bei Fehlern in der Konfiguration
In der Shopify-App aktiv ab „Standard“ in „Maximal“, laut TikToks Shopify-Artikel schon ab „Erweitert“

TikTok schreibt, die Events API erfasse Conversions, die dem Pixel durch Verbindungsprobleme oder Browser-Unterschiede entgehen. Laut Entwicklerdoku kommen die Signale bei zwei Kanälen weiter an, wenn einer ausfällt. Dafür verlangt TikTok eine Deduplizierung, damit derselbe Kauf nicht doppelt zählt.

Voraussetzungen

Laut TikTok ist „TikTok on Shopify“ nicht in allen Märkten verfügbar; maßgeblich ist der Eintrag im Shopify App Store. Die Länderliste in Shopifys Hilfe zum TikTok-Kanal gilt für TikTok Shop, also den Verkauf direkt auf TikTok, und nicht für Werbung und Pixel.

TikTok Pixel in Shopify einrichten

Schritt 1: TikTok-App installieren und Konten verbinden

Die offizielle App heißt „TikTok“ und stammt von TikTok Inc. Sie deckt Werbung mit Pixel und TikTok Shop ab. In der App verbindest du TikTok-for-Business-Konto, Business Center, Werbekonto und Pixel. Shopify sendet die Website-Events dann über diesen Pixel an das gewählte Werbekonto.

Startest du im TikTok Ads Manager, verbindest du Shopify im Pop-up. Leg in diesem Schritt kein neues Konto an: Laut TikTok hängt der Pixel sonst am neuen statt an deinem bestehenden Konto.

Schritt 2: Datenfreigabe-Stufe wählen

TikToks Hilfeartikel zur Shopify-App (Stand Februar 2025) beschreibt die drei Stufen so:

Stufe Was laut TikTok übertragen wird
Standard nur TikTok Pixel; Werbeblocker im Browser können ihn ausbremsen
Erweitert TikTok Pixel, Events API und Advanced Matching
Maximal wie Erweitert, dazu Shopify-APIs und der In-App-Checkout (Beta)

TikTok empfiehlt „Maximal“. Ein zweiter TikTok-Artikel für alle Pixel-Partner (Stand Juli 2025) beschreibt „Erweitert“ nur als Pixel mit Advanced Matching, ohne Events API. Beide Artikel nennen für „Maximal“ eine Übertragung von Partner-Servern. Unsere Lesart: Wer Server-Events will, wählt „Maximal“ und prüft das Ergebnis im Events Manager (Prüfung 2).

Advanced Matching teilt laut TikTok Kundendaten wie E-Mail, Telefonnummer, Name und Ort. TikTok fordert, dass deine Datenschutzerklärung das abbildet. Die Stufe stimmst du deshalb mit deiner Datenschutzberatung ab.

Schritt 3: Doppelte Pixel entfernen

Laut Shopify kann dasselbe Event an mehreren Stellen erfasst werden: im Theme-Code, in einer App und unter Kundenereignisse. Auch Reste in den „Zusätzlichen Skripten“ oder in checkout.liquid führen zu doppelten Events. TikTok ergänzt für eingebauten Code: Sind mehrere Pixel geladen, geht jedes Event an alle. Typische Fundorte:

Die „Zusätzlichen Skripte“ sind seit 28. August 2025 nur noch lesbar. Auf Danke- und Bestellstatusseite hat Shopify sie für Plus-Shops zum 28. August 2025 abgeschaltet; für alle anderen Shops lief die Frist bis 26. August 2026, danach stellte Shopify automatisch um. Ein altes TikTok-Kaufskript dort zählt also nicht mehr. Den Kauf erfasst jetzt der App-Pixel.

Schritt 4: Einwilligung prüfen

In Märkten mit Einwilligungspflicht, meist EWR und Großbritannien, laufen Web-Pixel laut Shopify erst nach den nötigen Berechtigungen. Welche Berechtigungen der TikTok-App-Pixel verlangt, legt TikTok fest. Du siehst sie unter Einstellungen > Kundenereignisse beim TikTok-Pixel über „View customer privacy“.

Zwei Stolperstellen nennt Shopify:

Auch Server-Pixel unterliegen laut Shopify deinen Einwilligungseinstellungen. Wie die TikTok-App ihre Server-Events ohne Einwilligung behandelt, dokumentiert TikTok nicht. Kläre das mit deiner Datenschutzberatung.

So prüfst du, ob TikTok Pixel und Events API richtig laufen

Prüfung 1: App-Pixel im Shopify Pixel Helper

Unter Einstellungen > Kundenereignisse startest du beim TikTok-Pixel den Test. Shopify öffnet dann deinen Shop mit dem Shopify Pixel Helper, der empfangene Events live zeigt. Du kannst immer nur einen App-Pixel gleichzeitig testen. Steht dort „Pixel is awaiting consent“, fehlt im Test die Einwilligung. Für die Danke-Seite brauchst du eine Testbestellung. Die Namen können abweichen: Shopifys Event „checkout_completed“ kann bei der Zielplattform zum Beispiel als „Purchase“ ankommen.

Die Chrome-Erweiterung TikTok Pixel Helper prüft Pixel, Events und Parameter. Ob sie einen App-Pixel in Shopifys abgeschirmter Umgebung erkennt, beschreiben die Hilfeseiten von TikTok und Shopify nicht. Zeigt sie nichts an, ist das allein kein Beleg für einen Fehler.

Prüfung 2: Testbestellung und Verbindungsmethode

Schließe eine echte Testbestellung ab, etwa mit einem günstigen Produkt, das du danach stornierst. Notiere Bestellnummer, Uhrzeit und Betrag. Öffne danach im Events Manager deinen Pixel, Tab „Overview“. Dort zeigt TikTok je Event-Typ, also für alle Käufe zusammen:

Die Daten erscheinen laut TikTok nicht in Echtzeit, plane also Wartezeit ein. Bei „Maximal“ erwartest du beim Kauf-Event „server & browser“. Steht dort „browser only“, kommen für Käufe keine Server-Events an. Ob genau deine Testbestellung über Pixel, Server oder beide kam, liest du dort nicht ab.

Das Kauf-Event heißt seit 1. Mai 2025 „Purchase“, vorher „CompletePayment“. Alte Namen wandelt TikTok automatisch um. TikToks Eventliste für Shopify vom Februar 2025 nennt noch „Complete Payment“.

Einzelne Test-Events zeigt der Tab „Test Events“, getrennt nach Browser und Server. Für Browser-Tests öffnest du deine Website direkt im Browser. Einen Testcode für Server-Events beschreibt TikTok nur für eine eigene API-Anbindung. Für die Shopify-App ist in den geprüften Quellen kein Weg dokumentiert, eine einzelne Bestellung mit diesem Server-Testcode zu prüfen. Die Übersicht belegt nur den Datenweg des Event-Typs insgesamt.

Prüfung 3: Deduplizierung

Senden Pixel und Events API denselben Kauf, behält TikTok das erste Event, wenn Pixel, Event-Name und Event-ID übereinstimmen und das zweite innerhalb von 48 Stunden ankommt. Als Event-ID eignen sich laut TikTok Bestell- oder Transaktionsnummern. Ob die Shopify-App die Event-ID setzt, dokumentiert TikTok nicht.

Prüfen kannst du das Ergebnis trotzdem, allerdings nur über alle Käufe hinweg: Die Kennzahl „Server & Browser“ in den Pixel-Details zählt ein Event, das über beide Kanäle kam, einmal. Ist sie zu niedrig, rät TikTok, die Event-ID zu prüfen. Details zeigt „Event Health“ beim jeweiligen Event.

Prüfung 4: Wert, Währung und Content-IDs

Für den ROAS braucht TikTok beim Kauf einen Wert (value) und eine Währung (currency). „value“ ist der Gesamtbetrag der Bestellung, ohne Währungszeichen und Kommas. Die Produkt-IDs in „content_ids“ sollen zu den IDs in deinem TikTok-Katalog passen. Details zu den Parametern zeigt der „Overview“ ebenfalls für alle Käufe zusammen. Fehlen dort value oder currency, korrigierst du das Setup. Ab welchem ROAS du nach allen Kosten verdienst, zeigt unser Artikel zum Break-even-ROAS.

Prüfung 5: Abgleichqualität und Diagnose

Den EMQ-Wert (Event Match Quality) berechnet TikTok als gewichteten Durchschnitt der Abdeckung aller Abgleichsmerkmale wie E-Mail oder Telefonnummer. Zielwerte nennt TikTok in den Hilfeartikeln, die wir gelesen haben, nicht. Der Tab „Diagnostics“ listet Probleme wie fehlende Parameter oder Content-IDs mit Schweregrad.

Typische Fehlerbilder

Symptom Wahrscheinliche Ursache Was du prüfst
Kauf nur „browser only“ Stufe „Standard“ oder „Erweitert“ ohne Server-Weg Datenfreigabe in der TikTok-App
Deutlich weniger Käufe als Bestellungen fehlende Einwilligung, Banner ohne Übergabe an Shopify, altes Skript entfallen Kundenereignisse, Customer Privacy API
Kauf im Browser doppelt Theme-Code zusätzlich zum App-Pixel Netzwerk-Tab der Entwicklertools, theme.liquid
„Server & Browser“ sehr niedrig Event-ID fehlt oder weicht ab „Event Health“ beim Kauf-Event
„Pixel is awaiting consent“ im Test keine Einwilligung Banner akzeptieren, erneut testen
Wert fehlt oder ohne Währung Parameter falsch übergeben TikTok Pixel Helper, „Diagnostics“
Events bleiben plötzlich aus Shopify kann bei „Optimized“ den Datenzugriff eines Marketing-Pixels pausieren Aktivitätslog der App-Pixel

Die Bestellzahlen in Shopify bleiben laut Shopify von Werbeblockern und Tracking-Schutz unberührt. Verloren geht die Zuordnung beim Werbekanal.

Kostenloser TikTok-Tracking-Check

Du willst wissen, ob dein TikTok-Kauf-Event sauber ankommt? Schick uns über das Kontaktformular den Link zu deinem Shop mit dem Stichwort „TikTok-Check“. Wir prüfen von außen, welche TikTok-Events dein Shop im Browser sendet und ob Pixel-Code doppelt eingebunden ist, und schicken dir kostenlos eine kurze Einschätzung. Dafür brauchen wir keinen Zugang zu deinen Konten. Bei EXRE betreuen wir Anzeigen auf TikTok, Meta und Google und bauen die Shopify-Shops und Landingpages, auf denen die Klicks landen. Für Meta steht der Ablauf in unserer Anleitung zur Meta Conversions API in Shopify.

Häufige Fragen

Brauche ich die TikTok Events API, wenn der Pixel schon läuft?

TikTok empfiehlt für Websites, Pixel und Events API zusammen zu nutzen und die Events zu deduplizieren. Der Pixel kann Events durch Werbeblocker oder Verbindungsprobleme verlieren. In der Shopify-App steuerst du den Server-Weg über die Datenfreigabe-Stufe.

Welche Datenfreigabe-Stufe sollte ich in der TikTok-App wählen?

TikTok empfiehlt „Maximal“. Für „Erweitert“ beschreiben zwei TikTok-Artikel unterschiedlich, ob die Events API dazugehört. „Standard“ nutzt nur den Pixel. Stimme die Stufe wegen Advanced Matching mit deiner Datenschutzberatung ab.

Wie sehe ich, ob die Events API in Shopify Daten sendet?

Im Events Manager zeigt der Tab „Overview“ je Event die Verbindungsmethode. „server & browser“ beim Kauf-Event heißt, dass Pixel und Server senden. Steht dort nur „browser only“, fehlt der Server-Weg.

Wie verhindert TikTok doppelt gezählte Käufe?

TikTok führt Pixel- und Server-Event zusammen, wenn Pixel, Event-Name und Event-ID übereinstimmen und beide innerhalb von 48 Stunden ankommen. Ob die Shopify-App die Event-ID setzt, ist nicht dokumentiert. Die Kennzahl „Server & Browser“ und „Event Health“ zeigen, ob die Zusammenführung greift.

Warum zeigt TikTok weniger Käufe als Shopify?

Mögliche Gründe sind fehlende Einwilligungen im EWR, Werbeblocker, ein Cookie-Banner ohne Übergabe an Shopify oder ein entfallenes altes Skript auf der Danke-Seite. Vergleiche eingegangene Kauf-Events mit Bestellungen im gleichen Zeitraum. Die Käufe im Werbekonto taugen dafür nicht, denn dort stehen nur Käufe, die TikTok deinen Anzeigen zurechnet.

Quellen

Alle Quellen gelesen am 9. November 2026.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert