Metrics

Métricas do Klaviyo pela API

Seu cliente conecta a conta do Klaviyo e seu produto consulta 20 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": "klaviyo:recipients",
      "component": "number_v1",
      "metrics": [
        "recipients"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}
Exemplo: "Destinatários" em outubro, comparado a setembro.

Mais exemplos de chamadas no Klaviyo

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

Engajamento de campanhas ao longo do tempo

Gráfico de barras comparando aberturas únicas e cliques únicos por campanha no período analisado.

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": "klaviyo:campaign_engagement_over_time",
      "component": "chart_v1",
      "metrics": [
        "opens_unique",
        "clicks_unique"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Principais campanhas

Detalhamento do desempenho de todas as campanhas de e-mail enviadas no período analisado.

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": "klaviyo:top_campaigns",
      "component": "datatable_v1",
      "metrics": [
        "campaign",
        "recipients",
        "opens_unique",
        "open_rate",
        "clicks_unique",
        "click_rate",
        "bounced"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Número

Entregue

Número de e-mails entregues com sucesso nas caixas de entrada dos destinatários no período analisado.

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": "klaviyo:delivered",
      "component": "number_v1",
      "metrics": [
        "delivered"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Números

14 métricas

  • Destinatários

    Número total de destinatários impactados por todas as campanhas de e-mail no período analisado.

    klaviyo:recipients
  • Entregue

    Número de e-mails entregues com sucesso nas caixas de entrada dos destinatários no período analisado.

    klaviyo:delivered
  • Taxa de entrega

    Percentual de e-mails enviados que foram entregues com sucesso. Calculado como entregues dividido por destinatários.

    klaviyo:delivery_rate
  • Aberturas únicas

    Número de destinatários únicos que abriram pelo menos uma campanha de e-mail no período analisado.

    klaviyo:opens_unique
  • Taxa de abertura

    Percentual de e-mails entregues que foram abertos por pelo menos um destinatário único.

    klaviyo:open_rate
  • Cliques únicos

    Número de destinatários únicos que clicaram em pelo menos um link em qualquer campanha de e-mail no período analisado.

    klaviyo:clicks_unique
  • Taxa de cliques

    Percentual de e-mails entregues que receberam pelo menos um clique único.

    klaviyo:click_rate
  • Taxa de clique por abertura

    Percentual de e-mails abertos que também receberam um clique único. Indica a relevância do conteúdo do e-mail.

    klaviyo:click_to_open_rate
  • Cancelamentos de Assinaturas

    Total number of recipients who unsubscribed from email campaigns in the analyzed period.

    klaviyo:unsubscribes
  • Taxa de assinaturas canceladas

    Percentual de destinatários que se descadastraram das campanhas de e-mail em relação ao total de destinatários.

    klaviyo:unsubscribe_rate
  • Bounces

    Número total de e-mails que não puderam ser entregues (hard + soft bounces) no período analisado.

    klaviyo:bounced
  • Reclamações de spam

    Número de destinatários que marcaram um e-mail de campanha como spam no período analisado.

    klaviyo:spam_complaints
  • Receita de conversão

    Receita total atribuída às campanhas de e-mail por meio de conversões rastreadas no período analisado.

    klaviyo:conversion_value
  • Receita por destinatário

    Receita média gerada por destinatário de e-mail, calculada como receita total de conversão dividida pelos destinatários.

    klaviyo:revenue_per_recipient

Gráficos

3 métricas

  • Engajamento de campanhas ao longo do tempo

    Gráfico de barras comparando aberturas únicas e cliques únicos por campanha no período analisado.

    klaviyo:campaign_engagement_over_time
  • Entregues vs bounces

    Gráfico de linha mostrando o volume de e-mails entregues versus e-mails com bounce por campanha no período analisado.

    klaviyo:delivery_vs_bounces
  • Engajamento de fluxos ao longo do tempo

    Gráfico de linha comparando aberturas únicas e cliques únicos por fluxo de automação no período analisado.

    klaviyo:flow_engagement_over_time

Tabelas

3 métricas

  • Principais campanhas

    Detalhamento do desempenho de todas as campanhas de e-mail enviadas no período analisado.

    klaviyo:top_campaigns
  • Melhores fluxos

    Detalhamento do desempenho de todos os fluxos de automação ativos no período analisado.

    klaviyo:top_flows
  • Desempenho dos formulários

    Funil de submissão de todos os formulários de cadastro do Klaviyo, mostrando visualizações, visualizações únicas, envios e taxa de envio.

    klaviyo:form_performance

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.