> 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" %}
Le **Amazon Ads Conversions API** la destination est **obsolète**.\
Amazon recommande le nouveau **API des événements** 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 entreprise technologique multinationale axée sur 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) correspondances du modèle [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 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.
* **Hachage automatique**: les informations sont hachées automatiquement 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

### Configuration

<table><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 Amazon Ads tels que définis dans l'interface Commanders Act, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter des identifiants de 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 API Amazon que vous avez 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">LINK</a>.</td></tr><tr><td><code>Advertiser ID</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'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 ex. "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 la 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">Commanders Act Events</th><th>Amazon Tracking</th></tr></thead><tbody><tr><td><code>[Tout événement]</code> <strong>[1]</strong></td><td><code>[Any Conversion Definitions/Types]</code> <strong>[2]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Utilisez [**filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
**2. Voir** <mark style="color:bleu;">`ID de définition de conversion`</mark> dans [Configuration](#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 Amazon sont incluses dans <mark style="color:bleu;">`eventData.0`</mark> .
{% endhint %}

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

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="237">Champs Smart Mapping</th><th width="303.6685580062746">Propriétés par défaut de Commanders Act</th><th width="271">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>name</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 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 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 des articles</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>Data Processing Options</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:bleu;">`matchKeys.X.values[0]`</mark> , il s'agit de l'une des valeurs suivantes : <mark style="color:bleu;">`EMAIL`</mark>, <mark style="color:bleu;">`PHONE`</mark>, <mark style="color:bleu;">`FIRST_NAME`</mark>, <mark style="color:bleu;">`LAST_NAME`</mark>, <mark style="color:bleu;">`ADDRESS`</mark>, <mark style="color:bleu;">`CITY`</mark>, <mark style="color:bleu;">`STATE`</mark>, <mark style="color:bleu;">`POSTAL`</mark> ou <mark style="color:bleu;">`MAID`</mark>.\
**3.** L'ID spécifié par le client pour l'événement de conversion. Pour les événements ayant le même <mark style="color:bleu;">`clientDedupeId`</mark> seul l'événement le plus récent sera conservé.\
**4.** Ceci est défini avec <mark style="color:bleu;">`LIMITED_DATA_USE`</mark> lorsque <mark style="color:bleu;">`partners.amazon.data_processing`</mark> est une valeur de chaîne non vide, non fausse (booléen), non nulle (nombre).
{% 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.