Empieza con Personyze funcionando en minutos.
Un recurso paso a paso para desarrolladores y equipos técnicos — instala el código de seguimiento, define los placeholders de contenido, configura objetivos y conecta tu stack de datos.
Empieza ahora →1Instala Personyze en tu sitio
Para habilitar la personalización debes instalar el snippet de seguimiento en cada página de tu sitio. Elige el método que se ajuste a tu plataforma.
Opción 1: Google Tag Manager (GTM)
Opción A: HTML personalizado (manual)
Crea una etiqueta de “HTML personalizado”, pega el snippet completo de JS de Personyze y dispáralo en “Todas las páginas”.
Opción B: integración con plantilla (la más fácil)
Busca en la galería de la comunidad de GTM “Personyze Tracking Code”. Añádelo, introduce tu Site ID y dispáralo en “Todas las páginas”. Así mantienes limpio tu contenedor.
Opción 2: HTML estándar
Pega el snippet directamente en la <head> etiqueta de tu archivo de plantilla maestra. Asegúrate de colocarlo lo más arriba posible, inmediatamente después de tus meta etiquetas charset y viewport.
Opción 3: Instrucciones para CMS
theme.liquid. Pega el código antes de </head>.header.ftl plantilla.2Define los placeholders (zonas)
Los placeholders son áreas de tu sitio en las que Personyze inyecta contenido. Usar placeholders en lugar de popups hace que la personalización se sienta nativa.
Opción A: el selector visual (sin código)
- Crea una nueva campaña y añade una acción de “Banner”.
- En Configuración de visualización, elige “Mostrar en placeholder”.
- Haz clic “Encontrar en páginas” para abrir el simulador.
- Navega por tu sitio y simplemente haz clic en el elemento (p. ej., Hero Banner) que quieras convertir en una zona.
Opción B: selectores CSS manuales
Introduce manualmente IDs o clases como #home-hero o .sidebar-widget.
Máximo de acciones simultáneas: Permite apilar varios banners verticalmente (p. ej., mostrar el banner A Y el banner B).
3Objetivos de conversión y seguimiento de KPIs
Mide el ROI definiendo qué es el éxito. Puedes hacer seguimiento de clics simples o de datos de ingresos complejos.
1. Tipos de objetivo
- URL de destino: Se dispara cuando el usuario visita una URL específica como
/thank-youo/order-confirmed. Mejor para generación de leads. - Sigue la actividad: Sigue interacciones específicas como hacer clic en “Añadir al carrito”, pasar el ratón sobre un menú o ver un vídeo. Usa el selector visual para elegir el elemento.
- Capturar datos (ingresos): Extrae valores dinámicos (p. ej., “$150.00”) del HTML de la página o de una cookie. Esencial para calcular el ROI y los ingresos.
- Eventos externos: Captura automáticamente los eventos enviados al Data Layer de GTM o los eventos de Google Analytics sin configuración adicional.
2. Configuración avanzada
- Valor del objetivo: Configura una Valor fijo (p. ej., Lead = $10) o un Valor dinámico (capturado de la página, como el total de compra).
- Frecuencia: Configura “Una vez por visita” para leads (para evitar conteos duplicados al refrescar) o “Sin límite” para compras (para hacer seguimiento de cada transacción).
3. Métricas de ecommerce
Si activas el seguimiento de productos/ingresos, Personyze calcula automáticamente Ingresos totales, AOV (valor medio del pedido) y tasa de contribución (cuánto de los ingresos se vio influido por la personalización).
4Extraer datos del sitio (variables)
Mejora la segmentación “capturando” datos del navegador del visitante o la sesión de página para crear un perfil de usuario rico.
Fuentes de datos soportadas
Puedes crear una “Variable de perfil de usuario” a partir de cualquiera de estas fuentes:
- Elementos de página (HTML): Extrae texto visible en la página (p. ej., “Hola, [Nombre]” o “Puntos: 500”). Usa el selector visual.
- Cookies: Lee valores guardados en cookies del navegador (p. ej.,
login_status,affiliate_id). - Variables de JavaScript: Lee variables globales de JS (p. ej.,
window.userLevelodataLayer[0].userId). - Etiquetas Meta: Lee meta tags de SEO para entender el contexto del contenido (p. ej.,
<meta name="author" content="John">). - Parámetros de URL: Lee UTMs o cadenas de consulta (p. ej.,
?campaign=summer_sale).
5CRM interno e integración de datos
Conecta tus bases de datos internas (CRM personalizado, SQL, ERP) con el comportamiento del sitio web en tiempo real.
Métodos de integración:
- Subida CSV: Sube manualmente listas de IDs de usuario + atributos (estado VIP, sector, compras offline).
- Feed en vivo: Sincroniza vía una URL de Google Sheet o un feed HTTP que se actualice automáticamente.
- API: Usa la API de Personyze para enviar actualizaciones de usuario en tiempo real desde tu backend.
6Feed de productos y contenido
Esto es necesario para ejecutar Recomendaciones de producto Y Recomendaciones de artículos/contenido.
1. Prepara tu feed
Personyze acepta CSV, XML, JSON, RSS, Atom o feeds de Google Merchant.
2. Mapea tus columnas
Ve a Configuración > Datos y contenido > Feed de productos. Debes mapear los campos de tu feed a los atributos de Personyze:
- ID interno: DEBE coincidir con el ID de producto/artículo que se encuentra en tu página en vivo (SKU/ID) o variable de GTM. Esto permite a Personyze saber qué artículo está viendo actualmente el usuario.
- Título: El nombre del producto o artículo.
- URL de imagen: Para mostrar en los widgets de recomendaciones.
- URL del enlace: A dónde lleva el clic en la recomendación.
- Precio / Categoría: Para filtrado y lógica.
Métodos alternativos
- Site Crawler: Si no tienes un feed, contacta con tu account manager para configurar un crawler que cree el feed desde tu sitio automáticamente.
- Subida por SFTP: Para catálogos enterprise grandes, pide a tu account manager que habilite la subida segura por SFTP.
7Privacidad y opt-out
Asegura el cumplimiento del RGPD/CCPA integrando con tu Consent Management Platform (CMP).
API de JavaScript:
Usa estos comandos dentro de la lógica de “Aceptar” o “Rechazar” de tu banner de cookies:
_S_T.system.off(): Detener el seguimiento. Llama a esto si un usuario rechaza las cookies. No se enviará ningún dato._S_T.system.on(): Iniciar seguimiento. Llama a esto cuando un usuario acepte las cookies._S_T.system.is_on(): Devuelvetrue/falsepara comprobar el estado actual.
Modo estricto: Puedes configurar Personyze en “Modo estricto”, donde no rastrea IPs ni PII por defecto hasta que se da consentimiento explícito mediante el comando anterior.
8Integraciones de terceros
Integraciones plug-and-play con las herramientas que ya usas. Para acceder, ve a: Configuración > Integraciones.
Analítica y datos
Envía datos de audiencia y campañas de Personyze a tus herramientas de analítica para informes.CRM y marketing
Sincronización bidireccional de leads y atributos de usuario entre Personyze y tu CRM.ABM y datos B2B
Enriquece el tráfico anónimo con datos de Nombre de Empresa, Sector e Ingresos.Infraestructura
Conecta sistemas backend, autenticación y automatización de flujos de trabajo.9Configuración del remitente de email
Configura cómo Personyze envía tus emails activados y newsletters.
Opción A: remitente por defecto (Amazon SES)
Por defecto, Personyze usa Amazon SES. Puedes autorizar tu propia dirección “From” (p. ej., info@tudominio.com).
- Añade el email que deseas en la configuración de Personyze.
- Recibirás una solicitud de verificación de AWS.
- Recomendación: Contacta con tu account manager para obtener los registros DKIM y subirlos a tu DNS para mejorar la entregabilidad.
Opción B: SMTP personalizado
Usa tu propio servidor de correo (SendGrid, Mailgun, Outlook, etc.) para tener control total.
- Selecciona “Proveedor de correo (SMTP)”.
- Introduce tu host, puerto (p. ej., 465 o 587), usuario y contraseña.
Opción C: webhook (HTTP POST)
Envía el payload de datos del email a tu propio endpoint o herramienta de automatización (como Zapier) para disparar el envío externamente.
10Configuración de notificaciones web push
Para habilitar las notificaciones push del navegador, debes instalar un Service Worker.
1. Descarga el Service Worker
Descarga el archivo estándar: sw.js
2. Instala en tu servidor
- Escenario A (sin Service Worker existente): Sube el archivo `sw.js` al directorio raíz de tu sitio web (p. ej., `tusitio.com/sw.js`).
- Escenario B (ya tienes un Service Worker): NO sobrescribas tu archivo. En su lugar, pide a tu desarrollador que fusione el contenido de nuestro `sw.js` al inicio de tu archivo service worker existente.
Nota: cada sitio solo puede tener un archivo Service Worker activo.
11API REST de Personyze
Integra Personyze de forma programática con tus sistemas backend para leer o escribir datos.
Capacidades
- Datos de usuario: Envía datos del CRM o actualiza perfiles de usuario.
- Contenido: Actualiza tu catálogo de productos o contenido.
- Eventos: Reporta conversiones offline o eventos del backend.
12SDK móvil (iOS y Android)
Extiende la personalización a tus aplicaciones móviles nativas.
Funcionalidades
- Perfil unificado: Sigue a los usuarios entre web y app.
- Segmentación nativa: Usa comportamientos específicos de la app para la segmentación.
- Notificaciones push: Activa alertas personalizadas.
13Single Sign-On (SSO)
Gestiona el acceso al panel de Personyze usando tu proveedor de identidad enterprise.
Gestión centralizada de usuarios, acceso con un solo clic para empleados y mayor cumplimiento de seguridad.
Proveedores soportados
- Auth0
- Okta
- OneLogin
- Xecurify
Instrucciones de configuración
- Ve a Configuración > Integraciones > Single Sign On en la consola de Personyze.
- Selecciona tu proveedor de la lista.
- Introduce la URL de metadatos o los detalles del certificado requeridos de tu IdP.
- Guarda y prueba la conexión.
Preguntas de configuración, respondidas.
Lo que los equipos preguntan antes de salir en vivo. Para cualquier otra cosa, nuestro equipo está a un mensaje de distancia.
¿El código de seguimiento ralentizará mi sitio web?
No. La etiqueta de Personyze carga de forma asíncrona, lo que significa que se ejecuta en segundo plano y no bloquea el renderizado del contenido principal de la página. Esto asegura que tiene un impacto insignificante en la velocidad del sitio o en Core Web Vitals.
¿Puedo instalar vía Google Tag Manager?
Sí. Este es el método recomendado. Puedes usar nuestra plantilla oficial de GTM (busca “Personyze”) o crear una etiqueta de HTML personalizado. Solo asegúrate de configurar la etiqueta para que se dispare en “Todas las páginas.”
¿Personyze cumple con el RGPD?
Sí. Ofrecemos herramientas para ayudarte a cumplir, incluyendo un “Modo estricto” que deshabilita el seguimiento hasta que se da el consentimiento. También puedes activar el seguimiento solo después de que un usuario acepte cookies vía tu CMP (Consent Management Platform).
¿Cómo sincronizo mi catálogo de productos?
Puedes subir un Product Feed (CSV, XML, JSON) o sincronizar directamente desde Google Merchant Center. Si no tienes un feed, nuestro Site Crawler puede extraer automáticamente los datos de producto desde tus páginas.
¿Y si tengo una Single Page Application (SPA)?
Personyze soporta completamente las SPAs (React, Angular, Vue). Nuestro tracker detecta automáticamente las “virtual pageviews” cuando la URL cambia sin recargar completamente, asegurando que el comportamiento se rastree correctamente a lo largo de la sesión.
¿Puedo hacer seguimiento de usuarios entre dispositivos?
Sí. Si un usuario inicia sesión tanto en escritorio como en móvil (o hace clic en un enlace de email en ambos), Personyze fusiona sus perfiles usando un identificador único (como User ID o Email Hash), dándote una vista unificada de su recorrido.
¿Necesito un desarrollador para configurar objetivos?
No necesariamente. Objetivos sencillos como “Visitas a URL” o “Clics en botón” se pueden configurar con nuestra interfaz visual. Objetivos más complejos, como capturar valores dinámicos de ingresos, pueden requerir conocer el selector CSS o el nombre de la variable de JavaScript.
¿Cómo funciona la integración con el CRM?
Sincronizamos los datos de forma bidireccional. Puedes enviar comportamiento del sitio web (p. ej., “Visitó la página de precios”) a tu CRM, y traer atributos del CRM (p. ej., “Cliente VIP”) a Personyze para personalizar la experiencia del sitio.
¿Puedo usar mi propio remitente de email?
Sí. Aunque proporcionamos un remitente por defecto vía Amazon SES, puedes configurar tu propio servidor SMTP (SendGrid, Mailgun, Outlook) en la configuración para asegurar que los emails provengan de tu propio dominio con control total de entregabilidad.
¿Qué pasa si cambio el tema de mi sitio web?
Si cambias la estructura HTML (IDs o clases CSS), algunos placeholders o reglas “capturar datos” podrían romperse. Recomendamos revisar tus campañas de Personyze después de cualquier rediseño importante del sitio para asegurar que los selectores sigan siendo válidos.
¿Puedo excluir el tráfico interno?
Sí. Puedes filtrar el tráfico de direcciones IP específicas (como la IP de tu oficina) en la configuración de la cuenta para que las visitas de empleados no distorsionen tus datos de analítica.
¿Funciona el seguimiento offline?
Para el seguimiento web, es necesaria una conexión a internet. Sin embargo, si usas nuestro SDK móvil, podemos almacenar los eventos localmente en el dispositivo y sincronizarlos cuando el usuario vuelva a estar en línea.
¿Cuán seguro es la transferencia de datos?
Todos los datos se transmiten vía cifrado HTTPS. Cumplimos protocolos de seguridad estrictos, incluido el cumplimiento de SOC 2, para garantizar que los datos de tus clientes permanezcan seguros.
¿Puedo gestionar varios dominios en una sola cuenta?
Sí. Personyze soporta seguimiento multidominio. Puedes gestionar sitios separados en una cuenta o vincularlos para compartir datos de usuario entre distintos dominios (Cross-Domain Tracking).
¿Qué es un “Service Worker” para notificaciones push?
Un Service Worker es un script que se ejecuta en segundo plano en el navegador. Es necesario para recibir mensajes push incluso cuando el usuario no está activamente en tu sitio web. Debes subir este archivo al directorio raíz de tu servidor.
Pon en marcha la personalización en vivo en tu sitio.
Tienes el playbook completo de configuración — ahora ponlo en marcha. Instala el tracker, define tu primer placeholder y observa cómo tu sitio se adapta a cada visitante.