Microsoft Conversions API

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 exploiter Microsoft Conversions API et à l’ Universal Event Tracking (UET) framework pour envoyer les actions utilisateur, sous forme d'événements, via des hits de suivi server-side, 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 fournit les principales fonctionnalités suivantes :

• Structure des événements : notre Référence des événements prend en charge Les événements UET server-side de Microsoft, 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.

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

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

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

• Prise en charge des données multi-éléments: les informations incluses dans le item array est transmis à Microsoft.

• Prise en charge du mode batch: envoyer 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 en complément de le suivi JavaScript UET client-side. Bien que les données soient capturées à l'aide de cette destination, un pixel de synchronisation d'identification utilisateur client-side peut également être utilisé pour connecter Microsoft et les identifiants utilisateur attribués par le client. Le pixel de synchronisation se trouve dans notre bibliothèque de modèles client-side sous le nom Bing - Client-side id-sync and data capture et est recommandée pour la mesure des conversions car elle est requise pour le remarketing et la création d'audience, car ces fonctionnalités reposent sur la résolution de l'identité utilisateur. De plus amples détails sont disponibles à l'adresse suivante LIEN.

Dans le cas 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 pour Microsoft custom type d'événement (voir Référence rapide). Veuillez vous référer à ce LIEN, montrant comment définir la valeur pour le event_id dans le tag UET client-side JavaScript. Le eventId (Voir Mappages des champs) peut être défini à l'aide du champ "Smart Mapping" ID d'événement . Les deux event_id et eventId doivent être définis avec la même valeur.

Configuration

Paramètres	Description
Jeton d'accès	Obligatoire Saisissez votre Jeton d'accès. Vous pouvez le trouver dans l'interface utilisateur Microsoft Advertising Ads en sélectionnant Conversions (menu de gauche) → EUT tag → passez la souris sur le nom du tag et cliquez sur le crayon → Dans Modifier le tag UET , cliquez Enregistrer et continuer → Sélectionnez Utiliser Conversions API .
UET Tag Id	Obligatoire Votre UET Tag Id . Vous pouvez le trouver dans l'interface utilisateur Microsoft Advertising Ads en sélectionnant Conversions (menu de gauche) → EUT tag → colonne ID du tag .
Nom du cookie Click Id	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 cookie first party 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 du cookie contenant la valeur. Par défaut : _uetmsclkid. De plus amples détails sont disponibles à l'adresse suivante LIEN. Vous pouvez également ajouter la valeur dans une propriété et utiliser le champ "Smart Mapping" Microsoft Msclkid qui a priorité sur le Nom du cookie Click Id . 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" URL de la page .

Référence rapide

Événements Commanders Act	Types d'événements Microsoft
page_view	pageLoad
[Tout autre événement]	custom

Mappages des champs

Les propriétés peuvent être remappées à l'aide de notre Smart Mapping fonctionnalité.

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 Nom du cookie Click Id (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éfinissez dans le userData . 5. Normalisé et haché automatiquement via SHA256 lorsqu'il est fourni en clair. 6. Normalisé selon le format E.164 avec indicatif pays. 7. Priorité dans la colonne de gauche. Vous utilisez le champ Nom du cookie Click Id (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éfinir si context.device.os.name est défini avec Android (insensible à la casse). 9. Définir si context.device.os.name est défini avec iOS (insensible à la casse). 10. Définissez dans le customData . 11. Tous les identifiants produit sont pris en compte. 12. Priorité dans la colonne de gauche. Ceci est défini selon les éléments suivants : • Si page_type est home , product , cart , category , other , achat 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 achat . • 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 achat alors pageType est achat .