X (Twitter) Conversion API

X CAPI, Twitter CAPI

X, également appelé par son ancien nom Twitter, est un site de médias sociaux. En utilisant cette destination, vous pouvez partager les données de conversion avec X afin d'activer la mesure des campagnes via Conversion API.

Fonctionnalités clés

La destination X Conversion API fournit les fonctionnalités clés suivantes :

• Structure des événements : notre Référence des événements correspondances de modèle événements de conversion X, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

• Mappages prédéfinis : le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.

• Hachage automatique: les informations sont hachées automatiquement conformément aux spécifications du partenaire.

• Mappage intelligent : le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.

Configuration de la destination

Avant d'utiliser cette destination, vous devez créer un nouvel événement de conversion dans Ads Manager ou utiliser un événement existant déjà créé et utilisé avec le Twitter Pixel.

Pour créer un événement de conversion, accédez à Ads Manager et rendez-vous dans Outils (1) → Gestionnaire d'événements (2) :

Si vous n'avez pas de source d'événement Twitter Pixel, créez-en une en sélectionnant Ajouter une source d'événement (3) :

L'identifiant obtenu est le vôtre Pixel ID : voir Configuration pour plus de détails. Vous pouvez maintenant créer un événement en cliquant sur Ajouter des événements (4) :

L'identifiant obtenu est le vôtre ID d'événement : voir Configuration pour plus de détails. Si vous souhaitez utiliser un événement existant que vous utilisez déjà avec le Twitter Pixel, vous pouvez le faire en récupérant son ID d'événement dans la liste des événements de l'onglet « Aperçu ».

X Conversion API prend en charge la déduplication avec votre client-side Twitter Pixel. Vérifiez le champ « Smart Mapping » ID de transaction , Mappages de champs (Voir la propriété conversion_id ) ou ceci LIEN pour plus de détails (voir la section « Duplication entre Pixel et Conversion API »).

Configuration

Paramètres	Description
Authentification	Obligatoire Vos identifiants Twitter tels que définis dans l'interface Commanders Act, comme suit : Administration ➜ Connector Credentials ➜ Ajouter des identifiants du connecteur ➜ Twitter
Pixel ID	Obligatoire Votre identifiant de pixel tel que créé dans Ads Manager (p. ex. « o8z6j », sans guillemets). Plus de détails sont disponibles en suivant ce LIEN (Voir la section « Étapes » → « Création de l'événement Conversion API »).
ID d'événement	Obligatoire Votre identifiant d'événement tel que créé dans Ads Manager (p. ex. « tw-o8z6j-o8z21 », sans guillemets). Plus de détails sont disponibles en suivant ce LIEN (Voir la section « Étapes » → « Création de l'événement Conversion API »).

Référence rapide

Événements Commanders Act	Événements de conversion X
[Any Event] [1]	[Any Event] [2]

1. Utiliser Filtres de destination pour spécifier vos événements correspondants. 2. Voir ID d'événement dans Configuration pour plus de détails.

Mappages des champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping fonctionnalité. Toutes les propriétés X sont définies dans l'objet conversions[0] . Plus de détails sont disponibles en suivant ce LIEN.

Au moins l'un des identifiants suivants doit être inclus : • identifiant de clic Twitter (twclid) • e-mail haché • haché E164 numéro de téléphone Lorsque vous transmettez une adresse IP ou un user agent, un second identifiant doit être fourni. Le fait d'avoir plus de valeurs augmente le taux de correspondance. Plus de détails sont disponibles en suivant ce LIEN (Voir la section « Préparation des identifiants pour les événements de conversion »).

Propriétés Commanders Act	Propriétés X
context.event_timestamp	conversion_time [*]
ID d'événement	event_id [*]
partners.twitter.twclid	identifiers.X.twclid [1]
user.email	identifiers.X.hashed_email [1]
user.phone	identifiers.X.hashed_phone_number [1]
context.device.ip	identifiers.X.ip_address [2]
context.device.user_agent	identifiers.X.user_agent [2]
items.length	number_items
currency	price_currency
value	value
id	conversion_id [3]
type	description
search_term	search_string
items.X.id	contents.X.content_id
items.X.product.group_id	contents.X.content_group_id
items.X.product.name	contents.X.content_name
items.X.product.price	contents.X.content_price
items.X.product.category_1 items.X.product.category_2 items.X.product.category_3 items.X.product.category_4 items.X.product.category_5	contents.X.content_type [4]
items.X.quantity	contents.X.num_items

* Propriété obligatoire. 1. Au moins l'une de ces propriétés doit être fournie. 2. Un second identifiant doit être fourni. 3. À des fins de déduplication, assurez-vous d'utiliser la même valeur avec votre Twitter Pixel. Plus de détails sont disponibles en suivant ce LIEN (Voir la section « Duplication entre Pixel et Conversion API »). 4. Les catégories sont séparées par le caractère supérieur à (>).