Por padrão, o Web Analytics é anônimo: ele conta as visitas sem saber quem as fez. Depois que você identifica um visitante, as visitas dele aparecem na linha do tempo do contato e os segmentos podem usar o comportamento dele.
Como /track é um endpoint público, um endereço sozinho não prova nada. A identificação é sempre assinada.
identify()
Chame identify assim que souber quem é o visitante, com o endereço e uma assinatura calculada no seu servidor.
NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')
Os dois argumentos são obrigatórios: sem eles, identify rejeita a chamada em vez de falhar em silêncio, e também rejeita um endereço com mais de 255 caracteres ou uma assinatura com mais de 64 bytes. Um endereço assinado incorretamente falha em silêncio: o servidor descarta a identidade e registra a visita como anônima.
Calcular a assinatura
A assinatura é um HMAC-SHA256, codificado em hexadecimal, sobre a string wa_identify: seguida do endereço de email, usando como chave a chave secreta do seu workspace.
import { createHmac } from 'crypto'
function webIdentifyHmac(email, workspaceSecretKey) {
return createHmac('sha256', workspaceSecretKey)
.update('wa_identify:' + email)
.digest('hex')
}func webIdentifyHMAC(email, workspaceSecretKey string) string {
mac := hmac.New(sha256.New, []byte(workspaceSecretKey))
mac.Write([]byte("wa_identify:" + email))
return hex.EncodeToString(mac.Sum(nil))
}Assine o endereço exatamente como você o passa para identify: a assinatura é verificada antes da normalização do endereço, então Alice@Example.com precisa ser assinado como Alice@Example.com.
Atenção
Nunca calcule isso no navegador. A assinatura existe porque qualquer pessoa pode enviar dados para o endpoint de rastreamento; uma chave secreta enviada para a página anula essa proteção por completo.
O prefixo wa_identify: mantém esta assinatura diferente da usada nos seus links de cancelamento de assinatura. Uma assinatura tirada de um email encaminhado não consegue identificar um visitante, e uma tirada da sua página não consegue alterar as inscrições de ninguém.
clearIdentity() faz com que os próximos beats deixem de levar a identidade. Ela não anonimiza o que já foi registrado.
Identificar a partir de links de email
O Notifuse pode adicionar uma identidade assinada aos links dos emails rastreados. Assim, um destinatário que clica em um deles é reconhecido ao chegar, sem nenhum código no seu site.
Esse recurso vem desativado por padrão. Ative Identificar destinatários de email em Configurações → Web Analytics.
Nota
Ao contrário de identify(), que o seu servidor chama com o seu próprio segredo, esta credencial é emitida pelo Notifuse para cada destinatário de cada envio rastreado. Por isso ela tem uma configuração própria e não é ativada junto com o web analytics.
A identidade é um parâmetro nf_id criptografado, que expira 7 dias depois de ser emitido. Ela só é adicionada aos links cujo host está nos seus domínios permitidos, então os links de terceiros no mesmo email nunca a levam. O rastreador a lê na chegada e a remove da URL.
Um envio nunca leva essa identidade quando o rastreamento está explicitamente desativado na notificação, ou (na API transacional) quando a mensagem tem algum destinatário em CC ou CCO, porque a identidade seria entregue a alguém que não é o contato.
Atenção
Desativar o rastreamento de cliques não remove a identidade. Sem redirecionamento para envolver o link, o parâmetro é gravado direto no seu próprio link. Para suprimi-lo, desative o rastreamento na notificação ou desative a identificação por links de email.
Desativar a configuração só impede que novas credenciais sejam emitidas. Um nf_id que já está no navegador de um visitante continua o identificando até expirar, até 7 dias depois.
O que a identificação registra
Depois que um visitante é identificado, essa visita e tudo o que já foi registrado nela são atribuídos ao contato:
- Nas linhas de analytics: o endereço do contato, o que faz de Contact Email uma dimensão e de Identified Contacts uma medida.
- Na linha do tempo do contato: uma entrada por página visualizada e uma que resume a visita, além das metas como eventos personalizados.
Se o endereço ainda não é um contato, um contato é criado com o idioma e o fuso horário informados pela visita, além do país obtido pelo IP do visitante quando a geolocalização está ativada. Um valor que o Notifuse não consegue armazenar, como um idioma sem suporte ou um fuso horário não reconhecido, fica de fora. Um contato existente nunca é modificado por uma visita, e um contato criado assim não entra em nenhuma lista.
Na ficha do contato
A aba Visitas web da ficha de um contato lista as visitas identificadas dele, das mais recentes para as mais antigas: quando, quanto tempo, quantas páginas, de onde ele veio e em qual dispositivo. Expanda uma visita para ver o percurso página por página, com as metas atingidas no caminho. Acima da lista, um resumo mostra a primeira visita identificada, as metas atingidas e as páginas mais vistas, e Abrir na análise web abre o dashboard filtrado pelo contato.
A aba só aparece para membros que podem ler o web analytics, e só enquanto o web analytics está ativado.
Segmentos
O comportamento na web está disponível como condições de Atividade em um segmento:
| Condição | Filtra por |
|---|---|
| Ver página web | Caminho, tempo na página, profundidade de rolagem, número da página na visita, tipo de entrada |
| Visitar site | Página de entrada, página de saída, páginas visualizadas, duração da visita, profundidade de rolagem, metas atingidas, valor das metas, domínio referenciador, origem, meio e campanha UTM, canal, grupo de canais, dispositivo, navegador, sistema operacional, país |
Assim, “visualizou /pricing pelo menos duas vezes nos últimos 30 dias” ou “veio de uma campanha de newsletter e atingiu pelo menos uma meta” são condições de segmento comuns. Veja Contatos para saber como as condições se combinam.
Nota
A navegação nunca dispara uma automação. Visualizações de página e visitas são registradas e podem ser usadas em segmentos, mas só as metas chegam às automações, pelo gatilho custom_event, com o nome normalizado da meta. As metas têm um tipo declarado, então também podem ser usadas pela condição Custom Events Goal; veja Metas.
Privacidade
- Nenhum cookie é criado, e nenhum identificador acompanha um visitante de um site para outro.
- Os endereços IP são usados para obter uma localização e nunca são armazenados.
- Uma visita anônima continua anônima. Nada a vincula retroativamente a um contato identificado em uma sessão posterior.
- Excluir um contato remove o endereço dele de todos os lugares onde estava armazenado: as linhas de analytics, as entradas da linha do tempo e os eventos personalizados criados a partir das metas web dele. O tráfego continua como anônimo, então os totais históricos não mudam.
Atenção
Um visitante cujo navegador ainda guarda uma credencial é identificado de novo (e recriado como contato) na próxima visita, mesmo depois que você o exclui. Para impedir isso de vez, pare de chamar identify() para esse endereço e desative a identificação por links de email se a credencial veio de um link. Um nf_id emitido antes de você desativar a configuração continua funcionando até expirar.
Observações
- A identificação tem limite de taxa por endereço e por IP de origem. A criação de um contato novo a partir de uma identificação tem, além disso, um limite de taxa por workspace.
- Ultrapassar um limite faz perder a identidade naquele beat, nunca a visita.
- Cada passagem de projeção grava no máximo 100 visualizações de página por visita, mantendo as mais recentes. Uma visita longa projetada em várias passagens pode deixar mais de 100 entradas de visualização de página na linha do tempo.
- Metas com mais de 24 horas não são adicionadas à linha do tempo, então uma visita offline reenviada não dispara automações com um dia de atraso.
- Referência da API
