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
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
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".
(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 champClick 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 lecontext.page.urlsi présent. [8] Défini sicontext.device.os.nameest défini avecAndroid(insensible à la casse). [9] Défini sicontext.device.os.nameest défini aveciOS(insensible à la casse). [10] Défini dans lecustomData. [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 : • Sipage_typeesthome,product,cart,category,other,purchaseousearchresultsalorspageTypeest défini avec la même valeur . • Sipage_typeestproduct_listalorspageTypeestcategory. • Sipage_typeestfunnel_confirmationalorspageTypeestpurchase. • Sipage_typeestsearchalorspageTypeestsearchresults. • Sievent_nameestsearchalorspageTypeestsearchresults. • Sievent_nameestview_item_listalorspageTypeestcategory. • Sievent_nameestview_itemalorspageTypeestproduct. • Sievent_nameestview_itemouadd_to_cartalorspageTypeestproduct. • Sievent_nameestview_cartalorspageTypeestcart. • Sievent_nameestpurchasealorspageTypeestpurchase.
Mis à jour
Ce contenu vous a-t-il été utile ?