# Amazon Events API

{% hint style="info" %}
Cette destination est actuellement en cours de dernière vérification et sera bientôt disponible.
{% endhint %}

[Amazon](https://www.aboutamazon.eu/who-we-are) est une entreprise technologique multinationale spécialisée dans l’e-commerce, le cloud computing, la publicité en ligne, le streaming numérique et l’intelligence artificielle. En utilisant cette destination, vous pouvez envoyer directement les données de conversion à Amazon Ads, en contournant les limitations côté navigateur comme les bloqueurs de publicité 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.

## Key features

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

* **Events structure**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspondances de modèle [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.
* **Prebuilt mappings**: 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.
* **Événements et propriétés personnalisés**: vous pouvez envoyer librement des événements et des propriétés personnalisés selon vos besoins spécifiques.
* **Smart mapping**: le mapping 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) :\
• Amazon Consent (`amazonConsent.amznUserData` et `amazonConsent.amznUserData)`\
`• IAB European Transparency & Consent Framework (`\
• IAB European Transparency & Consent Framework (`tcf`)\
• Global Privacy Policy (`gpp`)\
Les champs Amazon Consent sont automatiquement définis 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">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Requis</code></strong></em><br>Vos identifiants Amazon Ads, tels que définis dans l’interface Commanders Act, après : <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>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">LIEN</a>.</td></tr><tr><td><code>ID de l’annonceur</code></td><td><em><strong><code>Requis</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 l’ <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>Conversion Type</code></td><td><em><strong><code>Requis si non défini dans Smart Mapping</code></strong></em><br>Sélectionnez votre <code>Conversion Type</code> dans la liste ou mappez le <code>Smart Mapping</code> champ <code>Conversion Type</code>.</td></tr><tr><td><code>Event Source</code></td><td><em><strong><code>Requis si non défini dans Smart Mapping</code></strong></em><br>Sélectionnez votre <code>Event Source</code> dans la liste ou mappez le <code>Smart Mapping</code> champ <code>Event Source</code>.</td></tr><tr><td><code>Propriété pays</code></td><td><em><strong><code>Requis</code></strong></em><br>Le nom/chemin de la propriété correspondant au 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 fortement de définir ce champ afin d’aider à organiser vos définitions de conversion. Lorsqu’aucun nom de dataset n’est fourni, une nouvelle définition de conversion sera attribuée 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>.</td></tr><tr><td><code>Custom Event Properties</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

<table><thead><tr><th width="336">Commanders Act Events</th><th>Amazon Event</th></tr></thead><tbody><tr><td><code>[Any Event]</code> <strong>[1]</strong></td><td><code>[Any Event]</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Utilisez [**les filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour spécifier vos événements correspondants.
> {% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".
{% 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>partners.amazon.conversion_type</code><br><code>Conversion Type</code></td><td><code>conversionType</code> <strong>[*][1][2]</strong></td></tr><tr><td><code>Event Source</code></td><td><code>eventSource</code> <strong>[*][1]</strong></td></tr><tr><td><code>Propriété pays</code></td><td><code>countryCode</code> <strong>[*]</strong></td></tr><tr><td><code>Nom du dataset</code></td><td><code>dataSetName</code> <strong>[1][3]</strong></td></tr><tr><td><code>event_name</code></td><td><code>name</code> <strong>[1]</strong></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>eventTime</code></td></tr><tr><td><code>context.event_id</code></td><td><code>eventId</code> <strong>[4]</strong></td></tr><tr><td><code>currency</code></td><td><code>currencyCode</code></td></tr><tr><td><p><code>user.email</code><br><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><br><code>user.state</code><br><code>user.zipcode</code><br><code>context.device.advertising_id</code><br><code>partners.amazon.ramp_id</code><br><code>partners.amazon.match_id</code></p><p><code>partners.amazon.real_id</code><br><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>(user.email</code><br><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><br><code>user.state</code><br><code>user.zipcode</code><br><code>context.device.advertising_id</code><br><code>partners.amazon.ramp_id</code><br><code>partners.amazon.match_id</code></p><p><code>partners.amazon.real_id</code><br><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>partners.amazon.ad_storage</code></td><td><code>amazonConsent.amznAdStorage</code> <strong>[7]</strong></td></tr><tr><td><code>partners.amazon.user_data</code></td><td><code>amazonConsent.amznUserData</code> <strong>[7]</strong></td></tr><tr><td><code>partners.amazon.tcf</code></td><td><code>tcf</code> <strong>[7]</strong></td></tr><tr><td><code>partners.amazon.gpp</code></td><td><code>gpp</code> <strong>[7]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>ipAddress</code> <strong>[8]</strong></td></tr><tr><td><code>items.length</code></td><td><code>unitsSold</code></td></tr><tr><td><code>valeur</code></td><td><code>valeur</code></td></tr><tr><td><code>Custom Event Properties</code></td><td><code>customData</code></td></tr><tr><td><code>partners.amazon.data_processing</code></td><td><code>dataProcessingOptions</code></td></tr><tr><td><code>partners.amazon.ad_event_key</code></td><td><code>amazonAdEventKey</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[\*]** Champ obligatoire.\
> \&#xNAN;**\[1]** Défini dans <mark style="color:bleu;">`eventDescription`</mark> .\
> \&#xNAN;**\[2]** Priorité sur le côté gauche.\
> \&#xNAN;**\[3]** Voir [Configuration](#configuration) pour plus de détails.\
> \&#xNAN;**\[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 [LIEN](https://advertising.amazon.com/API/docs/en-us/guides/events/events#event-de-duplication).\
> \&#xNAN;**\[5]** Au moins un identifiant doit être fourni.\
> \&#xNAN;**\[6]** Selon la valeur fournie dans `matchKeys.X.values.0` , il s’agit de l’une des valeurs suivantes : `EMAIL` , `PHONE` , `FIRST_NAME` , `LAST_NAME` , `ADDRESS` , `CITY` , `STATE` , `POSTAL` , `MAID` , `RAMP_ID` , `MATCH_ID` , `REAL_ID` , `MERKLE_ID` et `KANTAR_ID` .\
> \&#xNAN;**\[7]** Défini dans <mark style="color:bleu;">`consent`</mark> . Voir [Configuration de la destination](#destination-setup) pour plus de détails.\
> \&#xNAN;**\[8]** Défini dans <mark style="color:bleu;">`consent.geo`</mark> .
> {% 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-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.