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"
]
}
]
}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:likesImpressions
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:impressionsEngagement 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:engagementsRetweets
Nombre total de retweets que vos annonces ont reçus.
tads:retweetsAbonnés perdus
Nombre de personnes qui ont cessé de suivre votre compte à partir d'une annonce.
tads:unfollowsClics
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:clicksRé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:repliesTotal 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_clicksClics dans l'application
Nombre de clics sur le bouton d'application (clics pour l'installation ou l'ouverture d'une application).
tads:app_clicksCPE
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:cpeCPC
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:cpcDépense
La valeur totale estimée que vous avez dépensée dans votre campagne.
tads:spendTaux 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.
