> 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

[Amazon](https://www.aboutamazon.eu/who-we-are) est une entreprise technologique multinationale 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 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 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.
* **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.
* **Hachage automatique**: les informations sont automatiquement hachées 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 data layer.

## 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">LIEN</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 Advertiser ID DSP. L'Entity ID DSP n'est pas pris en charge.</td></tr><tr><td><code>ID de profil</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez votre identifiant de 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 votre identifiant de 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">Événements Commanders Act</th><th>Amazon Tracking</th></tr></thead><tbody><tr><td><code>[N'importe quel événement]</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.** 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 %}

## 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 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><thead><tr><th width="359.6685580062746">Propriétés Commanders Act</th><th>Propriétés Amazon</th></tr></thead><tbody><tr><td><code>Pays</code></td><td><code>countryCode</code> <strong>[*]</strong></td></tr><tr><td><code>event_name</code></td><td><code>nom</code> <strong>[*]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>timestamp</code> <strong>[*]</strong></td></tr><tr><td><code>ID de définition de conversion</code></td><td><code>conversionDefinitionId</code> <strong>[*]</strong></td></tr><tr><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><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>items.length</code></td><td><code>unitsSold</code></td></tr><tr><td><code>value</code></td><td><code>value</code></td></tr><tr><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><code>context.event_id</code></td><td><code>clientDedupeId</code> <strong>[3]</strong></td></tr><tr><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.** En fonction de 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 portant le même <mark style="color:bleu;">`clientDedupeId`</mark> seul le dernier événement sera conservé.\
**4.** Ceci est défini avec avec <mark style="color:bleu;">`LIMITED_DATA_USE`</mark> lorsque <mark style="color:bleu;">`partners.amazon.data_processing`</mark> est une valeur de type 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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/amazon/amazon-ads-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.