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 personalizados

Ultima atualização: Abril 3, 2024

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

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

Os eventos personalizados permitem-lhe definir e acompanhar eventos que são exclusivos da sua empresa. Os eventos personalizados podem ser associados a propriedades de eventos, que podem ser utilizadas nas ferramentas da HubSpot. 

Existem três formas diferentes de criar eventos personalizados: 

  • Enviar via API: utilize o ponto de extremidade de definição de evento personalizado para criar o seu evento. A partir daí, use seu ID de evento com o ponto de extremidade send Custom event para enviar conclusões de eventos para o HubSpot.
  • Capture dados do seu sítio Web sem a API:
    • Código Javascript: usando Javascript personalizado, você pode inserir código personalizado no seu script de rastreamento do HubSpot usando o editor de código.
    • Utilizar o visualizador de eventos: monitoriza as visualizações de páginas ou os elementos clicados seleccionando-os no seu sítio Web. Saiba mais sobre criando eventos personalizados com o Visualizador de eventos.
  • Importar folha de cálculo: carrega uma folha de cálculo de dados de eventos para capturar actividades offline, preencher dados ou integrar manualmente qualquer ferramenta com o HubSpot.

 

Nota: a ferramenta de eventos personalizados substitui a anterior ferramenta de eventos herdada. 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 acionará o evento. 

Criar evento através da API

Se estiver a enviar dados para o HubSpot através da API, terá de utilizar o ponto de extremidade de definição de evento personalizado para criar o seu evento. Em seguida, é necessário definir a chamada à API para acionar 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 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 HubSpot, acesse Relatórios > 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, localizar o nome do evento em 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.
Nota:
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 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.

Criar eventos com um trecho de código Javascript

  • Na sua conta HubSpot, acesse Relatórios > Gerenciamento de dados > Eventos personalizados.
  • No canto superior direito, clique em Criar um evento.
  • Selecionar Código Javascript.
código-javascript
  • Clique em Próximo.
  • Introduza um nome de evento e, opcionalmente, forneça a descrição do evento.
  • Selecionar um Objeto associado. Isto permite-lhe associar a conclusão do seu evento a diferentes objectos no HubSpot, incluindo Contactos, Empresas, Concursos e Bilhetes
pormenores do evento personalizado

  • Clique em Próximo.

Adicionar propriedades

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 a sua propriedade. 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 epoch milissegundos ou ISO8601. 
    • Propriedade de enumeração personalizada: cria uma propriedade com um conjunto de valores predefinidos.

      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 Next.
  • Depois de configurar o evento e as suas propriedades, pode adicionar este evento ao código de seguimento do seu sítio Web, seleccionando o fragmento 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 concluir o seu evento e iniciar automaticamente o acompanhamento. 
    exemplo-código-código-nippet-custom-evento

Importar dados de eventos

Carregue os seus dados de participação de eventos presenciais, dados com carimbo de data/hora provenientes de aplicações que não integram com o HubSpot, dados de campanhas ou leads únicos de um fornecedor ou quaisquer outros dados de eventos em formato de folha de cálculo. Os eventos permitem-lhe capturar o comportamento e depois utilizá-lo no HubSpot. 

  • Na sua conta HubSpot, acesse Relatórios > Gerenciamento de dados > Eventos personalizados.
  • No canto superior direito, clique em Criar um evento.
  • Seleccione Importar folha de cálculo.
importar folha de cálculo
  • Clique em Próximo.
  • Introduza um nome de evento e, opcionalmente, forneça a descrição do evento.
  • Selecionar um Objeto associado. Isto permite-lhe associar a conclusão do seu evento a diferentes objectos no HubSpot, incluindo Contactos, Empresas, Concursos e Bilhetes

pormenores do evento personalizado

  • Arraste e largue um ficheiro na secção Selecionar um ficheiro ou clique em Escolher um ficheiro para carregar um ficheiro do seu computador.
Nota: ao importar dados de eventos, aplicam-se os limites abaixo indicados:
  • O seu ficheiro deve ser do tipo csv, .xlsx ou .xls 
  • Limitado a 1 milhão de linhas.
  • Por enquanto, os eventos criados através de importação só podem ser associados a contactos. 
  • Os eventos irão ccriar e atualizar os registos de contactos. Ta importação criará novos registos e actividades, bem como identificará e actualizará os registos existentes. Para criar novos registos ou actividades, o ficheiro deve conter as propriedades necessárias para esse contacto. Para atualizar os registos existentes, o seu ficheiro deve conter um identificador único .
  • A importação de eventos deve ser utilizada para eventos que já ocorreram, não sendo suportados eventos com datas futuras.

 

  • Clique no menu pendente para selecionar o idioma dos cabeçalhos das colunas.
carregar folhas de cálculo - eventos
  • Clique em Próximo.
  • No ecrã Mapear colunas no seu ficheiro para as propriedades do HubSpot, o HubSpot mapeará as colunas no seu ficheiro para as propriedades do contacto e do evento com base no cabeçalho, no idioma do cabeçalho e no nome da propriedade.
  • O Mapping Guide apresenta as propriedades necessárias para criar e/ou atualizar os contactos e eventos. Se faltar alguma das propriedades necessárias para completar o objetivo da sua importação, deve corrigir o seu ficheiro de importação e reiniciar a importação para evitar erros.
  • As colunas da sua folha de cálculo podem ser mapeadas para propriedades de contacto ou propriedades de evento. Clique no menu pendente Importar como para selecionar a forma de importar os dados do ficheiro. Em seguida, seleccione a propriedade do HubSpot para a mapear. Pode mapeá-lo para uma propriedade existente ou criar uma nova propriedade.
criar nova propriedade
  • Clique em Próximo.
  • Confirme o nome do seu ficheiro de importação.
  • Clique na caixa de verificação para concordar que os contactos esperam receber notícias suas e que o seu ficheiro de importação não inclui uma lista comprada. Saiba mais sobre A política de utilização aceitável da HubSpot.
  • Clique no menu pendente para selecionar o formato da data da propriedade Occurred at.
  • Clique em Finalizar importação.

Utilizar dados de eventos personalizados

Os dados de eventos personalizados podem ser visualizados e utilizados 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 seus eventos selecionados diretamente em ferramentas selecionadas do HubSpot com o menu suspenso de ações na sua lista de eventos, a exibição de evento único ou o canto superior direito dos gráficos na guia analisar.

Relatório sobre eventos personalizados

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

Saiba mais sobre analisar os seus 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:

  • Navegar para um registo de contacto que tenha concluído um evento personalizado.
  • Para filtrar uma cronologia de contactos por eventos concluídos, clique em Filtrar atividade e, em seguida, seleccione Evento personalizado.
  • Na linha temporal de contacto, clicar para expandir o evento para exibir os detalhes do evento.

Utilizar eventos personalizados em fluxos de trabalho

Num fluxo de trabalho, pode atrasar com base na conclusão de eventos personalizados utilizando uma ação Delay until event happens ou um acionador de inscrição de eventos.

  • 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 acionador:
    • No editor de fluxo de trabalho, clique em Definir gatilhos.
    • No painel esquerdo, seleccione Quando ocorre um evento. Configure o disparador e clique em Aplicar filtro
    • Para refinar ainda mais o seu acionador, clique em Adicionar filtros de refinamento. Pode selecionar propriedades adicionais para refinar os objectos 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 ativar a reinscrição, na secção Should [object] be re-enrolled in this workflow?, seleccione Yes, re-enroll every time the trigger occurs.
  • Para adicionar um atraso:
    • 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 pendente Event e, em seguida, seleccione um evento 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.

Nota: todos os accionadores de registo de eventos serão separados utilizando o operador OR. Isto significa que apenas um dos accionadores de inscrição de eventos deve ocorrer para que o registo se inscreva no fluxo de trabalho.

O fluxo de trabalho irá então atrasar os registos inscritos até que estes satisfaçam os critérios de eventos personalizados especificados ou será acionado quando o evento ocorrer.

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.