The Trade Desk Conversions API

The Trade Desk est l’une des plus grandes plateformes côté demande (DSP) indépendantes, offrant une tarification et un placement publicitaires en temps réel pour les annonceurs, les agences publicitaires et les marques. Grâce à cette destination, vous pouvez exploiter API des événements de conversion en temps réel de The Trade Desk 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 événements correspondances du 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.

• Mappages prédéfinis: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.

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

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

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

Configuration de la destination

Pour les identifiants utilisateur, vous devez transmettre soit Type d’ID utilisateur/appareil ET Identifiant utilisateur/appareil OU des 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	Obligatoire Votre URL de l’API de conversion TTD. Par défaut : "https://insight.adsrvr.org/track/realtimeconversion".
Type de tag de suivi	Obligatoire Choisissez le type de tag de suivi. Il s’agit soit de Suivi d’événements ou Mappage d’URL (pages vues).
ID marchand	Requis pour le suivi d’événements [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 le suivi d’événements [1] L’identifiant de plateforme The Trade Desk du tracker d’événements.
Advertiser ID	Requis pour le mappage d’URL (pages vues) [1] L’identifiant de plateforme The Trade Desk de l’annonceur pour le compte duquel l’appel de suivi est effectué.
ID du Universal Pixel	Requis pour le mappage d’URL (pages vues) [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 l’un quelconque des identifiants indiqués dans le LINK (voir adid propriété).
Nom du cookie TTD TDID	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 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 la propriété The Trade Desk et en ajoutant le nom du champ contenant les valeurs dans Votre valeur . p. ex. si vous saisissez size dans le Nom de la propriété The Trade Desk et items.0.product.size [2] dans Votre valeur , vous aurez dans The Trade Desk une propriété d’événement personnalisée appelée size avec une valeur basée sur le contenu du champ items.0.product.size .
Correspondance des événements	Modifiez le mappage standard entre les événements de The Trade Desk et les vôtres, ou ajoutez de nouveaux mappages.

1. VoirType de tag de suivipour plus de détails. 2. En utilisant des « points » ("."), vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous souhaitez 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 aucune limite.

Référence rapide

En utilisant le Correspondance des événements vous pouvez modifier le mappage standard entre les événements de The Trade Desk et les vôtres, ou ajoutez de nouveaux mappages.

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
[Tout événement]	[Tout événement] [1]

1. Voir Correspondance des événements pour plus de détails.

Correspondances des champs

Les propriétés peuvent être remappées à l'aide de notre Mappage intelligent fonctionnalité. 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 Système d'exploitation de l'appareil, dans le "Smart Mapping", est présent avec les valeurs prises en charge :

• aaid

• idfa

• naid

Propriétés Commanders Act	Propriétés The Trade Desk
ID marchand	merchant_id [*]
ID du tracker d’événements	tracker_id [*]
Advertiser ID	adv [*]
ID du 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
valeur	valeur
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. 1. Voir Remappage des é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 n’est défini que si Système d'exploitation 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 n’est défini que si Système d'exploitation 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 n’est défini que si Système d'exploitation 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 (tirets compris) 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 à l’aide des API UID2. De plus amples 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. De plus amples détails sur les Unified IDs sont disponibles en suivant ce LINK. 9. Le RampID de 49 ou 70 caractères (anciennement appelé IdentityLink). Il doit s’agir d’un RampID de LiveRamp mappé spécifiquement pour The Trade Desk. De plus amples détails sur le mappage d’un RampID sont disponibles en suivant ce LINK. 10. Un indicateur qui précise si l’événement est attribué à The Trade Desk. S’il est défini sur 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 sur 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 précise si l’événement est une conversion view-through. 13. Cela peut être l’un des éléments suivants :GDPR,CCPAouGPPselon la réglementation de confidentialité applicable. Ceci n’est inclus que si is_applicable et consent_string sont également définis. De plus amples détails sont disponibles en suivant ce LINK. 14. Indique si la valeur spécifiée dans privacy_type est applicable. Cela soit true (ou 1 ) ou false (ou 0 ), de type booléen ou entier. Ceci n’est inclus que si privacy_type et consent_string sont également définis. De plus amples 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. De plus amples détails sont disponibles en suivant ce LINK. 16. Voir Propriétés d'événement personnalisées dans Configuration pour plus de détails sur la façon dont vous pouvez associer des propriétés personnalisées à The Trade Desk.