Metrics

Métricas do HubSpot Marketing pela API

Seu cliente conecta a conta do HubSpot Marketing e seu produto consulta 48 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": "hubspot_marketing:sent_emails",
      "component": "number_v1",
      "metrics": [
        "stats.counters.sent"
      ],
      "dimensions": [
        "emails"
      ]
    }
  ]
}
Exemplo: "Emails enviados" em outubro, comparado a setembro.

Mais exemplos de chamadas no HubSpot Marketing

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

Visualizações por dispositivo

Número de visualizações por sessões do site, agrupada pelo tipo de dispositivo que o visitante utilizou.

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": "hubspot_marketing:sessions_by_device_chart",
      "component": "chart_v1",
      "metrics": [
        "desktop",
        "mobile",
        "others"
      ],
      "dimensions": [
        "device"
      ]
    }
  ]
}

Tabela

Emails em destaque

Resumo do desempenho dos e-mails enviados durante o período de análise.

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": "hubspot_marketing:emails_datatable",
      "component": "datatable_v1",
      "metrics": [
        "stats.counters.sent",
        "stats.counters.delivered",
        "stats.counters.open",
        "openratio",
        "deliveredratio",
        "clickratio",
        "clickthroughratio"
      ],
      "dimensions": [
        "emails"
      ]
    }
  ]
}

Número

Emails entregues

O número de emails entregues com sucesso em uma caixa de entrada, durante o período de análise

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": "hubspot_marketing:delivered_emails",
      "component": "number_v1",
      "metrics": [
        "stats.counters.delivered"
      ],
      "dimensions": [
        "emails"
      ]
    }
  ]
}

Números

36 métricas

  • Emails enviados

    O número total de e-mails enviados durante o período analisado.

    hubspot_marketing:sent_emails
  • Emails entregues

    O número de emails entregues com sucesso em uma caixa de entrada, durante o período de análise

    hubspot_marketing:delivered_emails
  • Cliques em emails

    O número de destinatários únicos que clicaram em qualquer link em seu e-mail, excluindo os links Cancelar assinatura e Preferências de assinatura.

    hubspot_marketing:click_emails
  • Aberturas Únicas

    O número total de aberturas exclusivas durante o período de análise

    hubspot_marketing:open_emails
  • Hard bounce emails

    O número de vezes que seus emails não puderam ser entregues porque o endereço de e-mail era inválido ou não estava mais em uso, ou porque o e-mail foi marcado como spam.

    hubspot_marketing:hardbounced_emails
  • Relatórios de spam

    Número de contatos que relataram este e-mail como spam ao provedor de e-mail ou arrastaram manualmente o e-mail da caixa de entrada para a pasta de lixo eletrônico.

    hubspot_marketing:spamreport_emails
  • Assinaturas canceladas

    O número de contatos que receberam seu e-mail e cancelaram a assinatura durante o período de revisão.

    hubspot_marketing:unsubscribed_emails
  • Taxa de assinaturas canceladas

    A porcentagem de destinatários que cancelaram a assinatura do seu e-mail durante o período de análise.

    hubspot_marketing:unsubscribedratio_emails
  • Taxa de relatórios de spam

    Porcentagem de e-mails marcados como spam entre os que foram entregues aos destinatários.

    hubspot_marketing:spamreportratio_emails
  • Taxa de hard bounce de emails

    A porcentagem de seus e-mails que não puderam ser entregues porque o endereço de e-mail era inválido ou não estava mais em uso, ou seu e-mail foi marcado como spam.

    hubspot_marketing:hardbounceratio_emails
  • Taxa de abertura

    A taxa de abertura é a porcentagem de pessoas que abriram seu e-mail em relação às pessoas que receberam seu e-mail.

    hubspot_marketing:openratio_emails
  • Taxa de entrega

    Porcentagem de e-mails entregues aos destinatários em comparação com a quantidade de e-mails enviados.

    hubspot_marketing:deliveredratio_emails
  • Taxa de cliques em emails

    A taxa de cliques é a porcentagem de pessoas que clicaram em um link em seu e-mail em relação às pessoas que receberam seu e-mail.

    hubspot_marketing:clickratio_emails
  • Taxa de click-through

    A porcentagem de pessoas que clicaram em um link em seu e-mail em relação ao número de pessoas que abriram seu e-mail.

    hubspot_marketing:clickthroughratio_emails
  • Entrada

    Número total de pessoas que iniciaram o preenchimento do formulário na página durante o período analisado.

    hubspot_marketing:entrances_landing_pages
  • Saídas

    Número total de pessoas que saíram do formulário antes de enviá-lo, durante o período analisado.

    hubspot_marketing:exits_landing_pages
  • Visualizações da página de destino do site

    Número total de visualizações da página de destino durante o período analisado.

    hubspot_marketing:rawViews_landing_pages
  • Taxa de rejeição das landing pages

    Porcentagem de usuários que visualizaram sua página de destino, mas saíram sem realizar nenhuma ação.

    hubspot_marketing:pageBounceRate_landing_pages
  • Total de envios

    Número total de envios de formulários durante os períodos de duração.

    hubspot_marketing:submissions_landing_pages
  • Novos contatos

    Número de novos leads captados pela página de destino durante o período de análise.

    hubspot_marketing:contacts_landing_pages
  • Tempo médio de visualização de página

    Tempo médio que os visitantes visualizaram sua página de destino. É calculado dividindo o tempo total de visualização pelo número de visualizações.

    hubspot_marketing:timePerPageview_landing_pages
  • Média de saídas por visualização de página

    Porcentagem de usuários que visualizaram sua página de destino, mas saíram sem converter. Essa métrica é calculada dividindo o número de saídas pelo número de visualizações.

    hubspot_marketing:exitsPerPageview_landing_pages
  • Exibições de CTA

    Número de vezes que o CTA foi exibido na tela durante o período de análise.

    hubspot_marketing:ctaViews_landing_pages
  • Taxa de envio

    Porcentagem de envios de formulário em comparação com o número de visualizações de formulário durante o período selecionado. A taxa de envio é calculada dividindo o número de envios de formulário pelo número de visualizações.

    hubspot_marketing:sentRate_landing_pages
  • Visualizações do blog

    Número de visualizações que seu blog obteve no período analisado.

    hubspot_marketing:rawViews_blogs
  • Taxa de rejeição de blogs

    Porcentagem de visitantes que acessaram uma única página do site da sua empresa e saíram sem continuar navegando.

    hubspot_marketing:pageBounceRate_blogs
  • Sessões do site

    Número de sessões ocorridas no período analisado. Uma sessão é uma série de atividades analíticas executadas por um visitante em seu site. As atividades podem incluir exibições de página, cliques em CTA, eventos etc. Uma sessão expira após 30 minutos de inatividade.

    hubspot_marketing:rawViews_sites
  • Visualizações de página/sessão

    Número médio de visualizações de página por sessão durante o período analisado.

    hubspot_marketing:page_sessions_views_sites
  • Novas sessões %

    Porcentagem de novas sessões de usuários durante o período analisado.

    hubspot_marketing:new_sessions_rate_sites
  • Duração média da sessão

    Duração média de uma sessão no site por parte do visitante, durante o período analisado.

    hubspot_marketing:time_per_session_sites
  • Taxa de rejeição do site

    Porcentagem de visitantes de um site específico que saem do site depois de visualizar apenas uma página.

    hubspot_marketing:bounce_rate_sites
  • Clientes

    Número de clientes que converteram originalmente em seu site durante o período de análise e estão atualmente no estágio do ciclo de vida do cliente.

    hubspot_marketing:customers_sites
  • Taxa de conversão de clientes

    Porcentagem de usuários que foram convertidos em clientes durante o período analisado. Esta taxa é calculada dividindo o número de clientes pelo número de sessões.

    hubspot_marketing:conversions_customers_sites
  • Taxa de conversão de contato

    Essa taxa é calculada dividindo o número de contatos pelo número de sessões no período analisado.

    hubspot_marketing:conversions_contact_sites
  • Novos visitantes

    Número de novos visitantes únicos em seu site durante o período analisado.

    hubspot_marketing:new_visitors_sites
  • Novos contatos do site

    Número de novos contatos criados durante o período analisado.

    hubspot_marketing:new_contacts_sites

Gráficos

4 métricas

  • Visualizações por dispositivo

    Número de visualizações por sessões do site, agrupada pelo tipo de dispositivo que o visitante utilizou.

    hubspot_marketing:sessions_by_device_chart
  • Tipo de contato

    Número de contatos novos e existentes que enviaram formulário, durante o período analisado.

    hubspot_marketing:contacts_type_chart
  • Sessões ao longo do tempo

    Número de sessões que seu site recebeu ao longo do período de análise.

    hubspot_marketing:sessions_over_time_chart
  • Clientes ao longo do tempo

    Número de usuários que foram convertidos em clientes ao longo do período analisado.

    hubspot_marketing:customers_over_time_chart

Tabelas

8 métricas

  • Emails em destaque

    Resumo do desempenho dos e-mails enviados durante o período de análise.

    hubspot_marketing:emails_datatable
  • Resumo dos formulários

    Resumo de desempenho das formas de período analisadas.

    hubspot_marketing:forms_datatable
  • Postagens em destaque

    Postagens de blog que tiveram mais visualizações durante o período analisado.

    hubspot_marketing:blogs_datatable
  • Envios por fonte

    As visualizações, envios e taxa de conversão pela origem da sessão quando o formulário foi enviado.

    hubspot_marketing:forms_per_origin_datatable_landing
  • Países em destaque

    Esta tabela detalha o tráfego do site pelos países dos seus visitantes

    hubspot_marketing:sites_countries_datatable
  • Parâmetros UTM

    Esta tabela permite analisar os dados de tráfego em termos de parâmetros UTM nas URLs que os visitantes estão usando para acessar seu site. Isso inclui revisar qualquer URL de rastreamento manual que você criou.

    hubspot_marketing:sites_utm_datatable
  • Origem das sessões

    Esta tabela fornece um resumo das principais fontes que trouxeram tráfego para seu site e um resumo da interação dos visitantes em cada uma delas.

    hubspot_marketing:origin_datatable_sites
  • Principais páginas

    Resumo do desempenho da página Hubspot durante o período analisado.

    hubspot_marketing:top_pages_datatable_sites

Veja o Connect aplicado ao seu produto.

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