Compreender os instantâneos de propriedades de objeto para eventos
Ultima atualização: 28 de Agosto de 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
|
|
|
|
|
Eventos são pontos de dados que capturam uma ação ou ocorrência específica em um determinado momento no tempo (por exemplo, envio de formulário, mensagem SMS enviada, exibição de página). Ao contrário de um objeto de registro, que representa o estado atual de um processo ou relacionamento, uma ocorrência de evento representa um ponto no tempo singular. Essa distinção é crucial para analisar a atividade histórica, rastrear alterações ao longo do tempo e identificar tendências.
Tipos de evento
Anúncio
- Interações de anúncios: o horário em que um visitante se envolveu com um anúncio conectado à conta HubSpot. O HubSpot pode capturar interações de anúncios que ocorreram de visitantes anônimos. Nos casos em que um lead se envolve com um anúncio sem visitar o seu site, essas interações ainda podem ser rastreadas como parte do desempenho do anúncio, mas podem não ser categorizadas como uma "Visita" para pontuações de leads .
Chamada
- Chamadas iniciadas: a hora em que o início de uma chamada com um contato começou. Use Chamadas iniciadas para avaliar se um representante fez uma chamada com um contato. Este evento captura uma chamada, seja ela de saída (ou seja, iniciada no registro do contato ou na caixa de entrada de conversas) ou de entrada (ou seja, o usuário ligou e a chamada foi conectada à
- Chamadas encerradas: a hora de término de uma chamada com um contato. Este evento captura uma chamada, seja ela de saída (ou seja, iniciada no registro do contato ou na caixa de entrada de conversas) ou de entrada (ou seja, o usuário ligou e a chamada foi conectada à
Saiba mais sobre como usar chamadas no HubSpot.
Campanhas
-
ID da campanha: preenche com a campanha à qual a interação está associada.
- Influências da campanha de marketing: contatos que envolveram ativos relacionados a uma campanha.
Saiba mais sobre como usar campanhas no HubSpot.
CTAs
- visualizações: a hora em que um visitante ou contato visualizou um O HubSpot pode rastrear
- Cliques CTA: o horário em que um visitante ou contato clicou em um O HubSpot pode rastrear os cliques do CTA, independentemente de a pessoa ser ou não um contato em sua conta do HubSpot (ou seja, visitantes anônimos).
Saiba mais sobre como usar CTAs no HubSpot.
Negócios
- Fase do negócio: preenche os dados da fase do negócio a partir de qualquer um de seus pipelines.
Documentos
-
Contatos concluíram a exibição do documentos: a hora em que um contato concluiu a exibição de um documento.
- Contatos exibiram documentos: a hora em que um contato começou a exibir um documento.
-
Documentos compartilhado com contatos: a hora em que um usuário do HubSpot compartilhou um documento com um contato. Este evento é rastreado quando um documento é enviado para um contato por meio de um e-mail ou sequência onde a caixa de entrada do usuário está conectada ao HubSpot.
Observação: o recurso de controle de email doHubSpot não permite que você veja quem encaminhou um documento a endereços de email desconhecidos se eles ainda não estiverem rastreados ou conectados ao sistema. No entanto, você pode obter mais informações sobre quem está visualizando seu documentos exigindo um e-mail para exibir um documento.
Saiba mais sobre como usar documentos no HubSpot.
Eventos de marketing
Formulários
- Modo Formulário: a hora em que um navegador carregou um formulário em uma tela, o que significa que o visitante rolou e pôde visualizar o formulário. O HubSpot pode capturar modos de exibição de formulário que ocorreram de visitantes anônimos
- Interação de formulário: a hora em que um visitante começou a preencher um formulário. Este evento é capturado quando alguém clica no formulário e começa a preenchê-lo. O HubSpot é capaz de capturar interações de formulários de visitantes anônimos.
- Exibição pop-up de formulário: a hora em que o navegador de um visitante carregou um formulário pop-up em sua tela. Isso é específico para formulários pop-up e acontece quando o código de rastreamento da HubSpot registra que o navegador do usuário carregou o formulário. O HubSpot pode capturar exibições de formulários pop-up que ocorreram de visitantes anônimos.
- Envio de formulário: a hora em que alguém submeteu um formulário com êxito. Os envios de formulários exigem que um usuário forneça seu endereço de e-mail. Portanto, este evento não precisa ter a opção ‘incluir visitantes anônimos’ marcada para ver todos os envios de formulários em um relatório de jornada.
Saiba mais sobre como usar formulários no HubSpot.
E-mails de marketing
- Links clicados no email: a hora em que um contato clicou em um link em um email de marketing.
- Ee-mails devolvidos: a hora em que um e-mail enviado a um contato foi devolvido.
- Emails entregues: a hora em que um email enviado a um contato foi entregue com êxito.
- Emails abertos: a hora em que um contato abriu um email de marketing.
- Spam reportado: a hora em que um contato marcou um e-mail como spam.
- Status de assinatura de email atualizado: a hora em que um contato atualizou seu status de assinatura de email.
- evento de marketing assistido: a data e a hora em que um contato participou de um evento de marketing.
- Aevento de marketing cancelado: a hora em que um contato cancelou seu registro para um convite de evento de marketing.
- Registrado para evento de marketing: a hora em que um contato se registrou para participar de um próximo evento de marketing.
Saiba mais sobre eventos de marketing no HubSpot.
Reuniões
- Reuniões reservadas: a hora em que um contato deve participar de uma reunião. Isso pode acontecer quando um contato faz o registro através de um link de reunião HubSpot ou quando um usuário do HubSpot programa uma reunião com um contato diretamente do registro .
- Alterações no resultado da reunião: a hora em que o resultado da reunião de um contato foi alterado ou definido. No registro de contato, os usuários da HubSpot podem definir o resultado da reunião. Por exemplo, o resultado da reunião poderia ser Agendado, Concluído, No show, etc. Este evento rastreia quando o valor foi definido.
Mensagens
- Entregas de mensagens de saída: a hora em que uma mensagem do WhatsApp foi entregue a um contato.
- Falhas de mensagens de saída: a hora em que uma mensagem do WhatsApp não foi entregue a um contato.
- Mensagem de saída abre: a hora em que um contato abriu uma mensagem do WhatsApp.
- Envio de mensagens: a hora em que uma mensagem do WhatsApp foi enviada para um contato.
Saiba mais sobre como usar o WhatsApp no HubSpot.
Pagamentos
- Falha no pagamento: a hora em que o pagamento recorrente por cartão ou transferência bancária de um contato falhou ao ser processado.
- Pagamento iniciado: a hora em que um pagamento de transferência bancária do contato foi iniciado.
- Falha no reembolso do pagamento: a hora em que o reembolso do pagamento de um contato não foi concluído.
- Reembolso de pagamento iniciado: a hora em que o reembolso de pagamento de um contato começou.
- Reembolso de pagamento bem-sucedido: a hora em que o reembolso de pagamento de um contato foi concluído.
- Pagamento bem-sucedido: a hora em que o pagamento de um contato foi processado com êxito.
Saiba mais sobre como usar o pagamentos no HubSpot.
E-mail de vendas
- Cliques em e-mail de vendas: a hora em que um contato clicou em um link em um e-mail individual.
- O e-mail de vendas é aberto: o horário em que um contato abriu um e-mail individual.
- Respostas por e-mail de vendas: o horário em que um contato respondeu a um e-mail individual.
- E-mail de vendas enviado: a hora em que um e-mail individual foi enviado a um contato.
Saiba mais sobre o envio de emails um-para-um no HubSpot.
Sequências
- Contatos de reuniões reservadas através de uma sequências: a hora em que um contato reservou uma reunião através de uma sequências.
- Contatos registrados em uma sequências: a hora em que um usuário do HubSpot registrou uma
- Contatos não inscritos em uma sequências:o horário em que um contato não está mais inscrito em uma sequências. Isso pode acontecer porque o contato reservou uma reunião através da sequências, respondeu a um e-mail na sequências, cancelou a inscrição da sequências, ou a sequências chegou ao fim.
- Contatos cancelados manualmente da sequências: a hora em que um usuário do HubSpot cancelou manualmente o registro de um contato de uma sequências.
- E-mail de cancelamento de assinatura de contatos da sequências: o horário em que um contato cancelou a inscrição em um email individual enquanto estava inscrito em uma sequências.
- E-mails de Sequências devolvidos: a hora em que um e-mail enviado a um contato foi devolvido.
- Sequenciaretapas ce executadas: a hora em que uma etapa foi executada em uma sequências.
- Sequências com erro: a hora em que ocorreu um erro em uma sequências.
- Sequências terminada: a hora em que um contato atingiu a etapa final de uma sequências.
Saiba mais sobre como usar sequências no HubSpot.
SMS
- Link em mensagens curtas clicadas: o horário em que um contato clicou em uma mensagem em uma mensagem SMS.
- Mensagens curtas entregues: a hora em que uma mensagem SMS foi entregue a um contato.
- Mensagens curtas descartadas: a hora em que uma mensagem SMS foi entregue a um contato, mas foi descartada.
- Falhas em mensagens curtas: a hora em que uma mensagem SMS não foi entregue a um contato.
- Mensagem curta enviada: a hora em que uma mensagem SMS foi enviada a um contato.
Saiba mais sobre como usar mensagens SMS no HubSpot.
Páginas da web
- Páginas visitadas: o horário em que um visitante visualizou uma página que foi rastreada pelo códigode rastreamento HubSpot. O HubSpot é capaz de capturar visitas de páginas e interações que aconteceram de usuários que ainda não se converteram em um contato no seu HubSpot.
Quais propriedades de objeto são adicionadas automaticamente aos meus eventos?
O HubSpot captura e preserva automaticamente a Principal Empresa Associada e Fases do ciclo de vida para todos os eventos de contato padrão rastreados em sua conta (por exemplo, envio de formulários, abertura de e-mail, início de chamadas, alterações de fases do negócio). Em vez de ver apenas os valores de propriedade atuais ao analisar eventos passados, agora você pode obter instantâneos do que as empresas e as fases do ciclo de vida de um contato eram quando cada evento ocorreu.
Por exemplo, quando alguém envia um formulário, o sistema registra o evento de envio de formulário, bem como a que empresa eles estavam associados e em que fase do ciclo de vida eles estavam naquele exato momento. Esse contexto histórico é marcado permanentemente em todos os eventos HubSpot.
Observe que a coleta de dados para essas propriedades começa em 27 de agosto de 2025. Os dados não estão disponíveis retroativamente para a Empresa primária associada.
Adicionar propriedades de instantâneo a eventos personalizados
Ao criar eventos personalizados usando a API, você tem a opção de enriquecer seu evento com suas próprias propriedades de objeto para capturar dados históricos quando ocorrem eventos personalizados. Quando você adiciona propriedades de instantâneo a eventos existentes, os dados são preenchidos somente a partir do momento em que a propriedade é adicionada.
Para adicionar propriedades de instantâneo a eventos personalizados:
- Na sua conta HubSpot, navegue até Gestão de dados >Event Management.
- Selecione um evento de API existente ou clique em Criar um evento no canto superior direito.
- Clique em Rastrear alterações no objeto .
- Na lista suspensa objeto , selecione uma opção. Em seguida, na lista suspensa propriedades de Objeto , selecione uma opção.
- Clique em Avançar e continue criando seu evento.
- Clique em Concluído.
Onde você pode usar essas propriedades?
Ao criar qualquer tipo de relatório com os tipos de evento, você terá a opção de selecionar a opção de selecionar a opção de empresa associada principal.