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"
]
}
]
}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:recipientsEntregue
Número de e-mails entregues com sucesso nas caixas de entrada dos destinatários no período analisado.
klaviyo:deliveredTaxa de entrega
Percentual de e-mails enviados que foram entregues com sucesso. Calculado como entregues dividido por destinatários.
klaviyo:delivery_rateAberturas únicas
Número de destinatários únicos que abriram pelo menos uma campanha de e-mail no período analisado.
klaviyo:opens_uniqueTaxa de abertura
Percentual de e-mails entregues que foram abertos por pelo menos um destinatário único.
klaviyo:open_rateCliques ú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_uniqueTaxa de cliques
Percentual de e-mails entregues que receberam pelo menos um clique único.
klaviyo:click_rateTaxa 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_rateCancelamentos de Assinaturas
Total number of recipients who unsubscribed from email campaigns in the analyzed period.
klaviyo:unsubscribesTaxa 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_rateBounces
Número total de e-mails que não puderam ser entregues (hard + soft bounces) no período analisado.
klaviyo:bouncedReclamações de spam
Número de destinatários que marcaram um e-mail de campanha como spam no período analisado.
klaviyo:spam_complaintsReceita de conversão
Receita total atribuída às campanhas de e-mail por meio de conversões rastreadas no período analisado.
klaviyo:conversion_valueReceita 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_timeEntregues 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_bouncesEngajamento 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_campaignsMelhores fluxos
Detalhamento do desempenho de todos os fluxos de automação ativos no período analisado.
klaviyo:top_flowsDesempenho 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.
