The Trade Desk Conversions API

The Trade Desk est l'une des plus grandes demand-side platform (DSP) indépendantes fournissant la tarification et le placement d'annonces en temps réel pour les annonceurs, agences média 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 correspondances de modèle Les événements de The Trade Desk, ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.

• Mappings pré-construits : 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 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 tableau item array est envoyé à The Trade Desk.

Configuration de la destination

Concernant les identifiants utilisateur, vous devez transmettre soit User/Device ID Type ET User/Device Identifier OU champs « Smart Mapping » tels que Device Mobile Identifier , The Trade Desk GUID , Encrypted UID2 token , Encrypted EUID token , RampID mais pas les deux.

Configuration

Settings	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 la plateforme du merchant attribué par The Trade Desk au merchant durant le 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'advertiser pour le compte 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".
User/Device ID Type	Le type de l'identifiant publicitaire, spécifié dans le User/Device Identifier. Valeurs supportées : TDID, IDFA, AAID, DAID, NAID, IDL, EUID, ou UID2.
User/Device Identifier	L'identifiant publicitaire unique pour l'événement. Il peut s'agir de n'importe lequel des identifiants spécifiés dans le LINK (Voir adid property).
TTD TDID Cookie Name	Le cookie First 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énement personnalisées	Mappez vos propriétés d'événement 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 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 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. &#xNAN;[2] En utilisant des "dots" (".") vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous souhaitez obtenir la valeur. Voir Référence des Events pour plus de détails sur les noms de champs standards 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 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
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 supportées :

• 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 [*]
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	région
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	[Custom Property Name] [16]

[*] Voir Configuration pour plus de détails sur les propriétés obligatoires. &#xNAN;[1] Voir Event Remapping 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 est défini uniquement si Device OS Le champ "Smart Mapping" est défini avec Android (insensible à la casse). &#xNAN;[4] L'identifiant publicitaire de l'appareil pour les appareils iOS. Ceci est défini uniquement si Device OS Le champ "Smart Mapping" est défini avec iOS (insensible à la casse). &#xNAN;[5] L'identifiant publicitaire de l'appareil pour les appareils Windows. Ceci est défini uniquement si Device OS Le champ "Smart Mapping" est défini avec Windows (insensible à la casse). &#xNAN;[6] Le GUID The Trade Desk de 36 caractères (y compris les tirets) pour cet utilisateur. &#xNAN;[7] The encrypted UID2 token, also known as an advertising token. This token is case-sensitive. Tokens are generated and managed using UID2 APIs. More details on the UID2 API/endpoints are available following this LINK. &#xNAN;[8] The encrypted EUID token, also known as an advertising token. This token is case-sensitive. More details on the Unified IDs are available following this LINK. &#xNAN;[9] Le RampID de 49 caractères ou 70 caractères (anciennement connu sous le nom 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 ceci LINK. &#xNAN;[10] Un indicateur qui indique si l'événement est attribué à The Trade Desk. Si défini à 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. &#xNAN;[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é. &#xNAN;[12] Un indicateur qui indique si l'événement est une conversion view-through. &#xNAN;[13] Ceci peut être l'un des suivants :GDPR,CCPAouGPPen fonction de la réglementation sur la 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 ceci 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 ), 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 ceci 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 ceci LINK. &#xNAN;[16] Voir Propriétés d'événement personnalisées dans Configuration pour plus de détails sur la manière dont vous pouvez lier des propriétés personnalisées à The Trade Desk.