> 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](https://twitter.com), également appelée par son ancien nom [Twitter](https://twitter.com), est un site web de médias sociaux.\
En utilisant cette destination, vous pouvez partager les données de conversion avec X pour permettre la mesure des campagnes via [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 fournit les principales fonctionnalités suivantes :

* **Structure des événements**: notre [référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond au modèle [Événements de conversion X](https://developer.x.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api)Google, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings prédéfinis**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées 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](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;">`Events manager`</mark> `(2)` :

<img src="/files/828f31134e55721ce865772eff8df60f95ef2c0e" alt="" data-size="original">

Si vous n'avez pas de 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)` :

![](/files/838d3e88d1888d3124f090338c95833a06756862)\
L'identifiant obtenu est votre <mark style="color:bleu;">`Pixel ID`</mark> : Voir [Configuration](#configuration) pour plus de détails.\
Vous pouvez maintenant créer un événement en cliquant sur <mark style="color:bleu;">`Ajouter des événements`</mark> `(4)` :

![](/files/cdf1f2c36c98181b9de8a4c94c18cc49fc5cece1)\
L'identifiant obtenu est le vôtre <mark style="color:bleu;">`ID de l'événement`</mark> : Voir [Configuration](#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 récupérant son <mark style="color:bleu;">`ID de l'événement`</mark> depuis la liste des événements dans l'onglet "Overview".
{% endhint %}

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

### Configuration

<table><thead><tr><th width="349">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentification</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants Twitter tels que définis dans l'interface Commanders Act, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter les identifiants du connecteur</code> ➜ <code>Twitter</code></td></tr><tr><td><code>Pixel ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de votre pixel tel que créé dans <a href="https://ads.twitter.com">Ads Manager</a> (Par ex. "o8z6j", sans guillemets). Plus de détails sont disponibles en suivant ce <a href="https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api">LINK</a> (Voir la section "Steps" → "Creating the Conversion API event").</td></tr><tr><td><code>ID de l'événement</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de votre événement tel que créé dans <a href="https://ads.twitter.com">Ads Manager</a> (Par ex. "tw-o8z6j-o8z21", sans guillemets). Plus de détails sont disponibles en suivant ce <a href="https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api">LINK</a> (Voir la section "Steps" → "Creating the Conversion API event").</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events       | Événements de conversion X  |
| --------------------------- | --------------------------- |
| `[Tout événement]` **\[1]** | `[Tout événement]` **\[2]** |

{% hint style="info" %}
**1.** Utilisez [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
**2.** Voir <mark style="color:bleu;">`ID de l'événement`</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 [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Toutes les propriétés X sont définies dans l'objet <mark style="color:bleu;">`conversions[0]`</mark> . Plus de détails sont disponibles en suivant ce [LINK](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/api-reference/conversions).
{% endhint %}

{% hint style="warning" %}
Au moins un des identifiants suivants doit être inclus :\
• Identifiant de clic Twitter (twclid)\
• E-mail haché\
• Haché [E164](https://en.wikipedia.org/wiki/E.164) numéro de téléphone\
Lorsque vous transmettez l'adresse IP ou l'user agent, un deuxième identifiant doit être fourni.\
L'ajout de plus de valeurs augmente le taux de correspondance. Plus de détails sont disponibles en suivant ce [LINK](https://developer.x.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api) (Voir la section "Preparing Identifiers for Conversion Events").
{% 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>ID de l'événement</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 l'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](https://business.twitter.com/en/help/campaign-measurement-and-analytics/conversion-tracking-for-websites.html). Plus de détails sont disponibles en suivant ce [LINK](https://developer.twitter.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api) (Voir la section "Duplication between Pixel and 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.