# The Trade Desk Conversions API

[The Trade Desk](https://www.thetradedesk.com/us) est l'une des plus grandes demand-side platform (DSP) indépendantes, fournissant une tarification et un placement des publicités en temps réel pour les annonceurs, les agences média 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 fournit les fonctionnalités clés suivantes :

* **Structure des events**: notre [Référence des events](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 bridgées vers les champs attendus de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur les events 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 datalayer.
* **Mappage des événements**: modifiez le mapping standard entre les événements de vos partenaires et les vôtres, ou ajoutez de nouveaux mappings.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est envoyé à The Trade Desk.

## Configuration de la destination

{% hint style="info" %}
Concernant les identifiants utilisateur, vous devez transmettre soit `Type d'ID utilisateur/appareil` **ET** `Identifiant utilisateur/appareil` **OU** des champs "Smart Mapping" comme `Device Mobile Identifier` , `The Trade Desk GUID` , `Encrypted UID2 token` , `Encrypted EUID token` , `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>TTD Conversion API URL</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre TTD Conversion API URL. Valeur par défaut : "https://insight.adsrvr.org/track/realtimeconversion".</td></tr><tr><td><code>Tracking Tag Type</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Choisissez le type de tracking tag. Il s'agit soit de <code>Event Tracking</code> soit de <code>URL Mapping (page views)</code>.</td></tr><tr><td><code>Merchant Id</code></td><td><em><strong><code>Requis pour Event Tracking</code></strong></em> <strong>[1]</strong><br>L'identifiant plateforme du merchant attribué par The Trade Desk au merchant pendant le processus d'onboarding.</td></tr><tr><td><code>Event Tracker Id</code></td><td><p><em><strong><code>Requis pour Event Tracking</code></strong></em> <strong>[1]</strong></p><p>L'identifiant plateforme The Trade Desk de l'event tracker.</p></td></tr><tr><td><code>Advertiser Id</code></td><td><em><strong><code>Requis pour URL Mapping (page views)</code></strong></em> <strong>[1]</strong><br>L'identifiant plateforme The Trade Desk de l'annonceur au nom duquel l'appel de tracking est effectué.</td></tr><tr><td><code>Universal Pixel Id</code></td><td><em><strong><code>Requis pour URL Mapping (page views)</code></strong></em> <strong>[1]</strong><br>L'identifiant plateforme The Trade Desk du "Universal Pixel".</td></tr><tr><td><code>Type d'ID utilisateur/appareil</code></td><td>Le type de l'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 de l'événement. Cela peut être n'importe lequel des identifiants spécifiés dans le <a href="https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi">LIEN</a> (Voir <code>adid</code> property).</td></tr><tr><td><code>TTD TDID Cookie Name</code></td><td>Le cookie first party dans lequel vous avez stocké la valeur du cookie TTD TDID. Celui-ci 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 personnalisées d’événement</code></td><td>Mappez vos propriétés personnalisées d’événement en définissant leurs noms de champ dans <code>The Trade Desk property name</code> et en ajoutant le nom du champ contenant les valeurs dans <code>Your value</code> . Par ex., si vous saisissez <code>size</code> dans le <code>The Trade Desk property name</code> and <code>items.0.product.size</code> <strong>[2]</strong> dans <code>Your value</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 des events</code></td><td>Modifiez le <a href="#quick-reference">standard mapping</a> entre les événements de The Trade Desk et les vôtres, ou ajoutez de nouveaux mappings.</td></tr></tbody></table>

{% hint style="info" %}

> **1.** Voir[`Tracking Tag Type`](#configuration)pour plus de détails.\
> **2.** En utilisant des « points » (".") vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous voulez obtenir la valeur. Voir [Référence des events](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 des events](#configuration) vous pouvez modifier le [standard mapping](#quick-reference) entre les événements de The Trade Desk et les vôtres, ou ajoutez de nouveaux mappings.
{% endhint %}

| Events Commanders Act | The Trade Desk Events  |
| --------------------- | ---------------------- |
| `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`             |
| `[Any Event]`         | `[Any Event]` **\[1]** |

{% hint style="info" %}

> **1.** Voir [Mapping des events](#configuration) pour plus de détails.
> {% endhint %}

## Mappings des 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) feature.\
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 `Device OS`est présent, dans le "Smart Mapping", avec les valeurs prises en charge :

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

<table><thead><tr><th width="341.6685580062746">Propriétés Commanders Act</th><th>The Trade Desk Properties</th></tr></thead><tbody><tr><td><code>Merchant Id</code></td><td><code>merchant_id</code> <strong>[*]</strong></td></tr><tr><td><code>Event Tracker Id</code></td><td><code>tracker_id</code> <strong>[*]</strong></td></tr><tr><td><code>Advertiser Id</code></td><td><code>adv</code> <strong>[*]</strong></td></tr><tr><td><code>Universal Pixel Id</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 personnalisées d’événement</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 [`Event Remapping`](#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. Celui-ci n'est défini que si `Device OS` le champ "Smart Mapping" est défini avec `Android` (insensible à la casse).\
> **4.** L'identifiant publicitaire de l'appareil pour un appareil iOS. Celui-ci n'est défini que si `Device OS` le champ "Smart Mapping" est défini avec `iOS` (insensible à la casse).\
> **5.** L'identifiant publicitaire de l'appareil pour un appareil Windows. Celui-ci n'est défini que si `Device OS` le champ "Smart Mapping" est défini avec `Windows` (insensible à la casse).\
> **6.** Le GUID The Trade Desk à 36 caractères (y compris les tirets) pour cet utilisateur.\
> **7.** Le encrypted UID2 token, également connu sous le nom de advertising token. Ce token est sensible à la casse. Les tokens sont générés et gérés à l'aide des UID2 APIs. Plus de détails sur l'UID2 API/endpoints sont disponibles en suivant ce [LIEN](https://unifiedid.com/docs/endpoints/summary-endpoints).\
> **8. T**he encrypted EUID token, également connu sous le nom de advertising token. Ce token est sensible à la casse. Plus de détails sur les Unified IDs sont disponibles en suivant ce [LIEN](https://partner.thetradedesk.com/v3/portal/data/doc/UnifiedIDs#id-types).\
> **9.** Le RampID à 49 caractères ou 70 caractères (anciennement connu sous le nom de IdentityLink). Il doit s'agir d'un RampID provenant de LiveRamp, spécifiquement mappé pour The Trade Desk. Plus de détails sur le mapping d'un RampID sont disponibles en suivant ce [LIEN](https://sidecar.readme.io/docs/getting-started).\
> **10.** Un indicateur qui indique si l'événement est attribué à The Trade Desk. S'il est défini sur <mark style="color:bleu;">`true`</mark> (boolean), 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 compris) qui sert d'identifiant unique pour l'impression à laquelle l'événement est attribué.\
> **12.** Un indicateur qui indique si l'événement est une view-through conversion.\
> **13.** Cela peut être l'un des éléments suivants :`GDPR`,`CCPA`soit de`GPP`selon la réglementation de confidentialité applicable. Ceci n'est inclus que si <mark style="color:bleu;">`is_applicable`</mark> and <mark style="color:bleu;">`consent_string`</mark> sont également définis. Plus 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 soit <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> and <mark style="color:bleu;">`consent_string`</mark> sont également définis. Plus de détails sont disponibles en suivant ce [LIEN](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy).\
> **15.** La TCF consent string de l'utilisateur. Ceci n'est inclus que si <mark style="color:bleu;">`privacy_type`</mark> and <mark style="color:bleu;">`is_applicable`</mark> sont également définis. Plus 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 personnalisées d’événement`</mark> dans [Configuration ](#configuration)pour plus de détails sur la manière dont vous pouvez relier des propriétés personnalisées à The Trade Desk.
> {% endhint %}


---

# Agent Instructions: 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/the-trade-desk/the-trade-desk-conversions-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.