Amazon Events API

Cette destination est actuellement en phase de validation finale et sera bientôt disponible.

Amazon est une entreprise technologique multinationale axée sur 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 des données de conversion directement à Amazon Ads, en contournant les limitations côté navigateur comme les bloqueurs de publicités et les restrictions liées aux 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 fournit les principales fonctionnalités suivantes :

• Structure des événements: notre Events reference correspondances de modèle la structure d’événements d’Amazon, ce qui signifie que vos données sont correctement rapprochées des 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 s’effectue 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.

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

Configuration de la destination

Si vous transmettez ou mettez à disposition d’Amazon Ads toute information personnelle dans le cadre de votre utilisation des 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 Field mapping 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 du Amazon Consent Signal.

Configuration

Paramètres	Description
Credentials	Obligatoire Vos credentials avec Amazon Ads tels que définis dans l’interface Commanders Act en suivant : Administration ➜ Connector Credentials ➜ Ajouter des credentials de connecteur ➜ AmazonAds
API Base Url	Obligatoire Votre endpoint Amazon API sélectionné. Plus de détails sont disponibles en suivant ce LIEN.
Advertiser Id	Obligatoire Saisissez votre identifiant annonceur, comme indiqué dans Amazon Ads, en cliquant sur l’ gear icon (Administration) dans le menu de gauche puis Account access and settings et Accounts.
Conversion Type	Obligatoire si non défini dans Smart Mapping Sélectionnez votre Conversion Type dans la liste ou mappez le Smart Mapping field Conversion Type.
Event Source	Obligatoire si non défini dans Smart Mapping Sélectionnez votre Event Source dans la liste ou mappez le Smart Mapping field Event Source.
Country Property	Obligatoire Le nom/chemin de la propriété correspondant au pays d’origine de l’événement. Cette valeur est basée sur ISO 3166-1 alpha-2.
Dataset Name	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 dataset default_events . Plus de détails sont disponibles en suivant ce LIEN.
Propriétés personnalisées d’événement	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 Amazon property name et en ajoutant les valeurs dans Your value .

Référence rapide

Commanders Act Events	Amazon Event
[Any Event] [1]	[Any Event]

1. Utilisez Destination filters pour spécifier vos événements correspondants.

Mappages de champs

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

Propriétés Commanders Act	Amazon Properties
partners.amazon.conversion_type Conversion Type	conversionType [*][1][2]
Event Source	eventSource [*][1]
Country Property	countryCode [*]
Dataset Name	dataSetName [1][3]
event_name	name [1]
context.event_timestamp	eventTime
context.event_id	eventId [4]
currency	currencyCode
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 [5]
(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 [6]
partners.amazon.ad_storage	amazonConsent.amznAdStorage [7]
partners.amazon.user_data	amazonConsent.amznUserData [7]
partners.amazon.tcf	tcf [7]
partners.amazon.gpp	gpp [7]
context.device.ip	ipAddress [8]
items.length	unitsSold
value	value
Propriétés personnalisées d’événement	customData
partners.amazon.data_processing	dataProcessingOptions
partners.amazon.ad_event_key	amazonAdEventKey

* Champ obligatoire. 1. Définir dans eventDescription . 2. Priorité sur le côté gauche. 3. Voir 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. 5. Au moins un identifiant doit être fourni. 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 . 7. Définir dans consent . Voir Configuration de la destination pour plus de détails. 8. Définir dans consent.geo .