> 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/the-trade-desk/the-trade-desk-conversions-api.md).

# The Trade Desk Conversions API

[The Trade Desk](https://www.thetradedesk.com/us) est l'une des plus grandes plateformes indépendantes côté demande (DSP) offrant une tarification et un placement publicitaires en temps réel pour les annonceurs, les agences publicitaires et les marques.\
Grâce à cette destination, vous pouvez exploiter [The Trade Desk Real-Time Conversion Events API](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi) pour envoyer des événements via des hits server-side.

## Fonctionnalités clés

La destination The Trade Desk offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspondances de modèle [Les événements de The Trade Desk](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#event-mapping), 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 les saisies utilisateur.
* **Smart Mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre data layer.
* **Mapping d'événements**: modifiez le mappage standard entre les événements de vos partenaires et les vôtres ou ajoutez de nouveaux mappages.
* **Prise en charge des données multi-item**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array est envoyé à The Trade Desk.

## Configuration de la destination

{% hint style="info" %}
Pour les identifiants utilisateur, vous devez passer soit `Type d'ID utilisateur/appareil` **ET** `Identifiant utilisateur/appareil` **OU** des champs "Smart Mapping" comme `Identifiant mobile de l'appareil` , `The Trade Desk GUID` , `jeton UID2 chiffré` , `jeton EUID chiffré` , `RampID` mais pas les deux.
{% endhint %}

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>URL de l'API de conversion TTD</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre URL de l'API de conversion TTD. Par défaut : "https://insight.adsrvr.org/track/realtimeconversion".</td></tr><tr><td><code>Type de tag de suivi</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Choisissez le type de tag de suivi. Il s'agit soit de <code>Suivi des événements</code> ou <code>Mappage d'URL (pages vues)</code>.</td></tr><tr><td><code>ID du marchand</code></td><td><em><strong><code>Requis pour le suivi des événements</code></strong></em> <strong>[1]</strong><br>L'identifiant de plateforme du marchand attribué par The Trade Desk au marchand lors du processus d'intégration.</td></tr><tr><td><code>ID du tracker d'événements</code></td><td><p><em><strong><code>Requis pour le suivi des événements</code></strong></em> <strong>[1]</strong></p><p>L'identifiant de plateforme The Trade Desk du tracker d'événements.</p></td></tr><tr><td><code>ID de l'annonceur</code></td><td><em><strong><code>Requis pour le mappage d'URL (pages vues)</code></strong></em> <strong>[1]</strong><br>L'identifiant de plateforme The Trade Desk de l'annonceur au nom duquel l'appel de suivi est effectué.</td></tr><tr><td><code>ID du Universal Pixel</code></td><td><em><strong><code>Requis pour le mappage d'URL (pages vues)</code></strong></em> <strong>[1]</strong><br>L'identifiant de plateforme The Trade Desk du "Universal Pixel".</td></tr><tr><td><code>Type d'ID utilisateur/appareil</code></td><td>Le type d'identifiant publicitaire, spécifié dans le <code>Identifiant utilisateur/appareil</code>. Valeurs prises en charge : TDID, IDFA, AAID, DAID, NAID, IDL, EUID ou UID2.</td></tr><tr><td><code>Identifiant utilisateur/appareil</code></td><td>L'identifiant publicitaire unique pour l'événement. Cela peut être l'un des identifiants spécifiés dans le <a href="https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi">LIEN</a> (Voir <code>adid</code> propriété).</td></tr><tr><td><code>Nom du cookie TTD TDID</code></td><td>Le First party cookie dans lequel vous avez stocké la valeur du cookie TTD TDID. Ceci est utilisé lorsqu'aucune valeur ne peut être récupérée depuis le champ<code>Identifiant utilisateur/appareil</code>. Valeur par défaut : "ttd_TDID".</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td>Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans <code>Le nom de propriété The Trade Desk</code> et en ajoutant le nom du champ contenant les valeurs dans <code>Votre valeur</code> . Par ex., si vous saisissez <code>size</code> dans la <code>Le nom de propriété The Trade Desk</code> et <code>items.0.product.size</code> <strong>[2]</strong> dans <code>Votre valeur</code> , vous aurez une propriété d'événement personnalisée dans The Trade Desk appelée <code>size</code> avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> .</td></tr><tr><td><code>Mapping d'événements</code></td><td>Modifiez le <a href="#quick-reference">mappage standard</a> entre les événements de The Trade Desk et les vôtres ou ajoutez de nouveaux mappages.</td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir[`Type de tag de suivi`](#configuration)pour plus de détails.\
**2.** En utilisant les « points » (« . »), vous pouvez descendre jusqu'au champ spécifique dont vous souhaitez obtenir la valeur. Voir [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) pour plus de détails sur les noms de champs standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a aucune limite.
{% endhint %}

## Référence rapide

{% hint style="info" %}
En utilisant le [Mapping d'événements](#configuration) vous pouvez modifier le [mappage standard](#quick-reference) entre les événements de The Trade Desk et les vôtres ou ajoutez de nouveaux mappages.
{% endhint %}

| Événements Commanders Act    | Les événements The Trade Desk         |
| ---------------------------- | ------------------------------------- |
| `add_to_cart`                | `addtocart`                           |
| `add_to_wishlist`            | `wishlistitem`                        |
| `begin_checkout`             | `startcheckout`                       |
| `login`                      | `login`                               |
| `page_view`                  | `sitevisit`                           |
| `purchase`                   | `purchase`                            |
| `search`                     | `searchitem`                          |
| `view_cart`                  | `viewcart`                            |
| `view_item`                  | `viewitem`                            |
| `[N'importe quel événement]` | `[N'importe quel événement]` **\[1]** |

{% hint style="info" %}
**1.** Voir [Mapping d'événements](#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 [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Toutes les propriétés The Trade Desk de la colonne de droite sont définies dans l'objet <mark style="color:bleu;">`data.0`</mark> .
{% endhint %}

{% hint style="warning" %}
Les propriétés The Trade Desk suivantes peuvent être définies si `système d'exploitation de l'appareil`, dans le "Smart Mapping", est présent avec les valeurs prises en charge :

* `aaid`
* `idfa`
* `naid`
  {% endhint %}

<table><thead><tr><th width="341.6685580062746">Propriétés Commanders Act</th><th>Propriétés The Trade Desk</th></tr></thead><tbody><tr><td><code>ID du marchand</code></td><td><code>merchant_id</code> <strong>[*]</strong></td></tr><tr><td><code>ID du tracker d'événements</code></td><td><code>tracker_id</code> <strong>[*]</strong></td></tr><tr><td><code>ID de l'annonceur</code></td><td><code>adv</code> <strong>[*]</strong></td></tr><tr><td><code>ID du Universal Pixel</code></td><td><code>upixel_id</code> <strong>[*]</strong></td></tr><tr><td><code>Type d'ID utilisateur/appareil</code></td><td><code>adid_type</code></td></tr><tr><td><code>Identifiant utilisateur/appareil</code></td><td><code>adid</code></td></tr><tr><td>Voir <a href="#quick-reference">Référence rapide</a></td><td><code>event_name</code> <strong>[1]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>daid</code> <strong>[2]</strong><br><code>aaid</code> <strong>[3]</strong><br><code>idfa</code> <strong>[4]</strong><br><code>naid</code> <strong>[5]</strong></td></tr><tr><td><code>partners.ttd.tduid</code></td><td><code>tdid</code> <strong>[6]</strong></td></tr><tr><td><code>partners.ttd.uid2_token</code></td><td><code>uid2_token</code> <strong>[7]</strong></td></tr><tr><td><code>partners.ttd.euid_token</code></td><td><code>euid_token</code> <strong>[8]</strong></td></tr><tr><td><code>partners.ttd.idl</code></td><td><code>idl</code> <strong>[9]</strong></td></tr><tr><td><code>user.country</code></td><td><code>country</code></td></tr><tr><td><code>user.state</code></td><td><code>region</code></td></tr><tr><td><code>user.metro</code></td><td><code>metro</code></td></tr><tr><td><code>user.city</code></td><td><code>city</code></td></tr><tr><td><code>user.zipcode</code></td><td><code>zip</code></td></tr><tr><td><code>context.device.ip</code></td><td><code>client_ip</code></td></tr><tr><td><code>context.page.url</code></td><td><code>referrer_url</code></td></tr><tr><td><code>id</code></td><td><code>order_id</code></td></tr><tr><td><code>value</code></td><td><code>value</code></td></tr><tr><td><code>currency</code></td><td><code>currency</code></td></tr><tr><td><code>partners.ttd.iattr</code></td><td><code>iattr</code> <strong>[10]</strong></td></tr><tr><td><code>partners.ttd.imp</code></td><td><code>imp</code> <strong>[11]</strong></td></tr><tr><td><code>partners.ttd.ivtc</code></td><td><code>ivtc</code> <strong>[12]</strong></td></tr><tr><td><code>partners.ttd.privacy_type</code></td><td><code>privacy_settings.0.privacy_type</code> <strong>[13]</strong></td></tr><tr><td><code>partners.ttd.is_applicable</code></td><td><code>privacy_settings.0.is_applicable</code> <strong>[14]</strong></td></tr><tr><td><code>partners.ttd.consent_string</code></td><td><code>privacy_settings.0.consent_string</code> <strong>[15]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>items.X.item_code</code></td></tr><tr><td><code>items.X.product.name</code></td><td><code>items.X.name</code></td></tr><tr><td><code>items.X.quantity</code></td><td><code>items.X.qty</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>items.X.price</code></td></tr><tr><td><code>items.X.product.category_id</code></td><td><code>items.X.cat</code></td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td><code>[Custom Property Name]</code> <strong>[16]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Voir [Configuration](#configuration) pour plus de détails sur les propriétés obligatoires.\
**1.** Voir [`Remappage des événements`](#configuration) pour plus de détails.\
**2.** L'identifiant publicitaire de l'appareil pour un appareil Android, iOS ou Windows.\
**3.** L'identifiant publicitaire de l'appareil pour un appareil Android. Ceci n'est défini que si `système d'exploitation de l'appareil` le champ "Smart Mapping" est défini avec `Android` (insensible à la casse).\
**4.** L'identifiant publicitaire de l'appareil pour un appareil iOS. Ceci n'est défini que si `système d'exploitation de l'appareil` le champ "Smart Mapping" est défini avec `iOS` (insensible à la casse).\
**5.** L'identifiant publicitaire de l'appareil pour un appareil Windows. Ceci n'est défini que si `système d'exploitation de l'appareil` le champ "Smart Mapping" est défini avec `Windows` (insensible à la casse).\
**6.** Le GUID The Trade Desk de 36 caractères (tirets inclus) pour cet utilisateur.\
**7.** Le jeton UID2 chiffré, également connu sous le nom de jeton publicitaire. Ce jeton est sensible à la casse. Les jetons sont générés et gérés à l'aide des API UID2. Davantage de détails sur l'API UID2/les endpoints sont disponibles via ce [LIEN](https://unifiedid.com/docs/endpoints/summary-endpoints).\
**8. T**le jeton EUID chiffré, également connu sous le nom de jeton publicitaire. Ce jeton est sensible à la casse. Davantage de détails sur les Unified IDs sont disponibles via ce [LIEN](https://partner.thetradedesk.com/v3/portal/data/doc/UnifiedIDs#id-types).\
**9.** Le RampID de 49 ou 70 caractères (anciennement connu sous le nom d'IdentityLink). Il doit s'agir d'un RampID de LiveRamp mappé spécifiquement pour The Trade Desk. Davantage de détails sur le mappage d'un RampID sont disponibles via ce [LIEN](https://sidecar.readme.io/docs/getting-started).\
**10.** Un indicateur qui précise si l'événement est attribué à The Trade Desk. S'il est défini sur <mark style="color:bleu;">`true`</mark> (booléen), The Trade Desk attribue l'événement à l'identifiant d'impression spécifié (voir <mark style="color:bleu;">`data.0.imp`</mark> ), contourne les modèles d'attribution de The Trade Desk et aligne les résultats d'attribution avec ceux fournis par le partenaire aux annonceurs.\
**11.** Une chaîne de 36 caractères (tirets inclus) servant d'identifiant unique pour l'impression à laquelle l'événement est attribué.\
**12.** Un indicateur qui précise si l'événement est une conversion view-through.\
**13.** Cela peut être l'un des éléments suivants :`GDPR`,`CCPA`ou`GPP`selon la réglementation de confidentialité applicable. Ceci n'est inclus que si <mark style="color:bleu;">`is_applicable`</mark> et <mark style="color:bleu;">`consent_string`</mark> sont également définis. Davantage de détails sont disponibles en suivant ce [LIEN](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy).\
**14.** Indique si la valeur spécifiée dans <mark style="color:bleu;">`privacy_type`</mark> est applicable. Cela peut être <mark style="color:bleu;">`true`</mark> (ou <mark style="color:bleu;">`1`</mark> ) ou <mark style="color:bleu;">`false`</mark> (ou <mark style="color:bleu;">`0`</mark> ), de type booléen ou entier. Ceci n'est inclus que si <mark style="color:bleu;">`privacy_type`</mark> et <mark style="color:bleu;">`consent_string`</mark> sont également définis. Davantage de détails sont disponibles en suivant ce [LIEN](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy).\
**15.** Le Consent String TCF de l'utilisateur. Ceci n'est inclus que si <mark style="color:bleu;">`privacy_type`</mark> et <mark style="color:bleu;">`is_applicable`</mark> sont également définis. Davantage de détails sont disponibles en suivant ce [LIEN](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy).\
**16.** Voir <mark style="color:bleu;">`Propriétés d'événement personnalisées`</mark> dans [Configuration ](#configuration)pour plus de détails sur la façon de connecter des propriétés personnalisées à The Trade Desk.
{% 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, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/the-trade-desk/the-trade-desk-conversions-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.