Central de conhecimento HubSpot

Criar manualmente eventos comportamentais personalizados e rastreados

Written by HubSpot Support | 28/set/2018 5:45:55

Os eventos personalizados rastreados manualmente 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 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.
  • Definição da chamada de API que disparará 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:

  • Clique em Personalizar Eventos de Comportamento.
  • No canto superior direito, clique em Criar evento.
  • No painel direito, insira um nome para seu evento e selecione Evento rastreado manualmente.
     
  • O evento será criado e poderá copiar o nome interno, que será usado ao fazer a solicitação de API. Para copiar o nome interno, clique em Copiar.

Em seguida, configure as propriedades que serão usadas na chamada de API.

Adicionar e gerenciar propriedades de evento

Ao criar um evento, um conjunto de propriedades de eventos padrão estará disponível para ser usado. Entretanto, 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 exibir e criar propriedades para um evento:

  • Clique em Personalizar eventos comportamentais.
  • Clique no nome do evento que você deseja visualizar ou atualizar. Você será encaminhado à página de detalhes do evento.
  • Na tabela Propriedades, veja as propriedades padrão criadas para o evento. 
  • Para editar uma propriedade:
    • Clique no nome da propriedade.
    • No painel direito, você pode inserir um novo nome ou descrição. Alterar o nome da propriedade não alterará o nome interno; portanto, você não precisará atualizar sua chamada de API se alterar o nome de uma propriedade.
    • Para alterar o tipo de campo e configurar a propriedade, clique na guia Tipo de campo e use os menus suspensos para selecionar um novo tipo de campo e configurar os detalhes da propriedade. 
    • Clique em Salvar.
  • Para criar uma nova propriedade:
    • No canto superior direito, clique em Criar propriedade.
    • No painel direito, configure a propriedade:
      • Selecione um agrupamento para a propriedade clicando no menu suspenso Grupo e selecionando um grupo.
      • Para definir o nome da propriedade, insira um nome no campo Rótulo. O nome que você insere automaticamente criará o nome interno para a propriedade.
        • Para editar o nome interno, clique no ícone de código code e clique no campo Nome interno para inserir um novo nome. Depois de criar a propriedade, o nome interno não poderá ser atualizado.

          Observação: o rótulo da propriedade e o nome interno são limitados a 50 caracteres.
        • Para salvar o nome, clique em Salvar
      • Opcionalmente, insira uma descrição para a propriedade no campo Descrição.
      • Clique em Próximo.
      • Selecione o tipo de propriedade clicando no menu suspenso Tipo de campo e selecione um tipo de campo. Por padrão, a propriedade estará disponível em formulários e bots. Para evitar que o campo seja usado em formulários e bots, clique para desmarcar a caixa de seleção Mostrar em formulários.
    • Clique em Criar.

Defina a chamada de API

Depois de configurar o evento e suas propriedades, você 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 encontrar o nome do evento interno e nome de propriedade:

  • Clique em Personalizar eventos comportamentais.
  • Clique no nome do evento. Você será encaminhado à página de detalhes do evento.
  • No canto superior, encontre o nome do evento em 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 code e veja o nome em Nome interno.

Observação: ao enviar dados para o seu evento, considere os seguintes limites:

  • O rótulo da propriedade e o nome interno 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 de JS, o HubSpot truncará quaisquer valores de nome da 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:

  • 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.