Metrics
Métricas de X Ads con la API
Tu cliente conecta su cuenta de X Ads y tu producto consulta 14 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.
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"
]
}
]
}Más ejemplos de llamadas a X Ads
El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).
Tabla
Campañas destacadas
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"
]
}
]
}Número
Impresiones
Número de usuarios que visualizan una campaña. Contabilizamos solo las impresiones en el contenido promovido. Por lo tanto, las impresiones generadas de manera orgánica no se contabilizan.
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"
]
}
]
}Números
13 métricas
'Me gusta'
Número total de me gusta que tus anuncios han recibido.
tads:likesImpresiones
Número de usuarios que visualizan una campaña. Contabilizamos solo las impresiones en el contenido promovido. Por lo tanto, las impresiones generadas de manera orgánica no se contabilizan.
tads:impressionsTotal de interacción
El engagement indica el número de interacciones del usuario con tu campaña. En los engagements se contabilizan todos los clics en el Tweet, incluyendo Retweets, respuestas, me gusta, votos en encuestas y clics en hashtags.
tads:engagementsRetweets
Número total de retweets que sus anuncios recibieron.
tads:retweetsSeguidores perdidos
Número de personas que dejaron de seguir su cuenta a partir de un anuncio.
tads:unfollowsClics
Total de clics en enlaces, hashtags, tarjeta del sitio y otros detalles del Tweet en su anuncio, combinado con me gusta y clics en el perfil.
tads:clicksRespuestas
Número total de respuestas que tus anuncios han recibido. Las respuestas son un Tweet en respuesta a otro Tweet. Generalmente se publica cuando haces clic en el botón Responder al lado del Tweet en tu timeline. Una respuesta siempre comienza con @nomdeusuario.
tads:repliesTotal de clics
Número total de clics en sus anuncios. Incluye los clics en la URL (enlaces acortados o normales), foto de perfil, nombre de pantalla, nombre de usuario, detalles, hashtags, me gusta y clics en el botón de la aplicación (instalación o apertura de una app).
tads:total_clicksClics en la aplicación
Número de clics en el botón de la aplicación (clics para instalación o apertura de una app).
tads:app_clicksCPE
El costo por compromiso (CPE) representa en promedio cuánto costó cada compromiso para usted. Se calcula dividiendo el gasto total de la campaña por el número de compromisos (como me gusta, retweets y respuestas).
tads:cpeCPC
El Costo por Clic (CPC) representa en promedio cuánto cuesta cada clic para ti. Se calcula dividiendo el gasto total de la campaña por el número total de clics.
tads:cpcGasto
El valor total estimado que gastaste en tu campaña.
tads:spendTasa de participación
La tasa de Engagement representa el total de interacciones en tu anuncio, considerando las impresiones de las mismas. Se calcula dividiendo el número total de interacciones (me gusta, retweets, respuestas, clics y seguidores ganados) con el volumen de impresiones.
tads:engagement_rate
Tablas
1 métrica
Campañas destacadas
Campaigns that had the greatest impact on your audience during the period analyzed.
tads:featured_campaigns
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
