Vincule datos de visitantes anónimos a usuarios conocidos. Cuando los visitantes inician sesión o envían formularios, Zenovay conecta su historial completo a su identidad.
Cómo funciona la identificación de usuarios
De anónimo a conocido
Recorrido del visitante:
Visita 1 (Anónima):
Visitante anónimo navega por el sitio
→ ID de visitante asignado: viz_abc123
Visita 2 (Anónima):
El mismo visitante regresa
→ Mismo ID de visitante: viz_abc123
Visita 3 (Identificada):
Visitante inicia sesión como [email protected]
→ zenovay('identify', '[email protected]')
→ Todo el historial vinculado a [email protected]
Visitas futuras:
Reconocido automáticamente
→ Recorrido completo preservado
Datos fusionados
Cuando se identifica:
- Visitas anónimas anteriores vinculadas
- Visitas futuras rastreadas
- Recorrido completo visible
- Múltiples dispositivos posibles
Implementar la identificación
Identificación básica
Llame a identify cuando el usuario sea conocido:
// Cuando el usuario inicia sesión
zenovay('identify', userId);
// Ejemplo
zenovay('identify', 'user_12345');
// o
zenovay('identify', '[email protected]');
Con propiedades del usuario
Agregue detalles del usuario como tercer argumento:
zenovay('identify', 'user_12345', {
email: '[email protected]',
name: 'John Smith',
company: 'Acme Corporation',
plan: 'enterprise',
role: 'admin'
});
Información
Se requiere una dirección de correo electrónico o un ID de cliente para identificar un visitante. El primer argumento puede ser una dirección de correo electrónico o su propio ID de usuario.
Propiedades compatibles
| Propiedad | Tipo | Descripción |
|---|---|---|
| string | Dirección de correo electrónico | |
| name | string | Nombre completo |
| first_name | string | Nombre |
| last_name | string | Apellido |
| company | string | Nombre de la empresa |
| phone | string | Número de teléfono |
| custom_* | any | Propiedades personalizadas |
Todas las claves adicionales que pasar se almacenan como atributos personalizados en el perfil de usuario.
Ejemplos de implementación
En el inicio de sesión
// Después de un inicio de sesión exitoso
async function handleLogin(credentials) {
const user = await loginUser(credentials);
// Identificar en Zenovay
zenovay('identify', user.id, {
email: user.email,
name: user.name,
company: user.company_name
});
// Continuar con la app
redirectToDashboard();
}
React Hook
import { useEffect } from 'react';
import { useAuth } from './auth';
function useZenovayIdentify() {
const { user, isAuthenticated } = useAuth();
useEffect(() => {
if (isAuthenticated && user) {
if (window.zenovay) {
window.zenovay('identify', user.id, {
email: user.email,
name: user.name,
company: user.company
});
}
}
}, [user, isAuthenticated]);
}
Envío de formulario
// Al enviar formulario (antes de iniciar sesión)
async function handleFormSubmit(formData) {
// Identificar con correo electrónico del formulario
zenovay('identify', formData.email, {
email: formData.email,
name: formData.name,
company: formData.company
});
// Rastrear el envío del formulario
zenovay('goal', 'form_submission');
// Enviar al backend
await submitForm(formData);
}
Ver usuarios identificados
Vista de usuarios
- Abra el panel de su sitio web (
/domains/{id}) - En el grupo Audience de la barra lateral, abra la pestaña Journeys
- Seleccione la subpestaña Users para ver usuarios identificados y sus cronologías
- Haga clic en un usuario para abrir su perfil y la cronología de actividad completa
Lista de usuarios
Cada fila muestra el nombre o correo electrónico del visitante, de dónde proviene, cuántas páginas ha visto, qué ingresos se le atribuyen y cuándo estuvo activo por última vez. Ordene la lista para mostrar sus usuarios más activos o que más ingresos generan:
| Visitante | Origen | Páginas vistas | Ingresos | Última actividad |
|---|---|---|---|---|
| [email protected] | 24 | 4.999 USD | Hoy | |
| [email protected] | Directo | 18 | — | Ayer |
| [email protected] | 12 | 99 USD | Hace 3 días |
Los visitantes que aún no se han identificado aparecen como Anónimo hasta que una llamada identify (o un correo electrónico conocido de un evento) vincule una identidad real. Haga clic en cualquier fila para abrir el perfil completo y la cronología de actividad del visitante.
Perfil de usuario
┌─────────────────────────────────────────────────────┐
│ John Smith │
│ [email protected] │
│ ─────────────────────────────────────────────────── │
│ │
│ Empresa: Acme Corporation │
│ Plan: Enterprise │
│ Rol: Admin │
│ Creado: 15 de noviembre de 2024 │
│ │
│ ─────────────────────────────────────────────────── │
│ │
│ Resumen de análisis: │
│ • Sesiones totales: 24 │
│ • Tiempo total: 3h 45m │
│ • Páginas vistas: 89 │
│ • Objetivos completados: 5 │
│ • Ingresos: 4.999 USD │
│ │
│ Primera visita: 20 oct. 2024 (anónima) │
│ Identificado: 15 nov. 2024 │
│ Última visita: Hoy a las 14:30 │
│ │
└─────────────────────────────────────────────────────┘
Recorrido del usuario
Cronología completa
Vea el historial completo del usuario:
John Smith - Cronología del recorrido
15 de enero de 2025
├── 14:30 - Página de configuración (5 min)
├── 14:00 - Panel de control (10 min)
└── Sesión iniciada
10 de enero de 2025
├── 15:45 - Página de facturación (3 min)
├── 15:40 - Modal de actualización → Actualización completada ✓
└── Sesión iniciada
15 de diciembre de 2024
├── 10:00 - Flujo de incorporación
└── Cuenta creada, identificada
28 de noviembre de 2024 (anónima)
├── Solicitud de demostración enviada → Identificado
├── /pricing (8 min)
└── /features (5 min)
20 de octubre de 2024 (anónima)
├── /blog/guide (4 min)
└── Primera visita desde búsqueda de Google
Rastreo entre dispositivos
Cuando un usuario inicia sesión en múltiples dispositivos, sus sesiones se vinculan a la misma identidad:
Dispositivos utilizados:
Escritorio (Chrome/Windows)
├── 18 sesiones
└── Última: Hoy
Móvil (Safari/iOS)
├── 4 sesiones
└── Última: 10 ene.
Tableta (Chrome/iPad)
├── 2 sesiones
└── Última: 20 dic.
Todas las sesiones vinculadas a [email protected]
Si el mismo visitante se identifica en más de uno de sus dominios rastreados, la cronología también muestra los otros dominios donde fue visto.
Consideraciones de privacidad
Consentimiento del usuario
Antes de identificar:
- Asegurar el consentimiento apropiado
- Seguir su política de privacidad
- Respetar las exclusiones
Manejo de datos
Los datos del usuario se:
- Cifran en tránsito
- Controlan el acceso por membresía de equipo y rol
- Retienen según la ventana de retención de datos de su plan
Eliminar datos de un usuario
Para eliminar los datos personales de una persona, use una solicitud estándar de derechos del titular: haga que la persona (o usted en su nombre) solicite la eliminación a través de Configuración → Cuenta para un titular de cuenta, o comuníquese con soporte en [email protected] para un visitante que no sea titular de cuenta. Eliminar la asociación de seguimiento del sitio web también detiene la recopilación futura.
Respetar la exclusión voluntaria
// Verificar la exclusión antes de identificar
if (!userHasOptedOut()) {
zenovay('identify', userId, userData);
}
Acceso API
Los datos de usuarios identificados están disponibles a través de la API REST de Zenovay en planes pagos. Úsela para extraer el perfil, estadísticas y cronología de un usuario en sus propios sistemas o para enviar la identificación desde un backend.
Para autenticación, endpoints y formatos de respuesta, consulte Descripción general de la API. La llamada identify mostrada arriba (zenovay('identify', ...)) es la forma del lado del cliente de crear o actualizar un usuario; la API REST es el equivalente del lado del servidor para releer esos datos.
Mejores prácticas
Identificar temprano
Identifique lo antes posible:
- Al registrarse/iniciar sesión
- Al enviar formulario
- Cuando se conoce el correo electrónico
Usar ID coherentes
Elija una estrategia de ID:
- Correo electrónico (si es único)
- ID de usuario de la base de datos
- UUID
Actualizar propiedades
Mantenga las propiedades actualizadas:
// Cuando el usuario actualiza su plan
zenovay('identify', userId, {
plan: 'enterprise',
upgraded_at: new Date()
});
No sobre-identificar
Evite llamar a identify:
- En cada carga de página
- Para visitantes anónimos
- Sin consentimiento del usuario
Solución de problemas
Usuario no identificado
Si la identificación falla:
- Verifique la consola para errores
- Verifique que el script de rastreo se cargó
- Confirme que identify se llamó después del script
Historial no vinculado
Si las visitas anteriores no aparecen:
- Las cookies pueden haber sido eliminadas
- Navegador/dispositivo diferente
- Modo incógnito utilizado