The Trade Desk Conversions API

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

Principales caractéristiques

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

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

• Mappings préconçus : 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 mapping 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-articles : les informations incluses dans le item le tableau 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 champs "Smart Mapping" tels que Identifiant mobile de l'appareil , The Trade Desk GUID , jeton UID2 chiffré , jeton EUID chiffré , RampID mais pas les deux.

Configuration

Paramètres	Description
URL de l'API de conversion TTD	Requis Votre URL de l'API de conversion TTD. Par défaut : "https://insight.adsrvr.org/track/realtimeconversion".
Type de tag de suivi	Requis Choisissez le type de tag de suivi. Il s'agit soit de Event Tracking ou URL Mapping (page views).
Id du marchand	Requis pour Event Tracking [1] L'identifiant de plateforme du marchand attribué par The Trade Desk au marchand lors du processus d'onboarding.
Id du tracker d'événements	Requis pour Event Tracking [1] L'identifiant de plateforme The Trade Desk du tracker d'événements.
Id de l'annonceur	Requis pour URL Mapping (page views) [1] L'identifiant de plateforme The Trade Desk pour l'annonceur au nom duquel l'appel de suivi est effectué.
Identifiant Universal Pixel	Requis pour URL Mapping (page views) [1] L'identifiant de 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 quel identifiant tel que spécifié dans le 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".
Propriétés d'événement personnalisées	Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans 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 taille dans le Nom de propriété The Trade Desk et items.0.product.size [2] in Votre valeur , vous aurez une propriété d'événement personnalisée dans The Trade Desk appelée taille avec une valeur basée sur le contenu du champ items.0.product.size .
Mapping des événements	Modifier le mapping standard entre les événements de The Trade Desk et les vôtres ou ajouter de nouveaux mappings.

[1] VoirType de tag de suivipour plus de détails. [2] En utilisant des "points" (".") vous pouvez naviguer plus profondément vers le champ spécifique dont vous voulez obtenir la valeur. Voir Référence des événements 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 Mapping des événements vous pouvez modifier le mapping standard entre les événements de The Trade Desk et les vôtres ou ajouter de nouveaux mappings.

Commanders Act Events	Événements The Trade Desk
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 Mapping des événements 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 OS de l'appareil, 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
Id du marchand	merchant_id [*]
Id du tracker d'événements	tracker_id [*]
Id de l'annonceur	adv [*]
Identifiant Universal Pixel	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
Propriétés d'événement personnalisées	[Nom de propriété personnalisé] [16]

[*] Voir Configuration pour plus de détails sur les propriétés obligatoires. [1] Voir Remappage d'événements pour plus de détails. [2] L'identifiant publicitaire de l'appareil pour un appareil Android, iOS ou Windows. [3] L'identifiant publicitaire de l'appareil pour un appareil Android. Ceci est uniquement défini si OS de l'appareil le champ "Smart Mapping" est défini avec Android (insensible à la casse). [4] L'identifiant publicitaire de l'appareil pour un appareil iOS. Ceci est uniquement défini si OS de l'appareil le champ "Smart Mapping" est défini avec iOS (insensible à la casse). [5] L'identifiant publicitaire de l'appareil pour un appareil Windows. Ceci est uniquement défini si OS de l'appareil le champ "Smart Mapping" est défini avec Windows (insensible à la casse). [6] Le GUID The Trade Desk de 36 caractères (y compris les tirets) pour cet utilisateur. [7] Le jeton UID2 chiffré, également connu sous le nom de jeton publicitaire. Ce jeton est sensible à la casse. Les jetons sont générés et gérés via les API UID2. Plus de détails sur l'API/les endpoints UID2 sont disponibles en suivant ce LINK. [8] TLe jeton EUID chiffré, également connu sous le nom de jeton publicitaire. Ce jeton est sensible à la casse. Plus de détails sur les Unified IDs sont disponibles en suivant ce LINK. [9] Le RampID de 49 ou 70 caractères (anciennement connu sous le nom d'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. [10] Un indicateur qui indique si l'événement est attribué à The Trade Desk. Si défini à true (booléen), 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 fournis par le partenaire aux annonceurs. [11] Une chaîne de 36 caractères (y compris les tirets) qui sert d'identifiant unique pour l'impression à laquelle l'événement est attribué. [12] Un indicateur qui indique si l'événement est une conversion view-through. [13] Ceci peut être l'un des éléments suivants :GDPR,CCPAouGPPen fonction du règlement sur la vie privée applicable. 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. [14] Indique si la valeur spécifiée dans privacy_type est applicable. Ceci vaut soit true (ou 1 ) ou false (ou 0 ), type booléen ou entier. 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. [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. [16] Voir Propriétés d'événement personnalisées in Configuration pour plus de détails sur la façon dont vous pouvez relier des propriétés personnalisées à The Trade Desk.