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
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
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é.
(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 .
Mis à jour
Ce contenu vous a-t-il été utile ?