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.

Criar eventos comportamentais personalizados com o assistente de código

Ultima atualização: Março 30, 2023

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Marketing Hub Enterprise

Os eventos comportamentais personalizados permitem-lhe definir e acompanhar eventos que são únicos para o seu negócio. 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 "código Javascript snippet adicionam automaticamente dados de eventos ao código de rastreio do seu sítio HubSpot e requerem a instalação de alguém familiarizado com Javascript. Os eventos controlados manualmente utilizam o aPI analítica e exigir que um promotor se instale. 

Aprenda a utilizar a ferramenta de eventos comportamentais personalizados para criar eventos com elementos clicados e eventos 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.
  • Criação de um Snippet de Código Javascript ou Definindo a chamada API que irá desencadear 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, clicar em Criar evento personalizado.
  • Seleccionar o Assistente de Código.

  • Introduza o nome de um evento e, opcionalmente, forneça a descrição do seu evento
  • No menu suspenso, seleccione o seu objecto associado. Isto permite-lhe associar a conclusão do seu evento a diferentes objectos no HubSpot, incluindo Contactos, Empresas, Concursos e Bilhetes

evento nome-customo-comportamental

  • Clique em Next para continuar.

Adicionar propriedades do evento

Quando um evento é criado, as propriedades padrão do evento estarão disponíveis. Também pode criar as 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:

  • Seleccione o tipo de propriedade clicando no Tipo de campo para o seu imóvel. As opções incluem: 
    • Propriedade de cadeia personalizada: criar uma propriedade que seja uma cadeia de texto simples. 
    • Propriedade de número personalizado: criar uma propriedade que é um valor numérico.
    • Propriedade de carimbo temporal personalizado: criar uma propriedade que é um valor de data. Deve enviar os seus dados sob a forma de milissegundos de época. 
    • Propriedade de enumeração personalizada: criar uma propriedade com um conjunto de valores pré-definidos.

      criar-propriedade-custódia-comportamento-evento
    • Quando tiver seleccionado o seu imóvel, configure o imóvel no painel direito:

    • Introduza um nome para o imóvel e introduza uma Descrição para o imóvel.
    • Para propriedades de Enumeração, clique em Seguinte e introduza os Rótulos e Valoresda sua propriedade. Deve definir os seus valores e etiquetas antes de lhes enviar os dados. Se esta etapa não for concluída antes do envio de dados que não constem da lista, os dados não estarão disponíveis para utilização. Para enviar múltiplos valores, separá-los com um ponto e vírgula.
    • Clique em Concluído.
    • Uma vez criado o seu imóvel, este aparecerá na tabela sob as propriedades de eventos por defeito do HubSpot. Pode editar ou apagar o seu imóvel, seleccionando o menu suspenso Acções e seleccionando Editar ou Apagar
  • Clique em Próximo.
  • Depois de configurar o evento e as suas propriedades, pode adicionar este evento ao código de rastreio do seu website, seleccionando o código Javascript snippet, ou enviar dados para o HubSpot via API, seleccionando Enviar dados para o HubSpot

Criar um snippet de código Javascript

A criação de eventos com um trecho de código Javascript permite-lhe adicionar automaticamente o código de localização Javascript ao seu HubSpot. Isto pode ser utilizado para a captura de dados de eventos mais complexos que o código de rastreio não captura por defeito. 

  • Seleccionar trecho de código Javascript. Use o snippet no painel direito para localizar o evento no HubSpot. Quaisquer propriedades personalizadas criadas serão pré-definidas dentro do código snippet. 
  • Modificar o trecho conforme necessário, introduzindo o texto dentro do painel direito. Qualquer código que acrescente será automaticamente incluído como parte do seu código de localização do HubSpot.
  • Quando terminar, clique em Criar para terminar o seu evento e começar automaticamente a rastrear.
    exemplo-código-código-nippet-custom-evento

Enviar dados para o HubSpot

Se estiver a enviar dados para o HubSpot, terá de definir a chamada API para desencadear o evento. Saiba como definir a sua chamada API em Documentação do 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 terminar de criar o seu evento para enviar dados via API:

  • Seleccione Enviar dados para o HubSpot e copie o ID de localização.
  • Clique em Criar.

Encontrar o nome de um evento interno para um evento existente e nomes de propriedade:

  • Na sua conta da HubSpot, navegue até Relatórios > Ferramentas de análise.
  • Clique em Personalizar eventos comportamentais.
  • Clique no nome do evento. Você será encaminhado à página de detalhes do evento.
  • No topo, localizar o nome do evento sob Nome interno.
    evento interno - nome-custom-event
  • Para encontrar os nomes internos dos imóveis que vai actualizar, clique no nome de um imóvel.
  • No painel direito, clicar no ícone de código, depois ver o nome sob Nome interno.
Atenção:
Ao enviar dados para o seu evento, aplicam-se os limites abaixo indicados:
  • Os nomes dos bens 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 estes limites forem excedidos ao fazer um pedido JS API, o HubSpot truncará qualquer valor de nome de propriedade ao comprimento permitido e/ou actualizará 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 analisando os seus 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:

  • Navegar para um registo de contacto que tenha completado um evento comportamental personalizado.
  • Para filtrar uma linha temporal de contacto por eventos concluídos, clicar em Filtrar actividade, depois seleccionar Evento comportamental personalizado.
  • Na linha temporal de contacto, clicar para expandir o evento para exibir os detalhes do evento.

Use eventos de comportamentos personalizados em fluxos de trabalho

Num fluxo de trabalho, pode atrasar com base na conclusão de eventos comportamentais personalizados usando um Atraso até o evento acontecer acção:

  • Na sua conta da HubSpot, navegue até Automação > Fluxos de trabalho.
  • Clique no nome de um fluxo de trabalho. Ou, aprender a criar um novo fluxo de trabalho.
  • No editor de fluxo de trabalho, clique no ícone ++ para adicionar uma acção de fluxo de trabalho.
  • No painel direito, seleccionar Atraso até que o evento aconteça.
  • 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.
    • Seleccionar o filtro para a propriedade do 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. 

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.