Twitter-Konversion-API-Tag für sGTM

Die Twitter Conversion API ermöglicht es Ihnen, Informationen von Ihrem Server direkt an die Twitter-Server zu senden, die zur Messung des Kampagnenerfolgs verwendet werden können.

Während viele Marketer bereits eine serverseitige Google Ads Conversion Tracking Einrichtung nutzen, zieht Twitter nun nach. Wie Facebook erlaubt und empfiehlt Twitter die Verwendung einer hybriden Tracking-Methode, Web+Server. Bei der Kombination von Web- und Server-Tracking ist eine Deduplizierung erforderlich. Um Nutzer in Events mit Twitter-Profilen abzugleichen, werden Kundendaten verwendet: E-Mail und twclid.

In diesem Leitfaden wird erläutert, wie die Twitter-Konvertierungs-API funktioniert und wie man das Twitter-CAPI-Tag in sGTM einrichtet.

Sie benötigen mehr als nur eine Twitter-Pixel-ID oder ein API-Token, um Ihre Twitter CAPI zu identifizieren. Twitter verlangt eine zusätzliche Authentifizierung, die sich nicht über sGTM implementieren lässt. Deshalb funktioniert das Twitter CAPI-Tag im Moment nur mit dem Stape. Ändern Sie die Tag-Vorlage und implementieren Sie bei Bedarf selbst eine Authentifizierung.

Die neue Twitter-CAPI ist noch nicht einsatzbereit und erfordert 5x mehr Arbeit als eine „Standard“-CAPI-Implementierung, wenn Sie bereits mit den APIs von FB oder TikTok vertraut sind. Darüber hinaus gibt es einige andere Komplikationen bei der Nutzung der Plattform, die die Dinge erschweren.

Sie benötigen ein Dev-Konto, müssen den Zugang zur Twitter CAPI beantragen und mehrere Zugangstoken generieren. Auf all diese Schritte werden wir später in einem Blogbeitrag näher eingehen.

Für den Zugriff auf die Ads-API wenden Sie sich bitte an einen Twitter-Mitarbeiter.

Vorhandene Ads-API-Anwendungen

Wenn Sie eine aktive Ads-API-Anwendung haben, können Sie diese und ihre Zugriffstoken für die Conversion-API verwenden.

Access Tokens

• Personal Tokens: Generieren Sie diese für Ihr Twitter-Handle im Entwicklerportal.
• Other Users' Tokens: Verwenden Sie einen 3-stufigen OAuth-Flow:

- Eine Befehlszeile mit Web-Autorisierung (twurl)

- Eine Befehlszeile mit PIN-basierter Autorisierung

- Benutzerdefinierter Webfluss

Token für die Konvertierungs-API müssen von Benutzern mit AD_MANAGER- oder ACCOUNT_ADMIN-Zugang stammen, was Sie über den Endpunkt authenticated_user_access überprüfen können.

Hinweis: Sie können Token mit Benutzern ohne AD_MANAGER- oder ACCOUNT_ADMIN-Zugang teilen.

Die Twitter Conversion API-Authentifizierung ist ein komplizierter Prozess; im Moment kann die Twitter CAPI-Authentifizierung auf sGTM noch nicht voll funktionsfähig sein. Aus diesem Grund wird die Authentifizierung intern durchgeführt. Das bedeutet, dass der Twitter CAPI-Tag das Hosting durch Stape erfordert. Wenn wir nur sGTM für die Authentifizierung verwenden können, werden wir dieses Tag aktualisieren, um jedes Hosting zu unterstützen. Den sGTM-Container-API-Schlüssel finden Sie in den Container-Einstellungen.

Diese beiden Schlüssel können nur generiert werden, wenn Sie ein Twitter Entwickler-Konto haben. Um ein Twitter-Entwicklerkonto zu erhalten, müssen Sie ein solches beantragen und 1-3 Tage warten, bis Ihr Antrag genehmigt wird.

Wenn Sie sich bewerben, müssen Sie Essential Access beantragen. Stellen Sie sicher, dass Sie den richtigen Twitter-Account für die Beantragung von Entwickler-Accounts verwenden, da es nicht möglich ist, den Account später zu ändern.

Wenn Sie einen Dev-Account erhalten, erstellen Sie eine App im Abschnitt Projekt und App. Sobald Sie dies getan haben, werden ein Consumer Key und ein Consumer Secret generiert.

Sie finden diese beiden in Ihrer Anzeige auf Ihrem Twitter-Entwicklerkonto.

1. Erstellen Sie einen Server Google Tag Manager Container und richten Sie ihn ein.

Wichtig: Das Twitter CAPI Tag funktioniert nur, wenn Sie Stape Hosting für sGTM Container verwenden.

2. Senden Sie Daten aus dem Web an den GTM-Server.  Sie können serverseitige GA4, Webhooks, oder Data Tag/Data Client einrichten.

3. Laden Sie das Twitter Conversion API-Tag aus der Template Gallery.

4. Erstellen Sie ein neues Tag und wählen Sie Twitter Tag. Um den Stape Container-API-Schlüssel hinzuzufügen, öffnen Sie die sGTM Container-Einstellungen und kopieren Sie den Container-API-Schlüssel.

5. Fügen Sie Consumer Key, Consumer Secret, OAuth Token und OAuth Token Secret hinzu. Wie Sie diese Werte generieren, habe ich hier beschrieben.

6. Fügen Sie die Twitter-Pixel-ID und die Ereignis-ID hinzu. Sie finden diese Werte im Tweeter Events Manager.

7. Fügen Sie die Server-Ereignisdatenüberschreibung und die Benutzerdaten hinzu, die Sie an Twitter senden möchten, und richten Sie einen Auslöser ein.

Twitter CAPI Tag Parameter:

Stape Container API Key - finden Sie ihn in der sGTM Container-Einstellung in Ihrem Stape-Konto.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - diese finden Sie in Ihrem Twitter Dev-Konto, nachdem Sie eine Twitter-App erstellt haben. Wir werden Ihnen später zeigen, wie Sie diese generieren können.

Pixel-ID - Dies ist die Universal Website Tag (UWT)-ID Ihres Twitter-Anzeigenkontos. Sie finden sie im Twitter Ereignis-Manager.

Event ID - Diese finden Sie beim Erstellen eines Conversion-API-Ereignisses im Twitter-Ereignismanager.

Use HttpOnly cookies - Verhindert, dass JavaScript auf das Cookie zugreift, wenn es aktiviert ist.

Server Event Data Override - wählen Sie diese Option, um einen der Standard-Serverparameter zu überschreiben: Umrechnungszeit, Anzahl der Artikel, Währung, Wert, Umrechnungs-ID, Beschreibung und Inhalt.

User Data - fügen Sie Benutzerdaten hinzu: E-Mail oder twclid.

Logs Settings - wählen Sie, ob Sie Stape-Protokolle verwenden möchten.

9. Ereignisse testen. Wenn Ihr Ereignis innerhalb von 12 bis 24 Stunden erfolgreich Conversion-Ereignisse empfangen hat, sollte der Status des „Einzelereignis-Web-Tags“ auf der Conversion-Tracking-Seite des Ads Managers TRACKING anzeigen. Dies hat keine Auswirkungen auf laufende Kampagnen, die Conversions über die Conversion-API senden.

Twitter unterstützt die Deduplizierung von Ereignissen. Die Kombination von Web- und Server-Tracking erfordert das Senden eines Deduplizierungsschlüssels sowohl mit Web- als auch mit Server-Events. Verwenden Sie conversion_id, um den Deduplizierungsschlüssel zu senden. Die Deduplizierung erfolgt nur, wenn die Ereignisse innerhalb von 48 Stunden empfangen wurden.

Um ein reines Server-Ereignis zu erstellen, verwenden Sie den Twitter-Ereignismanager, um ein neues Ereignis zu erstellen, und wählen Sie im dritten Schritt Mit Conversion-API installieren.

Im Gegensatz zu anderen Plattformen akzeptiert Twitter nur die Benutzer-E-Mail und twclid. Wenn Sie eine E-Mail senden, sollte sie mit SHA256 gehasht sein. Twitter Tag hat die Benutzer-E-Mail automatisch gehasht.

Leider gibt es keine Möglichkeit, Twitter-Server-Ereignisse in Echtzeit zu testen. Wenn das Tracking korrekt eingerichtet ist, sollte der Status des „Einzelereignis-Web-Tags“ innerhalb von 12 bis 24 Stunden beim Conversion-Tracking im Anzeigenmanager angezeigt werden.

Twitter CAPI kann eine großartige Ergänzung zu Ihrem serverseitigen Tracking-Stack sein. Obwohl der Autorisierungsprozess für Twitter CAPI im Moment unglaublich kompliziert ist, funktioniert die andere Logik sehr ähnlich wie die Konvertierungs-APIs von FB oder TikTok: Sie können benutzerdefinierte oder Standard-Ereignisse senden und Web+Server oder nur Server-Tracking verwenden. Twitter fragt nach Nutzerdaten, um Nutzer abzugleichen, aber im Moment unterstützen sie nur Nutzer-E-Mail und twclid.

Twitter CAPI hat zwei Hauptnachteile: den Authentifizierungsprozess und das Fehlen eines Echtzeit-Testtools. Aufgrund des Verifizierungsprozesses funktioniert der Twitter-Tag nur mit Stape-Servern für sGTM. Wenn Twitter den Authentifizierungsprozess vereinfacht, wird das Stape-Team das Tag aktualisieren, damit es mit GCP funktioniert.

Diese Anleitung hilft Ihnen, sich mit Twitter CAPI vertraut zu machen und es in sGTM einzurichten. Ausführlichere Informationen über Twitter CAPI finden Sie in der offiziellen Dokumentation.