Audiencias de Tealium en Personyze desde el servidor: de AudienceStream a listas de audiencia

Personyze ya lee Tealium en el navegador: badges, audiencias de AudienceStream y variables utag mientras el visitante está en su página (vea Segmentación y personalización con Tealium). La conexión desde el servidor cubre el resto: los propios servidores de Tealium avisan a Personyze cuando una persona entra en una audiencia de AudienceStream o sale de ella, incluso cuando esa persona no está en su sitio.

Qué hace

• Cada audiencia de Tealium se convierte en una lista de audiencia en Personyze, llamada “Tealium: <nombre de la audiencia>”. Diríjale cualquier campaña: sitio web, correo electrónico u offline.
• Quien entra en la audiencia se añade a la lista; quien sale se elimina. El sitio web ve el cambio en la siguiente página del visitante.
• Los atributos que envíe — nivel de fidelidad, plan, consentimientos, etapa del ciclo de vida — se guardan en el perfil del visitante. Los campos estándar como first_name, last_name o phone rellenan el campo del perfil; todo lo demás se convierte en un atributo personalizado que puede usar para segmentar.

Qué necesita

• Tealium AudienceStream, con permiso para añadir conectores.
• Una clave de API de Personyze: Configuración → Integraciones → Tealium, al final de la sección Enviar audiencias de Tealium a Personyze (desde el servidor), haga clic en Generar nueva clave. Son las mismas claves que las de la tarjeta API completa, así que también sirve una clave que ya tenga.

Configuración paso a paso

1. En Personyze, abra Configuración → Integraciones → Tealium y tome las dos URL de la sección de servidor:
   • URL de entrada: https://personyze.com/api/audiences/tealium?action=joined
   • URL de salida: https://personyze.com/api/audiences/tealium?action=left

   Si usa Personyze con su propio dominio, tome las URL del panel: usan el dominio que está viendo.

2. En Tealium AudienceStream, añada un conector Webhook y elija BasicAuth. Introduzca api como BasicAuth Username, y su clave de API de Personyze como BasicAuth Password. Guarde la clave en un lugar seguro: quien la tenga puede actuar como su cuenta.
3. Añada una acción para la audiencia que quiere enviar:
   • Trigger: Joined Audience
   • Action type: Send Customized Data via HTTP Request (Advanced)
   • Method: POST
   • URL: la URL de entrada
   • Body Content Type: application/x-www-form-urlencoded
4. En Body Data, añada las asignaciones de la tabla. Necesita email o user_id, o ambos.
5. Añada una segunda acción con el trigger Left Audience, las mismas asignaciones y la URL de salida. La función Copy Mappings de Tealium las copia desde la primera acción.
6. Guarde y publique en Tealium.

Asignar también Audience ID, además del nombre, hace que una audiencia renombrada conserve su lista en Personyze. Repita los pasos 3 a 5 para cada audiencia que quiera en Personyze: cada una tiene su propia lista.

Cómo se identifica a las personas

Personyze identifica a cada persona por el ID de usuario que su sitio envía a Personyze cuando alguien inicia sesión, y después por el correo electrónico. Alguien a quien Personyze aún no ha visto también se añade a la lista, y se le reconoce la primera vez que inicia sesión en su sitio. Un mensaje de salida sobre alguien que Personyze nunca ha visto se ignora.

Dónde encontrarlo

Audiencias → Listas de audiencia. Las listas se llaman “Tealium: <nombre de la audiencia>”. Elija una en la segmentación de una campaña con la regla Listas de usuarios. Puede renombrar una lista en Personyze: la sincronización sigue usándola.

Otras formas de enviar los datos

Un cuerpo JSON desde una plantilla

Con Body Content Type application/json, cree una plantilla de cuerpo:

{
  "audience": "{{#escapeJson}}{{audience}}{{/escapeJson}}",
  "audience_id": "{{#escapeJson}}{{audience_id}}{{/escapeJson}}",
  "email": "{{#escapeJson}}{{email}}{{/escapeJson}}",
  "user_id": "{{#escapeJson}}{{user_id}}{{/escapeJson}}",
  "attributes": {
    "loyalty_tier": "{{#escapeJson}}{{tier}}{{/escapeJson}}"
  }
}

Asigne las variables de la plantilla audience, audience_id, email, user_id y tier a sus atributos, y use la URL de entrada o de salida como antes. Envuelva los valores de texto en escapeJson para que unas comillas en un valor no rompan el JSON. También puede enviar la dirección en el cuerpo en lugar de en la URL: "action": "joined" o "action": "left".

Lotes, para grandes volúmenes

Use Send Batched Customized Data via HTTP Request (Advanced) con la misma plantilla, y configure Prefix [, Joiner , y Suffix ]. Tealium envía entonces hasta 100 personas por petición; Personyze acepta hasta 1.000.

El perfil completo del visitante

Send Visitor Data via HTTP Request envía el registro completo del visitante en Tealium, sin nada que asignar. Personyze lee de él las audiencias actuales del visitante:

• Con ?audience=<audience name> al final de la URL, solo se sincroniza esa audiencia: la persona se añade si está en ella y se elimina si no.
• Sin ello, se entra en todas las audiencias del registro, y la persona se elimina de cualquier otra lista “Tealium:” sincronizada por nombre.

Personyze busca el correo en una propiedad llamada Email, Email Address o Customer Email, y el ID de usuario en User ID, Customer ID o CRM ID. Si las suyas se llaman de otra forma, añada email_attribute=<name> o user_id_attribute=<name> a la URL. Las propiedades y los indicadores se guardan en el perfil, con nombres como customer_tier; attributes=none no guarda ninguno, y attributes=Name 1,Name 2 guarda solo esos. Active Print Attribute Names en la acción para que los atributos lleguen con su nombre.

Solo atributos

Una petición sin audiencia solo actualiza el perfil. También funciona desde EventStream: asigne los atributos del evento a email o user_id, y los atributos que quiera.

Límites

• Hasta 1.000 personas por petición, y 5 MB por petición.
• Hasta 100 atributos por persona. Nombres de atributo de hasta 64 caracteres y valores de hasta 1.000; lo que sea más largo se omite, no se recorta.
• Correos electrónicos e ID de usuario de hasta 80 caracteres.
• Nombres de audiencia de hasta 120 caracteres, salvo que envíe también el Audience ID.
• Enviar dos veces el mismo mensaje no causa problemas: nadie se añade dos veces.

Si algo no funciona

Personyze responde a cada petición con un mensaje breve que dice lo que hizo o lo que falla. Tealium lo muestra en el registro del conector.

Relacionado

• Segmentación y personalización con Tealium — el lado del navegador: badges, audiencias y variables utag en la página.
• Amplitude y Mixpanel — la misma sincronización de listas de audiencia para sus cohortes.
• Solución de problemas: una integración ha dejado de sincronizar