Saltar al contenido

Funciones

Identificar visitantes

Vincula una visita al sitio web con un contacto y usa el comportamiento de navegación en segmentos.

Línea de tiempo de un contacto filtrada por Web, con una sesión web y sus vistas de página

Por defecto, Analíticas web es anónima: cuenta las visitas sin saber quién las hace. Cuando identificas a un visitante, sus visitas aparecen en la línea de tiempo de su contacto y los segmentos pueden usar su comportamiento.

Como /track es un endpoint público, una dirección sola no demuestra nada. Por eso la identificación siempre va firmada.

identify()

Llama a identify en cuanto sepas quién es el visitante, con la dirección y una firma calculada en tu servidor.

NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')

Los dos argumentos son obligatorios: sin ellos, identify rechaza la llamada en lugar de fallar sin avisar, y también la rechaza si la dirección supera los 255 caracteres o la firma los 64 bytes. En cambio, una dirección mal firmada falla sin avisar: el servidor descarta la identidad y registra la visita como anónima.

Calcular la firma

La firma es un HMAC-SHA256, codificado en hexadecimal, de la cadena wa_identify: seguida de la dirección de correo, con la clave secreta de tu espacio de trabajo como clave.

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))
}

Firma la dirección exactamente como se la pasas a identify: la firma se comprueba antes de normalizar la dirección, así que Alice@Example.com debe firmarse como Alice@Example.com.

Advertencia

Nunca calcules la firma en el navegador. La firma existe porque cualquiera puede enviar datos al endpoint de seguimiento; una clave secreta incluida en la página la anula por completo.

El prefijo wa_identify: distingue esta firma de la de tus enlaces de baja, así que una firma copiada de un correo reenviado no puede identificar a un visitante, y una copiada de tu página no puede cambiar las suscripciones de nadie.

clearIdentity() hace que los latidos siguientes dejen de llevar la identidad. No anonimiza lo que ya se registró.

Notifuse puede añadir una identidad firmada a los enlaces de los correos con seguimiento, para reconocer al destinatario que hace clic en uno en cuanto llega, sin código en tu sitio.

Esta opción está desactivada por defecto. Activa Identificar a los destinatarios de los emails en Configuración → Analíticas web.

Nota

A diferencia de identify(), al que llama tu servidor con tu propio secreto, esta credencial la genera Notifuse para cada destinatario de cada envío con seguimiento. Por eso tiene su propia opción y no se activa junto con la analítica web.

La identidad es un parámetro nf_id cifrado que caduca 7 días después de generarse. Solo se añade a los enlaces cuyo host está en tus dominios permitidos, así que los enlaces a terceros del mismo correo nunca la llevan. El tracker la lee al llegar y la quita de la URL.

Un envío nunca la lleva cuando la notificación tiene el seguimiento desactivado de forma explícita o (en la API transaccional) cuando el mensaje tiene algún destinatario en CC o CCO, porque si no la identidad acabaría en manos de alguien que no es el contacto.

Advertencia

Desactivar el seguimiento de clics no elimina la identidad. Como no hay redirección que envolver, el parámetro se escribe directamente en tu propio enlace. Para suprimirla, hay que desactivar el seguimiento de la notificación o desactivar la identificación por enlace de correo.

Desactivar la opción solo impide que se generen credenciales nuevas. Un nf_id que ya está en el navegador de un visitante lo sigue identificando hasta que caduca, como mucho 7 días después.

Qué registra la identificación

Cuando se identifica a un visitante, esa visita y todo lo que ya se había registrado en ella se atribuyen al contacto:

  • En las filas de analítica: la dirección del contacto, de modo que Contact Email pasa a ser una dimensión e Identified Contacts una medida.
  • En la línea de tiempo del contacto: una entrada por cada página vista y otra que resume la visita, más los objetivos como eventos personalizados.

Si la dirección todavía no es un contacto, se crea uno con el idioma y la zona horaria que indicó la visita, más el país obtenido de la IP del visitante cuando la geolocalización está activada. Un valor que Notifuse no puede guardar, como un idioma no admitido o una zona horaria no reconocida, se omite. Una visita nunca modifica un contacto existente, y un contacto creado de esta forma no se une a ninguna lista.

En la ficha del contacto

La pestaña Visitas web de la ficha de un contacto lista sus visitas identificadas, de la más reciente a la más antigua: cuándo, cuánto duró, cuántas páginas, de dónde venía y desde qué dispositivo. Despliega una visita para ver su recorrido página a página, con los objetivos alcanzados por el camino.

Encima de la lista, un resumen muestra la primera visita identificada, los objetivos alcanzados y las páginas más vistas, y Abrir en analítica web abre el dashboard filtrado por el contacto.

La pestaña solo aparece para los miembros que pueden leer la analítica web, y solo mientras la analítica web está activada.

Segmentos

El comportamiento web está disponible como condiciones de actividad en un segmento:

CondiciónFiltra por
Ver la página webRuta, tiempo en la página, profundidad de desplazamiento, número de página en la visita, tipo de entrada
Visitar el sitio webPágina de entrada, página de salida, páginas vistas, duración de la visita, profundidad de desplazamiento, objetivos alcanzados, valor de los objetivos, dominio del referente, origen, medio y campaña UTM, canal, grupo de canales, dispositivo, navegador, sistema operativo, país

Así, “vio /pricing al menos dos veces en los últimos 30 días” o “llegó desde una campaña de newsletter y alcanzó al menos un objetivo” son condiciones de segmento normales. Consulta Contactos para ver cómo se combinan las condiciones.

Nota

La navegación nunca dispara una automatización. Las vistas de página y las visitas se registran y se pueden segmentar, pero solo los objetivos llegan a las automatizaciones, a través del disparador custom_event, con el nombre normalizado del objetivo. Los objetivos llevan un tipo declarado, así que también se puede llegar a ellos con la condición Objetivo de eventos personalizados; consulta Objetivos.

Privacidad

  • No se crea ninguna cookie, y ningún identificador sigue al visitante de un sitio a otro.
  • Las direcciones IP se usan para obtener una ubicación y nunca se guardan.
  • Una visita anónima sigue siendo anónima. Nada la vincula de forma retroactiva a un contacto identificado en una sesión posterior.
  • Al eliminar un contacto, su dirección se borra de todos los lugares donde estaba guardada: las filas de analítica, las entradas de su línea de tiempo y los eventos personalizados creados a partir de sus objetivos web. El tráfico se conserva como anónimo, así que los totales históricos no cambian.

Advertencia

Un visitante cuyo navegador todavía guarda una credencial se vuelve a identificar (y se vuelve a crear como contacto) en su siguiente visita, aunque lo hayas eliminado. Para evitarlo de forma definitiva, deja de llamar a identify() para esa dirección y desactiva la identificación por enlace de correo si la credencial venía de un enlace. Un nf_id generado antes de desactivar la opción sigue funcionando hasta que caduca.

Notas

  • La identificación tiene un límite de frecuencia por dirección y por IP de origen. Crear un contacto nuevo a partir de una identificación tiene además un límite por espacio de trabajo.
  • Superar un límite hace perder la identidad en ese latido, nunca la visita.
  • Cada pasada de proyección escribe como máximo 100 vistas de página por visita, y conserva las más recientes. Una visita larga proyectada en varias pasadas puede dejar más de 100 entradas de vistas de página en la línea de tiempo.
  • Los objetivos de más de 24 horas no se añaden a la línea de tiempo, así que una visita sin conexión que se reenvía más tarde no dispara automatizaciones con un día de retraso.
  • Referencia de la API