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"
]
}
]
}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_emailsEmails entregues
O número de emails entregues com sucesso em uma caixa de entrada, durante o período de análise
hubspot_marketing:delivered_emailsCliques 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_emailsAberturas Únicas
O número total de aberturas exclusivas durante o período de análise
hubspot_marketing:open_emailsHard 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_emailsRelató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_emailsAssinaturas 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_emailsTaxa 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_emailsTaxa de relatórios de spam
Porcentagem de e-mails marcados como spam entre os que foram entregues aos destinatários.
hubspot_marketing:spamreportratio_emailsTaxa 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_emailsTaxa 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_emailsTaxa de entrega
Porcentagem de e-mails entregues aos destinatários em comparação com a quantidade de e-mails enviados.
hubspot_marketing:deliveredratio_emailsTaxa 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_emailsTaxa 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_emailsEntrada
Número total de pessoas que iniciaram o preenchimento do formulário na página durante o período analisado.
hubspot_marketing:entrances_landing_pagesSaí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_pagesVisualizaçõ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_pagesTaxa 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_pagesTotal de envios
Número total de envios de formulários durante os períodos de duração.
hubspot_marketing:submissions_landing_pagesNovos contatos
Número de novos leads captados pela página de destino durante o período de análise.
hubspot_marketing:contacts_landing_pagesTempo 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_pagesMé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_pagesExibiçõ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_pagesTaxa 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_pagesVisualizações do blog
Número de visualizações que seu blog obteve no período analisado.
hubspot_marketing:rawViews_blogsTaxa 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_blogsSessõ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_sitesVisualizaçõ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_sitesNovas sessões %
Porcentagem de novas sessões de usuários durante o período analisado.
hubspot_marketing:new_sessions_rate_sitesDuraçã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_sitesTaxa 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_sitesClientes
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_sitesTaxa 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_sitesTaxa 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_sitesNovos visitantes
Número de novos visitantes únicos em seu site durante o período analisado.
hubspot_marketing:new_visitors_sitesNovos 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_chartTipo de contato
Número de contatos novos e existentes que enviaram formulário, durante o período analisado.
hubspot_marketing:contacts_type_chartSessõ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_chartClientes 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_datatableResumo dos formulários
Resumo de desempenho das formas de período analisadas.
hubspot_marketing:forms_datatablePostagens em destaque
Postagens de blog que tiveram mais visualizações durante o período analisado.
hubspot_marketing:blogs_datatableEnvios 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_landingPaíses em destaque
Esta tabela detalha o tráfego do site pelos países dos seus visitantes
hubspot_marketing:sites_countries_datatableParâ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_datatableOrigem 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_sitesPrincipais 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.
