> 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/amazon/amazon-ads-conversions-api.md).

# Amazon Ads Conversions API

{% hint style="warning" %}
La **Amazon Ads Conversions API** la destination est **obsolète**.\
Amazon recommande la nouvelle **Events API** pour fournir des signaux de consentement, et la destination associée est disponible comme suit
{% endhint %}

{% content-ref url="/pages/76cabf62497731708f9f1593670e3b3fcd162402" %}
[Amazon Events API](/fr/fonctionnalites/destinations/destinations-catalog/amazon/amazon-events-api.md)
{% endcontent-ref %}

[Amazon](https://www.aboutamazon.eu/who-we-are) est une multinationale technologique spécialisée dans le commerce électronique, le cloud computing, la publicité en ligne, le streaming numérique et l'intelligence artificielle.\
En utilisant cette destination, vous pouvez importer des données d'événements de conversion dans [Amazon DSP](https://advertising.amazon.com/solutions/products/amazon-dsp).

## Fonctionnalités clés

La destination Amazon Ads Conversions 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) le modèle correspond à [Les définitions/types de conversion d'Amazon](https://advertising.amazon.com/API/docs/en-us/dsp-conversion-builder#tag/Amazon-Conversion-Definitions/operation/dspAmazonCreateConversionDefinitions), ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.
* **Mappages préconfigurés**: le mappage des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement 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 data layer.

## Configuration de la destination

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="307">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 avec Amazon Ads tels que configurés dans l’interface Commanders Act selon : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants du connecteur</code> ➜ <code>AmazonAds</code></td></tr><tr><td><code>URL de base de l'API</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le point de terminaison Amazon API sélectionné. Plus de détails sont disponibles en suivant ce <a href="https://advertising.amazon.com/API/docs/en-us/reference/api-overview#api-endpoints">LIEN</a>.</td></tr><tr><td><code>ID de l'annonceur</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant de compte que vous utilisez pour accéder au DSP. Il s'agit de votre DSP Advertiser ID. DSP Entity ID n'est pas pris en charge.</td></tr><tr><td><code>ID du profil</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez l'identifiant de votre profil.</td></tr><tr><td><code>ID de définition de conversion</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez l'identifiant de votre définition de conversion.</td></tr><tr><td><code>Pays</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le pays d'où provient l'événement. Par exemple, « US ». Cette valeur est basée sur <a href="https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes">ISO 3166-1 alpha-2</a>.</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 propriété Amazon</code> et en ajoutant les valeurs dans <code>Votre valeur</code> . Vérifiez auprès d'Amazon si cette option est activée pour votre compte spécifique.</td></tr></tbody></table>

## Référence rapide

<table><thead><tr><th width="336">Événements Commanders Act</th><th>Amazon Tracking</th></tr></thead><tbody><tr><td><code>[Any Event]</code> <strong>[1]</strong></td><td><code>[Toutes les définitions/types de conversion]</code> <strong>[2]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Utilisation [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
**2. Voir** <mark style="color:blue;">`ID de définition de conversion`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages 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) fonctionnalité.\
Toutes les propriétés Amazon sont incluses dans <mark style="color:blue;">`eventData.0`</mark> .
{% endhint %}

{% hint style="warning" %}
Au moins un identifiant doit être fourni dans <mark style="color:blue;">`matchKeys`</mark> .
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Champs de Smart Mapping</th><th>Propriétés par défaut de Commanders Act</th><th>Propriétés Amazon</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>Pays</code></td><td><code>countryCode</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>nom</code> <strong>[*]</strong></td></tr><tr><td><code>Horodatage de l'événement</code></td><td><code>context.event_timestamp</code></td><td><code>timestamp</code> <strong>[*]</strong></td></tr><tr><td>-</td><td><code>ID de définition de conversion</code></td><td><code>conversionDefinitionId</code> <strong>[*]</strong></td></tr><tr><td><code>E-mail utilisateur haché</code><br><code>Téléphone utilisateur haché</code><br><code>Prénom haché</code><br><code>Nom de famille haché</code><br><code>Adresse utilisateur hachée</code><br><code>Ville utilisateur hachée</code><br><code>État utilisateur haché</code><br><code>Code postal utilisateur haché</code><br><code>Identifiant mobile de l'appareil</code></td><td><p><code>user.email_sha256</code></p><p><code>user.phone</code></p><p><code>user.firstname</code></p><p><code>user.lastname</code></p><p><code>user.street</code></p><p><code>user.city</code></p><p><code>user.state</code></p><p><code>user.zipcode</code></p><p><code>context.device.advertising_id</code></p></td><td><code>matchKeys.X.values[0]</code> <strong>[1]</strong></td></tr><tr><td><code>E-mail utilisateur haché</code><br><code>Téléphone utilisateur haché</code><br><code>Prénom haché</code><br><code>Nom de famille haché</code><br><code>Adresse utilisateur hachée</code><br><code>Ville utilisateur hachée</code><br><code>État utilisateur haché</code><br><code>Code postal utilisateur haché</code><br><code>Identifiant mobile de l'appareil</code></td><td><p><code>user.email_sha256</code></p><p><code>user.phone</code></p><p><code>user.firstname</code></p><p><code>user.lastname</code></p><p><code>user.street</code></p><p><code>user.city</code></p><p><code>user.state</code></p><p><code>user.zipcode</code></p><p><code>context.device.advertising_id</code></p></td><td><code>matchKeys.X.type</code> <strong>[2]</strong></td></tr><tr><td><code>Liste d'items</code></td><td><code>items.length</code></td><td><code>unitsSold</code></td></tr><tr><td><code>Valeur</code></td><td><code>valeur</code></td><td><code>valeur</code></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><code>ID de déduplication client</code></td><td><code>context.event_id</code></td><td><code>clientDedupeId</code> <strong>[3]</strong></td></tr><tr><td><code>Options de traitement des données</code></td><td><code>partners.amazon.data_processing</code></td><td><code>dataProcessingOptions</code> <strong>[4]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Au moins un identifiant doit être fourni.\
**2.** Selon la valeur fournie dans <mark style="color:blue;">`matchKeys.X.values[0]`</mark> , il s’agit de l’une des valeurs suivantes : <mark style="color:blue;">`EMAIL`</mark>, <mark style="color:blue;">`PHONE`</mark>, <mark style="color:blue;">`FIRST_NAME`</mark>, <mark style="color:blue;">`LAST_NAME`</mark>, <mark style="color:blue;">`ADDRESS`</mark>, <mark style="color:blue;">`CITY`</mark>, <mark style="color:blue;">`STATE`</mark>, <mark style="color:blue;">`POSTAL`</mark> ou <mark style="color:blue;">`MAID`</mark>.\
**3.** L'identifiant spécifié par le client pour l'événement de conversion. Pour les événements ayant le même <mark style="color:blue;">`clientDedupeId`</mark> seul le dernier événement sera conservé.\
**4.** Cela est défini avec avec <mark style="color:blue;">`LIMITED_DATA_USE`</mark> lorsque <mark style="color:blue;">`partners.amazon.data_processing`</mark> est une valeur chaîne non vide, non fausse (booléenne), non nulle (numérique).
{% 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/amazon/amazon-ads-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.