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"
      ]
    }
  ]
}
Ejemplo: "'Me gusta'" en octubre, comparado con septiembre.

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:likes
  • 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.

    tads:impressions
  • Total 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:engagements
  • Retweets

    Número total de retweets que sus anuncios recibieron.

    tads:retweets
  • Seguidores perdidos

    Número de personas que dejaron de seguir su cuenta a partir de un anuncio.

    tads:unfollows
  • Clics

    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:clicks
  • Respuestas

    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:replies
  • Total 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_clicks
  • Clics 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_clicks
  • CPE

    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:cpe
  • CPC

    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:cpc
  • Gasto

    El valor total estimado que gastaste en tu campaña.

    tads:spend
  • Tasa 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.