Integration · Destination
TikTok Ads
TikTok Pixel und Events API mit ttclid-Matching und Deduplizierung.
So erreichen Events TikTok
Jeder Pfad endet an derselben Stelle: Die Policy-Engine prüft den Consent-Zweck, den diese Destination benötigt, entfernt, was nicht hinaus darf, und der Worker stellt mit der gemeinsamen Event-ID zu.
- Browser-Tag — vom Track-Snippet nach Consent geladen; das Anbieter-Skript liegt nie im Template und wird ohne den nötigen Zweck nie geladen.
- Server-API — vom Worker zugestellt, mit Retries, Health-Checks, Fehlerklassifikation und geschwärzter Payload-Vorschau für jeden Versuch.
- Offline-Conversions — als offline markierte Server-Events (CRM-Abschlüsse, Telefonbestellungen, Ladenkäufe) erreichen diese Plattform mit der Offline-Action-Source des Anbieters.
- Hybrid — Browser-Tag und Server-Request teilen eine Event-ID; die Plattform dedupliziert über event_id.
Was gesendet wird
Nur, was du im Event-Mapping konfigurierst — und erst, nachdem die Policy-Engine das Event für diese Destination freigegeben hat.
- Eventname und Zeitstempel, von Tracks Standard-Events auf die Eventnamen der Plattform abgebildet.
- Die gemeinsame Event-ID im Feld event_id der Plattform, damit Browser- und Serverzustellung nur einmal zählen.
- Click-IDs, die diese Plattform erhalten darf: ttclid. Click-IDs anderer Anbieter werden nie weitergegeben.
- Bestellnummer, Wert, Währung und Positionen bei Kauf-Events.
- SHA-256-gehashte Kennungen (E-Mail, Telefon, externe ID) für das Matching — nur mit dem nötigen Consent und nur, wenn erfasst.
- Der Consent-Zustand, unter dem das Event erfasst wurde, sofern die Plattform Consent-Signale annimmt.
Nie gesendet
- E-Mail-Adressen, Telefonnummern oder Namen im Klartext — Kennungen werden beim Ingest gehasht.
- Abgeleitete Werte: Unbekannt bleibt unbekannt, nichts wird geraten.
- Events, die ohne den von dieser Destination benötigten Zweck erfasst wurden.
- Geheimnisse: Tokens liegen im verschlüsselten Tresor und erreichen nie Browser, Assistent oder Log.
Technische Fakten
- Deduplizierungsfeld
event_id— event_id- Click-IDs
ttclid- Consent-Zweck
- Marketing
- Gepinnte API-Version
v1.3- Umsetzungsstatus
- Umgesetzt · gegen die Anbieter-Dokumentation verifiziert · verifiziert am 2026-09-03
- Anbieter-Dokumentation
- API-Dokumentation von TikTok
Was du brauchst
Öffentliche Kennungen kannst du im Chat oder Assistenten eingeben; Geheimnisse gehen über die sichere Zugangsdaten-Karte oder OAuth und werden verschlüsselt gespeichert.
Öffentliche Kennungen
- pixel_id
- Pixel-Code
Zugangsdaten
- API-Zugangstoken
access_token— im verschlüsselten Tresor gespeichert
Consent
Benötigt den Zweck Marketing. Ohne ihn wird im Browser nichts geladen und vom Server nichts gesendet. Abgeleiteter Consent wird nie exportiert, und Global-Privacy-Control-Opt-outs blockieren die Zustellung.
Einrichtung in wenigen Schritten
Die detaillierten Prüfungen übernimmt der Assistent. Du siehst die Meilensteine, die eine Entscheidung von dir brauchen.
Kennungen eingeben
Die öffentlichen IDs der Plattform hinzufügen. Formate werden gegen die Anbieter-Dokumentation validiert, bevor etwas gespeichert wird.
Zugangsdaten verbinden
Token in die sichere Karte einfügen oder das Konto per OAuth verbinden. Geheimnisse wandern direkt in den verschlüsselten Tresor.
Mappen und testen
Standard-Events sind auf die Eventnamen der Plattform vorgemappt. Ein markierter Testevent läuft durch die echte Pipeline und zeigt die Antwort des Anbieters.
Veröffentlichen
Diff prüfen, freigeben, signierte Konfigurationsversion veröffentlichen. Bei Bedarf Rollback per Klick.
Aus Tracking Knowledge
Leitfäden vom Team, das diesen Connector baut.
TikTok Events API 2.0: Pixel plus Server-Events mit ttclid, _ttp und gemeinsamer event_id
TikTok Pixel und Events API gemeinsam einrichten — Access-Token, Pixel-Code, die /event/track/-Payload, Matching-Schlüssel, Deduplizierung und Test-Event-Codes.
Tutorial · 2 Min. Lesezeit
Deduplizierung, die der Realität standhält: Event-IDs, Bestellnummern und worauf jede Plattform wirklich schlüsselt
Eine Tabelle der Deduplizierungsschlüssel je Plattform — Meta, Google Ads, GA4, TikTok, Microsoft, LinkedIn, Pinterest, Snapchat, Reddit, X, CM360 — und die Zwei-Schlüssel-Strategie, die hybrides Tracking ehrlich hält.
Referenz · 3 Min. Lesezeit
Click-IDs und Attributionsfenster: welche Parameter erfassen, wie lange behalten und wo speichern
Eine Referenz der Werbe-Click-IDs (gclid, gbraid, wbraid, dclid, msclkid, fbclid, ttclid, li_fat_id, rdt_cid, epik, ScCid, twclid, tblci, ob_click_id, Affiliate-IDs), wie Consent ihre Erfassung steuert, wie sich Attributionsfenster je Plattform unterscheiden und wie First-Party-Speicherung ablaufen sollte.
Referenz · 3 Min. Lesezeit
Fragen
Kann ich nur serverseitig senden?
Ja. Wähle im Assistenten den Servermodus; das Anbieter-Skript wird nie geladen und das Matching stützt sich auf gehashte Kennungen und vom Tracker erfasste Click-IDs.
Wie werden Duplikate vermieden?
Browser-Tag und Server-Request tragen dieselbe Event-ID, Käufe zusätzlich die Bestellnummer. Der Worker dedupliziert wiederholte Quell-Events zudem vor der Zustellung.
Was, wenn sich die Anbieter-API ändert?
API-Versionen sind zentral mit Prüfdatum gepinnt; Sunset-Warnungen erscheinen im Destination-Zustand lange bevor ein Endpunkt abgeschaltet wird.
TikTok verbinden
Mit dem geführten Assistenten einrichten oder den Chat-Assistenten machen lassen.