The Trade Desk Conversions API

The Trade Desk est l'une des plus grandes demand-side platform (DSP) indépendantes, fournissant une tarification et un placement des publicités en temps réel pour les annonceurs, les agences média et les marques. Grâce à 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 events: notre Référence des events correspondances de modèle Les événements de The Trade Desk, ce qui signifie que vos données sont correctement bridgées vers les champs attendus de manière optimisée.

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

• Smart Mapping: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.

• Mappage des événements: modifiez le mapping standard entre les événements de vos partenaires et les vôtres, ou ajoutez de nouveaux mappings.

• Prise en charge des données multi-éléments: 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 des 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	Obligatoire Votre TTD Conversion API URL. Valeur par défaut : "https://insight.adsrvr.org/track/realtimeconversion".
Tracking Tag Type	Obligatoire Choisissez le type de tracking tag. Il s'agit soit de Event Tracking soit de URL Mapping (page views).
Merchant Id	Requis pour Event Tracking [1] L'identifiant plateforme du merchant attribué par The Trade Desk au merchant pendant le processus d'onboarding.
Event Tracker Id	Requis pour Event Tracking [1] L'identifiant plateforme The Trade Desk de l'event tracker.
Advertiser Id	Requis pour URL Mapping (page views) [1] L'identifiant 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 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 de l'événement. Cela peut être n'importe lequel des identifiants spécifiés dans le LIEN (Voir adid property).
TTD TDID Cookie Name	Le cookie first party dans lequel vous avez stocké la valeur du cookie TTD TDID. Celui-ci 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 personnalisées d’événement	Mappez vos propriétés personnalisées d’événement en définissant leurs noms de champ dans The Trade Desk property name et en ajoutant le nom du champ contenant les valeurs dans Your value . Par ex., si vous saisissez size dans le The Trade Desk property name and items.0.product.size [2] dans Your value , 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 .
Mapping des events	Modifiez le standard mapping entre les événements de The Trade Desk et les vôtres, ou ajoutez de nouveaux mappings.

1. VoirTracking Tag Typepour plus de détails. 2. En utilisant des « points » (".") 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 aucune limite.

Référence rapide

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

Events Commanders Act	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 Mapping des events pour plus de détails.

Mappings des champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping feature. Toutes les propriétés The Trade Desk de 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 OSest présent, dans le "Smart Mapping", avec les valeurs prises en charge :

• aaid

• idfa

• naid

Propriétés Commanders Act	The Trade Desk Properties
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
Propriétés personnalisées d’événement	[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 un appareil Android, iOS ou Windows. 3. L'identifiant publicitaire de l'appareil pour un appareil Android. Celui-ci 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 un appareil iOS. Celui-ci 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 un appareil Windows. Celui-ci n'est défini que si Device OS le champ "Smart Mapping" est défini avec Windows (insensible à la casse). 6. Le GUID The Trade Desk à 36 caractères (y compris les tirets) pour cet utilisateur. 7. Le encrypted UID2 token, également connu sous le nom de advertising token. Ce token est sensible à la casse. Les tokens sont générés et gérés à l'aide des UID2 APIs. Plus de détails sur l'UID2 API/endpoints sont disponibles en suivant ce LIEN. 8. The encrypted EUID token, également connu sous le nom de advertising token. Ce token est sensible à la casse. Plus de détails sur les Unified IDs sont disponibles en suivant ce LIEN. 9. Le RampID à 49 caractères ou 70 caractères (anciennement connu sous le nom de IdentityLink). Il doit s'agir d'un RampID provenant de LiveRamp, spécifiquement mappé pour The Trade Desk. Plus de détails sur le mapping d'un RampID sont disponibles en suivant ce LIEN. 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 fournis par le partenaire aux annonceurs. 11. Une chaîne de 36 caractères (tirets compris) 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 view-through conversion. 13. Cela peut être l'un des éléments suivants :GDPR,CCPAsoit deGPPselon la réglementation de confidentialité applicable. Ceci n'est inclus que si is_applicable and consent_string sont également définis. Plus de détails sont disponibles en suivant ce LIEN. 14. Indique si la valeur spécifiée dans privacy_type est applicable. Cela peut être soit true (ou 1 ) ou false (ou 0 ), de type booléen ou entier. Ceci n'est inclus que si privacy_type and consent_string sont également définis. Plus de détails sont disponibles en suivant ce LIEN. 15. La TCF consent string de l'utilisateur. Ceci n'est inclus que si privacy_type and is_applicable sont également définis. Plus de détails sont disponibles en suivant ce LIEN. 16. Voir Propriétés personnalisées d’événement dans Configuration pour plus de détails sur la manière dont vous pouvez relier des propriétés personnalisées à The Trade Desk.