Microsoft Conversions API

Cette destination est actuellement en cours de revue finale et sera bientôt disponible.

Microsoft Advertising (anciennement Bing Ads, Microsoft adCenter et MSN adCenter) est une plateforme publicitaire en ligne développée par Microsoft. En utilisant cette destination, vous pouvez exploiter Microsoft Conversions API et le Universal Event Tracking (UET) framework pour envoyer les actions des utilisateurs, sous forme d'événements, via des server-side tracking hits, permettant des fonctionnalités telles que le suivi des conversions (par ex., achats ou leads), le ciblage d'audience (par ex., remarketing), les enchères automatisées et l'intégration avec Microsoft Bing for Commerce.

Fonctionnalités clés

La destination Microsoft Conversions API offre les fonctionnalités clés suivantes :

• Structure des événements: notre Events reference prend en charge Microsoft's Server-side UET events, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

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

• Hachage automatique: les informations sont automatiquement hachées conformément aux spécifications du partenaire.

• Événements et propriétés personnalisés: vous pouvez envoyer librement des événements et des propriétés personnalisés selon vos besoins spécifiques.

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

• Prise en charge des données multi-items: les informations incluses dans le item array sont transmises à Microsoft.

• Prise en charge du batch mode: envoyez plusieurs événements dans une seule requête.

Configuration de la destination

Assurez-vous d'avoir accès à Microsoft Advertising.

Cette destination peut être utilisée seule ou avec le UET client-side JavaScript tracking. Pendant que les données sont capturées avec cette destination, un pixel de synchronisation d'identification utilisateur côté client peut également être utilisé pour connecter Microsoft et les identifiants utilisateur attribués par le client. Le pixel de synchronisation peut être trouvé dans notre bibliothèque de templates client-side sous le nom Bing - Client-side id-sync and data capture et il est recommandé pour la mesure des conversions car il est requis pour le remarketing et la création d'audiences, ces fonctionnalités reposant sur la résolution de l'identité utilisateur. Plus de détails sont disponibles au LINK.

Dans le scénario où vous utilisez le même UET Tag Id (voir Configuration), pour le UET client-side JavaScript et cette destination, il est important de configurer la déduplication. Veuillez vous référer à ce LINK, montrant comment définir la valeur pour le event_id dans le UET client-side JavaScript. Le eventId (voir Mappages des champs) peut être défini à l'aide du champ "Smart Mapping" Event Id . Les deux event_id et eventId doivent être définis avec la même valeur.

Configuration

Paramètres	Description
Access Token	Requis Saisissez votre Access Token. Vous pouvez le trouver dans Microsoft Advertising Ads UI en sélectionnant Conversions (menu de gauche) → EUT tag → survolez le nom du tag et cliquez sur le crayon → Dans Edit UET tag , cliquez sur Save and next → Sélectionnez Use Conversions API .
UET Tag Id	Requis Votre UET Tag Id . Vous pouvez le trouver dans Microsoft Advertising Ads UI en sélectionnant Conversions (menu de gauche) → EUT tag → colonne Tag ID .
Click Id Cookie Name	Le msclkid (Click Id) est utilisé dans l'attribution des conversions et est généré au moment du clic sur l'annonce. Cet id est ajouté à l'URL de la page de destination lorsque Microsoft auto-tagging est activé. Il doit être stocké dans un first party cookie et conservé pour chaque utilisateur pendant 90 jours ou jusqu'à ce que l'utilisateur génère un nouveau msclkid en cliquant sur une autre annonce, selon la première éventualité. Saisissez le nom de votre cookie contenant la valeur. Par défaut : _uetmsclkid. Plus de détails sont disponibles au LINK. Vous pouvez également ajouter la valeur dans une propriété et utiliser le champ "Smart Mapping" Microsoft Msclkid qui a priorité sur le Click Id Cookie Name . Cette destination essaie également de récupérer la valeur depuis l'URL de la page en utilisant la propriété mappée dans le champ "Smart Mapping" Page URL .

Référence rapide

Commanders Act Events	Microsoft Event Types
page_view	pageLoad
[Tout autre événement]	custom

Mappages des champs

La plupart des propriétés peuvent être remappées à l'aide de notre fonctionnalité "Smart Mapping".

Propriétés Commanders Act	Propriétés Microsoft
(event_name)	eventType [1]
context.event_id	eventId [2]
event_name	eventName
context.event_timestamp	eventTime
context.page.url	eventSourceUrl
context.device.lifecycle.session_id	pageLoadId [3]
context.page.referrer	referrerUrl
context.page.title	pageTitle
partners.microsoft.keyword	keywords
partners.microsoft.ad_storage_consent	adStorageConsent
context.device.user_agent	clientUserAgent [4]
user.consistent_anonymous_id	anonymousId
user.id	externalId
user.email	em [5]
user.phone	ph [5][6]
context.device.ip	clientIpAddress
partners.microsoft.msclkid Click Id Cookie Name (context.page.url)	msclkid [7]
context.device.advertising_id	gaid [8]
context.device.advertising_id	idfa [9]
event_category	eventCategory [10]
event_label	eventLabel [10]
value	eventValue [10] ecommTotalValue [10] hotelData.totalPrice [10]
revenue	value [10] hotelData.basePrice [10]
search_term	searchTerm [10]
id	transactionId [10]
currency	currency [10]
items.X.id	items.X.id [10]
items.X.product.price	items.X.price [10]
items.X.quantity	items.X.quantity [10]
items.X.product.name	items.X.name [10]
items.X.id	itemIds [10][11]
(page_type) (event_name)	pageType [10][12]
item_list_name	ecommCategory [10]
partners.microsoft.hotel_checkin_date	hotelData.checkinDate [10]
partners.microsoft.hotel_checkout_date	hotelData.checkoutDate [10]
partners.microsoft.hotel_length_stay	hotelData.lengthOfStay [10]
partners.microsoft.hotel_partner_id	hotelData.partnerHotelId [10]

[1] Voir Référence rapide pour plus de détails. [2] Utilisé pour la déduplication. Voir Configuration de la destination pour plus de détails. [3] Identifiant de chargement de page qui relie vos événements personnalisés provenant de la même page. Format : un UUID v4. [4] Défini dans le userData . [5] Normalisé et haché automatiquement via SHA256 lorsqu'il est fourni en texte clair. [6] Normalisé à l'aide du format E.164 avec code pays. [7] Priorité sur la colonne de gauche. Vous utilisez le champ Click Id Cookie Name (voir Configuration) pour définir un nom de cookie différent de celui par défaut _uetmsclkid . La valeur sera automatiquement récupérée depuis le context.page.url s'il est présent. [8] Défini si context.device.os.name est défini avec Android (insensible à la casse). [9] Défini si context.device.os.name est défini avec iOS (insensible à la casse). [10] Défini dans le customData . [11] Tous les identifiants de produit sont pris en compte. [12] Priorité sur la colonne de gauche. Ceci est défini en fonction des éléments suivants : • Si page_type est home , product , cart , category , other , purchase ou searchresults alors pageType est défini avec la même valeur. • Si page_type est product_list alors pageType est category . • Si page_type est funnel_confirmation alors pageType est purchase . • Si page_type est search alors pageType est searchresults . • Si event_name est search alors pageType est searchresults . • Si event_name est view_item_list alors pageType est category . • Si event_name est view_item alors pageType est product . • Si event_name est view_item ou add_to_cart alors pageType est product . • Si event_name est view_cart alors pageType est cart . • Si event_name est purchase alors pageType est purchase .