> 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

{% hint style="info" %}
Cette destination est actuellement en revue finale et sera bientôt disponible.
{% endhint %}

[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. Grâce à cette destination, vous pouvez envoyer les données de conversion directement à Amazon Ads, en contournant les limites côté navigateur comme les bloqueurs de publicités et les restrictions liées aux cookie. Elle complète [Amazon Ad Tag (AAT)](https://advertising.amazon.com/help/GLZ54GXQW773A6MG) pour fournir 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 [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) modèle 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 les événements se fait automatiquement, ce qui simplifie la saisie de l’utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées 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 selon vos besoins spécifiques.
* **Smart Mapping**: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.

## Configuration de la destination

{% hint style="warning" %}
Si vous transmettez ou mettez à disposition d’Amazon Ads 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\. Consentement Amazon (<mark style="color:bleu;">`amazonConsent.amznUserData`</mark> et <mark style="color:bleu;">`amazonConsent.amznUserData`</mark>`)`\
2\. Cadre européen de transparence et de consentement IAB (`tcf`)\
3\. Global Privacy Policy (`gpp`)\
Les champs de consentement Amazon (1.) sont définis automatiquement si vous activez notre [intégration Amazon Consent Signal](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>Requis</code></strong></em><br>Vos identifiants avec Amazon Ads tels que définis dans l’interface Commanders Act en suivant : <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>Requis</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>ID annonceur</code></td><td><em><strong><code>Requis</code></strong></em><br>Saisissez votre identifiant d’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 au compte et paramètres</code> et <code>Comptes</code>.</td></tr><tr><td><code>Source de l’événement</code></td><td><em><strong><code>Requis s’il n’est pas 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é pays</code></td><td><em><strong><code>Requis</code></strong></em><br>Le nom/le chemin de 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 jeu de données</code></td><td>Nom du jeu de données auquel cet événement doit être ajouté. Amazon recommande vivement de définir ce champ afin d’aider à organiser vos définitions de conversion. Lorsqu’aucun nom de jeu de données n’est fourni, de nouvelles définitions de conversion seront attribuées au <code>default_events</code> jeu de données. 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">LINK</a>.</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> .</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Types de conversion Amazon           |
| ------------------------- | ------------------------------------ |
| `add_to_cart`             | `ADD_TO_SHOPPING_CART`               |
| `application`             | `APPLICATION`                        |
| `begin_checkout`          | `CHECKOUT`                           |
| `contact`                 | `CONTACT`                            |
| `generate_lead`           | `LEAD`                               |
| `purchase`                | `OFF_AMAZON_PURCHASES`               |
| `mobile_app_first_start`  | `MOBILE_APP_FIRST_START`             |
| `page_view`               | `PAGE_VIEW`                          |
| `search`                  | `SEARCH`                             |
| `sign_up`                 | `SIGN_UP`                            |
| `subscribe`               | `SUBSCRIBE`                          |
| `other`                   | `OTHER`                              |
| `[Tout événement]`        | `[Tout type de conversion]` **\[1]** |

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

{% hint style="warning" %}
Au moins l’un des champs « Smart Mapping » suivants doit être renseigné :\
• <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 width="386">Champs Smart Mapping</th><th width="328.6685580062746">Propriétés Commanders Act</th><th width="311.3314419937253">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é pays</code></td><td><code>countryCode</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>Nom du jeu de données</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>name</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 du cadre de transparence et de consentement</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></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é de l’é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éfini dans <mark style="color:bleu;">`eventDescription`</mark> .\
**2.** Priorité du côté 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, utilisé pour la déduplication. Plus de détails sont disponibles en suivant ce [LINK](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éfini dans <mark style="color:bleu;">`consent`</mark> . Voir [Configuration de la destination](#destination-setup) pour plus de détails.\
**8.** Défini dans <mark style="color:bleu;">`consent.geo`</mark> .
{% 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-events-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.