The Trade Desk Conversions API

The Trade Desk est l'une des plus grandes demand-side platforms (DSP) indépendantes fournissant des prix et des emplacements publicitaires en temps réel pour les annonceurs, les agences médias et les marques. En utilisant cette destination, vous pouvez exploiter The Trade Desk Real-Time Conversion Events API pour envoyer des événements via des hits server-side.

Principales fonctionnalités

La destination The Trade Desk fournit les fonctionnalités clés suivantes :

• Structure des events: notre Events reference correspondances de modèle Les événements de The Trade Desk, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

• Mappings préconstruits: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.

• Smart mapping : le mappage des données peut être réajusté en utilisant vos champs définis dans le datalayer.

• Mapping des événements : modifier le mapping standard entre les événements de vos partenaires et les vôtres ou ajouter de nouveaux mappings.

• Prise en charge des données multi-éléments: les informations incluses dans le item array est envoyé à The Trade Desk.

Configuration de la destination

Concernant les identifiants utilisateur, vous devez transmettre soit Type d'ID utilisateur/appareil ET Identifiant utilisateur/appareil OU des champs "Smart Mapping" comme Identifiant mobile de l'appareil , The Trade Desk GUID , Jeton UID2 chiffré , Jeton EUID chiffré , RampID mais pas les deux.

Configuration

Settings	Description
URL de l'API de conversion TTD	Obligatoire Votre URL de l'API de conversion TTD. Par défaut : "https://insight.adsrvr.org/track/realtimeconversion".
Type de tracking tag	Obligatoire Choisissez le type de tracking tag. Il s'agit soit de Event Tracking ou URL Mapping (page views).
Merchant Id	Requis pour Event Tracking [1] L'identifiant de la plateforme du marchand attribué par The Trade Desk au marchand lors du processus d'onboarding.
Event Tracker Id	Requis pour Event Tracking [1] L'identifiant de la plateforme The Trade Desk du event tracker.
Advertiser Id	Requis pour URL Mapping (page views) [1] L'identifiant de la plateforme The Trade Desk pour l'annonceur au nom duquel l'appel de tracking est effectué.
Universal Pixel Id	Requis pour URL Mapping (page views) [1] L'identifiant de la plateforme The Trade Desk du "Universal Pixel".
Type d'ID utilisateur/appareil	Le type de l'identifiant publicitaire, spécifié dans le Identifiant utilisateur/appareil. Valeurs prises en charge : TDID, IDFA, AAID, DAID, NAID, IDL, EUID ou UID2.
Identifiant utilisateur/appareil	L'identifiant publicitaire unique pour l'événement. Il peut s'agir de n'importe lequel des identifiants spécifiés dans la LINK (Voir adid propriété).
Nom du cookie TDID TTD	Le cookie 1st party dans lequel vous avez stocké la valeur du cookie TTD TDID. Ceci est utilisé lorsqu'aucune valeur ne peut être récupérée depuis le champIdentifiant utilisateur/appareil. Valeur par défaut : "ttd_TDID".
Custom Event Properties	Mappez vos custom event properties en définissant leurs noms de champ dans Le nom de propriété The Trade Desk et en ajoutant le nom du champ contenant les valeurs dans Votre valeur . Par ex. si vous saisissez size dans le Le nom de propriété The Trade Desk et items.0.product.size [2] dans Votre valeur , vous aurez une propriété d'événement personnalisée dans The Trade Desk appelée size avec une valeur basée sur le contenu du champ items.0.product.size .
Event Mapping	Modifiez le mapping standard entre les événements de The Trade Desk et les vôtres ou ajoutez de nouveaux mappings.

[1] VoirType de tracking tagpour plus de détails. &#xNAN;[2] En utilisant des "dots" (".") vous pouvez naviguer plus profondément vers le champ spécifique dont vous souhaitez obtenir la valeur. Voir Events reference pour plus de détails sur les noms de champs standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a pas de limites.

Référence rapide

En utilisant le Event Mapping vous pouvez modifier le mapping standard entre les événements de The Trade Desk et les vôtres ou ajoutez de nouveaux mappings.

Commanders Act Events	The Trade Desk Events
add_to_cart	addtocart
add_to_wishlist	wishlistitem
begin_checkout	startcheckout
login	login
page_view	sitevisit
purchase	purchase
search	searchitem
view_cart	viewcart
view_item	viewitem
[Any Event]	[Any Event] [1]

[1] Voir Event Mapping pour plus de détails.

Mappings de champs

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping". Toutes les propriétés The Trade Desk dans la colonne de droite sont définies dans l'objet data.0 .

Les propriétés The Trade Desk suivantes peuvent être définies si Device OS, dans le "Smart Mapping", est présent avec des valeurs prises en charge :

• aaid

• idfa

• naid

Propriétés Commanders Act	Propriétés The Trade Desk
Merchant Id	merchant_id [*]
Event Tracker Id	tracker_id [*]
Advertiser Id	adv [*]
Universal Pixel Id	upixel_id [*]
Type d'ID utilisateur/appareil	adid_type
Identifiant utilisateur/appareil	adid
Voir Référence rapide	event_name [1]
context.device.advertising_id	daid [2] aaid [3] idfa [4] naid [5]
partners.ttd.tduid	tdid [6]
partners.ttd.uid2_token	uid2_token [7]
partners.ttd.euid_token	euid_token [8]
partners.ttd.idl	idl [9]
user.country	country
user.state	region
user.metro	metro
user.city	city
user.zipcode	zip
context.device.ip	client_ip
context.page.url	referrer_url
id	order_id
value	value
currency	currency
partners.ttd.iattr	iattr [10]
partners.ttd.imp	imp [11]
partners.ttd.ivtc	ivtc [12]
partners.ttd.privacy_type	privacy_settings.0.privacy_type [13]
partners.ttd.is_applicable	privacy_settings.0.is_applicable [14]
partners.ttd.consent_string	privacy_settings.0.consent_string [15]
items.X.id	items.X.item_code
items.X.product.name	items.X.name
items.X.quantity	items.X.qty
items.X.product.price	items.X.price
items.X.product.category_id	items.X.cat
Custom Event Properties	[Custom Property Name] [16]

[*] Voir Configuration pour plus de détails sur les propriétés obligatoires. &#xNAN;[1] Voir Remappage d'événements pour plus de détails. &#xNAN;[2] L'identifiant publicitaire de l'appareil pour les appareils Android, iOS ou Windows. &#xNAN;[3] L'identifiant publicitaire de l'appareil pour les appareils Android. Ceci n'est défini que si Device OS Le champ "Smart Mapping" est défini avec Android (sensible à la casse). &#xNAN;[4] L'identifiant publicitaire de l'appareil pour les appareils iOS. Ceci n'est défini que si Device OS Le champ "Smart Mapping" est défini avec iOS (sensible à la casse). &#xNAN;[5] L'identifiant publicitaire de l'appareil pour les appareils Windows. Ceci n'est défini que si Device OS Le champ "Smart Mapping" est défini avec Windows (sensible à la casse). &#xNAN;[6] Le GUID 36 caractères de The Trade Desk (y compris les tirets) pour cet utilisateur. &#xNAN;[7] Le jeton UID2 chiffré, également connu sous le nom de advertising token. Ce jeton est sensible à la casse. Les tokens sont générés et gérés en utilisant les API UID2. Plus de détails sur l'API/les endpoints UID2 sont disponibles en suivant ce LINK. &#xNAN;[8] TLe jeton EUID chiffré, également connu sous le nom de advertising token. Ce jeton est sensible à la casse. Plus de détails sur les Unified IDs sont disponibles en suivant ce LINK. &#xNAN;[9] Le RampID de 49 ou 70 caractères (précédemment connu sous le nom IdentityLink). Il doit s'agir d'un RampID de LiveRamp mappé spécifiquement pour The Trade Desk. Plus de détails sur le mapping d'un RampID sont disponibles en suivant ce LINK. &#xNAN;[10] Un indicateur qui indique si l'événement est attribué à The Trade Desk. S'il est défini sur true (boolean), The Trade Desk attribue l'événement à l'identifiant d'impression spécifié (Voir data.0.imp ), contourne les modèles d'attribution de The Trade Desk, et aligne les résultats d'attribution avec ceux livrés par le partenaire aux annonceurs. &#xNAN;[11] Une chaîne de 36 caractères (y compris les tirets) servant d'identifiant unique pour l'impression à laquelle l'événement est attribué. &#xNAN;[12] Un indicateur qui indique si l'événement est une conversion view-through. &#xNAN;[13] Ceci peut être l'un des éléments suivants :GDPR,CCPAouGPPen fonction de la réglementation sur la vie privée qui s'applique. Ceci n'est inclus que si is_applicable et consent_string sont également définis. Plus de détails sont disponibles en suivant ce LINK. &#xNAN;[14] Indique si la valeur spécifiée dans privacy_type est applicable. Ceci est soit true (ou 1 ) ou false (ou 0 ), type boolean ou integer. Ceci n'est inclus que si privacy_type et consent_string sont également définis. Plus de détails sont disponibles en suivant ce LINK. &#xNAN;[15] La Consent String TCF de l'utilisateur. Ceci n'est inclus que si privacy_type et is_applicable sont également définis. Plus de détails sont disponibles en suivant ce LINK. &#xNAN;[16] Voir Custom Event Properties dans Configuration pour plus de détails sur la façon dont vous pouvez relier des propriétés personnalisées à The Trade Desk.