> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/microsoft/microsoft-conversions-api.md).

# Microsoft Conversions API

[Microsoft Advertising](https://ads.microsoft.com/) (anciennement Bing Ads, Microsoft adCenter et MSN adCenter) est une plateforme de publicité en ligne développée par Microsoft. Avec cette destination, vous pouvez exploiter [Microsoft Conversions API](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration) et le [cadre Universal Event Tracking (UET)](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration?view=bingads-13#universal-event-tracking-uet) 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 fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge [les événements UET server-side de Microsoft](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration?view=bingads-13#server-side-uet-events), ce qui signifie que vos données sont correctement répercutées vers les champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie la saisie 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 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](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array sont répercutées vers 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](https://ads.microsoft.com/).

{% hint style="info" %}
Cette destination peut être utilisée comme solution autonome ou avec le [tracking JavaScript client-side UET](https://help.ads.microsoft.com/#apex/ads/en/56686/2).\
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 est disponible [dans notre bibliothèque de modèles client-side](https://doc.commandersact.com/features/sources/sources-catalog/web/containers/user-guides-for-browser-side-platform/tags/add-tags) sous le nom <mark style="color:bleu;">`Bing - Client-side id-sync and data capture`</mark> et est recommandé pour la mesure des conversions car il est requis pour le remarketing et la création d'audience, car ces fonctionnalités reposent sur la résolution de l'identité utilisateur. Plus de détails sont disponibles au [lien](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration?view=bingads-13#client-side-id-sync).
{% endhint %}

{% hint style="warning" %}
Dans le cas où vous utilisez le même `UET Tag Id` (Voir [Configuration](#configuration)) pour 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](#quick-reference)). Veuillez vous référer à ce [lien](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration?view=bingads-13#custom-events), montrant comment définir la valeur pour le `event_id` dans le tag JavaScript client-side UET. Le `eventId` (Voir [Mappages de champs](#field-mappings)) 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.
{% endhint %}

### Configuration

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Jeton d'accès</code></td><td><em><strong><code>Requis</code></strong></em><br>Saisissez votre <code>Jeton d'accès</code>. Vous pouvez le trouver dans <a href="https://help.ads.microsoft.com/apex/index/3/en/56705">interface utilisateur Microsoft Advertising Ads</a> en sélectionnant <code>Conversions</code> (menu de gauche) → <code>EUT tag</code> → survolez le nom du tag et cliquez sur le crayon → dans <code>Modifier le tag UET</code> , cliquez sur <code>Enregistrer et continuer</code> → Sélectionnez <code>Utiliser Conversions API</code> .</td></tr><tr><td><code>UET Tag Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre <code>UET Tag Id</code> . Vous pouvez le trouver dans <a href="https://help.ads.microsoft.com/apex/index/3/en/56705">interface utilisateur Microsoft Advertising Ads</a> en sélectionnant <code>Conversions</code> (menu de gauche) → <code>EUT tag</code> → colonne <code>Tag ID</code> .</td></tr><tr><td><code>Nom du cookie Click Id</code></td><td>Le <code>msclkid</code> (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 <a href="https://help.ads.microsoft.com/#apex/ads/en/60125/2-500">Microsoft auto-tagging</a> 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 <code>msclkid</code> en cliquant sur une autre annonce, selon la première éventualité. Saisissez le nom de votre cookie contenant la valeur. Par défaut : <code>_uetmsclkid</code>. Plus de détails sont disponibles au <a href="https://help.ads.microsoft.com/#apex/ads/en/60000/2">lien</a>. Vous pouvez aussi ajouter la valeur dans une propriété et utiliser le champ "Smart Mapping" <code>Microsoft Msclkid</code> qui a priorité sur le <code>Nom du cookie Click Id</code> . Cette destination essaie aussi d'obtenir la valeur depuis l'URL de la page à l'aide de la propriété mappée dans le champ "Smart Mapping" <code>URL de la page</code> .</td></tr></tbody></table>

## Référence rapide

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

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être réaffectées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Champs Smart Mapping</th><th width="396.6685580062746">Propriétés par défaut de Commanders Act</th><th>Propriétés Microsoft</th></tr></thead><tbody><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>eventType</code> <strong>[1]</strong></td></tr><tr><td><code>Event Id</code></td><td><code>context.event_id</code></td><td><code>eventId</code> <strong>[2]</strong></td></tr><tr><td><code>Action de l'événement</code></td><td><code>event_name</code></td><td><code>eventName</code></td></tr><tr><td><code>Horodatage de l'événement</code></td><td><code>context.event_timestamp</code></td><td><code>eventTime</code></td></tr><tr><td><code>URL de la page</code></td><td><code>context.page.url</code></td><td><code>eventSourceUrl</code></td></tr><tr><td><code>ID de chargement de page</code></td><td><code>context.device.lifecycle.session_id</code></td><td><code>pageLoadId</code> <strong>[3]</strong></td></tr><tr><td><code>Page de provenance</code></td><td><code>context.page.referrer</code></td><td><code>referrerUrl</code></td></tr><tr><td><code>Titre de la page</code></td><td><code>context.page.title</code></td><td><code>pageTitle</code></td></tr><tr><td><code>Mot-clé Microsoft</code></td><td><code>partners.microsoft.keyword</code></td><td><code>keywords</code></td></tr><tr><td><code>Consentement au stockage des annonces</code></td><td><code>partners.microsoft.ad_storage_consent</code></td><td><code>adStorageConsent</code></td></tr><tr><td><code>User Agent de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>clientUserAgent</code> <strong>[4]</strong></td></tr><tr><td><code>Identifiant anonyme de l'utilisateur</code></td><td><code>user.consistent_anonymous_id</code></td><td><code>anonymousId</code></td></tr><tr><td><code>Identifiant utilisateur</code></td><td><code>user.id</code></td><td><code>externalId</code></td></tr><tr><td><code>Email utilisateur</code></td><td><code>user.email</code></td><td><code>em</code> <strong>[5]</strong></td></tr><tr><td><code>Numéro de téléphone utilisateur</code></td><td><code>user.phone</code></td><td><code>ph</code> <strong>[5][6]</strong></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>clientIpAddress</code></td></tr><tr><td><code>Microsoft Msclkid</code><br><code>-</code><br><code>URL de la page</code></td><td>partners.microsoft.msclkid
<br>Nom du cookie Click Id
<br>context.page.url</td><td><code>msclkid</code> <strong>[7]</strong></td></tr><tr><td><code>Identifiant mobile de l'appareil</code></td><td><code>context.device.advertising_id</code></td><td><code>gaid</code> <strong>[8]</strong><br><code>idfa</code> <strong>[9]</strong></td></tr><tr><td><code>Catégorie de l'événement</code></td><td><code>event_category</code></td><td><code>eventCategory</code> <strong>[10]</strong></td></tr><tr><td><code>Libellé de l'événement</code></td><td><code>event_label</code></td><td><code>eventLabel</code> <strong>[10]</strong></td></tr><tr><td><code>Valeur de la transaction</code>
<br><code>Valeur totale e-commerce</code>
<br><code>Valeur de la réservation d'hôtel</code></td><td><code>value</code></td><td><code>eventValue</code> [10]
<br><code>ecommTotalValue</code> [10]
<br><code>hotelData.totalPrice</code> [10]</td></tr><tr><td><code>Revenu de la transaction</code>
<br><code>Revenu de la réservation d'hôtel</code></td><td><code>revenue</code>
<br><code>partners.microsoft.hotel_revenue</code></td><td><code>value</code> <strong>[10]</strong><br><code>hotelData.basePrice</code> <strong>[10]</strong></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>searchTerm</code> <strong>[10]</strong></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>transactionId</code> <strong>[10]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>currency</code> <strong>[10]</strong></td></tr><tr><td><code>ID de l'item</code></td><td><code>items.X.id</code></td><td><code>items.X.id</code> <strong>[10]</strong><br><code>itemIds</code> <strong>[10][11]</strong></td></tr><tr><td><code>Prix de l'item</code></td><td><code>items.X.product.price</code></td><td><code>items.X.price</code> <strong>[10]</strong></td></tr><tr><td><code>Quantité de l'item</code></td><td><code>items.X.quantity</code></td><td><code>items.X.quantity</code> <strong>[10]</strong></td></tr><tr><td><code>Nom de l'item</code></td><td><code>items.X.product.name</code></td><td><code>items.X.name</code> <strong>[10]</strong></td></tr><tr><td><code>Type de page</code><br><code>-</code></td><td><p><code>page_type</code></p><p><code>event_name</code></p></td><td><code>pageType</code> <strong>[10][12]</strong></td></tr><tr><td><code>Identifiant de catégorie</code></td><td><code>item_list_name</code></td><td><code>ecommCategory</code> <strong>[10]</strong></td></tr><tr><td><code>Date d'arrivée à l'hôtel</code></td><td><code>partners.microsoft.hotel_checkin_date</code></td><td><code>hotelData.checkinDate</code> <strong>[10]</strong></td></tr><tr><td><code>Date de départ de l'hôtel</code></td><td><code>partners.microsoft.hotel_checkout_date</code></td><td><code>hotelData.checkoutDate</code> <strong>[10]</strong></td></tr><tr><td><code>Durée du séjour à l'hôtel</code></td><td><code>partners.microsoft.hotel_length_stay</code></td><td><code>hotelData.lengthOfStay</code> <strong>[10]</strong></td></tr><tr><td><code>ID du partenaire hôtelier</code></td><td><code>partners.microsoft.hotel_partner_id</code></td><td><code>hotelData.partnerHotelId</code> <strong>[10]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir [Référence rapide](#quick-reference) pour plus de détails.\
**2.** Utilisé pour la déduplication. Voir [Configuration de la destination](#destination-setup) pour plus de détails.\
**3.** Identifiant de chargement de page qui relie vos événements personnalisés provenant de la même page. Formatez-le comme\
un UUID v4.\
**4.** Défini dans le <mark style="color:bleu;">`userData`</mark> .\
**5.** Normalisé et haché automatiquement via SHA256 lorsqu'il est fourni en texte clair.\
**6.** Normalisé au format E.164 avec code pays.\
**7.** Priorité dans la colonne de gauche. Vous utilisez le champ <mark style="color:bleu;">`Nom du cookie Click Id`</mark> (Voir [Configuration](#configuration)) pour définir un nom de cookie différent au lieu du cookie par défaut `_uetmsclkid` . La valeur sera automatiquement récupérée depuis le <mark style="color:bleu;">`context.page.url`</mark> s'il est présent.\
**8.** Défini si <mark style="color:bleu;">`context.device.os.name`</mark> est défini avec `Android` (Non sensible à la casse).\
**9.** Défini si <mark style="color:bleu;">`context.device.os.name`</mark> est défini avec `iOS` (Non sensible à la casse).\
**10.** Défini dans le <mark style="color:bleu;">`customData`</mark> .\
**11.** Tous les identifiants de produit sont pris en compte.\
**12.** Priorité dans la colonne de gauche. Cela est défini en fonction des éléments suivants :\
• Si <mark style="color:bleu;">`page_type`</mark> est <mark style="color:bleu;">`home`</mark> , <mark style="color:bleu;">`product`</mark> , <mark style="color:bleu;">`cart`</mark> , <mark style="color:bleu;">`category`</mark> , <mark style="color:bleu;">`other`</mark> , <mark style="color:bleu;">`purchase`</mark> ou <mark style="color:bleu;">`searchresults`</mark> alors <mark style="color:bleu;">`pageType`</mark> est défini avec la même valeur .\
• Si <mark style="color:bleu;">`page_type`</mark> est <mark style="color:bleu;">`product_list`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`category`</mark> .\
• Si <mark style="color:bleu;">`page_type`</mark> est <mark style="color:bleu;">`funnel_confirmation`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`purchase`</mark> .\
• Si <mark style="color:bleu;">`page_type`</mark> est <mark style="color:bleu;">`search`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`searchresults`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`search`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`searchresults`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`view_item_list`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`category`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`view_item`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`product`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`view_item`</mark> ou <mark style="color:bleu;">`add_to_cart`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`product`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`view_cart`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`cart`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`purchase`</mark> alors <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`purchase`</mark> .
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/microsoft/microsoft-conversions-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.