Integration · Destination
X Ads (Twitter)
X Pixel und Conversion API mit twclid.
So erreichen Events X Ads
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.
- Hybrid — Browser-Tag und Server-Request teilen eine Event-ID; die Plattform dedupliziert über conversion_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 conversion_id der Plattform, damit Browser- und Serverzustellung nur einmal zählen.
- Click-IDs, die diese Plattform erhalten darf: twclid. 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
conversion_id— conversion_id- Click-IDs
twclid- Consent-Zweck
- Marketing
- Gepinnte API-Version
12- Umsetzungsstatus
- Umgesetzt · gegen die Anbieter-Dokumentation verifiziert · verifiziert am 2026-09-03
- Anbieter-Dokumentation
- API-Dokumentation von X Ads
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
- X-Pixel-ID
Zugangsdaten
- OAuth-Verbindung · X
oauth_access_token— im verschlüsselten Tresor gespeichert- OAuth-Token-Secret · X
oauth_token_secret— 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.
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.
X Ads verbinden
Mit dem geführten Assistenten einrichten oder den Chat-Assistenten machen lassen.