Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.
Analytics Tools

Criar eventos comportamentais personalizados com o assistente de código (BETA)

Ultima atualização: Julho 19, 2022

Disponível para

Marketing Hub Enterprise

Os eventos comportamentais personalizados permitem que você defina e acompanhe eventos que são exclusivos para sua empresa. Os eventos comportamentais personalizados podem ser vinculados às propriedades do evento, os quais você pode usar nas ferramentas do HubSpot. Os eventos criados com o "snippet de código Javascript adicionam automaticamente os dados do evento ao código de rastreamento HubSpot do seu site e exigem que alguém familiarizado com o Javascript configure. Os eventos rastreados manualmente usam a API de análise e exigem um desenvolvedor para serem configurados. 

Saiba como usar a ferramenta de evento de comportamento personalizado para criar eventos de elemento clicados e eventos de URL visitados.

Observação: a ferramenta de eventos de comportamentos personalizados substitui a ferramenta anterior de eventos de comportamentos antigos. Qualquer evento criado na ferramenta antiga continuará a funcionar e você ainda pode gerenciar e analisar esses eventos na ferramenta antiga

O processo de criação de eventos envolve duas partes:

  • Definição do evento no HubSpot, incluindo quaisquer propriedades de eventos personalizados.
  • Criando um snippet de código Javascript ou definindo a chamada de API que ativará o evento. 

Criar o evento no HubSpot

Para configurar um evento de comportamentos personalizado, primeiro crie o evento e associe as propriedades com o evento:

  • Na sua conta da HubSpot, navegue até Relatórios > Ferramentas de análise.
  • Clique em Personalizar Eventos de Comportamento.
  • No canto superior direito, clique em Criar evento personalizado.
  • Selecione Assistente de código.

  • Insira um Nome  de evento e, opcionalmente, forneça a descrição do evento
  • No menu suspenso, selecione seu objeto Associado. Isso permite associar as conclusões do seu evento a diferentes objetos no HubSpot, incluindo Contatos, Empresas, Negócios e Tíquetes

evento nominativo-personalizado-comportamental

  • Clique em Avançar para prosseguir.

Adicionar propriedades do evento

Quando um evento é criado, as propriedades de evento padrão estarão disponíveis. Você também pode criar suas próprias propriedades personalizadas. As propriedades do evento são armazenadas separadamente de outras propriedades do CRM e são exclusivas para o evento (ou seja, não é possível editar essas propriedades das configurações da conta). 

Para criar propriedades para um evento:

  • Selecione o tipo de propriedade clicando no tipo de campo da sua propriedade. As opções incluem: 
    • Propriedade de cadeia de caracteres personalizada: crie uma propriedade que seja uma cadeia de caracteres de texto simples. 
    • Propriedade de número personalizado: crie uma propriedade que seja um valor de número.
    • Propriedade de carimbo de data e hora personalizado: crie uma propriedade que seja um valor de data. Você deve enviar seus dados na forma de milissegundos da época. 
    • Propriedade de enumeração personalizada: crie uma propriedade com um conjunto de valores predefinidos.

      criar-propriedade-personalizado-evento-comportamental
    • Quando tiver seleccionado a sua propriedade, configure-a no painel direito:

    • Insira um nome para a propriedade e insira uma Descrição para a propriedade.
    • Para propriedades de enumeração, clique em Avançar e insira suas propriedades Rótulos e valores. Você deve definir seus valores e rótulos antes de enviar dados para eles. Se esta etapa não for concluída antes de enviar dados que não estão na lista, os dados não estarão disponíveis para uso. Para enviar vários valores, separe-os com um ponto e vírgula.
    • Clique em Concluído.
    • Assim que sua propriedade for criada, ela aparecerá na tabela sob as propriedades de evento padrão do HubSpot. Você pode editar ou excluir sua propriedade selecionando o menu suspenso Ações e selecionando Editar ou Excluir
  • Clique em Próximo.
  • Depois de configurar o evento e suas propriedades, você pode adicionar esse evento ao código de acompanhamento do seu site selecionando o snippet de código Javascript ou enviar dados para o HubSpot via API selecionando Enviar dados para o HubSpot

Criar um snippet de código Javascript

Criar eventos com um snippet de código Javascript permite adicionar Javascript ao código de rastreamento da HubSpot automaticamente. Isso pode ser usado para capturar dados de eventos mais complexos que o código de rastreamento não captura por padrão. 

  • Selecione o trecho do código Javascript. Use o trecho no painel direito para acompanhar o evento no HubSpot. Quaisquer propriedades personalizadas criadas serão predefinidas dentro do snippet de código. 
  • Modifique o snippet conforme necessário inserindo texto no painel direito. Qualquer código que você adicionar será incluído automaticamente como parte do seu código de rastreamento da HubSpot.
  • Quando terminar, clique em Criar para terminar seu evento e iniciar o rastreamento automaticamente. 
    exemplo-code-snippet-custom-event

Enviar dados para o HubSpot

Se você estiver enviando dados para o HubSpot, precisará definir a chamada de API para disparar o evento. Saiba como definir sua chamada de API na documentação de desenvolvedor do HubSpot.

Você precisará de algumas informações para sua chamada de API, que pode obter de dentro do HubSpot:

  • Nome do evento: o nome interno do evento. 
  • Nomes de propriedade: os nomes internos das propriedades para as quais você envia dados.

Para finalizar a criação do seu evento para enviar dados via API:

  • Selecione Enviar dados para o HubSpot e copie o ID de rastreamento.
  • Clique em Criar.

Para encontrar o nome do evento interno para um evento existente e nome de propriedade:

  • Na sua conta da HubSpot, navegue até Relatórios > Ferramentas de análise.
  • Clique em Personalizar Eventos de Comportamento.
  • Clique no nome do evento. Você será encaminhado à página de detalhes do evento.
  • No canto superior, localize o nome do evento em Nome interno.
    evento-custom-nome-interno
  • Para encontrar os nomes internos das propriedades que você vai atualizar, clique no nome de uma propriedade.
  • No painel direito, clique no ícone de código e veja o nome em Nome interno.
Observação:
ao enviar dados para o seu evento, os limites abaixo se aplicam:
  • Os nomes das propriedades são limitados a 50 caracteres. 
  • Propriedades de URL e de referência podem ter até 1024 caracteres, enquanto todas as outras propriedades podem ter até 256 caracteres.
  • Cada conclusão de evento pode conter dados para até 50 propriedades.
  • Os nomes internos da propriedade devem começar com uma letra e conter apenas letras minúsculas de a-z, números de 0-9 e sublinhados. As propriedades com o mesmo nome interno após minúsculas serão consideradas duplicatas e apenas uma delas será usada na conclusão.
Se esses limites forem excedidos ao fazer uma solicitação de API de HTTP, ocorrerá uma erro na solicitação. Se esses limites forem excedidos ao fazer uma solicitação de API JS, o HubSpot truncará quaisquer valores de nome de propriedade para o comprimento permitido e/ou atualizará apenas 50 propriedades por conclusão de evento.

Use dados de eventos comportamentais personalizados

Os dados do evento de comportamentos personalizados podem ser visualizados e usados nas ferramentas da HubSpot. Abaixo, saiba onde visualizar as conclusões do evento e as maneiras de incorporar que os dados em outras ferramentas.

Relatório sobre eventos personalizados

As conclusões personalizadas de eventos de comportamentos podem ser analisadas na ferramenta de eventos de comportamentos personalizados e os dados de evento também estarão disponíveis no criador de relatórios personalizados e nos relatórios de atribuição.

Saiba mais sobre como analisar eventos comportamentais personalizados.

Exibir conclusões de evento na linha do tempo do contato

As conclusões de evento aparecerão na linha do tempo do registro do contato, juntamente com quaisquer propriedades que foram preenchidas.

Para exibir detalhes do evento na linha de tempo do contato:

  • Vá até um registro de contato que concluiu um evento de comportamentos personalizado.
  • Para filtrar uma linha do tempo de contato por eventos concluídos, clique em Filtrar atividade e selecione Evento de comportamentos personalizado.
  • Na linha do tempo do contato, clique para expandir o evento para exibir os detalhes do evento.

Use eventos de comportamentos personalizados em fluxos de trabalho

Em um fluxo de trabalho, você pode atrasar com base nas conclusões de eventos comportamentais personalizados usando uma ação Atrasar até que o evento aconteça:

  • Na sua conta da HubSpot, navegue até Automação > Fluxos de trabalho.
  • Clique no nome de um fluxo de trabalho. Ou, saiba como criar um novo fluxo de trabalho.
  • No editor de fluxo de trabalho, clique no + ícone de adição para adicionar uma ação de fluxo de trabalho.
  • No painel direito, selecione Atraso até o evento acontecer.
  • Configurar o atraso:
    • Clique no menu suspenso Evento e selecione um evento de comportamentos personalizado.
    • Em seguida, selecione a propriedade de evento que você deseja atrasar.
    • Selecione o filtro para a propriedade de evento.
    • Clique em Aplicar filtro.
    • Selecione o tempo máximo de espera ou selecione a caixa de seleção Atrasar o máximo possível.
  • Clique em Salvar.

O fluxo de trabalho vai atrasar os registros inscritos até que eles cumpram os critérios de eventos personalizados especificados. 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.