Microsoft Conversions API

Cette destination est actuellement en cours de révision finale et sera bientôt disponible.

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

Principales fonctionnalités

La destination Microsoft Conversions API fournit 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 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.

• Hachage automatique: les informations sont automatiquement hachées en respectant les spécifications du partenaire.

• Événements et propriétés personnalisés: vous pouvez librement pousser des événements et propriétés personnalisés en fonction de vos besoins spécifiques.

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

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

• Prise en charge du mode batch: 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 de manière autonome ou conjointement avec UET client-side JavaScript tracking. Tandis que les données sont capturées via cette destination, un pixel de synchronisation d'identification utilisateur client-side peut être utilisé pour connecter les identifiants utilisateur attribués par le client et Microsoft. Le pixel de synchronisation se trouve dans notre bibliothèque de templates client-side avec le nom Bing - Client-side id-sync and data capture et est recommandé pour la mesure des conversions car il est requis pour le remarketing et la création d'audiences puisque ces fonctionnalités reposent 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 à la fois 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 Mappings de champs) peut être défini en utilisant le 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 côté 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 côté 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 identifiant est ajouté à l'URL de la page de destination lorsque Microsoft auto-tagging est activé. Il doit être stocké dans un cookie 1st party et conservé pour chaque utilisateur pendant 90 jours ou jusqu'à ce que l'utilisateur génère un nouvel 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 à LINK. Vous pouvez également ajouter la valeur dans une propriété et utiliser le champ "Smart Mapping" Microsoft Msclkid qui a la priorité sur le Click Id Cookie Name . Cette destination tente également d'obtenir la valeur à partir de 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
[Any other event]	custom

Mappings de champs

La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".

Commanders Act Properties	Microsoft Properties
(event_name)	eventType [1]
context.event_id	eventId [2]
event_name	eventName
context.event_timestamp	eventTime
context.page.url	eventSourceUrl
partners.microsoft.page_load_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é automatiquement et haché via SHA256 lorsqu'il est fourni en clair. [6] Normalisé en utilisant le format E.164 avec l'indicatif 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 au lieu du nom par défaut _uetmsclkid . La valeur sera automatiquement récupérée depuis le context.page.url si 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 produits sont pris en compte. [12] Priorité sur la colonne de gauche. Ceci est défini en fonction de ce qui suit : • 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 .