Metrics

Métricas do Mailchimp pela API

Seu cliente conecta a conta do Mailchimp e seu produto consulta 18 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": "mailchimp:emails_sent",
      "component": "number_v1",
      "metrics": [
        "emails_sent"
      ]
    }
  ]
}
Exemplo: "Emails Enviados" em outubro, comparado a setembro.

Mais exemplos de chamadas no Mailchimp

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

Performance por Hora

Número de cliques e aberturas dos seus emails, agrupados pela hora que a ação aconteceu.

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": "mailchimp:timeseries",
      "component": "chart_v1",
      "metrics": [
        "unique_opens",
        "recipients_clicks"
      ],
      "dimensions": [
        "timeseries"
      ]
    }
  ]
}

Tabela

Melhores campanhas

Suas melhores campanhas do 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": "mailchimp:top_campaigns",
      "component": "datatable_v1",
      "metrics": [
        "emails_sent",
        "opens.unique_opens",
        "opens.open_rate",
        "clicks.unique_clicks",
        "clicks.click_rate",
        "bounces.soft_bounces",
        "bounces.hard_bounces"
      ],
      "dimensions": [
        "campaign_title"
      ]
    }
  ]
}

Número

Cancelamentos de Assinaturas

Número total de destinatários que clicaram no link de "Cancelar Assinatura", considerando todas suas campanhas do 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": "mailchimp:unsubscribed",
      "component": "number_v1",
      "metrics": [
        "unsubscribed"
      ]
    }
  ]
}

Números

13 métricas

  • Emails Enviados

    Número de emails que foram enviados pelas campanhas no período de tempo analisado.

    mailchimp:emails_sent
  • Cancelamentos de Assinaturas

    Número total de destinatários que clicaram no link de "Cancelar Assinatura", considerando todas suas campanhas do período analisado.

    mailchimp:unsubscribed
  • Total de Cliques

    O número de destinatários que clicaram em qualquer link rastreado uma ou mais vezes.

    mailchimp:clicks_total
  • Taxa de Cliques

    O número total de cliques dividido pelo número de e-mails enviados.

    mailchimp:clicks_total_rate
  • Cliques Únicos

    Número de destinatários unicos que clicaram em qualquer link rastreado.

    mailchimp:unique_clicks
  • Total de Aberturas

    O número de destinatários que abriram seus emails uma ou mais vezes.

    mailchimp:opens_total
  • Taxa de Abertura

    O número total de aberturas dividido pelo número de e-mails enviados.

    mailchimp:opens_total_rate
  • Aberturas Únicas

    O número de destinatários únicos que abriram seus emails.

    mailchimp:unique_opens
  • Número de Campanhas

    Número de campanhas que enviaram um email no período analisado.

    mailchimp:campaigns_count
  • Devoluções Temporárias

    As devoluções temporárias normalmente indicam um problema temporário com a entrega.

    mailchimp:soft_bounces
  • Devoluções Permanentes

    Uma devolução permanente indica um motivo permanente pelo qual um e-mail não pode ser entregue.

    mailchimp:hard_bounces
  • Total de Encaminhadas

    O número de vezes que a campanha foi encaminhada usando o formulário "Encaminhar para um amigo". Essa estatística considera encaminhamentos somente por meio do formulário "Encaminhar para um amigo" e não é capaz de detectar quando um destinatário usa a função de encaminhamento no programa de e-mail dele.

    mailchimp:forwards_count
  • Aberturas de Encaminhadas

    O número de vezes que a campanha foi aberta por alguém que a encaminhou usando um formulário "Encaminhar para um amigo".

    mailchimp:forwards_opens

Gráficos

2 métricas

  • Performance por Hora

    Número de cliques e aberturas dos seus emails, agrupados pela hora que a ação aconteceu.

    mailchimp:timeseries
  • Aberturas por Dia

    Esse gráfico mostra as aberturas de suas campanhas, agrupadas pelo dia em que aconteceu a ação.

    mailchimp:opens_by_day

Tabelas

3 métricas

  • Melhores campanhas

    Suas melhores campanhas do período analisado.

    mailchimp:top_campaigns
  • Estatísticas de E-commerce por Campanha

    Dados estatísticos de E-commerce das campanhas do período analisado.

    mailchimp:ecommerce_summary
  • Resumo das Listas

    Estatísticas das suas listas de remetentes.

    mailchimp:lists

Veja o Connect aplicado ao seu produto.

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