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"
]
}
]
}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:chargeImpresiones
El número de veces que se han mostrado tus anuncios.
kwai_ads:showClics
El número de veces que los usuarios hicieron clic en la portada o en el creativo de tu anuncio.
kwai_ads:photo_clickCTR
La tasa de clics de tus anuncios.
kwai_ads:photo_click_ratioImpresiones del Activo
El número de impresiones generadas por el activo promocionado.
kwai_ads:aclickAcciones
El número de acciones generadas por tus anuncios.
kwai_ads:bclickTasa de Acción
El porcentaje de impresiones de anuncio que generaron una acción.
kwai_ads:action_ratioCoste por Acción
El costo promedio de cada acción generada por tus anuncios.
kwai_ads:action_costCPM
The average cost per thousand impressions.
kwai_ads:impression_1k_costReproducciones de Video 3s
El número de reproducciones de video que alcanzaron al menos 3 segundos.
kwai_ads:played_three_secondsTasa de Reproducción 3s
El porcentaje de impresiones que generaron una reproducción de video de 3 segundos.
kwai_ads:play_3s_ratioTasa de Reproducción 5s
El porcentaje de impresiones que generaron una reproducción de video de 5 segundos.
kwai_ads:play_5s_ratioTasa 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:likeComentarios
El número de comentarios generados por tus anuncios.
kwai_ads:commentNúmero de veces compartido
El número de compartidos generados por tus anuncios.
kwai_ads:shareSeguidores
El número de nuevos seguidores generados por tus anuncios.
kwai_ads:followConversiones
El número de conversiones atribuidas a tus anuncios.
kwai_ads:conversion_numCoste por conversión
El costo promedio de cada conversión.
kwai_ads:conversion_costTasa de Conversión
El porcentaje de acciones que generaron una conversión.
kwai_ads:conversion_ratioConversiones Profundas
El número de conversiones profundas atribuidas a tus anuncios.
kwai_ads:deep_conversion_numCosto por Conversión Profunda
El costo promedio de cada conversión profunda.
kwai_ads:deep_conversion_costTasa 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_dayImpresiones y Clics a lo largo del tiempo
El número de impresiones y clics a lo largo del tiempo.
kwai_ads:impressions_clicks_by_dayConversiones 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_tableGrupos de Anuncios Destacados
Grupos de anuncios con datos de rendimiento para el período seleccionado.
kwai_ads:ad_groups_tableCreativos Destacados
Creativos con datos de rendimiento para el período seleccionado.
kwai_ads:creatives_tablePúblico por Edad
Rendimiento agrupado por rango de edad.
kwai_ads:audience_by_agePú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.
