Criar eventos personalizados

Os eventos personalizados permitem que você defina e acompanhe eventos que são exclusivos para sua empresa. Os eventos personalizados podem ser vinculados a propriedades de evento, as quais você pode usar nas ferramentas da HubSpot. 

Há diferentes maneiras de criar eventos personalizados: 

• Enviar via API: use o ponto de extremidade de definição de evento personalizado para criar seu evento. A partir daí, use seu ID de evento com o ponto de extremidade Enviar evento personalizado para enviar conclusões de eventos para o HubSpot.
• Capturar dados do seu site sem a API:
  • Código Javascript: usando Javascript personalizado, você pode inserir código personalizado no script de rastreamento da HubSpot usando o editor de código.
  • Usar rastreador de eventos (somente Marketing Hub Enterprise): rastreie visualizações de página ou elementos clicados selecionando-os no seu site. Saiba mais sobre como criar eventos personalizados com o Rastreador de eventos.
• Importar planilha: carregue uma planilha de dados de eventos para capturar a atividade offline, os dados de preenchimento ou integre manualmente qualquer ferramenta ao HubSpot.
• Configurar webhooks (somente Operations Hub Professional e Enterprise): personalize as condições que disparam um webhook e os dados que serão enviados. 

Observação: a ferramenta de eventos personalizados substituiu a ferramenta anterior de eventos. 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 Definição da chamada de API que disparará o evento. 

Criar evento via API

Se estiver enviando dados para o HubSpot via API, você precisará usar a opção Enviar via API , ou use o Ponto de extremidade de definição de evento personalizado para criar seu evento. Saiba mais sobre como definir sua chamada de API na documentação para desenvolvedores da 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 concluir a criação do 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 de evento interno para um nome de propriedade e evento existente:

• Na sua conta da HubSpot, navegue até Gerenciamento de dados > Eventos personalizados.
• Clique em Eventos personalizados.
• Clique no nome do evento. Você será encaminhado à página de detalhes do evento.
• Na parte 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 e veja o nome em Nome interno.

Criar eventos com um snippet de código Javascript

• Na sua conta da HubSpot, navegue até Gerenciamento de dados > Eventos personalizados.
• No canto superior direito, clique em Criar um evento.
• Selecione Código Javascript.

• Clique em Próximo.
• Insira o Nome do evento e, opcionalmente, forneça a descrição do evento.
• Selecione um Objeto associado. Isso permite que você associe suas conclusões de eventos a diferentes objetos no HubSpot, incluindo Contatos, Empresas, Negócios e Tickets. 

• Clique em Próximo.

Adicionar propriedades

Quando um evento é criado, as propriedades padrão do evento ficam 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 desativar a criação de propriedades de evento padrão, desative a opção Propriedades de evento padrão.
• Para criar propriedades personalizadas, selecione o tipo de propriedade clicando no botão Tipo de campo para sua propriedade. As opções incluem: 
  • Propriedade de string personalizada: crie uma propriedade que seja uma string de texto sem formatação. 
  • Propriedade de número personalizado: crie uma propriedade que seja um valor numérico.
  • Propriedade de data/hora personalizada: crie uma propriedade que seja um valor de data. Você deve enviar seus dados na forma de milissegundos de época ou ISO8601. 
  • Propriedade de enumeração personalizada: crie uma propriedade com um conjunto de valores predefinidos.
    
    
  • Depois de selecionar sua propriedade, configure-a no painel direito:

• • Insira um nome e uma Descrição para a propriedade.
  • Para Propriedades de enumeração, clique em Próximo e insira os Rótulos e Valores da propriedade.
    • As propriedades de enumeração podem ser de seleção única ou múltipla. Para habilitar valores de seleção múltipla, ative a opção Suporte a vários valores.

• • • Você deve definir os valores e rótulos antes de enviar dados para eles. Se essa etapa não for concluída antes do envio de dados que não estão na lista, eles não ficarão disponíveis para uso. Para enviar vários valores via API, separe-os com ponto e vírgula.

• • Clique em Concluído.
• Clique em Próximo.
• Depois de configurar o evento e suas propriedades, você pode adicionar o evento ao código de rastreamento do seu site selecionando o snippet de código Javascript.

A criação de eventos com um snippet de código Javascript permite que você adicione Javascript ao seu código de rastreamento da HubSpot automaticamente. Isso pode ser usado para capturar dados de evento mais complexos que o código de rastreamento não captura por padrão. 

• Selecione Snippet de código JavaScript. Use o snippet no painel direito para rastrear o evento no HubSpot. Qualquer propriedade personalizada criada será predefinida no 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 concluir o evento e iniciar o rastreamento automaticamente. 
  

Importar dados de evento

Carregue seus dados de participação de eventos presenciais, dados de registro de data e hora provenientes de aplicativos que você não integra ao HubSpot, dados de campanha ou de lead únicos de um fornecedor ou outros dados de evento em formato de planilha. Os eventos permitem capturar o comportamento e usá-lo no HubSpot. 

• Endereço de e-mail do contato.
• Ocorreu em data/hora. Saiba mais sobre formatação de propriedades de data em arquivos de importação.

Exemplo de arquivo

Para importar eventos personalizados:

• Na sua conta da HubSpot, navegue até Gerenciamento de dados > Eventos personalizados.

• No canto superior direito, clique em Criar um evento.
• Selecione Importar planilha.

• Clique em Próximo.
• Insira o Nome do evento e, opcionalmente, forneça a descrição do evento.
• Selecione um Objeto associado. No momento, os eventos criados via importação somente podem ser associados a contatos.

• Carregue o arquivo. Selecione como importar os objetos e o idioma do arquivo e clique em Próximo.

• Mapeie as colunas às propriedades de evento e contato e clique em Próximo.

• Confirme o nome do seu arquivo de importação.
• marque a caixa de seleção para concordar que os contatos desejam ser contatados por você e que seu arquivo de importação não inclui uma lista adquirida. Saiba mais sobre a política de utilização responsável da HubSpot.
• Selecione o formato de data da propriedade Ocorreu em.
• Clique em Finalizar importação.

Configurar webhooks

Defina as condições que acionarão um webhook.

• Na sua conta da HubSpot, navegue até Gerenciamento de dados > Eventos personalizados.

• No canto superior direito, clique em Criar um evento.
• Selecione Configurar webhooks.
• Clique em Próximo.
• Insira um Nome do evento e selecione um Objeto associado.

• Clique em Próximo.
• Configurar um evento de teste:
  • Copie o URL do webhook. 
  • Navegue até a página de configurações do webhook no aplicativo de terceiros que você deseja integrar.
  • Cole o URL copiado.
  • Clique em Enviar um evento de teste.
• Clique em Próximo.
• Revise as propriedades do seu webhook. Clique no botão Tipo de propriedade para selecionar um tipo de propriedade. 

• Clique em Próximo.
• Selecione uma propriedades do seu webhook de terceiros que corresponda exatamente a uma propriedade de objeto do HubSpot. 

Usar dados de evento personalizado

Os dados do evento personalizado 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.

Você pode abrir os eventos selecionados diretamente nas ferramentas da HubSpot com o menu suspenso de ações na lista de eventos, na exibição de evento único ou no canto superior direito dos gráficos na guia Analisar.

Relatório sobre eventos personalizados

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

Saiba mais sobre como analisar eventos 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 personalizado.
• Para filtrar uma linha do tempo de contato por eventos concluídos, clique em Filtrar atividade e selecione Evento personalizado.
• Na linha do tempo do contato, clique para expandir o evento para exibir os detalhes do evento.

Usar eventos personalizados em fluxos de trabalho

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

• Na sua conta HubSpot, acesse Automações > Fluxos de trabalho.
• Clique no nome de um fluxo de trabalho. Ou, saiba como criar um novo fluxo de trabalho.
• Para adicionar um gatilho:
  • No editor de fluxo de trabalho, clique em Definir gatilhos.
  • No painel esquerdo, selecione Quando um evento ocorre. Configure o disparador e clique em Aplicar filtro.
  • Para refinar ainda mais o gatilho, clique em Adicionar filtros de refinamento. Você pode selecionar propriedades adicionais para refinar os objetos que gostaria de inscrever no fluxo de trabalho.
  • Por padrão, os registros só serão inscritos em um fluxo de trabalho na primeira vez que eles atenderem aos gatilhos de inscrição. Para permitir reinscrições, na seção O [objeto] deve ser reinscrito neste fluxo de trabalho?, selecione Sim, reinscrever sempre que o gatilho ocorrer.
• Para adicionar um atraso:
  • 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 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.

Observação: todos os gatilhos de inscrição serão separados usando o operador OU. Isso significa que apenas um dos gatilhos de inscrição de evento devem ocorrer para que o registro seja inscrito no fluxo de trabalho.

O fluxo de trabalho vai atrasar os registros inscritos até que eles cumpram os critérios de evento personalizado especificados ou sejam acionados quando o evento ocorrer.