> 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 côté demande (DSP) indépendantes, 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 [API des événements de conversion en temps réel de The Trade Desk](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 événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspondances du 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.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Mappage 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-items**: 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" %}
Pour les identifiants utilisateur, vous devez transmettre soit `Type d’ID utilisateur/appareil` **ET** `Identifiant utilisateur/appareil` **OU** des champs "Smart Mapping" tels que `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 d’événements</code> ou <code>Mappage d’URL (pages vues)</code>.</td></tr><tr><td><code>ID marchand</code></td><td><em><strong><code>Requis pour le suivi d’é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’onboarding.</td></tr><tr><td><code>ID du tracker d’événements</code></td><td><p><em><strong><code>Requis pour le suivi d’é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>Advertiser ID</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 pour le compte 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 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 pour l’événement. Il peut s’agir de l’un quelconque des identifiants indiqués dans le <a href="https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi">LINK</a> (voir <code>adid</code> propriété).</td></tr><tr><td><code>Nom du cookie TTD TDID</code></td><td>Le cookie First party 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>Nom de la propriété The Trade Desk</code> et en ajoutant le nom du champ contenant les valeurs dans <code>Votre valeur</code> . p. ex. si vous saisissez <code>size</code> dans le <code>Nom de la propriété The Trade Desk</code> et <code>items.0.product.size</code> <strong>[2]</strong> dans <code>Votre valeur</code> , vous aurez dans The Trade Desk une propriété d’événement personnalisée 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>Correspondance des é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 des « points » ("."), vous pouvez naviguer plus profondément 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 [Correspondance des é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 %}

| Commanders Act Events | É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`                  |
| `[Tout événement]`    | `[Tout événement]` **\[1]** |

{% hint style="info" %}
**1.** Voir [Correspondance des événements](#configuration) pour plus de détails.
{% endhint %}

## Correspondances des 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 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 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>Advertiser ID</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>valeur</code></td><td><code>valeur</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 compris) 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. De plus amples détails sur l’API/les endpoints UID2 sont disponibles en suivant ce [LINK](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. De plus amples détails sur les Unified IDs sont disponibles en suivant ce [LINK](https://partner.thetradedesk.com/v3/portal/data/doc/UnifiedIDs#id-types).\
**9.** Le RampID de 49 ou 70 caractères (anciennement appelé IdentityLink). Il doit s’agir d’un RampID de LiveRamp mappé spécifiquement pour The Trade Desk. De plus amples détails sur le mappage d’un RampID sont disponibles en suivant ce [LINK](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 sur 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 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. De plus amples détails sont disponibles en suivant ce [LINK](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 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> et <mark style="color:bleu;">`consent_string`</mark> sont également définis. De plus amples détails sont disponibles en suivant ce [LINK](https://api.thetradedesk.com/v3/portal/data/doc/DataConversionEventsApi#properties-privacy).\
**15.** La 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. De plus amples détails sont disponibles en suivant ce [LINK](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 dont vous pouvez associer 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.