The Trade Desk Conversions API

The Trade Desk est l'une des plus grandes plateformes côté demande indépendantes (DSP) fournissant des prix et des placements publicitaires en temps réel pour les annonceurs, agences médias et 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.

Fonctionnalités clés

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

• Structure des événements: notre Référence des Events modèle correspond 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.

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

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

• Mappage d'événements : modifier le mappage standard entre les événements de vos partenaires et les vôtres ou ajouter de nouveaux mappages.

• Prise en charge des données multi-articles : les informations incluses dans le tableau item array est dispatché vers The Trade Desk.

Configuration de la destination

Sur les identifiants utilisateur, vous devez transmettre soit User/Device ID Type ET User/Device Identifier OR champs "Smart Mapping" comme Device Mobile Identifier , The Trade Desk GUID , Encrypted UID2 token , Encrypted EUID token , RampID mais pas les deux.

Configuration

Paramètres	Description
TTD Conversion API URL	Requis Votre TTD Conversion API URL. Par défaut : "https://insight.adsrvr.org/track/realtimeconversion".
Tracking Tag Type	Requis 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 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 plateforme The Trade Desk du tracker d'événements.
Id annonceur	Requis pour URL Mapping (page views) [1] L'identifiant de plateforme The Trade Desk de l'annonceur au nom duquel l'appel de tracking est effectué.
Universal Pixel Id	Requis pour URL Mapping (page views) [1] L'identifiant de plateforme The Trade Desk de l'"Universal Pixel".
User/Device ID Type	Le type de l'identifiant publicitaire, spécifié dans le User/Device Identifier. Valeurs prises en charge : TDID, IDFA, AAID, DAID, NAID, IDL, EUID, ou UID2.
User/Device Identifier	L'identifiant publicitaire unique pour l'événement. Cela peut être n'importe lequel des identifiants spécifiés dans la LINK (Voir adid property).
TTD TDID Cookie Name	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 champUser/Device Identifier. Valeur par défaut : "ttd_TDID".
Propriétés d'événements personnalisées	Mappez vos propriétés d'événements personnalisées 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 la 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 standard mapping entre les événements The Trade Desk et les vôtres ou ajoutez de nouvelles correspondances.

[1] VoirTracking Tag Typepour plus de détails. [2] En utilisant des "dots" (".") vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous voulez obtenir la valeur. Voir Référence des Events 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 changer le standard mapping entre les événements The Trade Desk et les vôtres ou ajoutez de nouvelles correspondances.

Commanders Act Events	The Trade Desk Events
addPaymentInfo	addtocart
add_to_wishlist	wishlistitem
addToCart	startcheckout
viewPage	viewPage
beginCheckout	sitevisit
Events Criteo	Events Criteo
viewItem	searchitem
login	viewcart
viewBasket	viewitem
[Any Event]	[Any Event] [1]

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

est transmis.

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

Commanders Act Properties	The Trade Desk Properties
Merchant Id	merchant_id [*]
Event Tracker Id	tracker_id [*]
Id annonceur	adv [*]
Universal Pixel Id	upixel_id [*]
User/Device ID Type	adid_type
User/Device Identifier	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énements personnalisées	[Custom Property Name] [16]

[*] Voir Configuration pour plus de détails sur les propriétés obligatoires. [1] Voir Event Remapping pour plus de détails. [2] L'identifiant publicitaire de l'appareil pour les appareils Android, iOS ou Windows. [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 (insensible à la casse). [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 (insensible à la casse). [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 (insensible à la casse). [6] Le GUID 36 caractères (y compris les tirets) de The Trade Desk pour cet utilisateur. [7] Le token UID2 encrypté, également connu sous le nom de token publicitaire. Ce token est sensible à la casse. Les tokens sont générés et gérés à l'aide des API UID2. Plus de détails sur l'API/les endpoints UID2 sont disponibles en suivant ce LINK. [8] TLe token EUID encrypté, également connu sous le nom de token publicitaire. Ce token est sensible à la casse. Plus de détails sur les Unified IDs sont disponibles en suivant ce LINK. [9] Le RampID de 49 caractères ou 70 caractères (anciennement connu sous le nom d'IdentityLink). Il doit s'agir d'un RampID de LiveRamp qui est 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. 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 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 de confidentialité 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. Cela peut être true (ou 1 ) ou false (ou 0 ), de 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. [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énements personnalisées dans Configuration pour plus de détails sur la façon dont vous pouvez relier des propriétés personnalisées à The Trade Desk.