Metrics
Métricas do Kwai Ads pela API
Seu cliente conecta a conta do Kwai Ads e seu produto consulta 31 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.
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"
]
}
]
}Mais exemplos de chamadas no Kwai Ads
O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).
Gráfico
Gasto ao longo do tempo
O valor total investido ao longo do tempo.
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"
]
}
]
}Tabela
Campanhas em Destaque
Campanhas com dados de desempenho para o período selecionado.
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
Impressões
O número de vezes que seus anúncios foram exibidos.
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 investido
O valor total investido no Kwai Ads durante o período selecionado.
kwai_ads:chargeImpressões
O número de vezes que seus anúncios foram exibidos.
kwai_ads:showCliques
O número de vezes que os usuários clicaram na capa ou no criativo do seu anúncio.
kwai_ads:photo_clickCTR (Taxa de Cliques)
A taxa de cliques dos seus anúncios.
kwai_ads:photo_click_ratioImpressões do Ativo
O número de impressões geradas pelo ativo promovido.
kwai_ads:aclickAções
O número de ações geradas pelos seus anúncios.
kwai_ads:bclickTaxa de Ação
A porcentagem de impressões de anúncio que geraram uma ação.
kwai_ads:action_ratioCusto por Ação
O custo médio de cada ação gerada pelos seus anúncios.
kwai_ads:action_costCPM
The average cost per thousand impressions.
kwai_ads:impression_1k_costReproduções de Vídeo 3s
O número de reproduções de vídeo que atingiram pelo menos 3 segundos.
kwai_ads:played_three_secondsTaxa de Reprodução 3s
A porcentagem de impressões que geraram uma reprodução de vídeo de 3 segundos.
kwai_ads:play_3s_ratioTaxa de Reprodução 5s
A porcentagem de impressões que geraram uma reprodução de vídeo de 5 segundos.
kwai_ads:play_5s_ratioTaxa de Conclusão
A porcentagem de reproduções de vídeo que chegaram ao fim.
kwai_ads:play_end_ratioCurtidas
O número de curtidas geradas pelos seus anúncios.
kwai_ads:likeComentários
O número de comentários gerados pelos seus anúncios.
kwai_ads:commentCompartilhamentos
O número de compartilhamentos gerados pelos seus anúncios.
kwai_ads:shareSeguidores
O número de novos seguidores gerados pelos seus anúncios.
kwai_ads:followConversões
O número de conversões atribuídas aos seus anúncios.
kwai_ads:conversion_numCusto por conversão
O custo médio de cada conversão.
kwai_ads:conversion_costTaxa de conversão
A porcentagem de ações que geraram uma conversão.
kwai_ads:conversion_ratioConversões Profundas
O número de conversões profundas atribuídas aos seus anúncios.
kwai_ads:deep_conversion_numCusto por Conversão Profunda
O custo médio de cada conversão profunda.
kwai_ads:deep_conversion_costTaxa de Conversão Profunda
A porcentagem de conversões que geraram uma conversão profunda.
kwai_ads:deep_conversion_ratio
Gráficos
3 métricas
Gasto ao longo do tempo
O valor total investido ao longo do tempo.
kwai_ads:spend_by_dayImpressões e Cliques ao longo do tempo
O número de impressões e cliques ao longo do tempo.
kwai_ads:impressions_clicks_by_dayConversões ao longo do tempo
O número de conversões e conversões profundas ao longo do tempo.
kwai_ads:conversions_by_day
Tabelas
5 métricas
Campanhas em Destaque
Campanhas com dados de desempenho para o período selecionado.
kwai_ads:campaigns_tableGrupos de Anúncios em Destaque
Grupos de anúncios com dados de desempenho para o período selecionado.
kwai_ads:ad_groups_tableCriativos em Destaque
Criativos com dados de desempenho para o período selecionado.
kwai_ads:creatives_tablePúblico por Idade
Desempenho agrupado por faixa etária.
kwai_ads:audience_by_agePúblico por Gênero
Desempenho agrupado por gênero.
kwai_ads:audience_by_gender
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
