Balise API conversion de Twitter pour sGTM

Le Twitter Conversion API vous permet d'envoyer des informations de votre serveur directement aux serveurs de Twitter, ce qui peut être utilisé pour mesurer le succès d'une campagne.

Avec l'API de Twitter, vous rendez le suivi plus sûr et plus précis. Comme Facebook, Twitter autorise et recommande l'utilisation d'une méthode hybride de suivi, web+serveur. Lorsque l'on combine le suivi sur le web et le suivi sur le serveur, la déduplication est nécessaire. Pour faire correspondre les utilisateurs des événements aux profils Twitter, ils utilisent les données des clients : email et twclid.

Ce guide explique comment fonctionne le Twitter conversion API et comment configurer la balise Twitter CAPI dans sGTM.

Vous avez besoin de plus qu'un simple ID de pixel Twitter ou qu'un jeton API pour identifier votre CAPI Twitter. Twitter exige une authentification supplémentaire, qu'il est impossible de mettre en œuvre via sGTM. C'est pourquoi, pour l'instant, le tag Twitter CAPI ne fonctionne qu'avec le stape. N'hésitez pas à modifier le modèle de balise et à mettre en œuvre l'authentification vous-même si nécessaire.

Le nouveau Twitter CAPI n'est pas encore prêt pour le prime time et nécessitera 5 fois plus de travail que l'implémentation CAPI « standard » si vous êtes déjà familier avec les API de FB ou TikTok. En outre, l'utilisation de leur plateforme présente d'autres complications qui compliquent les choses.

Vous aurez besoin d'un compte de développeur, d'une demande d'accès à Twitter CAPI, et de générer plusieurs jetons d'accès. Nous détaillerons toutes ces étapes plus tard dans un article de blog.

Pour accéder à l'API des publicités, contactez un représentant de Twitter.

Applications Ads API existantes

Si vous disposez d'une application API Publicités active, vous pouvez l'utiliser, ainsi que ses jetons d'accès, pour l'API Conversion.

Jetons d'accès

• Personal Tokens: Générez-les pour votre compte Twitter dans le portail des développeurs.
• Other Users' Tokens: Utilisez un flux OAuth à trois branches:

- Une ligne de commande avec autorisation web (twurl)

- Une ligne de commande avec une autorisation basée sur le code PIN

- Flux web personnalisé

Les jetons pour l'API de conversion doivent provenir d'utilisateurs ayant un accès AD_MANAGER ou ACCOUNT_ADMIN, que vous pouvez vérifier via le point de terminaison authenticated_user_access.

Note: Vous pouvez partager des tokens avec des utilisateurs n'ayant pas d'accès AD_MANAGER ou ACCOUNT_ADMIN.

L'authentification de l'API de conversion de Twitter est un processus compliqué ; pour l'instant, l'authentification CAPI de Twitter ne peut pas être pleinement fonctionnelle sur sGTM. C'est pourquoi nous gérons l'authentification en interne. Cela signifie que le tag Twitter CAPI nécessite l'hébergement de Stape. Si nous pouvons utiliser uniquement sGTM pour l'authentification, nous mettrons à jour ce tag pour supporter n'importe quel hébergement. Vous pouvez trouver la clé API du conteneur sGTM dans les paramètres du conteneur.

Ces deux clés ne peuvent être générées que si vous disposez d'un compte de développeur Twitter. Pour obtenir un compte de développeur Twitter, vous devez en faire la demande et attendre 1 à 3 jours pour que votre demande soit approuvée.

Lors de votre demande, vous devez demander l'accès essentiel. Veillez à utiliser le bon compte Twitter pour demander un compte de développeur, car il est impossible de changer de compte par la suite.

Créez une application à l'aide de la section Projet et application lorsque vous recevez un compte de développeur. Une fois que vous avez fait cela, une clé de consommateur et un secret de consommateur seront générés.

Vous trouverez ces deux éléments dans votre annonce sur votre compte de développement Twitter.

1. Créer et configurer un conteneur Google Tag Manager.

Important : Le tag CAPI Twitter ne fonctionne que si vous utilisez l'hébergement Stape pour les conteneurs sGTM.

2. Envoyez les données du web vers le serveur GTM. Vous pouvez configurer des GA4 côté serveur, Webhooks, ou Data Tag/Data Client.

3. Téléchargez le tag Twitter Conversion API depuis la Template Gallery.

4. Créez une nouvelle balise et sélectionnez Twitter Tag. Pour ajouter la clé API du conteneur Stape, ouvrez les paramètres du conteneur sGTM et copiez la clé API du conteneur.

5. Ajouter la Consumer Key, le Consumer Secret, l'OAuth Token, l'OAuth Token Secret. J'ai décrit comment générer ces valeurs ici.

6. Ajoutez l'ID du pixel Twitter et l'ID de l'événement. Vous pouvez trouver ces valeurs dans le gestionnaire d'événements de Tweeter.

7. Ajoutez le Server Event Data Override et les données utilisateur que vous souhaitez envoyer à Twitter, et configurez un déclencheur.

Paramètres de la balise CAPI de Twitter :

Stape Container API Key - vous la trouverez dans les paramètres du conteneur sGTM dans votre compte Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - vous les trouverez dans votre compte Twitter dev après avoir créé une application Twitter. Nous vous montrerons plus tard comment les générer.

Pixel ID - Il s'agit de l'ID de l'Universal Website Tag (UWT) de votre compte publicitaire Twitter. Pour le trouver, rendez-vous dans le gestionnaire d'événements Twitter.

Event ID - Vous le trouverez lors de la création d'un événement API de conversion dans le gestionnaire d'événements Twitter.

Use HttpOnly cookies - Empêche JavaScript d'accéder au cookie s'il est activé.

Server Event Data Override - permet de remplacer l'un des paramètres serveur standard : heure de conversion, nombre d'articles, devise, valeur, ID de conversion, description et contenu.

User Data - ajoutez les données de l'utilisateur : email ou twclid.

Logs Settings - sélectionnez si vous souhaitez utiliser les journaux de Stape.

9. Test des événementsLorsque votre événement a reçu avec succès des événements de conversion dans les 12 à 24 heures, l'état de la balise web d'événement unique doit afficher SUIVI sur la page Suivi des conversions du Gestionnaire de publicités. Cela n'aura pas d'impact sur les campagnes en vol qui envoient des conversions via l'API de conversion.

Twitter prend en charge la déduplication des événements. La combinaison du suivi Web et du suivi de serveur nécessite l'envoi d'une clé de déduplication avec les événements Web et les événements de serveur. Utilisez conversion_id pour envoyer la clé de déduplication. La déduplication n'a lieu que si les événements ont été reçus dans les 48 heures.

Pour créer un événement réservé au serveur, utilisez le gestionnaire d'événements Twitter pour créer un nouvel événement et sélectionnez Installer avec l'API de conversion à la troisième étape.

Contrairement à d'autres plateformes, Twitter n'accepte que l'email de l'utilisateur et twclid. Lorsque vous envoyez un courriel, il doit être haché avec SHA256. La balise Twitter hachait automatiquement l'email de l'utilisateur.

Malheureusement, il n'existe aucun moyen de tester les événements du serveur Twitter en temps réel. Si le suivi est configuré correctement, vous devriez voir l'état de la balise web à événement unique s'afficher dans le suivi des conversions dans le Gestionnaire de publicités dans les 12 à 24 heures.

Twitter CAPI peut être un excellent complément à votre système de suivi côté serveur. Bien que le processus d'autorisation pour Twitter CAPI soit incroyablement compliqué pour l'instant, les autres logiques fonctionnent de manière très similaire aux API de conversion FB ou TikTok : Vous pouvez envoyer des événements personnalisés ou standard et utiliser le suivi web+serveur ou serveur uniquement. Twitter demande des données d'utilisateur pour faire correspondre les utilisateurs, mais pour l'instant, ils ne prennent en charge que l'email de l'utilisateur et twclid.

Twitter CAPI présente deux inconvénients majeurs : le processus d'authentification et l'absence d'un outil de test en temps réel. En raison du processus de vérification, le tag Twitter ne fonctionne qu'avec les serveurs stape pour sGTM. Si Twitter simplifie le processus d'authentification, l'équipe de stape mettra à jour le tag pour qu'il fonctionne avec GCP.

Ce guide vous aidera à vous familiariser avec Twitter CAPI et à le configurer dans sGTM. Pour plus d'informations sur Twitter CAPI, consultez la documentation officielle.