# X (Twitter) Conversion API

[X](https://twitter.com), également connu sous son ancien nom [Twitter](https://twitter.com), est un site web de réseau social.\
À l’aide de cette destination, vous pouvez partager des 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 fonctionnalités clés suivantes :

* **Structure des events**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) modèle correspond à [X conversion events](https://developer.x.com/en/docs/twitter-ads-api/measurement/web-conversions/conversion-api), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur des events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hashing automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping 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 event de conversion dans [Ads Manager](https://ads.twitter.com) ou utiliser un event 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 event de conversion, accédez à [Ads Manager](https://ads.twitter.com) et naviguez vers <mark style="color:blue;">`Tools`</mark> `(1)` → <mark style="color:blue;">`Events manager`</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 n’avez pas de source d’event Twitter Pixel, créez-en une en sélectionnant <mark style="color:blue;">`Add event source`</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:blue;">`Pixel Id`</mark> : voir [Configuration](#configuration) pour plus de détails.\
Vous pouvez maintenant créer un event en cliquant sur <mark style="color:blue;">`Add events`</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:blue;">`Event Id`</mark> : voir [Configuration](#configuration) pour plus de détails.\
Si vous souhaitez utiliser un event existant que vous utilisez déjà avec le pixel Twitter, vous pouvez le faire en récupérant son <mark style="color:blue;">`Event Id`</mark> dans la liste des events, 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:blue;">`Transaction Id`</mark> , [Field Mappings](#field-mappings) (voir la propriété <mark style="color:blue;">`conversion_id`</mark> ) ou ce [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 and 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>Requis</code></strong></em><br>Vos identifiants Twitter tels que définis dans l’interface Commanders Act selon : <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>Requis</code></strong></em><br>Votre identifiant de 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>Event Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant d’event 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  | X Conversion Events    |
| ---------------------- | ---------------------- |
| `[Any Event]` **\[1]** | `[Any Event]` **\[2]** |

{% hint style="info" %}

> **\[1]** Utilisez [**Destination filters**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos events correspondants.  \
> \&#xNAN;**\[2]** Voir <mark style="color:blue;">`Event Id`</mark> dans [Configuration](#configuration) pour plus de détails.
> {% endhint %}

## Field mappings

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".\
Toutes les propriétés X sont définies dans l’objet <mark style="color:blue;">`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)\
• Email haché\
• Numéro de téléphone haché [E164](https://en.wikipedia.org/wiki/E.164) \
Lors de la transmission de l’adresse IP ou de l’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](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">Commanders Act Properties</th><th>X Properties</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.  \
> \&#xNAN;**\[1]** Au moins une de ces propriétés doit être fournie.  \
> \&#xNAN;**\[2]** Un second identifiant doit être fourni.  \
> \&#xNAN;**\[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").  \
> \&#xNAN;**\[4]** Les catégories sont séparées par le caractère supérieur à (>) .
> {% endhint %}