Anleitung zur Einrichtung und Nachverfolgung der TikTok Conversion-API
Erfahren Sie, wie die TikTok Conversion API funktioniert, wie Sie die Events API mit dem Pixel einrichten, doppelte Events vermeiden, das Matching verbessern und das Conversion-Tracking testen.

Von
Kinnari Ashar
Lesezeit: 15 Min.

Ihre TikTok-Kampagne mag oberflächlich betrachtet profitabel wirken, während einige ihrer wertvollsten Conversions nie im Bericht auftauchen. Ein Kunde kann sich ein Produkt ansehen, es in den Warenkorb legen, den Bezahlvorgang abschließen oder ein Lead-Formular absenden – und dennoch bleibt der Pfad hinter dieser Aktion möglicherweise unvollständig.
Diese fehlenden Daten wirken sich auf mehr als nur das Reporting aus. Sie können beeinflussen, welche Anzeigen TikTok priorisiert, wo Sie Ihr Budget einsetzen und wie sicher Sie die Kampagnenleistung bewerten können.
Die TikTok Conversion API, offiziell als Events API bekannt, wurde entwickelt, um dieses Bild klarer zu machen. Wie nützlich die Daten jedoch sind, hängt davon ab, wie Sie sie einrichten, mit dem TikTok-Pixel verknüpfen und sich überschneidende Events handhaben.
In den folgenden Abschnitten werden die entscheidenden Punkte aufgeschlüsselt, ohne den Prozess in ein technisches Labyrinth zu verwandeln.
Was ist die TikTok Conversion API?
Die TikTok Conversion API, offiziell TikTok Events API genannt, ist eine Server-to-Server-Verbindung, die Marketing- und Conversion-Events von Ihrer Website, E-Commerce-Plattform, App, Ihrem CRM, Server oder Offline-System direkt an TikTok sendet.
Abhängig von Ihrem Unternehmen und Setup können Sie Aktionen wie die folgenden erfassen:
Produktaufrufe und Suchvorgänge
Hinzufügen zum Warenkorb und Beginn des Checkouts
Käufe und Offline-Verkäufe
Registrierungen und Formularübermittlungen
Abonnements und qualifizierte Leads
TikTok kann geeignete Event-Daten nutzen, um Conversions zu messen, Ergebnisse Anzeigen zuzuordnen, die Auslieferung zu optimieren, Zielgruppen zu erstellen und Retargeting zu unterstützen. Die Qualität dieser Ergebnisse hängt von der Genauigkeit, Vollständigkeit, den Abgleichungsdetails (Matching) und dem Einwilligungsstatus der von Ihnen bereitgestellten Informationen ab.
Die Events API hat einen spezifischeren Zweck als andere Entwicklerprodukte von TikTok. Die Marketing API verwaltet Werbefunktionen, TikTok Shop APIs unterstützen Commerce-Abläufe und die Research API bietet zugelassenen Forschern Zugriff auf ausgewählte öffentliche Plattformdaten. Die Events API konzentriert sich auf das Senden von Marketing-Events.
Wie funktioniert die TikTok Conversion API?
Die TikTok Conversion API überträgt eine erfasste Kundenaktion von Ihren Unternehmenssystemen an TikTok, wo sie mit einer berechtigten Anzeigeninteraktion abgeglichen und für Messungen verwendet werden kann.
Der Prozess folgt in der Regel diesem Ablauf:
Ein Kunde sieht oder klickt auf Ihre TikTok-Anzeige und besucht Ihre Website oder Ihren Shop.
Er führt eine Aktion aus, z. B. das Ansehen eines Produkts, das Hinzufügen eines Artikels zum Warenkorb, das Absenden eines Formulars oder das Aufgeben einer Bestellung.
Ihre Website, E-Commerce-Plattform, Ihr Zahlungssystem oder CRM zeichnet die Aktion auf.
Ihr Server oder Ihre Integration erstellt ein Event, das Details wie den Event-Namen, den Zeitpunkt, den Bestellwert, Produktinformationen und verfügbare Matching-Daten enthält.
Das Event wird an die TikTok Events API gesendet.
TikTok verwendet Identifikatoren wie Klickdaten, Kontaktdaten, Browserinformationen oder andere berechtigte Matching-Felder, um die Aktion mit einem TikTok-Nutzer oder einer Anzeigeninteraktion zu verknüpfen.
Zugeordnete Events können zu Reporting, Attribution, Kampagnenoptimierung, Retargeting und Zielgruppenerstellung beitragen.
Beim Web-Tracking kann dieselbe Aktion TikTok auch über das Pixel erreichen:
TikTok-Anzeige → Website-Besuch → Kundenaktion → Pixel-Event und Server-Event → Deduplizierung → TikTok Ads Manager
Das Server-Event kann ein bestätigtes Ergebnis immer noch melden, wenn die Browser-Anfrage fehlschlägt, weil das Pixel blockiert wurde, die Bestätigungsseite nicht geladen wurde, der Checkout an anderer Stelle stattfand oder die Verbindung zu schnell beendet wurde.
Der Erhalt des Events garantiert jedoch keine TikTok-Attribution. TikTok benötigt immer noch genügend gültige Matching- und Attributionsdaten, um diese Conversion mit einer berechtigten Anzeigeninteraktion zu verknüpfen.
TikTok-Pixel vs. TikTok Conversion API
TikTok-Pixel und Events API erfassen Conversion-Daten auf unterschiedlichen Wegen. Das Pixel zeichnet Aktivitäten im Browser des Kunden auf, während die Events API Events von Ihrem Server oder einem anderen verbundenen System sendet.
TikTok empfiehlt, nach Möglichkeit beide für das Web-Conversion-Tracking zu verwenden.
Funktion | TikTok-Pixel | TikTok Conversion API |
Datenquelle | Browser des Kunden | Server, Plattform, App, CRM oder Offline-System |
Tracking-Methode | Browserbasiert | Server-to-Server |
Installation | Website-Code, Event Builder oder Tag Manager | Partner-Integration, Events API Gateway, Server-Container oder direkte API |
Browser-Einschränkungen | Stärker betroffen | Weniger abhängig von der Browser-Ausführung |
Am besten geeignet für | Seitenaufrufe und Onsite-Aktionen | Bestätigte Website-, Backend-, CRM- und Offline-Ergebnisse |
CRM- und Offline-Events | Eingeschränkt | Unterstützt |
Technischer Schwierigkeitsgrad | Normalerweise geringer | Variiert von moderat bis fortgeschritten |
Deduplizierung | Nicht erforderlich bei alleiniger Verwendung | Erforderlich, wenn das Pixel dasselbe Event sendet |
Das Pixel eignet sich besser für unmittelbares Onsite-Verhalten, während die Events API Ergebnisse bestätigen kann, die nach der Browser-Interaktion erfasst werden, wie z. B. genehmigte Zahlungen oder qualifizierte CRM-Leads.
Wenn beide dieselbe Conversion melden, verlangt TikTok eine Deduplizierung, damit der Ads Manager sie nur einmal zählt.
Welche Events und Daten können Sie über die TikTok Events API senden?
1. Standard-Conversion-Events
TikTok bietet Standard-Event-Namen für gängige E-Commerce- und Lead-Generierungsaktionen. Diese vordefinierten Events können Reporting, Conversion-Optimierung und Zielgruppenerstellung unterstützen.
Häufige Events sind:
ViewContent: Ein Besucher öffnet eine Produktseite oder eine andere wichtige Seite.
Search: Jemand durchsucht Ihre Website nach einem Produkt, einer Kategorie oder einem Begriff.
AddToWishlist: Ein Käufer speichert einen Artikel für später.
AddToCart: Ein Produkt wird erfolgreich in den Warenkorb gelegt.
InitiateCheckout: Der Kunde beginnt den Checkout-Prozess.
AddPaymentInfo: Zahlungsinformationen werden während des Checkouts übermittelt.
Purchase: Ein abgeschlossener Kauf wird erfasst.
SubmitForm: Ein Besucher sendet erfolgreich ein Lead- oder Anfrageformular ab.
CompleteRegistration: Ein Nutzer schließt die Erstellung eines Kontos oder die Registrierung ab.
Subscribe: Ein Kunde schließt ein Abonnement ab.
StartTrial: Ein Nutzer startet einen Testzeitraum.
Der Event-Name allein reicht nicht aus. Sie müssen auch genau festlegen, wann jedes Event ausgelöst wird.
Beispielsweise kann sich Purchase darauf beziehen, dass eine Bestellung erstellt, die Zahlung autorisiert, die Zahlung eingezogen oder die Bestellung ausgeführt wird. Wählen Sie einen Trigger und wenden Sie ihn einheitlich auf Ihre Website, Ihr Backend und Ihre Reporting-Systeme an.
Parameter verleihen dem Event dann Kontext. Abhängig von der Aktion können dies Wert, Währung, Menge, Content-IDs und Produktinformationen sein. TikTok kennzeichnet einige Parameter als erforderlich und empfiehlt andere, da sie die Event-Qualität und Kampagnenleistung verbessern können.
Das Senden desselben Events auf verschiedenen Stufen kann Conversions und Umsatz künstlich aufblähen. Standardisieren Sie den Trigger und die Parameter vor dem Start, damit der Ads Manager eine konsistente Version jeder Kundenaktion erhält.
2. Event-Parameter
Sobald der Event-Trigger klar ist, beschreiben Parameter, was passiert ist, und liefern TikTok die notwendigen Informationen, um das Event korrekt zu interpretieren.
Ein Event kann Folgendes enthalten:
Event-Name: Die gemeldete Aktion, z. B.
AddToCartoderPurchase.Event-Zeitpunkt: Der Zeitpunkt, zu dem die Aktion stattgefunden hat.
Event-ID: Eine eindeutige Kennung, um dasselbe Event über Pixel und Events API hinweg wiederzuerkennen.
Event-Quell-URL: Die Seite, auf der die Aktion stattgefunden hat.
Währung: Die für die Transaktion verwendete Währung.
Conversion-Wert: Der dem Event zugeordnete monetäre Gesamtwert.
Produkt- oder Content-IDs: Die Identifikatoren für die beteiligten Produkte.
Content-Typ: Die Kategorie des gemeldeten Inhalts.
Menge: Die Anzahl der in der Aktion enthaltenen Einheiten.
Bestelldetails: Unterstützte Kaufinformationen, wie z. B. Content-Daten auf Artikelebene.
Produkt-IDs müssen demselben Format folgen, das in Ihrem verbundenen TikTok-Katalog verwendet wird. Prüfen Sie vor dem Mapping der Events, ob der Katalog Produkt-IDs, Varianten-IDs, SKUs oder andere plattformspezifische IDs speichert.
Währung und Wert erfordern ebenfalls eine konsistente Formatierung. Fehlende, statische oder falsch gemappte Werte können dazu führen, dass Kauf-Events keine nutzbaren Umsatzdaten enthalten, was das Reporting des Return on Ad Spend schwächt.
3. Kunden-Matching-Informationen
Nachdem TikTok ein Event empfangen hat, benötigt es genügend Informationen, um diese Aktion mit einem Kunden oder einer berechtigten Anzeigeninteraktion zu verknüpfen.
Gängige Matching-Identifikatoren sind:
TikTok Click-ID: Der
ttclid-Wert, der an einen TikTok-Anzeigenklick angehängt ist.Gehashte E-Mail-Adresse: Eine normalisierte, mit SHA-256 konvertierte E-Mail-Adresse.
Gehashte Telefonnummer: Eine einheitlich formatierte, mit SHA-256 konvertierte Telefonnummer.
Gehashte externe Kunden-ID: Ihre eigene Kundenkennung, aufbereitet nach den Vorgaben von TikTok.
Kunden-IP-Adresse: Die IP, die bei der Website-Aktion erfasst wurde.
Browser-User-Agent: Informationen über den Browser und das Gerät des Kunden.
TikTok-Erstanbieter-Identifikator: Der unterstützte
_ttp-Cookie-Wert, sofern verfügbar.
Ein Event kann von der Events API akzeptiert werden und dennoch ein schwaches Matching aufweisen, wenn diese Felder fehlen, ungültig oder falsch formatiert sind. Ein stärkeres Matching hängt davon ab, die Identifikatoren zu senden, die Sie rechtmäßig erfassen dürfen, und nicht einfach eine größere Datenmenge zu übertragen.
E-Mail-Adressen, Telefonnummern und externe IDs müssen exakt nach den Vorgaben von TikTok normalisiert und gehasht werden. Click-IDs, IP-Adressen, User Agents und unterstützte Cookie-Identifikatoren folgen ihren eigenen Formatierungsregeln.
Ihr Setup muss außerdem Einwilligungsentscheidungen, Datenschutzhinweise und die in den jeweiligen Märkten geltenden Datenschutzanforderungen einhalten.
Wie Event-Matching und Deduplizierung bei TikTok funktionieren
Event-Matching
TikTok verwendet Match-Keys, um eine gemeldete Conversion mit einer Person zu verknüpfen, die zuvor mit einer Anzeige interagiert hat. Ein nützlicher Schlüssel ist die TikTok Click-ID oder ttclid, die nach einem Klick auf eine Anzeige an die Zielseiten-URL angehängt werden kann.
Ihre Website sollte diesen Wert beibehalten, während sich der Besucher durch den Kaufprozess bewegt. Das Speichern dieses Werts zusammen mit der endgültigen Bestellung oder dem Lead erhöht die Chance für TikTok erheblich, das Ergebnis der ursprünglichen Interaktion zuzuordnen.
Die Click-ID kann verloren gehen, wenn:
Eine Weiterleitung URL-Parameter entfernt
Der Checkout auf eine andere Domain wechselt
Ein Zahlungsanbieter eine separate Sitzung startet
Tracking-Werte aus der URL bereinigt werden
Die ursprüngliche Sitzung abläuft
Kontaktdaten und externe Kunden-IDs können das Matching ebenfalls unterstützen, müssen jedoch vor dem Hashing normalisiert werden. Verwenden Sie zudem die tatsächliche IP-Adresse und den Browser-User-Agent des Kunden.
Das Senden von Platzhalterdaten, einer Server-IP oder eines Backend-User-Agents liefert TikTok Informationen über Ihr System statt über den Käufer.
Event-Deduplizierung
Wenn sowohl Pixel als auch Events API dieselbe Conversion senden, muss TikTok erkennen können, dass die beiden Datensätze eine einzige Kundenaktion beschreiben. Die Deduplizierung verhindert, dass ein Kauf, Lead oder eine Registrierung doppelt gezählt wird.
Beide Kopien müssen denselben Event-Namen und dieselbe eindeutige Event-ID verwenden.
Zum Beispiel:
Pixel
Purchase:order_84739Server
Purchase:order_84739
TikTok vergleicht diese Felder, um überlappende Events zu identifizieren. Wert, Währung und Produktdetails sollten ebenfalls übereinstimmen, damit das Reporting konsistent bleibt.
Eine Bestell-ID, Transaktions-ID, Checkout-Abschluss-ID oder eine stabile, serverseitig generierte UUID eignen sich gut, da sich jede auf eine einzelne Conversion bezieht.
Vermeiden Sie Produkt-IDs, Kunden-IDs, wiederverwendete Sitzungs-IDs oder separate Zufalls-IDs, die unabhängig voneinander von Browser und Server generiert werden.
API-Wiederholungsversuche (Retries) sollten die ursprüngliche Event-ID wiederverwenden. Eine neue ID kann dazu führen, dass der Wiederholungsversuch wie eine weitere Conversion erscheint.
So richten Sie die TikTok Conversion API ein
Schritt 1. Eine Integrationsmethode wählen
Ihre erste Entscheidung ist, wie die Event-Daten von Ihren Unternehmenssystemen zu TikTok gelangen sollen. Der beste Weg hängt von Ihrer bestehenden Plattform, dem verfügbaren technischen Support und dem Grad der Kontrolle ab, den Sie über Event-Mapping und Datenqualität benötigen.
Jede Methode deckt ein anderes Maß an Komplexität ab; vergleichen Sie die Optionen daher mit der Art und Weise, wie Ihr Shop Conversions bereits erfasst.
Integration über E-Commerce-Plattformen: Meistens der einfachste Weg für unterstützte Shopify- oder WooCommerce-Shops. Die Plattform übernimmt einen Großteil der Verbindung, des Event-Mappings und der Katalogeinrichtung.
Daten- oder Tracking-Partner: Geeignet, wenn Sie bereits eine Kundendatenplattform (CDP), ein CRM, einen Tag Manager oder einen Server-Tracking-Anbieter nutzen. Prüfen Sie, welche Events, Identifikatoren und Einwilligungssteuerungen der Partner unterstützt.
Direkte API-Integration: Besser für benutzerdefinierte Websites, proprietäre Checkouts, Marktplätze, Abonnement-Plattformen oder ungewöhnliche Conversion-Logiken. Sie bietet mehr Kontrolle, erfordert jedoch Entwicklung, Tests, Monitoring und Wartung.
Serverseitiger Google Tag Manager: Eine praktische Option für Teams, die bereits einen Server-Container betreiben und mit Tags, Triggern, Variablen, GA4 und Cloud-Hosting vertraut sind. TikTok bietet für diese Methode auch einen interaktiven Setup-Ablauf an.
Prüfen Sie vorab Ihre erforderlichen Events, technischen Ressourcen, die Katalogstruktur, den Zugriff auf Event-Logs, die Anzahl der Shops, das Einwilligungs-Setup und wer die Verbindung nach dem Start betreuen wird.
Schritt 2. Einen Event-Tracking-Plan erstellen
Erstellen Sie vor der Konfiguration der Integration einen Tracking-Plan, der jeder Kundenaktion eine einheitliche Definition zuweist. So arbeiten Entwickler, Marketer und Analytics-Teams nach denselben Regeln.
Halten Sie für jedes Event Folgendes fest:
TikTok-Event-Name
Bedeutung der Aktion für Ihr Unternehmen
Die genaue Bedingung, die es auslöst
Ob es vom Browser, Server oder beiden stammt
Datenfelder, die zwingend enthalten sein müssen
Verfügbare Matching-Informationen
Quelle der eindeutigen Event-ID
Geltende Einwilligungsbedingungen
Nehmen Sie Purchase als Beispiel. Entscheiden Sie, ob es ausgelöst werden soll, wenn der Shop eine Bestellung erstellt, oder erst nach erfolgreicher Zahlung. Für die meisten Shops liefert eine bestätigte Zahlung ein verlässlicheres Bild des tatsächlichen Umsatzes, da unbezahlte und fehlgeschlagene Bestellungen ausgeschlossen bleiben.
Halten Sie diese Regel im Plan fest und wenden Sie sie dann konsistent auf Checkout, Backend, Pixel und Events API an. Da TikTok Standard-Events über beide Tracking-Pfade hinweg unterstützt, verhindert eine gemeinsame Definition spätere widersprüchliche Berichte.
Schritt 3. Die richtige TikTok-Datenquelle verknüpfen
Öffnen Sie als Nächstes den Events Manager über das Werbekonto, mit dem die Kampagnen geschaltet werden sollen.
Gehen Sie zu Tools, wählen Sie Events Manager, klicken Sie auf Datenquelle verbinden und wählen Sie dann Web. Erstellen Sie eine neue Website-Datenverbindung oder öffnen Sie die bestehende, die mit der richtigen Website verknüpft ist.
Überprüfen Sie vor dem Abschluss des Setups Website-URL, Pixel-Code, Werbekonto und Benutzerberechtigungen. Diese Überprüfung ist besonders wichtig, wenn mehrere Shops oder Kundenkonten in einem Business Center verwaltet werden.
Wenn Pixel und Events API Aktivitäten derselben Website melden, verbinden Sie beide mit der vorgesehenen Website-Datenverbindung. Die Verwendung des falschen Ziels kann gültige Events an ein nicht verwandtes Konto senden, während den eigentlichen Kampagnen die benötigten Daten fehlen.
Schritt 4. Das Zugriffs-Token generieren und sichern
Wenn Sie eine direkte Integration der Events API aufbauen, generieren Sie das Zugriffs-Token, das zur Authentifizierung von Anfragen verwendet wird. Partner-Integrationen verwalten die Authentifizierung möglicherweise über ihren eigenen Verbindungsprozess.
Speichern Sie das Token in einer geschützten Serverumgebung, einem Secrets Manager oder einer verschlüsselten Konfigurationsdatei. Nur die für die Integration zuständigen Systeme und Personen sollten Zugriff darauf haben.
Geben Sie das Token unter keinen Umständen preis in:
Website-Quellcode
Browser-Skripten
Öffentlichen Repositories
Geteilten Screenshots
Ungeschützten Logs
Ein in clientseitigem Code platziertes Token kann über Browser-Tools eingesehen werden. Sollte eines öffentlich werden, tauschen Sie es unverzüglich aus und überprüfen Sie Ihre Event-Aktivitäten auf unerwartete Anfragen.
Dokumentieren Sie, wie die Anmeldeinformationen erneuert werden können, ohne die Event-Übertragung zu unterbrechen.
Schritt 5. Event-Daten erfassen und vorbereiten
Bereiten Sie nach dem Einrichten der Verbindung die Daten vor, die TikTok mit jedem Event erhalten soll.
Behalten Sie die ttclid von der Zielseite bei und leiten Sie sie über Weiterleitungen, Checkout- und Zahlungsschritte weiter. Speichern Sie sie nach Möglichkeit zusammen mit der endgültigen Bestellung oder dem Lead.
Erfassen Sie als Nächstes nur die Kundenidentifikatoren, die Ihre Einwilligungseinstellungen erlauben. Normalisieren Sie E-Mail-Adressen und Telefonnummern, bevor Sie das vorgeschriebene Hashing anwenden, anstatt uneinheitliche Rohwerte zu hashen.
Das Event sollte nach Möglichkeit auch die tatsächliche IP-Adresse und den Browser-User-Agent des Kunden enthalten. Ersetzen Sie diese nicht durch Daten Ihres Hosting-Servers oder Backend-Systems.
Generieren Sie schließlich für jede Aktion eine stabile Event-ID. Verwenden Sie denselben Wert in der Pixel- und der Server-Kopie, damit TikTok beide als eine einzige Conversion identifizieren kann.
Schritt 6. Pixel- und Server-Events senden
Sobald die Event-Daten vorbereitet sind, senden Sie die Browser- und Server-Kopien unter demselben TikTok-Event-Namen und derselben Event-ID. Diese gemeinsame Identität ermöglicht es TikTok, überlappende Datensätze zu erkennen und die Aktion nur einmal zu zählen.
Verwenden Sie Backend-Daten für den endgültigen Kaufwert, die Währung, die Bestell-ID und die Produktdetails, da Ihr Shop oder Zahlungssystem den bestätigten Transaktionsdatensatz enthält.
Das Purchase-Event sollte nur an dem in Ihrem Tracking-Plan festgelegten Punkt ausgelöst werden. Senden Sie es beispielsweise erst nach erfolgreicher Zahlung oder Bestätigung einer gültigen Bestellung – nicht, wenn der Kunde lediglich den Checkout betritt oder eine Zwischenseite zur Zahlung erreicht.
Vergleichen Sie vor dem Start beide Kopien des Events und stellen Sie sicher, dass Namen, IDs, Werte und Bestellinformationen übereinstimmen.
Schritt 7. Events im TikTok Events Manager testen
Öffnen Sie vor dem Start von Kampagnen die Test-Tools im Events Manager und führen Sie die in Ihrem Tracking-Plan aufgeführten Aktionen durch.
Führen Sie einen Produktaufruf, das Hinzufügen zum Warenkorb, den Checkout und einen Testkauf durch. Überprüfen Sie anschließend Folgendes:
Browser- und Server-Events erreichen die vorgesehene Website-Datenverbindung
Event-Namen und Zeitstempel stimmen mit den durchgeführten Aktionen überein
Kaufwert und Währung spiegeln die Testbestellung wider
Produkt-IDs entsprechen dem Format des verbundenen Katalogs
Verfügbare Matching-Identifikatoren werden korrekt angezeigt
Überlappende Events tragen denselben Event-Namen und dieselbe Event-ID
Temporäre Testeinstellungen werden vor dem Start entfernt
Überprüfen Sie auch den Bereich „Diagnose“. Ein Event kann erfolgreich ankommen, aber dennoch fehlende, ungültige oder falsch formatierte Informationen enthalten.
Prüfen Sie nach dem Testen die Deduplizierungsdetails für übereinstimmende Browser- und Server-Datensätze. Das Reporting im Events Manager wird außerhalb der Live-Testansicht möglicherweise nicht sofort aktualisiert. Warten Sie daher die Verarbeitungszeit ab, bevor Sie ein ausstehendes Event als fehlgeschlagene Anfrage einstufen.
Häufige Probleme mit der TikTok Conversion API und deren Behebung
Ein empfangenes Event kann dennoch falsche Werte, unzureichende Matching-Informationen oder doppelte Datensätze enthalten. Nutzen Sie die folgenden Prüfungen, um die Ursache zu ermitteln, bevor Sie die gesamte Integration ändern.
Problem | Wahrscheinliche Ursache | Was zu prüfen ist |
Käufe werden doppelt angezeigt | Browser- und Server-Events verwenden unterschiedliche IDs | Vergleichen Sie den Event-Namen und die Event-ID in beiden Kopien |
Server-Events werden nicht angezeigt | Falsche Datenquelle, falsches Token, Werbekonto oder fehlerhafte Umgebung | Prüfen Sie die verbundene Datenquelle, das Zugriffs-Token, das Konto und die Produktionskonfiguration |
TikTok ordnet nur wenige Events zu | Click-ID oder Kundenidentifikatoren fehlen | Überprüfen Sie, welche Match-Keys erfasst und gesendet werden |
Alle Events zeigen dieselbe IP-Adresse | Die IP des Hosting-Servers wird weitergeleitet | Übertragen Sie die ursprüngliche Besucher-IP, sofern zulässig |
User Agent fehlt | Browserinformationen wurden nicht beibehalten | Erfassen Sie den User Agent des Besuchers während der Sitzung |
Kaufumsatz ist null | Wert oder Währung fehlt oder ist falsch formatiert | Überprüfen Sie die Parameter für Wert und Währung |
Produkte stimmen nicht mit dem Katalog überein | Content-IDs verwenden ein anderes ID-Format | Vergleichen Sie Event-IDs mit dem Format von Produkt, Variante oder SKU im Katalog |
Bestellungen werden vor der Zahlung gesendet | Der Purchase-Trigger wird zu früh ausgelöst | Prüfen Sie den Zahlungs- oder Bestellstatus, der das Event aktiviert |
Wiederholungsversuche erzeugen zusätzliche Käufe | Jeder Versuch erhält eine neue Event-ID | Verwenden Sie die ursprüngliche Event-ID für jeden Wiederholungsversuch wieder |
Events treffen verspätet ein | Eine Warteschlange, Batch-Verarbeitung oder ein Partner verzögert die Auslieferung | Senden Sie die ursprüngliche Aktionszeit statt der späteren Verarbeitungszeit |
Eine geringere Kaufanzahl in TikTok deutet nicht automatisch auf einen Fehler hin. Ihr Shop zeichnet jede Bestellung auf, während der Ads Manager nur Käufe ausweist, die unter den ausgewählten TikTok-Einstellungen zugeordnet wurden.
Vergleichen Sie Backend-Käufe, Pixel-Events, Server-Events, deduplizierte Datensätze und attribuierte Käufe, um die Ursache für Abweichungen zu finden.
Fundiertere Entscheidungen bei jedem TikTok-Test
Die TikTok Conversion API, offiziell als TikTok Events API bezeichnet, bietet Ihnen ein klareres Bild davon, was Kunden tun, nachdem sie mit Ihren Anzeigen interagiert haben. Für Website-Kampagnen empfiehlt TikTok die parallele Nutzung mit dem Pixel, damit Browser- und Server-Events dasselbe Mess-Setup unterstützen.
Aussagekräftige Berichte hängen nach wie vor von der Qualität der gesendeten Events ab. Purchase-Trigger müssen echte Bestellungen widerspiegeln, Umsatzwerte müssen präzise sein, Katalog-IDs müssen übereinstimmen und duplizierte Browser- und Server-Events erfordern konsistente IDs.
Diese Prüfungen zeigen Ihnen, wie Ihre Kampagnen abgeschnitten haben. WinningHunter unterstützt Sie bei den Entscheidungen, die vor dem Start anstehen. Sie können aktive TikTok-Anzeigen, Mitbewerberaktivitäten, Produktsignale, Creative-Formate und Shop-Daten analysieren, um zu entscheiden, welche Ideen einen Test wert sind.
Zusammen eingesetzt hilft Ihnen die Recherche dabei, bessere Tests auszuwählen, während präzise Conversion-Daten aufzeigen, welche dieser Tests echte Ergebnisse geliefert haben.
Häufig gestellte Fragen (FAQs)
Ist die TikTok Conversion API dasselbe wie die Events API?
Ja. Events API ist der offizielle Produktname von TikTok. Werbetreibende und Tracking-Anbieter nennen sie oft TikTok Conversion API, Conversions API oder TikTok CAPI. Diese inoffiziellen Begriffe beziehen sich im Allgemeinen auf dieselbe Serververbindung, die verwendet wird, um Marketing-Events von Websites, Apps, CRMs und Offline-Systemen direkt an TikTok zu senden.
Benötige ich das TikTok-Pixel weiterhin, wenn ich die Events API nutze?
TikTok empfiehlt, Pixel und Events API für das Web-Conversion-Tracking gemeinsam einzusetzen. Das Pixel sendet Aktivitäten aus dem Browser, während die Events API Datensätze von einem Server oder einer angebundenen Plattform übermittelt. Wenn beide Verbindungen dieselbe Kundenaktion melden, müssen sie denselben Event-Namen und dieselbe Event-ID aufweisen, damit TikTok Duplikate entfernen kann.
Was ist Event-Deduplizierung bei TikTok?
Die Event-Deduplizierung verhindert, dass eine Conversion doppelt gezählt wird, wenn sowohl das Pixel als auch die Events API sie melden. TikTok vergleicht den Event-Namen und die Event-ID in jeder Kopie. Wenn diese Felder übereinstimmen, erkennt TikTok, dass beide Datensätze denselben Kauf, dieselbe Registrierung, denselben Lead oder eine andere Kundenaktion beschreiben.
Was sollte ich als TikTok-Event-ID verwenden?
Verwenden Sie eine Kennung, die an eine bestimmte Conversion gebunden ist, wie eine Bestell-ID, Transaktions-ID, stabile Checkout-Abschluss-ID oder eine serverseitig generierte UUID. Pixel und Events API müssen für überlappende Events denselben Wert erhalten. Auch jeder Wiederholungsversuch der Server-Anfrage sollte diese ursprüngliche ID wiederverwenden, anstatt eine neue zu erzeugen.
Kann ich die TikTok Events API auf Shopify einrichten?
Ja. Shopify-Händler können die Verbindung zu TikTok über die offizielle E-Commerce-Integration oder einen anderen kompatiblen Tracking-Anbieter herstellen. Verfügbarkeit und Funktionen können je nach Markt und Setup variieren. Prüfen Sie vorab, welche Events, Kundenidentifikatoren, Einwilligungssignale, Umsatzfelder und Produkt-IDs die Integration von Ihrem Shop an TikTok sendet.
Warum meldet TikTok weniger Käufe als Shopify?
Shopify erfasst alle Bestellungen unabhängig von der Traffic-Quelle, während TikTok nur Käufe ausweist, die der TikTok-Werbung im Rahmen der gewählten Attributionseinstellungen zugeordnet wurden. Unterschiede können auch auf Attributionszeitfenster, fehlende Match-Keys, Nutzereinwilligungen, Übertragungsfehler, Verarbeitungsverzögerungen oder Deduplizierung zurückzuführen sein. Vergleichen Sie die empfangenen Events, bevor Sie von einem technischen Fehler ausgehen.
Umgeht die TikTok Events API Ad-Blocker?
Die Events API ist weniger abhängig von Browser-Skripten, da das Event von einem Server oder einer angebundenen Plattform gesendet wird. Dennoch sollte sie nicht als völlig immun gegen Ad-Blocker, Browser-Kontrollen, Einwilligungsentscheidungen oder Datenschutzbeschränkungen angesehen werden. Sie müssen Kundendaten weiterhin rechtmäßig erfassen und übermitteln sowie die Vorgaben von TikTok einhalten.
Wie kann ich überprüfen, ob die TikTok Events API funktioniert?
Öffnen Sie den TikTok Events Manager und prüfen Sie empfangene Server-Events, Parameter, Matching-Informationen, Diagnosedaten und Deduplizierungsdetails. Testen Sie wichtige Aktionen wie Käufe und vergleichen Sie den gemeldeten Wert, die Währung, die Produkt-IDs und die Event-IDs mit Ihren Shop- und Zahlungsdaten. Berücksichtigen Sie die Verarbeitungszeit, bevor Sie ein verzögertes Event als fehlend einstufen.











