Guía de integración de Segment con Personyze

Segment y Personyze intercambian datos en ambos sentidos.

• Segment → Personyze. Segment envía llamadas identify a Personyze. Cada llamada crea o actualiza un perfil de visitante de Personyze a partir de sus traits. Esos traits pueden venir de su CRM, de su plataforma de email, de transacciones offline y de los traits calculados y las audiencias de Segment Engage. Después puede usarlos en reglas de segmentación, contenido dinámico, recomendaciones e informes.
• Personyze → Segment. Personyze envía eventos de campaña (impresiones, clics, conversiones) a Segment. En su web pasan por analytics.js de Segment; desde las automatizaciones, por la API de servidor de Segment.

Puede configurar cada sentido por separado, o ambos.

Parte 1: Enviar datos de Segment a Personyze

Paso 1: Generar una clave de Segment en Personyze

1. En el panel de Personyze, abra Configuración → Integraciones.
2. Busque la tarjeta Segment y haga clic en ella.
3. En la sección Segment → Personyze, haga clic en Generar nueva clave.
4. Guarde la clave en un lugar seguro — la introducirá en Segment.

Estas claves de Segment son independientes de sus claves de la API completa. Si revoca una aquí, solo se desconecta Segment.

Paso 2: Añadir el destino Personyze en Segment

1. En Segment, abra Connections → Catalog → Destinations.
2. Busque Personyze y selecciónelo.
3. Elija la fuente que debe enviar datos a Personyze. Normalmente es la fuente de su web.
4. En la configuración del destino, introduzca la clave del paso 1 en API Key.
5. Guarde y active el destino.

A partir de ahora, cada llamada identify de esa fuente crea o actualiza un perfil de visitante de Personyze.

Paso 3: Vincular el ID de visitante de Segment con el visitante de la web (recomendado)

Así se conecta el perfil que construye Segment con el visitante que Personyze ve en su web.

1. En Personyze, vaya a Configuración → Atributos del visitante.
2. Abra Identificadores de usuario entre dispositivos.
3. Cree un identificador Internal ID de tipo Cookie que lea la cookie ajs_anonymous_id .
4. Guárdelo y actívelo.

Alternativa: enviar llamadas identify a la URL del webhook

Use esta opción si no puede usar el destino Personyze — por ejemplo, con un destino Webhooks de Segment o con otra CDP.

Ejemplo de cuerpo:

{
  "type": "identify",
  "userId": "u-1029",
  "anonymousId": "5b1c2e9a-7c1f-4f0e-9b1e-2a3c4d5e6f70",
  "traits": {
    "email": "dana@example.com",
    "firstName": "Dana",
    "plan": "pro"
  }
}

En lugar de la cabecera Bearer también puede usar la autenticación HTTP Basic, con la clave como nombre de usuario y la contraseña vacía.

Lo que llega a Personyze

• Una llamada identify crea o actualiza un perfil a partir de sus traits. Los nombres de traits en camelCase pasan a snake_case (firstName pasa a ser first_name). Los traits que coinciden con un campo del perfil de Personyze rellenan ese campo. Todo lo demás se guarda como atributo de visitante personalizado.
• Gestión de la identidad. Cuando una llamada lleva previousId o anonymousId junto con userId, Personyze reasigna el perfil existente al userId. Un visitante que era anónimo antes de iniciar sesión conserva su historial en lugar de recibir un segundo perfil.
• Engage. Los traits calculados y las audiencias llegan como traits normales de identify (por ejemplo order_completed_last_30days: true). Segment indica que la primera sincronización de audiencias puede tardar seis horas o más.

Parte 2: Enviar eventos de campaña de Personyze a Segment

Desde su web (analytics.js)

Funciona en las páginas donde está instalado analytics.js de Segment. Personyze nunca carga analytics.js por usted. En una página sin él, no se envía nada y nada se rompe.

Cada evento se envía con analytics.track() y recibe el nombre de la acción de campaña. Una impresión se ve así:

analytics.track('<action name>', {event: 'shown', source: 'personyze'})

Puede elegir qué eventos van a Segment de tres maneras:

1. Todas las campañas. Abra Configuración → Integraciones → Segment. En la sección Personyze → Segment, active Reportar aquí los eventos de campaña. Las impresiones, los clics y las conversiones de todas las campañas se envían a Segment.
2. Una acción. En la configuración de eventos de la acción, marque Segment en Enviar este evento a. Así reporta a Segment los eventos de una acción concreta, con su propio nombre de evento y sus propiedades.
3. Un evento personalizado. Añada la acción Send Event to Analytics a una campaña y marque Segment. Usted elige el nombre del evento y las propiedades.

Desde automatizaciones (API de servidor de Segment)

Funciona sin que el visitante esté en su web — por ejemplo, cuando la audiencia de una campaña offline coincide con alguien.

1. En Segment, consulte la write key de la fuente que debe recibir los eventos (Connections → Sources → su fuente → Settings → API Keys).
2. En Personyze, añada la acción Send Event to Analytics (Automation) a la automatización.
3. Marque Segment e introduzca la write key en Segment write key.
4. Guarde y publique.

Cada usuario que coincide se envía a Segment como un evento track . Su dirección de email se usa como userIdde Segment. Los usuarios sin dirección de email se omiten.

Usar los datos de Segment en Personyze

Segmentación

Los traits de Segment aparecen como campos de perfil en las reglas de segmentación. Añada reglas de audiencia sobre datos demográficos, cargo, etapa del embudo o cualquier trait personalizado.

Contenido dinámico

Inserte campos de Segment como variables dinámicas en las campañas, por ejemplo «Bienvenido de nuevo, {first_name}».

Recomendaciones

Use los datos del perfil como filtros de recomendación, o deje que los algoritmos los usen automáticamente.

¿Necesita ayuda?

Escriba a info@personyze.com.

En el sitio de Personyze

• Personalización con Segment y Personyze — activar audiencias de Segment en su web.
• Personalización web — el motor de segmentación y contenido que hay detrás.