Rastrear eventos no Intercom oferece uma melhor compreensão de como seus clientes usam seu produto. Esse entendimento permite enviar mensagens direcionadas e relevantes, além de fornecer todo o contexto necessário para apoiar seus clientes.
O Intercom rastreia alguns eventos por padrão, como visualizações de página e interações com seu Help Center, este artigo trata do rastreamento de seus próprios eventos personalizados.
Existem várias maneiras de enviar eventos para o Intercom:
Através dos nossos SDKs móveis.
Metadados do Evento
Cada evento que você rastreia pode incluir metadados. Esta é uma informação adicional sobre cada ocorrência específica do evento. Por exemplo: se você rastrear um evento “purchase”, os metadados podem ser o nome e o preço do item comprado.
Cada evento pode ser enviado com até vinte metadados. Os seguintes tipos de dados são suportados:
String: Uma string simples de até 255 caracteres.
Número: Número positivo ou negativo.
Link: Uma URL http ou https, para a qual criaremos um link.
Link rico: Um link http ou https, também enviado com um título, para o qual criaremos um link.
Imagem: Um link http ou https para uma imagem, que exibiremos.
Stripe (varejo): Um identificador de fatura, cliente ou cobrança Stripe, para o qual criaremos um link.
Monetário (varejo): Um valor com uma moeda.
Importante:
Os nomes das chaves não diferenciam maiúsculas de minúsculas e não podem conter pontos ('.'), cifrões ('$'), caracteres como ~`!@#%^&*'{}|\'" ou o caractere NULL.
Hífens nos nomes das chaves não são exibidos no Intercom. A chave ainda é importante para rastrear dados, enquanto 'invited-friend' e 'invited friend' serão exibidos como Amigo convidado na interface, os dois campos representam dados diferentes.
Continue lendo para aprender como enviar eventos com cada método. Ou, pule para esta visão geral do rastreamento de um evento do início ao fim.
A API JavaScript do Intercom
Com o snippet JavaScript do Intercom instalado no seu app ou site, você pode enviar eventos quando seus users ou visitantes realizam ações.
Use o método Intercom('trackEvent'). Isso associa automaticamente o evento ao visitante, lead ou user atualmente rastreado e o envia para o Intercom. Um evento simples ficaria assim:
Isso seria rastreado assim:
Intercom('trackEvent', ‘upload-complete');
Opcionalmente, você também pode incluir metadados com o evento para um direcionamento mais granular de mensagens baseadas em eventos e inclusão no conteúdo da mensagem:
Este evento com metadados:
var metadata = {
duration: 19,
type: "JPEG",
file_location: "https://external-content.com/example.jpg"
};
Intercom('trackEvent', 'upload-complete');
Nota: Para rastrear eventos com a API JavaScript, você precisa garantir que o snippet JavaScript do Intercom já tenha sido carregado com sucesso na página.
Para instalar o Intercom, copie o primeiro snippet de código nas configurações de instalação web, que já vem preenchido com seu workspace ID. Depois cole o código logo antes da tag <body/> de fechamento de qualquer página onde deseja rastrear eventos.
Google Tag Manager
Se você instalou o Intercom com o Google tag manager, pode usá-lo para rastrear eventos personalizados, como neste exemplo do nosso artigo de ajuda, que rastreia um evento de “Exit intent”. Isso é perfeito para mensagens que você quer enviar aos visitantes do seu site, como exemplo.
Diretamente via REST API
Você pode rastrear eventos diretamente via REST API, usando a linguagem de sua escolha ou um dos nossos SDKs suportados:
Ao rastrear um evento com a REST API, você também pode especificar um horário “created_at” para definir exatamente quando ele ocorreu, o que permite “recuperar” eventos que aconteceram no passado.
Veja nossa Documentação da API para mais detalhes.
Nota: Eventos rastreados via API não acionam Banners ou Carrosséis. Para esses tipos de mensagem, recomendamos usar a API JavaScript ou um dos nossos SDKs móveis.
Do seu app móvel usando um dos nossos SDKs móveis
Você pode usar qualquer um dos nossos SDKs móveis para configurar o rastreamento de eventos:
Com um app como Segment ou Stripe.
Vários apps da nossa app store rastrearão eventos para você no Intercom. Por exemplo, o app Stripe rastreará eventos de assinatura como pagamentos recentes. Isso é perfeito para enviar mensagens de notificação sobre atividade da conta.
Rastreamento de eventos em ação
Neste exemplo, vamos rastrear um evento com a API JavaScript sempre que o upload de um cliente for concluído, e enviar uma mensagem a ele cada vez que isso acontecer.
Primeiro, o código que precisamos:
Este JavaScript rastreia um evento chamado “Upload complete” e inclui:
O local do arquivo - “/example.jpg”
O tipo - “JPEG”
E quanto tempo levou para fazer o upload (em minutos) - 19
Agora, cada vez que o evento for rastreado, ele será visível nestes locais:
O perfil do user.
No Help Desk (eventos recentes).
Nos seus filtros de mensagem.
Filtros na lista de contatos.
Nota: Quando alguém entra em contato pela primeira vez e é adicionado como lead no Intercom, você pode ver quaisquer eventos que ele tenha rastreado como visitante nos últimos 90 dias antes do contato.
Em Configurações > Dados > Pessoas e na aba Eventos, vamos adicionar uma descrição ao evento para que fique super claro para todos os nossos colegas o que ele representa:
Agora, com o evento rastreado com sucesso, podemos usar mensagens baseadas em eventos para enviar um banner de notificação a cada vez que ele ocorrer. Leia este artigo para aprender tudo sobre mensagens baseadas em eventos.
Como eu excluo eventos?
Nas configurações de eventos do seu workspace, abra o evento e clique em 'Arquivar':
Você sempre pode desarquivar um evento depois, se mudar de ideia, mas eventos arquivados não são recriados se você os rastrear novamente.
Abaixo está um exemplo de como configurar um Link Rico:
var metadata = {
order_number: {url: "https://example.com/tx186373", value: "TX186373"},
};
Intercom('trackEvent', 'order', metadata);No exemplo acima, estamos enviando o link https://example.com/tx186373 nos metadados para o evento 'order' com um título que criará um link para a URL enviada.
Quando o evento acima é enviado para um user específico, ele verá o atributo order_number com o valor TX186373, mas o link estará embutido nesse valor.
Melhores práticas para capturar eventos
Eventos são mais úteis para filtrar e segmentar seus users, e enviar mensagens direcionadas aos seus clientes.
Com isso em mente, temos algumas recomendações para aproveitar ao máximo os Eventos:
Envie eventos que capturem ações significativas. Uma compra é uma ótima base para uma conversa, ao contrário de registrar todos os cliques que levaram a essa compra. Eventos significativos também facilitam a criação de filtros e mensagens automáticas.
Envie a quantidade certa de metadados. Metadados são uma ótima forma de contextualizar a atividade, mas enviar demais pode ser distrativo. Lembre-se que você sempre pode vincular de volta aos seus próprios sistemas para mais detalhes.
Formate seus metadados como se fossem enviados a um cliente. Metadados não são formatados quando incluídos em suas mensagens, então devem estar prontos para uso quando recebidos pelo Intercom.
Use eventos para entender interações entre users como convites e atividades sociais. Você pode usar metadados para fornecer uma visão rica de como os users interagem com seu negócio e entre si.
Nomeie seus eventos de forma que sejam facilmente legíveis no Intercom. Usar um verbo no passado é uma forma de tornar a ação mais facilmente compreendida quando aparece na linha do tempo de atividade do user, por exemplo, “Comprou item”, “Criou perfil” ou “Visualizou guia de introdução”.