For the complete documentation index, see llms.txt. This page is also available as Markdown.

X (Twitter) Conversion API

X CAPI, Twitter CAPI

X, également appelé sous 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 de permettre la mesure des campagnes via API de conversion.

Fonctionnalités principales

La destination API de conversion X fournit les principales fonctionnalité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.

  • Correspondances prédéfinies: le mappage des données pour les destinations basées sur les é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.

  • Smart mapping: le mappage des données peut être réajusté à l'aide des champs définis dans votre data layer.

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 accédez à Outils (1) → Gestionnaire d'événements (2) :

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

L'identifiant obtenu est le vôtre ID du pixel : 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 pixel Twitter, vous pouvez le faire en obtenant son ID d'événement à partir de la liste des événements dans l'onglet "Overview".

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

Configuration

Paramètres
Description

Authentification

Requis Vos identifiants Twitter définis dans l'interface Commanders Act comme suit : Administration ➜ Identifiants du connecteur ➜ Ajouter des identifiants du connecteur ➜ Twitter

ID du pixel

Requis Votre identifiant de pixel créé dans Ads Manager (Par exemple « o8z6j », sans guillemets). Plus de détails sont disponibles en suivant ce LIEN (Voir la section « Étapes » → « Création de l'événement API de conversion »).

ID d'événement

Requis Votre identifiant d'événement créé dans Ads Manager (Par exemple « 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 API de conversion »).

Référence rapide

Événements Commanders Act
Événements de conversion X

[Any Event] [1]

[Any Event] [2]

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

Mappages de champs

Les propriétés peuvent être remappées à l'aide de notre Mappage intelligent 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.

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 une de ces propriétés doit être fournie. 2. Un deuxième 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 API de conversion"). 4. Les catégories sont séparées par le caractère supérieur à (>)

Mis à jour

Ce contenu vous a-t-il été utile ?