X (Twitter) Conversion API

X CAPI, Twitter CAPI

X, également appelé par son ancien nom Twitter, est un site de réseau social. En utilisant cette destination, vous pouvez partager des données de conversion avec X pour permettre la mesure des campagnes via Conversion API.

Principales fonctionnalités

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

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

• Mappings préconçus : le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

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

• Mapping intelligent : le mapping des données peut être réajusté en utilisant vos champs définis dans le 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 naviguez vers Outils (1) → Gestionnaire d'événements (2) :

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

L'identifiant résultant est votre 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 résultant est votre Event Id : Voir Configuration pour plus de détails. Si vous souhaitez utiliser un événement existant que vous utilisez déjà avec le pixel Twitter, vous pouvez le faire en obtenant son Event Id depuis la liste d'événements dans l'onglet "Overview".

X Conversion API prend en charge la déduplication avec votre Twitter Pixel. Vérifiez le champ "Smart Mapping" Transaction Id , Mappages de champs (Voir la propriété conversion_id ) ou ce LINK pour plus de détails (Voir la section "Duplication between Pixel and Conversion API").

Configuration

Paramètres	Description
Authentification	Requis Vos identifiants avec Twitter tels que définis dans l'interface Commanders Act en suivant : Administration ➜ Connector Credentials ➜ Ajouter des connector credentials ➜ Twitter
Pixel Id	Requis Votre identifiant de pixel tel que créé dans Ads Manager (Par ex. "o8z6j", sans guillemets). Plus de détails sont disponibles en suivant ce LINK (Voir la section "Steps" → "Creating the Conversion API event").
Event Id	Requis Votre identifiant d'événement tel que créé dans Ads Manager (Par ex. "tw-o8z6j-o8z21", sans guillemets). Plus de détails sont disponibles en suivant ce LINK (Voir la section "Steps" → "Creating the Conversion API event").

Référence rapide

Commanders Act Events	X Conversion Events
[Any Event] [1]	[Any Event] [2]

[1] Utiliser Filtres de destination pour spécifier vos événements correspondants. [2] Voir Event Id dans Configuration pour plus de détails.

Mappages de champs

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping". Toutes les propriétés X sont définies dans l'objet conversions[0] . Plus de détails sont disponibles en suivant ce LINK.

Au moins un des identifiants suivants doit être inclus : • Identifiant de clic Twitter (twclid) • Email haché • Numéro de téléphone haché E164 numéro de téléphone Lors de la transmission de l'adresse IP ou du user agent, un second identifiant doit être fourni. Avoir plus de valeurs augmente le taux de correspondance. Plus de détails sont disponibles en suivant ce LINK (Voir la section "Preparing Identifiers for Conversion Events").

Propriétés Commanders Act	Propriétés X
context.event_timestamp	conversion_time [*]
Event Id	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 une de ces propriétés doit être fournie. [2] Un second identifiant doit être fourni. [3] Pour des raisons de déduplication, assurez-vous d'utiliser la même valeur avec votre Twitter Pixel. Plus de détails sont disponibles en suivant ce LINK (Voir la section "Duplication between Pixel and Conversion API"). [4] Les catégories sont séparées par le caractère supérieur à (>) .