> 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-events-api.md).

# Amazon Events API

[Amazon](https://www.aboutamazon.eu/who-we-are) est une société 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 envoyer les données de conversion directement à Amazon Ads, en contournant les limitations côté browser-side comme les bloqueurs de publicité et les restrictions de cookie. Elle complète [Amazon Ad Tag (AAT)](https://advertising.amazon.com/help/GLZ54GXQW773A6MG) afin d'offrir une attribution plus complète sur les campagnes DSP, SD et STV, permettant une meilleure optimisation et un CPA plus faible.

## Fonctionnalités clés

La destination Amazon Events API offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [modèle de référence Events](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond à [la structure d'événements d'Amazon](https://advertising.amazon.com/API/docs/en-us/guides/events/events#send-events), 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 se fait automatiquement, ce qui simplifie la saisie de l'utilisateur.
* **Hachage automatique**les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Événements et propriétés personnalisés**vous pouvez envoyer librement des événements et propriétés personnalisés en fonction de vos besoins spécifiques.
* **Smart Mapping**le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge du mode batch**envoyer plusieurs événements dans une seule requête.

## Configuration de la destination

{% hint style="warning" %}
Si vous transmettez à Amazon Ads ou mettez à sa disposition des informations personnelles dans le cadre de votre utilisation de services publicitaires Amazon au Royaume-Uni et dans l'EEE, vous devez partager un signal de consentement valide ainsi que le code pays dans lequel le consentement a été accordé par le client.\
Les signaux de consentement pertinents incluent (voir [Mappage des champs](#field-mappings) pour plus de détails) :\
1\. Amazon Consent (<mark style="color:bleu;">`amazonConsent.amznUserData`</mark> et <mark style="color:bleu;">`amazonConsent.amznUserData`</mark>`)`\
2\. IAB European Transparency & Consent Framework (`tcf`)\
3\. Global Privacy Policy (`gpp`)\
Les champs Amazon Consent (1.) sont automatiquement définis si vous activez notre [Amazon Consent Signal integration](https://doc.commandersact.com/features/consent-management/setup-guides/tag-manager/amazon-consent-signal).
{% endhint %}

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Vos identifiants Amazon Ads tels que définis dans l'interface Commanders Act, conformément à : <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>ID annonceur</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Saisissez l'identifiant de votre annonceur, comme indiqué dans <a href="https://advertising.amazon.com">Amazon Ads</a>, en cliquant sur le <code>icône d'engrenage (Administration)</code> dans le menu de gauche puis <code>Accès et paramètres du compte</code> et <code>Comptes</code>.</td></tr><tr><td><code>Source de l'événement</code></td><td><em><strong><code>Obligatoire si non défini dans Smart Mapping</code></strong></em><br>Sélectionnez votre <code>Source de l'événement</code> dans la liste ou mappez le <code>Smart Mapping</code> champ <code>Source de l'événement</code>.</td></tr><tr><td><code>Propriété de pays</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le nom/le chemin de la propriété vers le pays d'où provient l'événement. 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>Nom du dataset</code></td><td>Nom du dataset auquel cet événement doit être ajouté. Amazon recommande vivement de définir ce champ afin d'organiser vos définitions de conversion. Lorsqu'aucun nom de dataset n'est fourni, de nouvelles définitions de conversion seront attribuées au <code>default_events</code> dataset. Plus de détails sont disponibles en suivant ce <a href="https://advertising.amazon.com/API/docs/en-us/guides/events/events#the-datasets-concept">LIEN</a>.<br>Le premier caractère doit être une lettre majuscule (<code>A-Z</code>) ou minuscule (<code>a-z</code>) et, suivi de 4 à 99 caractères, chacun pouvant être une lettre, un chiffre (<code>0-9</code>), un underscore (<code>_</code>), ou un tiret (<code>-</code>).</td></tr><tr><td><code>Mappage des événements</code></td><td>Modifiez le mappage standard entre les types de conversion Amazon et vos événements, ou ajoutez de nouveaux mappages.</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td>Données personnalisées associées à l'événement. 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> . <code>Votre valeur</code> ne peut pas être vide et son type doit être l'un des suivants : <code>INTEGER</code> , <code>TIMESTAMP</code> ou <code>STRING</code> .</td></tr></tbody></table>

## Référence rapide

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Événements Commanders Act</th><th>Types de conversion Amazon</th></tr></thead><tbody><tr><td><code>add_to_cart</code></td><td><code>ADD_TO_SHOPPING_CART</code></td></tr><tr><td><code>application</code></td><td><code>APPLICATION</code></td></tr><tr><td><code>begin_checkout</code></td><td><code>CHECKOUT</code></td></tr><tr><td><code>contact</code></td><td><code>CONTACT</code></td></tr><tr><td><code>generate_lead</code></td><td><code>LEAD</code></td></tr><tr><td><code>purchase</code></td><td><code>OFF_AMAZON_PURCHASES</code></td></tr><tr><td><code>mobile_app_first_start</code></td><td><code>MOBILE_APP_FIRST_START</code></td></tr><tr><td><code>page_view</code></td><td><code>PAGE_VIEW</code></td></tr><tr><td><code>search</code></td><td><code>SEARCH</code></td></tr><tr><td><code>sign_up</code></td><td><code>SIGN_UP</code></td></tr><tr><td><code>subscribe</code></td><td><code>SUBSCRIBE</code></td></tr><tr><td><code>other</code></td><td><code>OTHER</code></td></tr><tr><td><code>[Any Event]</code></td><td><code>[Any Conversion Type]</code> <strong>[1]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Mappage des événements`</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é.
{% endhint %}

{% hint style="warning" %}
Au moins l'un des champs "Smart Mapping" suivants doit être défini :\
• <mark style="color:bleu;">`E-mail utilisateur`</mark>\
• <mark style="color:bleu;">`Téléphone utilisateur`</mark>\
• <mark style="color:bleu;">`Prénom`</mark>\
• <mark style="color:bleu;">`Nom`</mark>\
• <mark style="color:bleu;">`Adresse utilisateur`</mark>\
• <mark style="color:bleu;">`Ville utilisateur`</mark>\
• <mark style="color:bleu;">`État utilisateur`</mark>\
• <mark style="color:bleu;">`Code postal utilisateur`</mark>\
• <mark style="color:bleu;">`Identifiant mobile de l'appareil`</mark>\
• <mark style="color:bleu;">`ID Ramp`</mark>\
• <mark style="color:bleu;">`ID Match`</mark>\
• <mark style="color:bleu;">`ID Real`</mark>\
• <mark style="color:bleu;">`ID Merkle`</mark>\
• <mark style="color:bleu;">`ID Kantar`</mark>\
Voir la propriété Amazon <mark style="color:bleu;">`matchKeys.X.values.0`</mark> pour plus de détails.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Champs Smart Mapping</th><th>Propriétés par défaut Commanders Act</th><th>Propriétés Amazon</th></tr></thead><tbody><tr><td><p><code>Type de conversion</code></p><p><code>-</code></p></td><td><p><code>partners.amazon.conversion_type</code></p><p><code>(event_name)</code></p></td><td><code>conversionType</code> <strong>[*][1][2]</strong></td></tr><tr><td><p><code>Source de l'événement</code></p><p><code>-</code></p></td><td><p><code>partners.amazon.event_source</code></p><p><code>Source de l'événement</code></p></td><td><code>eventSource</code> <strong>[*][1]</strong></td></tr><tr><td><code>-</code></td><td><code>Propriété de pays</code></td><td><code>countryCode</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Nom du dataset</code></td><td><code>dataSetName</code> <strong>[1][3]</strong></td></tr><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>nom</code> <strong>[1]</strong></td></tr><tr><td><code>Horodatage de l'événement</code></td><td><code>context.event_timestamp</code></td><td><code>eventTime</code></td></tr><tr><td><code>ID de l'événement</code></td><td><code>context.event_id</code></td><td><code>eventId</code> <strong>[4]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><p><code>E-mail utilisateur</code></p><p><code>Téléphone utilisateur</code></p><p><code>Prénom</code></p><p><code>Nom</code></p><p><code>Adresse utilisateur</code></p><p><code>Ville utilisateur</code></p><p><code>État utilisateur</code></p><p><code>Code postal utilisateur</code></p><p><code>Identifiant mobile de l'appareil</code></p><p><code>ID Ramp</code></p><p><code>ID Match</code></p><p><code>ID Real</code></p><p><code>ID Merkle</code></p><p><code>ID Kantar</code></p></td><td><p><code>user.email</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><p><code>partners.amazon.ramp_id</code></p><p><code>partners.amazon.match_id</code></p><p><code>partners.amazon.real_id</code></p><p><code>partners.amazon.merkle_id</code></p><p><code>partners.amazon.kantar_id</code></p></td><td><code>matchKeys.X.values.0</code> <strong>[5]</strong></td></tr><tr><td><p><code>E-mail utilisateur</code></p><p><code>Téléphone utilisateur</code></p><p><code>Prénom</code></p><p><code>Nom</code></p><p><code>Adresse utilisateur</code></p><p><code>Ville utilisateur</code></p><p><code>État utilisateur</code></p><p><code>Code postal utilisateur</code></p><p><code>Identifiant mobile de l'appareil</code></p><p><code>ID Ramp</code></p><p><code>ID Match</code></p><p><code>ID Real</code></p><p><code>ID Merkle</code></p><p><code>ID Kantar</code></p></td><td><p><code>user.email</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><p><code>partners.amazon.ramp_id</code></p><p><code>partners.amazon.match_id</code></p><p><code>partners.amazon.real_id</code></p><p><code>partners.amazon.merkle_id</code></p><p><code>partners.amazon.kantar_id</code></p></td><td><code>matchKeys.X.type</code> <strong>[6]</strong></td></tr><tr><td><code>Stockage publicitaire Amazon Consent</code></td><td><code>partners.amazon.ad_storage</code></td><td><code>amazonConsent.amznAdStorage</code> <strong>[7]</strong></td></tr><tr><td><code>Données utilisateur Amazon Consent</code></td><td><code>partners.amazon.user_data</code></td><td><code>amazonConsent.amznUserData</code> <strong>[7]</strong></td></tr><tr><td><code>Chaîne Transparency and Consent Framework</code></td><td><code>partners.amazon.tcf</code></td><td><code>tcf</code> <strong>[7]</strong></td></tr><tr><td><code>Chaîne Global Privacy Platform</code></td><td><code>partners.amazon.gpp</code></td><td><code>gpp</code> <strong>[7]</strong></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>ipAddress</code> <strong>[8]</strong></td></tr><tr><td><code>Liste d'articles</code></td><td><code>items.length</code></td><td><code>unitsSold</code></td></tr><tr><td><code>Valeur</code></td><td><code>value</code></td><td><code>value</code></td></tr><tr><td>-</td><td><code>Propriétés d'événement personnalisées</code></td><td><code>customData</code> <strong>[9]</strong></td></tr><tr><td><code>Limiter l'utilisation des données</code></td><td><code>partners.amazon.data_processing</code></td><td><code>dataProcessingOptions</code></td></tr><tr><td><code>Clé d'événement publicitaire</code></td><td><code>partners.amazon.ad_event_key</code></td><td><code>amazonAdEventKey</code></td></tr></tbody></table>

{% hint style="info" %}
**\*** Champ obligatoire.\
**1.** Définir dans <mark style="color:bleu;">`eventDescription`</mark> .\
**2.** La priorité est à gauche. Voir [Référence rapide](#quick-reference) pour plus de détails.\
**3.** Voir [Configuration](#configuration) pour plus de détails.\
**4.** Votre ID spécifié pour l'événement de conversion et utilisé pour la déduplication. Plus de détails sont disponibles en suivant ce [LIEN](https://advertising.amazon.com/API/docs/en-us/guides/events/events#event-de-duplication).\
**5.** Au moins un identifiant doit être fourni.\
**6.** 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> , <mark style="color:bleu;">`MAID`</mark> , <mark style="color:bleu;">`RAMP_ID`</mark> , <mark style="color:bleu;">`MATCH_ID`</mark> , <mark style="color:bleu;">`REAL_ID`</mark> , <mark style="color:bleu;">`MERKLE_ID`</mark> et <mark style="color:bleu;">`KANTAR_ID`</mark> .\
**7.** Définir dans <mark style="color:bleu;">`consent`</mark> . Voir [Configuration de la destination](#destination-setup) pour plus de détails.\
**8.** Définir dans <mark style="color:bleu;">`consent.geo`</mark> .\
&#x39;**.** Voir <mark style="color:bleu;">`Propriétés d'événement personnalisées`</mark> dans [Configuration](#configuration).
{% 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-events-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.