> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/x-twitter-conversion-api.md).

# X (Twitter) Conversion API

X CAPI, Twitter CAPI

[X](https://twitter.com), également connu sous son ancien nom [Twitter](https://twitter.com), est un réseau social.\
Cette destination vous permet de partager des données de conversion avec X afin de mesurer les campagnes via l’ [Conversion API](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api).

## Fonctionnalités clés

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

* **Structure des événements**: notre modèle de [référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond au modèle des [événements de conversion X](https://developer.x.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api), ce qui garantit que vos données sont correctement associées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être 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](https://ads.twitter.com) ou utiliser un événement existant déjà créé et utilisé avec le [Twitter Pixel](https://business.twitter.com/en/help/campaign-measurement-and-analytics/conversion-tracking-for-websites.html).

{% hint style="info" %}
Pour créer un événement de conversion, accédez à [Ads Manager](https://ads.twitter.com) et allez dans <mark style="color:bleu;">`Outils`</mark> `(1)` → <mark style="color:bleu;">`Gestionnaire d’événements`</mark> `(2)` :

<img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-a912e9efc3652b4d00d5f879923e941fecf524d9%2Ftwitter_1.png?alt=media" alt="" data-size="original">

Si vous ne disposez pas d’une source d’événements Twitter Pixel, créez-en une en sélectionnant <mark style="color:bleu;">`Ajouter une source d’événements`</mark> `(3)` :

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-e00d687d4250e00d23bbef9a6d87bb397de226c6%2Ftwitter_2.png?alt=media)\
L’identifiant obtenu est votre <mark style="color:bleu;">`Pixel Id`</mark> : consultez la section [Configuration](#configuration) pour en savoir plus.\
Vous pouvez maintenant créer un événement en cliquant sur <mark style="color:bleu;">`Ajouter des événements`</mark> `(4)` :

![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-723a18461f6047aeed8fe6baea5595474028abe6%2Ftwitter_3.png?alt=media)\
L’identifiant obtenu est votre <mark style="color:bleu;">`Event Id`</mark> : consultez la section [Configuration](#configuration) pour en savoir plus.\
Si vous souhaitez utiliser un événement existant que vous utilisez déjà avec le pixel Twitter, vous pouvez récupérer son <mark style="color:bleu;">`Event Id`</mark> dans la liste des événements de l’onglet « Vue d’ensemble ».
{% endhint %}

{% hint style="info" %}
X Conversion API prend en charge la déduplication avec votre [Twitter Pixel](https://business.twitter.com/en/help/campaign-measurement-and-analytics/conversion-tracking-for-websites.html).\
Vérifiez le champ « Mappage intelligent » <mark style="color:bleu;">`Transaction Id`</mark> , [Mappages des champs](#field-mappings) (voir la propriété <mark style="color:bleu;">`conversion_id`</mark> ) ou ceci [LIEN ](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api)pour plus de détails (voir la section « Duplication entre le Pixel et la Conversion API »).
{% endhint %}

### Configuration

<table><thead><tr><th width="349">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentication</code></td><td><em><strong><code>Required</code></strong></em><br>Vos identifiants Twitter tels qu’ils sont définis dans l’interface Commanders Act en suivant les étapes suivantes : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Add connector credentials</code> ➜ <code>Twitter</code></td></tr><tr><td><code>Pixel Id</code></td><td><em><strong><code>Required</code></strong></em><br>Votre identifiant de pixel, tel qu’il a été créé dans <a href="https://ads.twitter.com">Ads Manager</a> (par exemple, « o8z6j », sans les guillemets). Pour plus de détails, suivez ce <a href="https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api">LIEN</a> (voir la section « Étapes » → « Création de l’événement Conversion API »).</td></tr><tr><td><code>Event Id</code></td><td><em><strong><code>Required</code></strong></em><br>Votre identifiant d’événement, tel qu’il a été créé dans <a href="https://ads.twitter.com">Ads Manager</a> (par exemple, « tw-o8z6j-o8z21 », sans les guillemets). Pour plus de détails, suivez ce <a href="https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api">LIEN</a> (voir la section « Étapes » → « Création de l’événement Conversion API »).</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Événements de conversion X |
| ------------------------- | -------------------------- |
| `[Any Event]` **\[1]**    | `[Any Event]` **\[2]**     |

{% hint style="info" %}
**1.** Utilisez les [**filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour définir les événements correspondants.\
**2.** Consultez <mark style="color:bleu;">`Event Id`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) Toutes les propriétés X sont définies dans l’objet\
&#x20;<mark style="color:bleu;">`conversions[0]`</mark> . Pour plus de détails, suivez ce [LIEN](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/api-reference/conversions).
{% endhint %}

{% hint style="warning" %}
Au moins l’un des identifiants suivants doit être inclus :\
• Identifiant de clic Twitter (twclid)\
• Adresse e-mail hachée\
• Numéro de téléphone haché au format [E164](https://en.wikipedia.org/wiki/E.164) numéro de téléphone\
Lors de la transmission d’une adresse IP ou d’un agent utilisateur, un deuxième identifiant doit être fourni.\
Plus vous fournissez de valeurs, plus le taux de correspondance augmente. Pour en savoir plus, suivez ce [LIEN](https://developer.x.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api) (Voir la section « Préparer les identifiants pour les événements de conversion »).
{% endhint %}

<table><thead><tr><th width="348.6685580062746">Propriétés Commanders Act</th><th>Propriétés X</th></tr></thead><tbody><tr><td><code>context.event_timestamp</code></td><td><code>conversion_time</code> <strong>[*]</strong></td></tr><tr><td><code>Event Id</code></td><td><code>event_id</code> <strong>[*]</strong></td></tr><tr><td><code>partners.twitter.twclid</code></td><td><code>identifiers.X.twclid</code> <strong>[1]</strong></td></tr><tr><td><code>user.email</code></td><td><code>identifiers.X.hashed_email</code> <strong>[1]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>identifiers.X.hashed_phone_number</code> <strong>[1]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>identifiers.X.ip_address</code> <strong>[2]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>identifiers.X.user_agent</code> <strong>[2]</strong></td></tr><tr><td><code>items.length</code></td><td><code>number_items</code></td></tr><tr><td><code>currency</code></td><td><code>price_currency</code></td></tr><tr><td><code>value</code></td><td><code>value</code></td></tr><tr><td><code>id</code></td><td><code>conversion_id</code> <strong>[3]</strong></td></tr><tr><td><code>type</code></td><td><code>description</code></td></tr><tr><td><code>search_term</code></td><td><code>search_string</code></td></tr><tr><td><code>items.X.id</code></td><td><code>contents.X.content_id</code></td></tr><tr><td><code>items.X.product.group_id</code></td><td><code>contents.X.content_group_id</code></td></tr><tr><td><code>items.X.product.name</code></td><td><code>contents.X.content_name</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>contents.X.content_price</code></td></tr><tr><td><code>items.X.product.category_1</code> <code>items.X.product.category_2</code> <code>items.X.product.category_3</code> <code>items.X.product.category_4</code> <code>items.X.product.category_5</code></td><td><code>contents.X.content_type</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>contents.X.num_items</code></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Au moins une de ces propriétés doit être renseignée.\
**2.** Un deuxième identifiant doit être fourni.\
**3.** Pour permettre la déduplication, veillez à utiliser la même valeur que pour votre [Twitter Pixel](https://business.twitter.com/en/help/campaign-measurement-and-analytics/conversion-tracking-for-websites.html). Vous trouverez plus de détails en suivant ce lien [LIEN](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api) (Voir la section « Duplication entre Pixel et Conversion API »).\
**4.** Les catégories sont séparées par le caractère supérieur à (>).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/x-twitter-conversion-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
