Amazon Events API

Amazon 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 envoyer les données de conversion directement à Amazon Ads, en contournant les limitations côté navigateur comme les bloqueurs de publicité et les restrictions de cookie. Elle complète Amazon Ad Tag (AAT) 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 le modèle correspond à la structure d’événements d’Amazon, 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 s’effectue automatiquement, ce qui simplifie les saisies 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 selon vos besoins spécifiques.

• Mappage intelligent: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.

• Prise en charge du mode batch: envoyez plusieurs événements dans une seule requête.

Configuration de la destination

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 pour plus de détails) : 1. Amazon Consent (amazonConsent.amznUserData et amazonConsent.amznUserData) 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 intégration Amazon Consent Signal.

Configuration

Paramètres	Description
Identifiants	Obligatoire Vos identifiants avec Amazon Ads tels que configurés dans l’interface Commanders Act selon : Administration ➜ Identifiants du connecteur ➜ Ajouter des identifiants du connecteur ➜ AmazonAds
URL de base de l'API	Obligatoire Le point de terminaison Amazon API sélectionné. Plus de détails sont disponibles en suivant ce LIEN.
ID de l'annonceur	Obligatoire Saisissez l’identifiant de votre annonceur, comme indiqué dans Amazon Ads, en cliquant sur l' icône d'engrenage (Administration) dans le menu de gauche puis Accès au compte et paramètres et Comptes.
Source d'événement	Obligatoire s’il n’est pas défini dans Smart Mapping Sélectionnez votre Source d'événement dans la liste ou mappez le Smart Mapping champ Source d'événement.
Propriété du pays	Obligatoire Le nom/chemin de propriété vers le pays d’où provient l’événement. Cette valeur est basée sur ISO 3166-1 alpha-2.
Nom du dataset	Nom du dataset auquel cet événement doit être ajouté. Amazon recommande vivement de définir ce champ pour aider à organiser vos définitions de conversion. Lorsqu’aucun nom de dataset n’est fourni, de nouvelles définitions de conversion seront attribuées au default_events dataset. Plus de détails sont disponibles en suivant ce LIEN. Le premier caractère doit être une lettre majuscule (A-Z) ou minuscule (a-z) lettre, suivie de 4 à 99 caractères, chacun pouvant être une lettre, un chiffre (0-9), un tiret bas (_), ou un tiret (-).
Mappage des événements	Modifiez le mappage standard entre les types de conversion Amazon et vos événements ou ajoutez de nouveaux mappages.
Propriétés d’événement personnalisées	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 nom de propriété Amazon et en ajoutant les valeurs dans Votre valeur . Votre valeur ne peut pas être vide et son type doit être l’un des suivants : INTEGER , TIMESTAMP ou STRING .

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
[Any Event]	[Any Conversion Type] [1]

1. Voir Mappage des événements dans Configuration pour plus de détails.

Mappages de champs

Les propriétés peuvent être remappées à l’aide de notre Smart Mapping fonctionnalité.

Au moins l’un des champs « Smart Mapping » suivants doit être défini : • E-mail utilisateur • Téléphone utilisateur • Prénom • Nom • Adresse utilisateur • Ville utilisateur • État utilisateur • Code postal utilisateur • Identifiant mobile de l'appareil • ID Ramp • ID Match • ID Real • ID Merkle • ID Kantar Voir la propriété Amazon matchKeys.X.values.0 pour plus de détails.

Champs Smart Mapping	Propriétés par défaut de Commanders Act	Propriétés Amazon
Type de conversion -	partners.amazon.conversion_type event_name	conversionType [*][1][2]
Source d'événement -	partners.amazon.event_source Source d'événement	eventSource [*][1]
-	Propriété du pays	countryCode [*]
Nom de la définition de conversion	event_name	name [*][1][3]
-	Nom du dataset	dataSetName [1][4]
Horodatage de l'événement	context.event_timestamp	eventTime
ID de l'événement	context.event_id	eventId [5]
Devise	currency	currencyCode
E-mail utilisateur Téléphone utilisateur Prénom Nom Adresse utilisateur Ville utilisateur État utilisateur Code postal utilisateur Identifiant mobile de l'appareil ID Ramp ID Match ID Real ID Merkle ID Kantar	user.email user.phone user.firstname user.lastname user.street user.city user.state user.zipcode context.device.advertising_id partners.amazon.ramp_id partners.amazon.match_id partners.amazon.real_id partners.amazon.merkle_id partners.amazon.kantar_id	matchKeys.X.values.0 [6]
E-mail utilisateur Téléphone utilisateur Prénom Nom Adresse utilisateur Ville utilisateur État utilisateur Code postal utilisateur Identifiant mobile de l'appareil ID Ramp ID Match ID Real ID Merkle ID Kantar	user.email user.phone user.firstname user.lastname user.street user.city user.state user.zipcode context.device.advertising_id partners.amazon.ramp_id partners.amazon.match_id partners.amazon.real_id partners.amazon.merkle_id partners.amazon.kantar_id	matchKeys.X.type [7]
Amazon Consent Ad Storage	partners.amazon.ad_storage	amazonConsent.amznAdStorage [8]
Amazon Consent User Data	partners.amazon.user_data	amazonConsent.amznUserData [8]
Transparency and Consent Framework String	partners.amazon.tcf	tcf [8]
Global Privacy Platform String	partners.amazon.gpp	gpp [8]
IP de l’appareil	context.device.ip	ipAddress [9]
Liste d'articles	items.length	unitsSold
Valeur	value	value
-	Propriétés d’événement personnalisées	customData [10]
Limiter l’utilisation des données	partners.amazon.data_processing	dataProcessingOptions
Clé d'événement publicitaire	partners.amazon.ad_event_key	amazonAdEventKey
Partenaire	partners.amazon.partner	partner

* Champ obligatoire. 1. Définir dans eventDescription . 2. Priorité sur le côté gauche. Voir Référence rapide pour plus de détails. 3. Valeur par défaut : event_name . 4. Voir Configuration pour plus de détails. 5. 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. 6. Au moins un identifiant doit être fourni. 7. 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 . 8. Définir dans consent . Voir Configuration de la destination pour plus de détails. 9. Définir dans consent.geo . 10. Voir Propriétés d’événement personnalisées dans Configuration.