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"
      ]
    }
  ]
}
Exemplo: "Valor investido" em outubro, comparado a setembro.

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:charge
  • Impressões

    O número de vezes que seus anúncios foram exibidos.

    kwai_ads:show
  • Cliques

    O número de vezes que os usuários clicaram na capa ou no criativo do seu anúncio.

    kwai_ads:photo_click
  • CTR (Taxa de Cliques)

    A taxa de cliques dos seus anúncios.

    kwai_ads:photo_click_ratio
  • Impressões do Ativo

    O número de impressões geradas pelo ativo promovido.

    kwai_ads:aclick
  • Ações

    O número de ações geradas pelos seus anúncios.

    kwai_ads:bclick
  • Taxa de Ação

    A porcentagem de impressões de anúncio que geraram uma ação.

    kwai_ads:action_ratio
  • Custo por Ação

    O custo médio de cada ação gerada pelos seus anúncios.

    kwai_ads:action_cost
  • CPM

    The average cost per thousand impressions.

    kwai_ads:impression_1k_cost
  • Reproduções de Vídeo 3s

    O número de reproduções de vídeo que atingiram pelo menos 3 segundos.

    kwai_ads:played_three_seconds
  • Taxa de Reprodução 3s

    A porcentagem de impressões que geraram uma reprodução de vídeo de 3 segundos.

    kwai_ads:play_3s_ratio
  • Taxa de Reprodução 5s

    A porcentagem de impressões que geraram uma reprodução de vídeo de 5 segundos.

    kwai_ads:play_5s_ratio
  • Taxa de Conclusão

    A porcentagem de reproduções de vídeo que chegaram ao fim.

    kwai_ads:play_end_ratio
  • Curtidas

    O número de curtidas geradas pelos seus anúncios.

    kwai_ads:like
  • Comentários

    O número de comentários gerados pelos seus anúncios.

    kwai_ads:comment
  • Compartilhamentos

    O número de compartilhamentos gerados pelos seus anúncios.

    kwai_ads:share
  • Seguidores

    O número de novos seguidores gerados pelos seus anúncios.

    kwai_ads:follow
  • Conversões

    O número de conversões atribuídas aos seus anúncios.

    kwai_ads:conversion_num
  • Custo por conversão

    O custo médio de cada conversão.

    kwai_ads:conversion_cost
  • Taxa de conversão

    A porcentagem de ações que geraram uma conversão.

    kwai_ads:conversion_ratio
  • Conversões Profundas

    O número de conversões profundas atribuídas aos seus anúncios.

    kwai_ads:deep_conversion_num
  • Custo por Conversão Profunda

    O custo médio de cada conversão profunda.

    kwai_ads:deep_conversion_cost
  • Taxa 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_day
  • Impressões e Cliques ao longo do tempo

    O número de impressões e cliques ao longo do tempo.

    kwai_ads:impressions_clicks_by_day
  • Conversõ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_table
  • Grupos de Anúncios em Destaque

    Grupos de anúncios com dados de desempenho para o período selecionado.

    kwai_ads:ad_groups_table
  • Criativos em Destaque

    Criativos com dados de desempenho para o período selecionado.

    kwai_ads:creatives_table
  • Público por Idade

    Desempenho agrupado por faixa etária.

    kwai_ads:audience_by_age
  • Pú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.