- Central de conhecimento
- Relatórios e dados
- Relatórios
- Compreender os eventos de assinatura de comunicação no construtor de relatórios personalizados
Compreender os eventos de assinatura de comunicação no construtor de relatórios personalizados
Ultima atualização: 26 de Maio de 2026
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
-
Marketing Hub
Professional, Enterprise
O HubSpot rastreia dois eventos de assinatura de comunicação que você pode usar no construtor de relatórios personalizados para analisar como as preferências de assinatura e consentimento dos contatos mudam ao longo do tempo.
Cada evento registra uma alteração pontual, portanto, um contato que cancela a assinatura por meio de uma página de preferências e depois é cancelado por meio de um fluxo de trabalho terá dois eventos separados, um para cada ação.
Caso de uso: Análise de causa raiz de atrito de assinantes e auditoria de fadiga de canal
O problema
Durante uma revisão trimestral de desempenho, uma organização vê um aumento acentuado no atrito e nas recusas de banco de dados, mas não tem os dados de atribuição para identificar o motivo.
A equipe não sabe dizer se a taxa de cancelamento de clientes se deve a um baixo ajuste do conteúdo do público, problemas de fluxo de trabalho ou fadiga de canal de mídias de alto contato, como SMS. Essa visibilidade limitada bloqueia os esforços de retenção direcionados e as correções do sistema, colocando em risco a receita de longo prazo e a geração de leads.
A solução
Usando o rastreamento de eventos point-in-time, um gerente de operações de marketing pode criar um relatório personalizado para diagnosticar a origem técnica ou estratégica precisa da perda de público.
Em vez de depender de registros de contatos estáticos e substituídos, este relatório captura a trajetória histórica de não adesões, fornecendo uma linha do tempo auditável de como e por que as preferências mudaram.
Criar relatórios a partir de modelos de assinatura de comunicação
Os modelos de relatório disponíveis incluem:
- Atividade da assinatura de comunicação por mês
- Atividade de consentimento de comunicação nos últimos 6 meses
- Atividade de assinatura de comunicação por fonte ao longo do último ano
- Atividade de assinatura de comunicação nos últimos 6 meses
Para criar relatórios a partir desses modelos:
- Na sua conta da HubSpot, navegue até Relatórios > Relatórios.
- Na parte superior direita, clique em Criar. Em seguida, selecione Criar relatório.
- No menu da barra lateral esquerda, clique em Biblioteca de relatórios de modelos. Em seguida, clique em Próximo.
- No menu da barra lateral esquerda, clique no menu suspenso Fontes de dados e selecione Assinaturas de comunicação.
- Selecione um dos modelos disponíveis e continue personalizando as configurações do seu relatório. As configurações podem variar por relatório.
- Quando terminar de personalizar o relatório, clique em Salvar relatório. O relatório estará agora disponível para visualização na sua biblioteca de relatórios.
Compreender os tipos de eventos e os valores de origem
Abaixo, saiba mais sobre o que cada tipo de evento e propriedade de valor de origem representa:
Evento 1: Atualização do status da assinatura de comunicação
Este evento dispara quando o status da assinatura de um contato muda para um tipo de assinatura específico (por exemplo, "Informações de marketing").
| Propriedade | O que isso representa |
| Tipo de assinatura (hs_subscription) | A categoria de conteúdo que o contato assinou ou cancelou a assinatura (por exemplo, newsletter, atualizações de produtos). |
| Status da assinatura (hs_subscription_status) | O status da assinatura do contato: Inscrito (OPT_IN), Cancelado (OPT_OUT) ou Não especificado (NOT_OPTED). |
| Fonte (hs_source) | De onde veio a atualização da assinatura. Consulte a tabela de valores de origem abaixo. |
| Marca (hs_business_unit_id) | As marcas associadas a essa assinatura no momento da atualização. |
| Endereço de e-mail (hs_subscriber_email_address) | O endereço de e-mail associado à atualização de assinatura. |
| Número de telefone (hs_subscriber_phone_number) | O número de telefone associado à atualização da assinatura. |
| Usuário (hs_user) | O usuário da HubSpot que alterou o status da assinatura (se aplicável). |
| Fluxo de trabalho (hs_workflow_id) | O fluxo de trabalho que disparou esse evento (se a fonte for Fluxo de trabalho). |
| Nome do e-mail (hs_email_id) | O e-mail específico que levou à atualização da assinatura (se aplicável). |
| Formulário (hs_form_id) | O formulário associado à atualização da assinatura (se aplicável). |
| Importação (hs_import_id) | A importação que atualizou o status da assinatura do contato (se aplicável). |
Evento 2: Consentimento do canal de comunicação atualizado
Este evento dispara quando o consentimento de um contato para receber comunicações em um canal específico (e-mail, SMS ou WhatsApp) é atualizado.
| Propriedade | O que isso representa |
| Tipo de assinatura (hs_subscription) | O canal de comunicação: e-mail, WhatsApp ou SMS. |
| Status da assinatura (hs_subscription_status) | O status de consentimento de do contato. Atualmente, apenas Assinatura cancelada (OPT_OUT) é rastreado. |
| Fonte (hs_source) | De onde veio a atualização de consentimento. Consulte a tabela de valores de origem abaixo. |
| Marca (hs_business_unit_id) | A marca à qual este status de consentimento se aplica. |
| Endereço de e-mail (hs_subscriber_email_address) | O endereço de e-mail associado à atualização de consentimento. |
| Número de telefone (hs_subscriber_phone_number) | O número de telefone associado à atualização de consentimento. |
| Usuário (hs_user) | O usuário do HubSpot que alterou o consentimento (se aplicável). |
| Fluxo de trabalho (hs_workflow_id) | O fluxo de trabalho que disparou esse evento (se a fonte for Fluxo de trabalho). |
| Nome do e-mail (hs_email_id) | O e-mail específico que levou à atualização do consentimento (se aplicável). |
| Formulário (hs_form_id) | O formulário associado à atualização de consentimento (se aplicável). |
| Importação (hs_import_id) | A importação que atualizou o status de consentimento do contato (se aplicável). |
Valores da fonte do evento
Ambos os eventos compartilham os mesmos valores de propriedade Source. Veja o que cada um significa:
| Valor |
Rótulo |
Descrição |
| BULK_UPDATE |
Atualização de assinatura em massa |
Uma ação em massa foi usada para atualizar o status da assinatura para vários contatos de uma só vez. |
| FLUXO DE TRABALHO |
Fluxo de trabalho |
Uma ação do fluxo de trabalho do HubSpot alterou o status de assinatura ou consentimento. |
| EXTERNAL_API |
API externa |
Uma atualização foi feita por meio da API do HubSpot por uma integração externa. |
| LIST_UNSUBSCRIBE |
Cancelar assinatura da lista |
O contato cancelou a assinatura por meio de um cabeçalho de cancelamento de assinatura em nível de lista em um e-mail. |
| PREFERENCE_PAGE |
Página de preferências |
O contato atualizou suas preferências por meio da página de preferências de assinatura de e-mail. |
| ONE_CLICK_UNSUBSCRIBE |
Cancelar assinatura com um clique |
O contato usou o mecanismo de cancelamento de assinatura com um clique no cabeçalho do e-mail. |
| FORM_SUBMISSION |
Envio de formulário: |
A alteração de assinatura ocorreu como resultado do envio de formulário. |
| CONTACT_RECORD |
Registro do contato |
Um usuário do HubSpot atualizou manualmente a assinatura a partir do registro do contato no CRM. |
| LEGADO |
Sistemas legados |
A atualização veio de um sistema antigo da HubSpot. |
| DATA_SYNC |
Sincronização de dados |
A atualização foi aplicada por meio de uma integração de sincronização de dados (como Salesforce). |
| IMPORTAÇÃO |
Importar |
O status da assinatura foi alterado por meio de uma importação de arquivo. |
| HUBSPOT_MIGRATION |
Migração iniciada pela HubSpot |
A atualização ocorreu como parte de uma migração de dados iniciada pela HubSpot. |
| SPAM_REPORT |
Relatório de spam |
O contato denunciou um e-mail como spam, o que desencadeou um cancelamento automático da assinatura. |
| CONVERSA |
Conversa |
A atualização foi feita por meio de uma ação de conversas/caixa de entrada do HubSpot. |
| NÃO RECONHECIDO |
Fonte não suportada |
Não foi possível identificar a origem da atualização ou não é um tipo de fonte compatível. |
Considerações importantes
Antes de criar relatórios com eventos de comunicação, revise estes principais comportamentos técnicos e distinções estruturais:
- Registro histórico imutável: Cada alteração no status de uma assinatura ou consentimento de canal gera um evento único e independente. O HubSpot nunca atualiza ou substitui eventos existentes. Se um contato modificar suas preferências várias vezes ou por meio de diferentes fontes operacionais, cada ação distinta produzirá seu próprio registro de evento, preservando uma trilha de auditoria histórica impecável.
- Arquitetura centrada no contato: esses eventos de rastreamento são centrados no contato e estão diretamente vinculados ao registro do contato individual.
- Tipos de assinatura vs. canais: ao configurar seus relatórios personalizados, observe a distinção entre estas duas propriedades principais:
- Tipo de assinatura (evento de status): representa categorias específicas de conteúdo que sua organização distribui (por exemplo, "Informações de marketing", "Atualizações de produtos").
- Canal (evento de consentimento): Representa o próprio meio de comunicação (por exemplo, e-mail, SMS, WhatsApp).
Conteúdo relacionado
Conteúdo relacionado
