Balise API conversion de Twitter pour sGTM

L'API conversion de Twitter vous permet d'envoyer des informations de votre serveur directement aux serveurs Twitter, qui peuvent être utilisées pour mesurer le succès de la campagne.

Avec Twitter CAPI, vous rendez le suivi plus sûr et plus précis. Comme FB, Twitter permet le suivi du Web et du serveur. Lorsque vous combinez le suivi du Web et du serveur, la déduplication est requise. Pour faire correspondre les utilisateurs des événements aux profils Twitter, ils utilisent les données client : e-mail et twclid.

Dans ce guide, je vais parler du fonctionnement de l'API conversion de Twitter et de la configuration de la balise Twitter CAPI dans sGTM.

Fonctionnement de l'API conversion de TwitterCopier le lien vers cette section

AuthentificationCopier le lien vers cette section

Pour que la balise Twitter CAPI fonctionne, il ne suffit pas d'ajouter uniquement un identifiant de pixel ou un jeton d'API. Twitter nécessite une authentification supplémentaire. Ce type d'authentification est impossible à mettre en place via sGTM. C'est pourquoi pour l'instant, la balise Twitter CAPI ne fonctionne qu'avec les serveurs stape pour sGTM.

Stape dispose d'un module supplémentaire pour gérer l'authentification de l'API Twitter. C'est la raison pour laquelle la balise Twitter CAPI ne fonctionne qu'avec stape. N'hésitez pas à utiliser le modèle de balise pour le modifier et implémenter l'authentification par vous-même.

Il semble que le fonctionnement de Twitter CAPI soit la première version et sera amélioré. De manière réaliste, il faudra 5 fois plus de temps pour mettre en œuvre le CAPI Twitter que le CAPI "standard" pour quelqu'un qui connaît déjà FB ou TikTok CAPI. En plus, il existe quelques autres complications avec Twitter CAPI.

Vous aurez besoin d'un compte de développement, demandez l'accès à Twitter CAPI et générez plusieurs jetons d'accès. J’expliquerai toutes ces étapes plus tard dans un article de blog.

Déduplication d'événementsCopier le lien vers cette section

Twitter prend en charge la déduplication des événements. Vous envoyez le même ID d'événement si vous souhaitez utiliser à la fois le suivi du serveur et du Web. Si vous souhaitez envoyer des données d'événement uniquement à partir du serveur, vous devez créer un nouvel ID d'événement dans le gestionnaire d'événements Twitter.

Si vous combinez le suivi Web et serveur, vous devez envoyer une clé de déduplication avec les événements Web et 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 serveur uniquement, vous devez utiliser le gestionnaire d'événements Twitter pour créer un nouvel événement et sélectionner Installer avec l'API conversion à la 3ème étape.

Paramètres d’utilisateur Twitter CAPICopier le lien vers cette section

Vis-à-vis à d'autres plates-formes, Twitter n'accepte que les e-mails des utilisateurs et twclid. Lorsque vous envoyez un e-mail, il doit être haché avec SHA256

Test CAPI sur TwitterCopier le lien vers cette section

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 d'événement unique » devrait afficher SUIVI lors du suivi des conversions dans le gestionnaire de publicités pendant 12 à 24 heures.

 Paramètres de la balise CAPI TwitterCopier le lien vers cette section

Clé API du conteneur Stape - trouvez-la dans le paramètre de conteneur sGTM de votre compte Stape.

Consumer Key, Consumer Secret, OAuth Token, OAuth Token Secret - vous pouvez le trouver dans votre compte de développement Twitter après avoir créé une application Twitter. Je vous montrerai comment les générer plus tard.

Pixel ID - ID de balise de site Web universelle (UWT) de votre compte publicitaire Twitter. Pour le trouver, rendez-vous sur le gestionnaire d'événements Twitter.

ID d'événement - Lors de la création d'un événement API de conversion dans le gestionnaire d'événements Twitter, vous le trouverez.

 Utiliser les cookies HttpOnly - Interdit à JavaScript d'accéder au cookie s'il est activé.

Remplacement des données d'événement du serveur (Server Event Data Override )- Sélectionnez cette option pour remplacer l'un des paramètres de serveur par défaut : temps de conversion, nombre d'éléments, devise, coût, ID de conversion, description et contenu.

 Données utilisateur - ajouter des données utilisateur : e-mail ou twclid

Paramètres des journaux - indiquez si vous souhaitez utiliser les journaux Stape.

Qu’est-ce qu’il vous faudrait pour configurer Twitter CAPICopier le lien vers cette section

Clé API du conteneur StapeCopier le lien vers cette section

L'authentification de l'API conversion de Twitter est un processus compliqué ; pour l'instant, l'authentification Twitter CAPI ne peut pas être entièrement fonctionnelle sur sGTM. C'est pourquoi nous gérons l'authentification en interne. Cela signifie que la balise Twitter CAPI nécessite un hébergement Stape. S'il est possible à l'avenir d'utiliser uniquement sGTM pour l'authentification, nous mettrons à jour cette balise pour prendre en charge tout hébergement. Vous pouvez trouver la clé API du conteneur sGTM dans les paramètres du conteneur.

Clé du consommateur et secret du consommateur (Consumer Key and Consumer Secret)Copier le lien vers cette section

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

Quand vous faites la demande, vous devez demander un accès essentiel. Assurez-vous d'utiliser le bon compte Twitter pour postuler aux comptes de développement car il est impossible de changer de compte ultérieurement.

Créez une application à l'aide de la section Projet et application lorsque vous recevez un compte de développement. Une fois cela fait, Clé du consommateur et Secret du consommateur seront générés.

Accès CAPI aux publicités TwitterCopier le lien vers cette section

Pour configurer CAPI, il est nécessaire d'obtenir l'accès à l'API des annonces. Incluez l'ID d'application correct dans l'application API Ads. Sélectionnez API de conversion dans l'application API Ads sous "Comment allez-vous utiliser l'API Ads ?"

Jeton OAuth et secret du jeton Oauth (OAuth Token and OAuth Token Secret)Copier le lien vers cette section

Vous pouvez trouver ces deux dans votre annonce à l'intérieur du compte de développement Twitter.

Comment configurer la balise API conversion de Twitter dans sGTMCopier le lien vers cette section

1. Créez et configurez un conteneur Google Tag Manager pour le serveur.

2. Envoyez les données à sGTM. Vous pouvez utiliser GA4, Webhooks, ou Data Tag/Data Client.

3. Téléchargez la balise API conversion de Twitter à partir de GitHub. Ouvrez la section du modèle sGTM -> cliquez sur trois points dans le coin supérieur droit -> Cliquez sur importer -> téléchargez la balise que vous avez récemment téléchargée depuis GitHub, puis cliquez sur Enregistrer. 

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

5. Ajoutez la clé du consommateur, le secret du consommateur, le jeton OAuth, le secret du jeton OAuth. J'ai décrit comment générer ces valeurs ici.

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

7. Ajoutez le remplacement des données d'événement du serveur et les données utilisateur que vous souhaitez envoyer à Twitter. Et configurez un déclencheur.

8. Malheureusement, il n'existe aucun moyen de tester Twitter CAPI en temps réel. Après la configuration, utilisez le gestionnaire d'événements Twitter pour voir si les événements CAPI Twitter ont été envoyés.

Conclusion:Copier le lien vers cette section

CAPI Twitter peut être un excellent ajout à votre pile de suivi côté serveur. Bien que le processus d'autorisation pour Twitter CAPI soit incroyablement compliqué pour l'instant, une autre logique fonctionne de manière très similaire aux autres API de conversion : vous pouvez envoyer des événements personnalisés ou standard et utiliser le suivi du serveur +Web ou du serveur uniquement. Pour faire correspondre les utilisateurs, Twitter demande d'envoyer des données utilisateur, mais pour l'instant, ils ne prennent en charge que les e-mails et twclid des utilisateurs.

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

J'espère que ce guide vous aidera à vous familiariser avec CAPI Twitter et à configurer Twitter CAPI dans sGTM. Pour des informations plus détaillées sur Twitter CAPI, consultez la documentation officielle. Si vous avez besoin d'aide pour configurer Twitter CAPI, n’hesitez pa à nous contacter!