> 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. En utilisant cette destination, vous pouvez exploiter [Microsoft Conversions API](https://learn.microsoft.com/en-us/advertising/guides/uet-conversion-api-integration) et les [le framework 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 des utilisateurs, sous forme d’événements, via des hits de suivi server-side, en 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 offre 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 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 des propriétés personnalisés selon vos besoins spécifiques.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est transmis à 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 seule ou en complément de [le suivi JavaScript client-side UET](https://help.ads.microsoft.com/#apex/ads/en/56686/2).\
Alors que les données sont capturées à l’aide de cette destination, un pixel de synchronisation d’identification utilisateur client-side peut également être utilisé pour relier Microsoft et les identifiants utilisateur attribués par le client. Le pixel de synchronisation se trouve [dans notre bibliothèque de templates 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 il est recommandé pour la mesure des conversions, car il est requis pour le remarketing et la création d’audience, puisque ces fonctionnalités reposent sur la résolution de l’identité utilisateur. Davantage de détails sont disponibles à l’adresse suivante [LINK](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 scénario où vous utilisez le même `UET Tag ID` (voir [Configuration](#configuration)) pour à la fois le JavaScript UET client-side et cette destination, il est important de configurer la déduplication pour Microsoft `personnalisé` type d’événement (voir [Référence rapide](#quick-reference)). Veuillez vous référer à ce [LINK](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 UET client-side. Le `eventId` (voir [Correspondances des champs](#field-mappings)) peut être défini à l’aide du champ « Smart Mapping » `ID de l'événement` . Les deux `event_id` et `eventId` doivent être définis avec la même valeur.
{% endhint %}

### Configuration

<table><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>Obligatoire</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">l’interface utilisateur Microsoft Advertising Ads</a> en sélectionnant <code>Conversions</code> (menu de gauche) → <code>tag EUT</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>Obligatoire</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">l’interface utilisateur Microsoft Advertising Ads</a> en sélectionnant <code>Conversions</code> (menu de gauche) → <code>tag EUT</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é pour 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 d’atterrissage 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 cookie First party 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 du cookie contenant la valeur. Par défaut : <code>_uetmsclkid</code>. Davantage de détails sont disponibles à l’adresse suivante <a href="https://help.ads.microsoft.com/#apex/ads/en/60000/2">LINK</a>. Vous pouvez également 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 é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 » <code>URL de la page</code> .</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events    | Types d’événements Microsoft |
| ------------------------ | ---------------------------- |
| `page_view`              | `pageLoad`                   |
| `[Tout autre événement]` | `personnalisé`               |

## Correspondances des champs

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

<table><thead><tr><th width="396.6685580062746">Propriétés Commanders Act</th><th>Propriétés Microsoft</th></tr></thead><tbody><tr><td><code>(event_name)</code></td><td><code>eventType</code> <strong>[1]</strong></td></tr><tr><td><code>context.event_id</code></td><td><code>eventId</code> <strong>[2]</strong></td></tr><tr><td><code>event_name</code></td><td><code>eventName</code></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>eventTime</code></td></tr><tr><td><code>context.page.url</code></td><td><code>eventSourceUrl</code></td></tr><tr><td><code>context.device.lifecycle.session_id</code></td><td><code>pageLoadId</code> <strong>[3]</strong></td></tr><tr><td><code>context.page.referrer</code></td><td><code>referrerUrl</code></td></tr><tr><td><code>context.page.title</code></td><td><code>pageTitle</code></td></tr><tr><td><code>partners.microsoft.keyword</code></td><td><code>keywords</code></td></tr><tr><td><code>partners.microsoft.ad_storage_consent</code></td><td><code>adStorageConsent</code></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>clientUserAgent</code> <strong>[4]</strong></td></tr><tr><td><code>user.consistent_anonymous_id</code></td><td><code>anonymousId</code></td></tr><tr><td><code>user.id</code></td><td><code>externalId</code></td></tr><tr><td><code>user.email</code></td><td><code>em</code> <strong>[5]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>ph</code> <strong>[5][6]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>clientIpAddress</code></td></tr><tr><td><p><code>partners.microsoft.msclkid</code></p><p><code>Nom du cookie Click ID</code></p><p><code>(context.page.url)</code></p></td><td><code>msclkid</code> <strong>[7]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>gaid</code> <strong>[8]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>idfa</code> <strong>[9]</strong></td></tr><tr><td><code>event_category</code></td><td><code>eventCategory</code> <strong>[10]</strong></td></tr><tr><td><code>event_label</code></td><td><code>eventLabel</code> <strong>[10]</strong></td></tr><tr><td><code>valeur</code></td><td><p><code>eventValue</code> <strong>[10]</strong></p><p><code>ecommTotalValue</code> <strong>[10]</strong></p><p><code>hotelData.totalPrice</code> <strong>[10]</strong></p></td></tr><tr><td><code>revenue</code></td><td><code>valeur</code> <strong>[10]</strong><br><code>hotelData.basePrice</code> <strong>[10]</strong></td></tr><tr><td><code>search_term</code></td><td><code>searchTerm</code> <strong>[10]</strong></td></tr><tr><td><code>id</code></td><td><code>transactionId</code> <strong>[10]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[10]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>items.X.id</code> <strong>[10]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>items.X.price</code> <strong>[10]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>items.X.quantity</code> <strong>[10]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>items.X.name</code> <strong>[10]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>itemIds</code> <strong>[10][11]</strong></td></tr><tr><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>item_list_name</code></td><td><code>ecommCategory</code> <strong>[10]</strong></td></tr><tr><td><code>partners.microsoft.hotel_checkin_date</code></td><td><code>hotelData.checkinDate</code> <strong>[10]</strong></td></tr><tr><td><code>partners.microsoft.hotel_checkout_date</code></td><td><code>hotelData.checkoutDate</code> <strong>[10]</strong></td></tr><tr><td><code>partners.microsoft.hotel_length_stay</code></td><td><code>hotelData.lengthOfStay</code> <strong>[10]</strong></td></tr><tr><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. Format :\
un UUID v4.\
**4.** Défini dans le <mark style="color:bleu;">`userData`</mark> .\
**5.** Normalisé et hashé automatiquement via SHA256 lorsqu’il est fourni en texte clair.\
**6.** Normalisé selon le format E.164 avec indicatif 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 à la place de la valeur 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éfinir si <mark style="color:bleu;">`context.device.os.name`</mark> est défini avec `Android` (non sensible à la casse).\
**9.** Définir 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;">`données personnalisées`</mark> .\
**11.** Tous les identifiants de produit sont pris en compte.\
**12.** Priorité dans la colonne de gauche. Cela est défini selon les é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;">`catégorie`</mark> , <mark style="color:bleu;">`other`</mark> , <mark style="color:bleu;">`purchase`</mark> ou <mark style="color:bleu;">`searchresults`</mark> ensuite <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> ensuite <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`catégorie`</mark> .\
• Si <mark style="color:bleu;">`page_type`</mark> est <mark style="color:bleu;">`funnel_confirmation`</mark> ensuite <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> ensuite <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> ensuite <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> ensuite <mark style="color:bleu;">`pageType`</mark> est <mark style="color:bleu;">`catégorie`</mark> .\
• Si <mark style="color:bleu;">`event_name`</mark> est <mark style="color:bleu;">`view_item`</mark> ensuite <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> ensuite <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> ensuite <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> ensuite <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.