Integration mit Werbeplattformen

X-Conversions, von deinem Server gesendet

ROASaurus sendet Käufe, Warenkorb-Hinzufügungen, Checkouts und Seitenaufrufe an den Conversions-Endpunkt der X Ads API. In ROASaurus gibt es für X keinen Browser-Pixel: Es empfängt nur Server-Events.

X (Twitter) auf einen Blick
VerbindungWeb-Conversions der X Ads API, signiert mit OAuth 1.0a
EventsPurchase (erforderlich), Warenkorb-Hinzufügung, Checkout gestartet, Seitenaufruf, jeweils als Event-ID aus dem Events Manager
Identifikatorentwclid, gehashte E-Mail, gehashte Telefonnummer (E.164); IP und User-Agent nur zusammen mit einem davon
ZugangsdatenPixel-ID, API-Key und Secret, Zugriffstoken und Secret
Browser-PixelNein, nur Server-Events
Ausgaben-SyncJa: Kampagnenausgaben, Impressionen und Klicks pro Tag, nachdem du das Werbekonto unter Setup › Ad spend verbunden hast

Was ROASaurus an X sendet

X hat keine Standard-Event-Namen. Jeder Event-Typ ist eine Event-ID, die du im X Events Manager anlegst, etwa tw-o1abc-o1def, und in ROASaurus einfügst. Die Event-ID für den Kauf ist erforderlich. Warenkorb-Hinzufügung, Checkout gestartet und Seitenaufruf sind optional; ein Event-Typ ohne ID wird nicht gesendet. Produktansichten werden nicht an X gesendet.

Jede Conversion listet Identifikatoren auf: die Click-ID twclid, die mit SHA-256 gehashte E-Mail und die Telefonnummer im E.164-Format, gehasht. IP-Adresse und User-Agent werden nur zusammen mit einem davon ergänzt, weil X sie nur in Kombination zählt. ROASaurus sendet außerdem eine Conversion-ID, Wert, Währung, Artikelanzahl und die Produkte. Eine Conversion ohne twclid, E-Mail oder Telefonnummer wird übersprungen.

ROASaurus wertet eine Übermittlung nur dann als gesendet, wenn X mindestens eine verarbeitete Conversion meldet.

So verbindest du es

  1. Hole dir eine X-Developer-App mit Zugriff auf die Ads API.
  2. Generiere OAuth-1.0a-Nutzertokens für einen Nutzer mit Ad-Manager-Zugriff auf das Werbekonto: Du brauchst den API-Key und das Secret sowie das Zugriffstoken und das Secret.
  3. Lege im X Events Manager für jeden gewünschten Typ ein Event an und kopiere die Event-IDs.
  4. Gehe in ROASaurus zu Tracking & platforms, klicke auf der X-Karte auf Add pixel und gib die Pixel-ID, die Event-IDs und die vier Schlüssel ein.

Einschränkungen

  • Kein Browser-Pixel: X empfängt nur Server-Events.
  • Die Kampagnenausgaben von X werden synchronisiert, sobald du das Werbekonto unter Setup › Ad spend verbindest.
  • Eine twclid allein erzeugt noch keinen Attributions-Touchpoint. Versieh deine X-Anzeigen mit UTM-Parametern, damit die Besuche in der Attribution nach Quelle und Kampagne erscheinen.

Verwandt

FAQ

Antworten auf deine Fragen

Warum braucht X vier Schlüssel?

Die X Ads API verlangt für eigene Integrationen OAuth 1.0a. Jede Anfrage wird mit dem API-Key und dem Secret deiner App sowie dem Zugriffstoken und dem Secret eines Nutzers signiert, der das Werbekonto verwalten darf.

Lädt ROASaurus den X-Pixel?

Nein. X empfängt nur Server-Events. Conversions werden über die Click-ID twclid oder die gehashte E-Mail oder Telefonnummer des Kunden abgeglichen.

Welche X-Events kann ich senden?

Purchase, Warenkorb-Hinzufügung, Checkout gestartet und Seitenaufruf. Lege jedes im X Events Manager an und füge seine Event-ID ein. Nur der Kauf ist erforderlich.

Jeder Verkauf, zurückverfolgt zur Anzeige, die ihn gebracht hat

Server-Side-Tracking, Gewinn und Customer Lifetime Value in einer App. 14 Tage kostenlos testen, ohne Kreditkarte.

Starte deine kostenlose Testphase →