Metrics

Métricas de Kwai Ads con la API

Tu cliente conecta su cuenta de Kwai Ads y tu producto consulta 31 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": "kwai_ads:charge",
      "component": "number_v1",
      "metrics": [
        "cost"
      ]
    }
  ]
}
Ejemplo: "Valor invertido" en octubre, comparado con septiembre.

Más ejemplos de llamadas a Kwai 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}).

Gráfico

Gasto a lo largo del tiempo

El valor total invertido a lo largo del tiempo.

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": "kwai_ads:spend_by_day",
      "component": "chart_v1",
      "metrics": [
        "cost"
      ],
      "dimensions": [
        "stat_date"
      ]
    }
  ]
}

Tabla

Campañas Destacadas

Campañas con datos de rendimiento para el período seleccionado.

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": "kwai_ads:campaigns_table",
      "component": "datatable_v1",
      "metrics": [
        "cost",
        "exposure",
        "click",
        "ctr",
        "action",
        "cpa"
      ],
      "dimensions": [
        "campaign_name"
      ]
    }
  ]
}

Número

Impresiones

El número de veces que se han mostrado tus anuncios.

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": "kwai_ads:show",
      "component": "number_v1",
      "metrics": [
        "exposure"
      ]
    }
  ]
}

Números

23 métricas

  • Valor invertido

    El valor total invertido en Kwai Ads durante el período seleccionado.

    kwai_ads:charge
  • Impresiones

    El número de veces que se han mostrado tus anuncios.

    kwai_ads:show
  • Clics

    El número de veces que los usuarios hicieron clic en la portada o en el creativo de tu anuncio.

    kwai_ads:photo_click
  • CTR

    La tasa de clics de tus anuncios.

    kwai_ads:photo_click_ratio
  • Impresiones del Activo

    El número de impresiones generadas por el activo promocionado.

    kwai_ads:aclick
  • Acciones

    El número de acciones generadas por tus anuncios.

    kwai_ads:bclick
  • Tasa de Acción

    El porcentaje de impresiones de anuncio que generaron una acción.

    kwai_ads:action_ratio
  • Coste por Acción

    El costo promedio de cada acción generada por tus anuncios.

    kwai_ads:action_cost
  • CPM

    The average cost per thousand impressions.

    kwai_ads:impression_1k_cost
  • Reproducciones de Video 3s

    El número de reproducciones de video que alcanzaron al menos 3 segundos.

    kwai_ads:played_three_seconds
  • Tasa de Reproducción 3s

    El porcentaje de impresiones que generaron una reproducción de video de 3 segundos.

    kwai_ads:play_3s_ratio
  • Tasa de Reproducción 5s

    El porcentaje de impresiones que generaron una reproducción de video de 5 segundos.

    kwai_ads:play_5s_ratio
  • Tasa de Conclusión

    El porcentaje de reproducciones de video que llegaron al final.

    kwai_ads:play_end_ratio
  • 'Me gusta'

    El número de me gusta generados por tus anuncios.

    kwai_ads:like
  • Comentarios

    El número de comentarios generados por tus anuncios.

    kwai_ads:comment
  • Número de veces compartido

    El número de compartidos generados por tus anuncios.

    kwai_ads:share
  • Seguidores

    El número de nuevos seguidores generados por tus anuncios.

    kwai_ads:follow
  • Conversiones

    El número de conversiones atribuidas a tus anuncios.

    kwai_ads:conversion_num
  • Coste por conversión

    El costo promedio de cada conversión.

    kwai_ads:conversion_cost
  • Tasa de Conversión

    El porcentaje de acciones que generaron una conversión.

    kwai_ads:conversion_ratio
  • Conversiones Profundas

    El número de conversiones profundas atribuidas a tus anuncios.

    kwai_ads:deep_conversion_num
  • Costo por Conversión Profunda

    El costo promedio de cada conversión profunda.

    kwai_ads:deep_conversion_cost
  • Tasa de Conversión Profunda

    El porcentaje de conversiones que generaron una conversión profunda.

    kwai_ads:deep_conversion_ratio

Gráficos

3 métricas

  • Gasto a lo largo del tiempo

    El valor total invertido a lo largo del tiempo.

    kwai_ads:spend_by_day
  • Impresiones y Clics a lo largo del tiempo

    El número de impresiones y clics a lo largo del tiempo.

    kwai_ads:impressions_clicks_by_day
  • Conversiones a lo largo del tiempo

    El número de conversiones y conversiones profundas a lo largo del tiempo.

    kwai_ads:conversions_by_day

Tablas

5 métricas

  • Campañas Destacadas

    Campañas con datos de rendimiento para el período seleccionado.

    kwai_ads:campaigns_table
  • Grupos de Anuncios Destacados

    Grupos de anuncios con datos de rendimiento para el período seleccionado.

    kwai_ads:ad_groups_table
  • Creativos Destacados

    Creativos con datos de rendimiento para el período seleccionado.

    kwai_ads:creatives_table
  • Público por Edad

    Rendimiento agrupado por rango de edad.

    kwai_ads:audience_by_age
  • Público por Género

    Rendimiento agrupado por género.

    kwai_ads:audience_by_gender

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.