Extension de transfert d’événement Twitter

Twitter est un service de réseaux sociaux en ligne, sur lequel les utilisateurs publient et interagissent avec des messages de 280 caractères, appelés tweets. Les utilisateurs peuvent interagir avec Twitter à l’aide d’un navigateur, d’un logiciel frontal mobile ou par programmation via ses API

L’extension Twitter Web Conversions API de transfert d’événement vous permet d’exploiter les données capturées dans l’Edge Network Adobe Experience Platform et de les envoyer à Twitter. Ce document couvre les cas d’utilisation de l’extension, comment l’installer et comment intégrer ses fonctionnalités dans le transfert d’événement rules.

Twitter nécessite OAuth 1.0 pour l'authentification avec l'API Twitter Web Conversions.

Cas d’utilisation

Cette extension doit être utilisée si vous souhaitez utiliser les données de l’Edge Network dans Twitter pour tirer parti de ses fonctionnalités d’analyse et de ciblage des clients.

Prenons l’exemple d’une équipe marketing au sein d’une organisation. L’équipe capture les données d’événement d’interaction de l’utilisateur de son site web en tant que données d’événement de son site web et les charge dans Twitter à l’aide de cette extension de transfert d’événement.

Les équipes de marketing et d’analyse peuvent ensuite exploiter les fonctionnalités Twitter’s pour effectuer une analyse supplémentaire et cibler ces utilisateurs pour les campagnes de publicité ciblées.

Pour plus d'informations sur les cas d'utilisation spécifiques à Twitter, consultez la documentation Twitter Cas d'utilisation .

Twitter conditions préalables et barrières de sécurité prerequisites

Pour utiliser cette extension, vous devez disposer d’un compte Twitter valide. Accédez à la Twitter page d'inscription pour vous enregistrer et créer un compte si vous n'en avez pas déjà un.

Vous devez configurer votre compte en tant que compte de développeur Twitter. Pour savoir comment vous inscrire en tant que développeur, reportez-vous au Twitter compte développeur.

Protections des API guardrails

L’API de conversion web Twitter a une limite de taux de 60 000 demandes par intervalle de 15 minutes, où chaque demande autorise 500 événements.

Collecte des détails de configuration requis configuration-details

Pour connecter l’Experience Platform à Twitter, les entrées suivantes sont requises :

Type de clé
Description
Clé client
​ Clé API de l’application pour accéder à l’API Twitter. Pour plus d'informations, reportez-vous à la documentation Twitter sur les clés et secrets d'api .
Secret du client
Le secret API permet à votre application d’accéder à l’API Twitter. Pour plus d'informations, reportez-vous à la documentation Twitter sur les clés et secrets d'api .
Secret du jeton
Secret de jeton non expirant de votre application, utilisé pour l’authentification à l’API Twitter via OAuth. Pour plus d'informations, reportez-vous à la documentation Twitter sur l' obtention des jetons d'accès à l'utilisation .
Jeton d’accès
Jeton d’accès non expirant de votre application, utilisé pour l’authentification à l’API Twitter via OAuth. Pour plus d'informations, reportez-vous à la documentation Twitter sur l' obtention des jetons d'accès à l'utilisation .
Pixel Id
Le pixel Twitter est une balise de site web qui est implémentée sur votre site web pour suivre les actions ou les conversions du site. Pour plus d'informations, reportez-vous à la documentation Twitter sur le suivi de conversion pour les sites web .

Installation et configuration de l’extension Twitter install

Pour installer l’extension, créez une propriété de transfert d’événement ou choisissez une propriété existante à modifier à la place.

Sélectionner Extensions dans le volet de navigation de gauche. Dans l’onglet Catalogue , sélectionnez Installer sur la carte de l’extension Twitter.

Catalogue présentant l’installation de mise en surbrillance de l’extension Twitter.

IMPORTANT
En fonction des besoins de mise en oeuvre, vous devrez peut-être créer un schéma, des éléments de données et un jeu de données avant de configurer l’extension. Avant de commencer, consultez toutes les étapes de configuration afin de déterminer les entités à configurer pour votre cas d’utilisation.

Sur l’écran suivant, saisissez les valeurs de configuration suivantes que vous avez précédemment collectées à partir de Twitter :

  • Id Pixel
  • Clé client
  • Secret du client
  • Jeton
  • Jeton Secret

Lorsque vous avez terminé, sélectionnez Enregistrer.

Écran de configuration Twitter pour l’extension Twitter.

Configurer une règle de transfert d’événement config-rule

Une fois tous vos éléments de données configurés, vous pouvez commencer à créer des règles de transfert d’événement qui déterminent quand et comment vos événements seront envoyés à Twitter.

Créez une règle dans votre propriété de transfert d’événement. Sous Actions, ajoutez une nouvelle action et définissez l’extension sur Twitter. Pour envoyer des événements Edge Network à Twitter, définissez le Type d’action sur Envoyer la conversion web.

Une fois la sélection effectuée, d’autres commandes s’affichent pour configurer davantage l’événement. Vous devez mapper les propriétés d’événement Twitter aux éléments de données que vous avez précédemment créés. Pour plus d’informations, reportez-vous à l’ Twitter API de conversion web.

Twitter créant une règle d’événement de conversion.

Identification de l’utilisateur

Nom du champ
Description
Exemple
Obligatoire
Twitter ID de clic
Twitter ID de clic tel qu’analysé à partir de l’URL de clic publicitaire.
26l6412g5p4iyj65a2oic2ayg2
Obligatoire si aucun autre identifiant n’est ajouté.
E-mail.
Adresse électronique hachée avec SHA256. Le texte doit être en minuscules et les espaces à la fin ou au début doivent être supprimés avant le hachage.
eventforwarding@example.com
Obligatoire si aucun autre identifiant n’est ajouté.
Phone
Phone sert d’identifiant pour correspondre à l’événement de conversion. Le numéro de téléphone doit être au format E164 [+][code pays][code zone][local phone number] avant le hachage.
+911234567875
Obligatoire si aucun autre identifiant n’est ajouté.

Données de conversion

Nom du champ
Description
Exemple
Obligatoire
Temps de conversion
Date-time sous la forme d’une chaîne au format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
2022-02-18T01:14:00.603Z
Oui
​ {Event Id
ID de base 36 d’un événement spécifique. Cet identifiant doit correspondre à un événement préconfiguré contenu dans votre compte publicitaire Twitter. Il s’agit de l’identifiant de l’événement correspondant dans le Gestionnaire d’événements.
o87ne ou tw-o8z6j-o87ne (tw-pixel_id-event-id)
Oui
Nombre d’éléments
Nombre d’éléments achetés dans l’événement. Il doit s’agir d’un nombre positif supérieur à 0.
4
Non
Devise
Devise des éléments achetés dans l’événement. Elle est exprimée dans la norme ISO-4217 et, si elle n’est pas fournie, la valeur par défaut est USD.
USD
Non
Valeur
Valeur du prix des articles achetés dans l’événement.
100,00
Non
ID de conversion
Identifiant d’un événement de conversion pouvant être utilisé pour la déduplication entre les conversions de l’API de conversion et de pixel web dans la même balise d’événement.
23294827
Non
Description
Description contenant des informations supplémentaires sur les conversions.
Test de la conversion
Non

Validation des données dans Twitter

Une fois la règle de transfert d’événement créée et exécutée, vérifiez si l’événement envoyé à l’API Twitter s’affiche comme prévu dans l’interface utilisateur de Twitter.

Si la collecte d’événements et l’intégration de Experience Platform ont réussi, vous verrez des événements dans le Twitter gestionnaire d’événements.

Le Twitter gestionnaire d’événements

Étapes suivantes

Ce guide explique comment envoyer des événements de conversion vers Twitter à l’aide du transfert d’événement. Pour plus d'informations sur ces technologies sous-jacentes, consultez la documentation officielle :

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743