# Amazon Ads Conversions API

[Amazon](https://www.aboutamazon.eu/who-we-are) est une entreprise technologique multinationale axée sur le e-commerce, le cloud computing, la publicité en ligne, le streaming numérique et l'intelligence artificielle.\
En utilisant cette destination, vous pouvez importer les données des é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 principales fonctionnalité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 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 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.
* **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 datalayer.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Authentication</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos credentials avec Amazon Ads tels que définis dans l’interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des credentials de connecteur</code> ➜ <code>AmazonAds</code></td></tr><tr><td><code>API Base Url</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre endpoint 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>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. Le DSP Entity ID n'est pas pris en charge.</td></tr><tr><td><code>Profile Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez votre identifiant de profil.</td></tr><tr><td><code>Conversion Definition Id</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 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>Amazon property name</code> et en ajoutant les valeurs dans <code>Your value</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">Events Commanders Act</th><th>Amazon Tracking</th></tr></thead><tbody><tr><td><code>[Any Event]</code> <strong>[1]</strong></td><td><code>[Any Conversion Definitions/Types]</code> <strong>[2]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **1.** Utilisez [**Destination filters**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.\
> **2. Voir** <mark style="color:bleu;">`Conversion Definition Id`</mark> dans [Configuration](#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) 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>Amazon Properties</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>name</code> <strong>[*]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>timestamp</code> <strong>[*]</strong></td></tr><tr><td><code>Conversion Definition Id</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.** 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> soit de <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 chaîne non vide, une valeur non fausse (booléenne) et non nulle (numérique).
> {% 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/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.