Twitter-Konversion-API-Tag für sGTM

Die Twitter-Konversion-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.

Mit der CAPI von Twitter wird das Tracking sicherer und genauer. Wie FB ermöglicht auch Twitter das Tracken von Webseiten und Servern. Bei der Kombination von Web- und Server-Tracking ist eine Deduplizierung erforderlich. Um Nutzer in Veranstaltungen mit Twitter-Profilen abzugleichen, werden Kundendaten verwendet: E-Mail und Euklid.

In diesem Leitfaden erläutere ich, wie die Twitter-Konversion-API funktioniert und wie man das Twitter CAPI-Tag in sGTM einrichtet. 

So funktioniert die Twitter-Konversion-APILink zu diesem Abschnitt kopieren

AuthentifizierungLink zu diesem Abschnitt kopieren

Damit ein Twitter CAPI-Tag funktioniert, reicht es nicht aus, nur eine Pixel-ID oder ein API-Token hinzuzufügen. Twitter erfordert eine zusätzliche Authentifizierung. Diese Art der Authentifizierung kann nicht über sGTM realisiert werden. Daher funktioniert der Twitter CAPI-Tag derzeit nur mit Stape-Servern für sGTM. 

Stape verfügt über ein optionales Modul für die Twitter-API-Authentifizierung. Aus diesem Grund funktioniert der Twitter CAPI-Tag nur mit stape. Sie können die Tag-Vorlage verwenden, um sie zu ändern und die Authentifizierung selbst zu implementieren. 

Es sieht so aus, als ob die Art und Weise, wie die Twitter-CAPI funktioniert, die erste Version ist und noch verbessert wird. Realistisch betrachtet wird es fünfmal länger dauern, die Twitter-CAPI zu implementieren als die "Standard"-CAPI, wenn man bereits mit der FB- oder TikTok-CAPI vertraut ist. Abgesehen davon gibt es noch ein paar andere Schwierigkeiten mit dem Twitter-CAPI. Sie benötigen ein Dev-Konto, eine Anwendung für den Twitter-CAPI-Zugang und die Generierung einiger Zugangstoken. Ich werde all diese Schritte später in einem Blog-Beitrag näher erläutern. 

Ereignis-DeduplizierungLink zu diesem Abschnitt kopieren

Twitter unterstützt die Deduplizierung von Ereignissen. Sie senden dieselbe Ereignis-ID, wenn Sie sowohl das Server- als auch das Webtracking verwenden möchten. Wenn Sie nur Ereignisdaten vom Server senden möchten, sollten Sie eine neue Ereignis-ID im Twitter Event Manager erstellen. 

Wenn Sie das Tracking von Web- und Serverereignissen kombinieren, müssen Sie einen Deduplizierungsschlüssel sowohl mit Web- als auch mit Serverereignissen senden. Verwenden Sie conversion_id, um den Deduplizierungsschlüssel zu senden. Die Deduplizierung erfolgt nur, wenn die Ereignisse innerhalb von 48 Stunden eingehen. 

Twitter CAPI-BenutzerparameterLink zu diesem Abschnitt kopieren

Im Gegensatz zu anderen Plattformen akzeptiert Twitter nur die E-Mail und Euklid des Nutzers. Wenn Sie eine E-Mail senden, muss sie mit SHA256 gehasst werden.

Twitter CAPI-TestsLink zu diesem Abschnitt kopieren

Leider gibt es keine Möglichkeit, Ereignisse auf dem Twitter-Server in Echtzeit zu überprüfen. Wenn das Tracking korrekt eingerichtet ist, sollten Sie sehen, dass der Status des "Single Event Web Tag" innerhalb von 12-24 Stunden TRACKING im Conversion Tracking im Ads Manager anzeigen sollte.

Twitter CAPI-Tag-ParameterLink zu diesem Abschnitt kopieren

Stape-Container-API-Schlüssel - diesen finden Sie in den sGTM-Container-Einstellungen in Ihrem Stape-Konto. 

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

Die Pixel-ID ist die Universal Website Tagging (UWT)-ID des Twitter-Anzeigenkontos. Sie finden sie im Ereignis-Manager von Twitter. 

Ereignis-ID - Wenn Sie ein Conversion-API-Ereignis im Twitter Event Manager erstellen, finden Sie es.

HttpOnly-Cookies verwenden - Verhindert, dass JavaScript auf das Cookie zugreift, falls aktiviert.

Server-Ereignisdaten überschreiben - wählen Sie diese Option, um einen der Standard-Serverparameter zu überschreiben: Konvertierungszeit, Anzahl der Artikel, Währung, Wert, Konvertierungs-ID, Beschreibung und Inhalt. 

Benutzerdaten - Benutzerdaten hinzufügen: E-Mail und Euclid

Protokolleinstellungen - wählen Sie aus, ob Sie Stape-Protokolle verwenden möchten. 

Was brauchen Sie, um Twitter CAPI einzurichten?Link zu diesem Abschnitt kopieren

Stape-Container-API-SchlüsselLink zu diesem Abschnitt kopieren

Die Twitter Conversion API-Authentifizierung ist ein komplexer Prozess; derzeit ist die Twitter CAPI-Authentifizierung auf sGTM nicht voll funktionsfähig. Daher übernehmen wir die Authentifizierung intern. Das bedeutet, dass der Twitter CAPI-Tag das Hosting durch Stape erfordert. Wenn es in Zukunft möglich wird, nur sGTM für die Authentifizierung zu verwenden, werden wir dieses Tag aktualisieren, um jedes Hosting zu unterstützen. Der sGTM-Container-API-Schlüssel ist in den Container-Einstellungen zu finden.

Verbraucherschlüssel und VerbrauchergeheimnisLink zu diesem Abschnitt kopieren

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

Bei der Bewerbung müssen Sie Essential Access beantragen. Stellen Sie sicher, dass Sie den richtigen Twitter-Account verwenden, um einen Dev-Account zu beantragen, da es nicht möglich ist, den Account später zu ändern. 

Sobald Sie ein Entwicklerkonto erhalten haben, erstellen Sie eine Anwendung im Bereich Projekt und Anwendung. Anschließend werden ein Verbraucherschlüssel und ein Verbrauchergeheimnis generiert.

Greifen Sie auf die CAPI für Twitter-Anzeigen zuLink zu diesem Abschnitt kopieren

Um die CAPI einzurichten, muss auf die Ads-API zugegriffen werden. Geben Sie die richtige App-ID in der Anzeigen-API-Anwendung an. Wählen Sie Conversion API in Ads API Application unter "Wie werden Sie Ads API verwenden?

OAuth Token und OAuth Token SecretLink zu diesem Abschnitt kopieren

Sie finden diese beiden Parameter in der Ankündigung auf dem Twitter-Entwicklerkonto.

So richten Sie das Twitter-Konversion-API-Tag in sGTM einLink zu diesem Abschnitt kopieren

1. Erstellen und konfigurieren Sie einen Google Tag Manager-Server-Container.

2. Senden Sie Daten an sGTM. Sie können GA4, Webhooks oder Data Tag/Data Client verwenden.

3. Laden Sie das Twitter Konversion-API-Tag von GitHub herunter. Öffnen Sie den sGTM-Vorlagenbereich -> klicken Sie auf die drei Punkte in der oberen rechten Ecke -> klicken Sie auf import -> laden Sie das Tag hoch, das Sie kürzlich von GitHub heruntergeladen haben, und klicken Sie auf Save.

4. Erstellen Sie ein neues Tag und wählen Sie Twitter-Tag. Fügen Sie einen Stape-Container-API-Schlüssel hinzu. Dazu öffnen Sie die sGTM-Container-Einstellungen und kopieren den Container-API-Schlüssel.

5. Fügen Sie Consumer Key, Consumer Secret, OAuth Token und OAuth Token Secret hinzu. Ich habe hier beschrieben, wie man diese Werte generiert. 

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 Server Event Data Override und Benutzerdaten hinzu, die Sie an Twitter senden möchten. Und richten Sie einen Trigger ein.

8. Leider gibt es keine Möglichkeit, Twitter CAPI in Echtzeit zu testen. Nach der Einrichtung können Sie mit dem Twitter Event Manager überprüfen, ob Twitter CAPI-Ereignisse gesendet wurden.

Schlussfolgerung:Link zu diesem Abschnitt kopieren

Twitter CAPI kann eine großartige Ergänzung zu Ihrem Server-Tracking-Stack sein. Obwohl der Autorisierungsprozess für Twitter CAPI immer noch unglaublich komplex ist, funktioniert der Rest der Logik sehr ähnlich wie bei anderen Konvertierungs-APIs: Sie können benutzerdefinierte oder Standard-Ereignisse senden und nur Web+Server oder Server-seitiges Tracking verwenden. Um Benutzer abzugleichen, bittet Twitter um die Übermittlung von Benutzerdaten, aber bisher werden nur Benutzer-E-Mail und twclid unterstützt. 

Die Twitter-CAPI hat zwei große Nachteile: den Authentifizierungsprozess und das Fehlen eines Echtzeit-Testsystems. Aufgrund des Authentifizierungsprozesses 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. 

Ich hoffe, dass dieser Leitfaden Ihnen hilft, sich mit der Twitter CAPI vertraut zu machen und zu erfahren, wie man die Twitter CAPI in sGTM konfiguriert. Weitere Informationen über Twitter CAPI finden Sie in der offiziellen Dokumentation. Wenn Sie Hilfe bei der Einrichtung der Twitter CAPI benötigen, wenden Sie sich bitte an uns!