Metrics
Métriques Microsoft Ads via l'API
Votre client connecte son compte Microsoft Ads et votre produit interroge 36 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "microsoft_ads:impressions",
"component": "number_v1",
"metrics": [
"impressions"
]
}
]
}Plus d'exemples d'appels Microsoft Ads
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Impressions et clics au fil du temps
Le nombre d'impressions et de clics que vos annonces ont reçus au fil du temps
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "microsoft_ads:impressions_clicks_by_day",
"component": "chart_v1",
"metrics": [
"impressions",
"clicks"
],
"dimensions": [
"day"
]
}
]
}Tableau
Campagnes à la une
Campagnes ayant eu le plus grand impact sur votre public pendant la période analysée.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "microsoft_ads:featured_campaigns",
"component": "datatable_v1",
"metrics": [
"impressions",
"clicks",
"ctr",
"spend",
"conversions",
"conversion_rate",
"average_cpc"
],
"dimensions": [
"campaign"
]
}
]
}Chiffre
Clics
Le nombre de fois que les utilisateurs ont cliqué sur votre annonce
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "microsoft_ads:clicks",
"component": "number_v1",
"metrics": [
"clicks"
]
}
]
}Chiffres
21 métriques
Impressions
Le nombre de fois que votre annonce a été affichée aux utilisateurs
microsoft_ads:impressionsClics
Le nombre de fois que les utilisateurs ont cliqué sur votre annonce
microsoft_ads:clicksMontant dépensé
Le montant total dépensé dans vos campagnes
microsoft_ads:spendConversions
Le nombre de conversions attribuées à vos annonces
microsoft_ads:conversionsToutes les conversions
Total des conversions incluant les conversions entre appareils et navigateurs
microsoft_ads:all_conversionsCPA de toutes les conversions
Le coût moyen par conversion en tenant compte de toutes les conversions
microsoft_ads:all_conversions_cpaTaux de toutes les conversions
Le taux de conversion en tenant compte de toutes les conversions, calculé comme toutes les conversions divisées par les clics
microsoft_ads:all_conversions_rateRevenu de toutes les conversions
Le revenu total de toutes les conversions incluant les conversions entre appareils
microsoft_ads:all_conversions_revenueROAS de toutes les conversions
Retour sur les dépenses publicitaires en tenant compte de toutes les conversions, calculé comme le revenu de toutes les conversions divisé par les dépenses
microsoft_ads:all_conversions_roasValeur de la conversion
La valeur totale de toutes les conversions
microsoft_ads:conversion_valueRevenu
Le revenu total généré à partir des conversions
microsoft_ads:revenueCTR (Taux de clics)
Le pourcentage d'impressions qui ont abouti à des clics
microsoft_ads:ctrCPC moyen
Le coût moyen par clic
microsoft_ads:average_cpcCPM moyen
Le coût moyen pour mille impressions
microsoft_ads:average_cpmTaux de conversion
Le pourcentage de clics qui ont abouti à des conversions
microsoft_ads:conversion_rateCoût par conversion
Le coût moyen de chaque conversion
microsoft_ads:cost_per_conversionROAS (Retour sur les dépenses publicitaires)
Le retour sur les dépenses publicitaires calculé comme le revenu divisé par les dépenses
microsoft_ads:roasIndice de qualité
Une mesure de la qualité et de la pertinence de vos annonces, mots-clés et pages de destination
microsoft_ads:quality_scoreTaux d'impressions
Le pourcentage estimé d'impressions du total des impressions disponibles sur le marché que vous cibliez
microsoft_ads:impression_shareTaux d'impressions supérieures
Le pourcentage de fois que votre annonce a été affichée dans les positions supérieures au-dessus des résultats organiques
microsoft_ads:top_impression_rateTaux d'impressions supérieures absolues
Le pourcentage de fois que votre annonce a été en première position de tous les résultats
microsoft_ads:absolute_top_impression_rate
Graphiques
9 métriques
Impressions et clics au fil du temps
Le nombre d'impressions et de clics que vos annonces ont reçus au fil du temps
microsoft_ads:impressions_clicks_by_dayDépenses au fil du temps
Le montant total dépensé dans vos campagnes au fil du temps
microsoft_ads:spend_by_dayConversions au fil du temps
Le nombre de conversions au fil du temps
microsoft_ads:conversions_by_dayClics et CTR au fil du temps
Le nombre de clics et le taux de clics au fil du temps
microsoft_ads:clicks_ctr_by_dayClics par appareil
Répartition des clics par type d'appareil (Bureau, Mobile, Tablette)
microsoft_ads:clicks_by_deviceImpressions par appareil
Répartition des impressions par type d'appareil
microsoft_ads:impressions_by_deviceDépenses par appareil
Répartition des dépenses par type d'appareil
microsoft_ads:spend_by_deviceClics par âge
Répartition des clics par tranche d'âge. Disponible uniquement pour les campagnes avec ciblage de public ou diffusées sur le Microsoft Audience Network.
microsoft_ads:clicks_by_ageClics par genre
Distribution des clics par genre. Disponible uniquement pour les campagnes avec ciblage d'audience ou diffusées sur le Microsoft Audience Network.
microsoft_ads:clicks_by_gender
Tableaux
6 métriques
Campagnes à la une
Campagnes ayant eu le plus grand impact sur votre public pendant la période analysée.
microsoft_ads:featured_campaignsGroupes d'annonces
Synthèse des données clés des groupes d'annonces au cours de la période analysée.
microsoft_ads:ad_groupsPrincipaux mots-clés
Mots-clés les plus performants pendant la période analysée.
microsoft_ads:keywordsAnnonces en vedette
Performance de vos annonces pendant la période analysée.
microsoft_ads:adsPerformance géographique
Résumé des principales données par localisation géographique.
microsoft_ads:insights_by_geographicPerformance par appareil
Résumé des principales données par type d'appareil.
microsoft_ads:insights_by_device
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
