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"
      ]
    }
  ]
}
Exemple : « Impressions » en octobre, comparé à septembre.

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:impressions
  • Clics

    Le nombre de fois que les utilisateurs ont cliqué sur votre annonce

    microsoft_ads:clicks
  • Montant dépensé

    Le montant total dépensé dans vos campagnes

    microsoft_ads:spend
  • Conversions

    Le nombre de conversions attribuées à vos annonces

    microsoft_ads:conversions
  • Toutes les conversions

    Total des conversions incluant les conversions entre appareils et navigateurs

    microsoft_ads:all_conversions
  • CPA de toutes les conversions

    Le coût moyen par conversion en tenant compte de toutes les conversions

    microsoft_ads:all_conversions_cpa
  • Taux 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_rate
  • Revenu de toutes les conversions

    Le revenu total de toutes les conversions incluant les conversions entre appareils

    microsoft_ads:all_conversions_revenue
  • ROAS 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_roas
  • Valeur de la conversion

    La valeur totale de toutes les conversions

    microsoft_ads:conversion_value
  • Revenu

    Le revenu total généré à partir des conversions

    microsoft_ads:revenue
  • CTR (Taux de clics)

    Le pourcentage d'impressions qui ont abouti à des clics

    microsoft_ads:ctr
  • CPC moyen

    Le coût moyen par clic

    microsoft_ads:average_cpc
  • CPM moyen

    Le coût moyen pour mille impressions

    microsoft_ads:average_cpm
  • Taux de conversion

    Le pourcentage de clics qui ont abouti à des conversions

    microsoft_ads:conversion_rate
  • Coût par conversion

    Le coût moyen de chaque conversion

    microsoft_ads:cost_per_conversion
  • ROAS (Retour sur les dépenses publicitaires)

    Le retour sur les dépenses publicitaires calculé comme le revenu divisé par les dépenses

    microsoft_ads:roas
  • Indice de qualité

    Une mesure de la qualité et de la pertinence de vos annonces, mots-clés et pages de destination

    microsoft_ads:quality_score
  • Taux d'impressions

    Le pourcentage estimé d'impressions du total des impressions disponibles sur le marché que vous cibliez

    microsoft_ads:impression_share
  • Taux 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_rate
  • Taux 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_day
  • Dépenses au fil du temps

    Le montant total dépensé dans vos campagnes au fil du temps

    microsoft_ads:spend_by_day
  • Conversions au fil du temps

    Le nombre de conversions au fil du temps

    microsoft_ads:conversions_by_day
  • Clics et CTR au fil du temps

    Le nombre de clics et le taux de clics au fil du temps

    microsoft_ads:clicks_ctr_by_day
  • Clics par appareil

    Répartition des clics par type d'appareil (Bureau, Mobile, Tablette)

    microsoft_ads:clicks_by_device
  • Impressions par appareil

    Répartition des impressions par type d'appareil

    microsoft_ads:impressions_by_device
  • Dépenses par appareil

    Répartition des dépenses par type d'appareil

    microsoft_ads:spend_by_device
  • Clics 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_age
  • Clics 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_campaigns
  • Groupes d'annonces

    Synthèse des données clés des groupes d'annonces au cours de la période analysée.

    microsoft_ads:ad_groups
  • Principaux mots-clés

    Mots-clés les plus performants pendant la période analysée.

    microsoft_ads:keywords
  • Annonces en vedette

    Performance de vos annonces pendant la période analysée.

    microsoft_ads:ads
  • Performance géographique

    Résumé des principales données par localisation géographique.

    microsoft_ads:insights_by_geographic
  • Performance 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.