Metrics

Métriques X Ads via l'API

Votre client connecte son compte X Ads et votre produit interroge 14 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": "tads:likes",
      "component": "number_v1",
      "metrics": [
        "likes"
      ],
      "dimensions": [
        "engagement"
      ]
    }
  ]
}
Exemple : « Likes » en octobre, comparé à septembre.

Plus d'exemples d'appels X 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}).

Tableau

Campagnes à la une

Campaigns that had the greatest impact on your audience during the period analyzed.

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": "tads:featured_campaigns",
      "component": "datatable_v1",
      "metrics": [
        "likes",
        "replies",
        "retweets",
        "billed_charge_local_micro",
        "total_clicks",
        "engagements"
      ],
      "dimensions": [
        "engagement"
      ]
    }
  ]
}

Chiffre

Impressions

Nombre d'utilisateurs qui visualisent une campagne. Nous comptabilisons uniquement les impressions sur le contenu promu. Par conséquent, les impressions générées de manière organique ne sont pas comptabilisées.

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": "tads:impressions",
      "component": "number_v1",
      "metrics": [
        "impressions"
      ],
      "dimensions": [
        "engagement"
      ]
    }
  ]
}

Chiffres

13 métriques

  • Likes

    Nombre total de likes que vos annonces ont reçus.

    tads:likes
  • Impressions

    Nombre d'utilisateurs qui visualisent une campagne. Nous comptabilisons uniquement les impressions sur le contenu promu. Par conséquent, les impressions générées de manière organique ne sont pas comptabilisées.

    tads:impressions
  • Engagement total

    L'engagement indique le nombre d'interactions de l'utilisateur avec votre campagne. Dans les engagements, tous les clics sur le Tweet sont comptabilisés, y compris les Retweets, les réponses, les likes, les votes dans les sondages et les clics sur les hashtags.

    tads:engagements
  • Retweets

    Nombre total de retweets que vos annonces ont reçus.

    tads:retweets
  • Abonnés perdus

    Nombre de personnes qui ont cessé de suivre votre compte à partir d'une annonce.

    tads:unfollows
  • Clics

    Total des clics sur les liens, hashtags, carte du site et autres détails du Tweet dans votre annonce, combiné avec les likes et les clics sur le profil.

    tads:clicks
  • Réponses

    Nombre total de réponses que vos annonces ont reçues. Les réponses sont un Tweet en réponse à un autre Tweet. Elles sont généralement publiées lorsque vous cliquez sur le bouton Répondre à côté du Tweet dans votre fil d'actualité. Une réponse commence toujours par @nomdutilisateur.

    tads:replies
  • Total de clics

    Nombre total de clics sur vos annonces. Inclut les clics sur l'URL (liens raccourcis ou normaux), photo de profil, nom d'utilisateur, détails, hashtags, likes et clics sur le bouton d'application (installation ou ouverture d'une application).

    tads:total_clicks
  • Clics dans l'application

    Nombre de clics sur le bouton d'application (clics pour l'installation ou l'ouverture d'une application).

    tads:app_clicks
  • CPE

    Le coût par engagement (CPE) représente en moyenne combien chaque engagement vous a coûté. Il est calculé en divisant le coût total de la campagne par le nombre d'engagements (comme les likes, retweets et réponses).

    tads:cpe
  • CPC

    Le Coût par Clic (CPC) représente en moyenne combien chaque clic vous coûte. Il est calculé en divisant le coût total de la campagne par le nombre total de clics.

    tads:cpc
  • Dépense

    La valeur totale estimée que vous avez dépensée dans votre campagne.

    tads:spend
  • Taux d'engagement

    Le taux d'engagement représente le total des interactions sur votre annonce, en tenant compte des impressions. Il est calculé en divisant le nombre total d'interactions (likes, retweets, réponses, clics et abonnés gagnés) par le volume d'impressions.

    tads:engagement_rate

Tableaux

1 métrique

  • Campagnes à la une

    Campaigns that had the greatest impact on your audience during the period analyzed.

    tads:featured_campaigns

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.