Tealium AudienceStream
Tealium AudienceStream es un motor de segmentación de clientes omnicanal y de acción en tiempo real. AudienceStream toma los datos que fluyen hacia EventStream y crea perfiles de visitantes que representan los atributos más importantes de la interacción de tus clientes con tu marca.
La integración de Braze y Tealium aprovecha los perfiles de visitantes de AudienceStream. Los comportamientos compartidos segmentan estos perfiles para crear conjuntos de visitantes con rasgos comunes, conocidos como audiencias. Estas audiencias pueden ayudar a alimentar tu stack tecnológico de marketing en tiempo real mediante conectores.
Tealium AudienceStreams y EventStreams ofrecen acciones de conector por lotes y no por lotes. El conector no por lotes debe utilizarse cuando las solicitudes en tiempo real sean importantes para el caso de uso y no haya preocupación por superar las especificaciones del límite de velocidad de la API de Braze. Ponte en contacto con el soporte de Braze o con tu administrador del éxito del cliente si tienes alguna pregunta.
Requisitos previos
| Apellidos | Descripción |
|---|---|
| Cuenta Tealium | Se necesita una cuenta Tealium con acceso al servidor. Recomendamos utilizar también las integraciones del lado del cliente para aprovechar esta asociación. |
| Clave de API REST | Una clave de API REST Braze con permisos users.track, users.delete, y subscription.status.set.Se puede crear en el panel de Braze > Consola para desarrolladores > Clave de API REST > Crear nueva clave de API |
| Punto final REST Braze | La URL de su punto final REST. Tu punto final dependerá de la URL Braze de tu instancia. |
Integración
Paso 1: Configurar atributos y señales
Comprensión de los atributos
El primer paso para utilizar AudienceStream es crear atributos. Los atributos te permiten definir las características importantes que representan los hábitos, preferencias, acciones e interacción de un visitante con tu marca.
Atributos de la visita: Los atributos de visita se refieren a la visita (o sesión) actual del usuario. Los datos almacenados en estos atributos persisten mientras dura la visita. Algunos ejemplos de atributos de visita son:
- Duración de la visita (número)
- Navegador actual (cadena)
- Dispositivo de corriente (cadena)
- Número de páginas vistas
Atributos del visitante: Los atributos de los visitantes se refieren al usuario actual. Los datos almacenados en estos atributos persisten durante toda la vida del usuario. Algunos ejemplos de atributos del visitante son:
- Valor de duración del pedido (Número)
- Nombre (cadena)
- Fecha de nacimiento
- Compras/Marcas (Tally)
Visita Tealium para consultar la lista completa de tipos de datos disponibles.
Enriquecimiento de atributos
Una vez identificados los atributos deseados, puedes configurarlos con enriquecimientos: reglas empresariales que determinan cuándo y cómo actualizar los valores de los atributos. Cada tipo de dato ofrece su propia selección de enriquecimientos para manipular el valor del atributo. Está asociado a la configuración “CUANDO”. Las siguientes opciones están disponibles para cada atributo de visita y visitante:
- Nuevo visitante: se produce la primera vez que un visitante entra en tu sitio.
- Nueva visita: se produce en una nueva visita de un visitante.
- Cualquier suceso: se produce en cualquier suceso.
- Visita finalizada: se produce cuando termina una visita.
También puedes crear una condición personalizada, llamada regla, que determinará cuándo se producirá el enriquecimiento.
Señales
Las señales son atributos especiales de los visitantes que representan patrones de comportamiento valiosos. Las señales se asignan o retiran a los visitantes en función de la lógica de sus enriquecimientos. Esta lógica suele combinar varias condiciones para captar segmentos de visitantes o establece un umbral para cuando se alcanza un valor concreto.
Ejemplo de atributo y señal
Crea un atributo de visitante “Valor de duración del pedido” que calcule el importe acumulado gastado (order_total) por el cliente para todos los pedidos completados (evento de compra). Para configurar el valor de duración del pedido en tu cuenta de Tealium, sigue las siguientes instrucciones:
- Ve a AudienceStream > Atributos de visitantes/visitas y haz clic en Añadir atributo.
- Selecciona el ámbito como Visitante y haz clic en Continuar.
- Selecciona el tipo de dato Número y haz clic en Continuar.
- Introduce el nombre del atributo, “Valor de duración del pedido”.
- Haz clic en Añadir enriquecimiento y selecciona Aumentar o Disminuir número.
- Selecciona el atributo que contiene el valor a incrementar (
order_total). - Deja “CUANDO” en “Cualquier suceso” y, a continuación, haz clic en Crear una nueva regla.
- Crea una regla que identifique cuándo se ha producido un evento de compra.
- Haz clic en Guardar y luego en Finalizar.
Ahora, todos los clientes tendrán un atributo de valor de duración del pedido vinculado a ellos.
Puedes crear señales que te ayuden a clasificar y dirigirte a tus usuarios por determinados atributos que comparten. En el siguiente ejemplo, creamos una señal VIP para usuarios con un “Valor de pedido de por vida” superior a 500 $.
- Ve a AudienceStream > Atributos de visitantes/visitas y haz clic en Añadir atributo.
- Selecciona el ámbito como Visitante y haz clic en Continuar.
- Selecciona el tipo de datos Señal y haz clic en Continuar.
- Introduce el nombre de la señal, “VIP”.
- Haz clic en Añadir enriquecimiento y selecciona Asignar señal.
- Deja “CUANDO” en “Cualquier evento”.
- Crea una regla para asignar señales seleccionando Crear regla. Asigna un título a esta regla y, utilizando el atributo creado anteriormente, establece la regla como “…tiene el atributo “Valor del pedido durante la vida útil superior a 500”.
- Haz clic en Guardar y luego en Finalizar.
Paso 2: Crear una audiencia
En la página de inicio de Tealium, selecciona Audiencias en AudienceStream en la barra lateral de navegación. Aquí puedes crear una audiencia de usuarios con atributos comunes. La entrada o salida de un usuario de esta audiencia será el desencadenante de la Acción desencadenante, configurada en el paso siguiente, que pasa esta información al perfil de usuario en Braze.
En primer lugar, nombra a tu audiencia y, a continuación, considera qué atributos se aplicarían al tipo de audiencia que intentas crear. Por ejemplo, para crear una audiencia de usuarios VIP, podrías crear una audiencia de visitantes que tengan la señal VIP.
Asegúrate de Guardar / Publicar tu audiencia cuando hayas terminado.
Paso 3: Crear un conector de eventos
Un conector es una integración entre Tealium y otro proveedor utilizada para transmitir datos. Estos conectores contienen acciones que representan las API compatibles de su socio.
- En la barra lateral de Tealium, en el lado del servidor, ve a AudienceStream > Conectores de audiencia.
- Selecciona el botón azul + Añadir conector para buscar en el mercado de conectores. En el nuevo cuadro de diálogo que aparece, utiliza la búsqueda rápida para encontrar el conector Braze.
- Para añadir este conector, haz clic en la ficha del conector Braze. Al hacer clic, puedes ver el resumen de la conexión y una lista de la información necesaria, las acciones admitidas y las instrucciones de configuración. La configuración consta de tres pasos: origen, configuración y acción.
Fuente
En el cuadro de diálogo Fuente que aparece, selecciona la audiencia que creaste en el paso anterior y un desencadenante que consideres adecuado para tu situación. También puedes alternar el límite de frecuencia para controlar la frecuencia con la que se desencadena esta acción.
Configuración
A continuación, aparecerá un diálogo de Configuración. Selecciona Añadir conector en la parte inferior de la página. Da un nombre a tu conector y proporciona aquí tu punto final de la API Braze y tu clave de API REST Braze.
Si ya has creado antes un conector, puedes utilizar opcionalmente uno existente de la lista de conectores disponibles y modificarlo para adaptarlo a tus necesidades con el icono del lápiz o eliminarlo con el icono de la papelera.
Cuando hayas creado o seleccionado un conector para vincular esta audiencia, haz clic en Listo para continuar.
Acción
A continuación, asigna un nombre a tu acción de conector y selecciona un tipo de acción que envíe datos según el mapeado que configures. Aquí mapearás atributos Braze con nombres de atributos Tealium. Dependiendo del tipo de acción que elijas, habrá una selección variada de campos requeridos por Tealium. A continuación se dan ejemplos y explicaciones de estos campos.
No todos los campos ofrecidos son obligatorios.
Esta acción le permite realizar un seguimiento de los atributos de usuario, evento y compra en una sola acción. Aunque la acción Seguir usuario es la misma para AudienceStream y EventStream, Tealium recomienda configurar los mapeados de atributos de usuario con acciones de AudienceStream y los mapeados de eventos y compras con acciones de EventStream.
| Parámetros | Descripción |
|---|---|
| ID de usuario | Utilice este campo para asignar el campo ID de usuario Tealium a su equivalente Braze. Asigna uno o más atributos de ID de usuario. Cuando se especifican varios ID, se elige el primer valor que no está en blanco según el siguiente orden de prioridad: ID externo, ID Braze, Nombre de alias y Etiqueta de alias. - El ID externo y el ID Braze no deben especificarse si se importan tokens push. - Si se especifica un alias de usuario, deben establecerse el nombre y la etiqueta del alias. Para más información, consulta el punto final de /users/track de Braze. |
| Atributos del usuario | Utiliza los nombres de campo de perfil de usuario Braze existentes para actualizar los valores de perfil de usuario en el panel Braze o añade tus propios datos de atributo personalizado de usuario a los perfiles de usuario. - Por defecto, se crearán nuevos usuarios si no existe ninguno. - Si configura Actualizar sólo existentes en true, sólo se actualizarán los usuarios existentes y no se creará ningún usuario nuevo.- Si un atributo Tealium está vacío, se convertirá en nulo y se eliminará del perfil de usuario Braze. Los enriquecimientos deben utilizarse si no deben enviarse valores nulos a Braze para eliminar un atributo de usuario. |
| Modificar los atributos del usuario | Utilice este campo para aumentar o disminuir ciertos atributos de usuario - Los atributos enteros pueden incrementarse con enteros positivos o negativos. - Los atributos de las matrices pueden modificarse añadiendo o eliminando valores de las matrices existentes. |
| Evento | Un evento representa una ocurrencia única de un evento personalizado por un usuario particular en una marca de tiempo. Utilice este campo para rastrear y asignar atributos de evento como los del objeto de evento Braze. - El atributo de evento Name es necesario para cada evento asignado.- El atributo de evento Time se establece automáticamente en now a menos que se asigne explícitamente. - Por defecto, se crearán nuevos eventos si no existe ninguno. Estableciendo Update Existing Only a true, sólo se actualizarán los eventos existentes, y no se creará ningún evento nuevo.- Mapa de atributos de tipo array para añadir múltiples eventos. Los atributos de tipo array deben tener la misma longitud. - Se pueden utilizar atributos de valor único y aplicarlos a cada evento. |
| Plantilla de eventos | Proporcionar plantillas de eventos a las que hacer referencia en los datos del cuerpo. Las plantillas pueden utilizarse para transformar los datos antes de enviarlos a Braze. Consulte la Guía de plantillas de Tealium para obtener más información. |
| Variable de plantilla de evento | Proporcione variables de plantilla de eventos como entrada de datos. Consulte la Guía de Variables de Plantilla de Tealium para obtener más información. |
| Compra | Utilice este campo para rastrear y asignar atributos de compra del usuario como los del objeto de compra Braze. - Los atributos de compra Product ID, Currency y Price son necesarios para cada compra mapeada.- El atributo de compra Time se establece automáticamente en now a menos que se asigne explícitamente.- Por defecto, se crearán nuevas compras si no existe ninguna. Si configura Update Existing Only en true, sólo se actualizarán las compras existentes y no se creará ninguna compra nueva.- Asignar atributos de tipo array para añadir múltiples artículos de compra. Los atributos de tipo array deben tener la misma longitud. - Se pueden utilizar atributos de valor único y se aplicarán a cada artículo. |
| Plantilla de compra | Las plantillas pueden utilizarse para transformar los datos antes de enviarlos a Braze. - Defina una plantilla de compra si necesita compatibilidad con objetos anidados. - Cuando se define una plantilla de compra, la configuración establecida en la sección de compras de su acción será ignorada. - Consulte la Guía de plantillas de Tealium para obtener más información. |
| Variable del modelo de compra | Proporcione variables de plantilla de productos como entrada de datos. Consulte la Guía de Variables de Plantilla de Tealium para obtener más información. |
Esta acción te permite eliminar usuarios del panel de Braze.
| Parámetros | Descripción |
|---|---|
| ID de usuario | Utiliza este campo para mapear el campo ID de usuario de Tealium a su equivalente en Braze. - Mapea uno o más atributos de ID de usuario. Cuando se especifican varios ID, se elige el primer valor que no está en blanco según el siguiente orden de prioridad: ID externo, ID Braze, Nombre de alias y Etiqueta de alias. - Al especificar un alias de usuario, deben establecerse tanto el Nombre de alias como la Etiqueta de alias. Para más información, consulta el punto final /users/delete de Braze. |
Esta acción te permite añadir o eliminar usuarios de los grupos de suscripción por SMS o correo electrónico de Braze.
| Parámetros | Descripción |
|---|---|
| Tipo de grupo | Utiliza este campo para indicar si se trata de un grupo de suscripción por SMS o correo electrónico. |
| Tipo de actualización | Mapea esta acción a un evento de cancelar suscripción o suscripción |
| Atributos | - ID del grupo de suscripción (obligatorio): El ID del grupo de suscripción relacionado con el tipo de grupo mapeado en el campo anterior. - ID externo: El ID externo del usuario. Correo electrónico específico del grupo: - Correo electrónico: La dirección de correo electrónico del usuario. Si el ID externo no está definido, se requerirá el correo electrónico. Específico del grupo SMS: - Teléfono: El número de teléfono en formato E.164. Por ejemplo, +14155552671. Si el ID externo no está definido, se requerirá el teléfono. |
Selecciona Finalizar.
Resumen
Visualiza el resumen del conector que has creado. Si quieres modificar las opciones elegidas, selecciona Atrás para editar o Finalizar para terminar.
Tu conector aparece ahora en la lista de conectores de tu página de inicio de Tealium.
Asegúrate de guardar o publicar tu conector cuando hayas terminado. Las acciones que configuraste se dispararán ahora cuando se cumplan las conexiones desencadenantes.
Paso 4: Prueba tu conector Tealium
Una vez que el conector esté en funcionamiento, debes probarlo para asegurarte de que funciona correctamente. La forma más sencilla de comprobarlo es utilizar la Herramienta de Rastreo de Tealium. Para empezar a utilizar Trace, asegúrate de que has añadido la extensión de navegador Herramientas de Tealium.
- Para iniciar un nuevo rastreo, selecciona Rastreo en la barra lateral, en Opciones del lado del servidor. Haga clic en Iniciar y capture el ID de Traza.
- Abre la extensión del navegador e introduce el ID de rastreo en AudienceStream Trace.
- Examina el registro en tiempo real.
- Compruebe la acción que desea validar haciendo clic en la entrada Acciones desencadenadas para expandirla.
- Busca la acción que quieras validar y visualiza el estado del registro.
Consulta la documentación de Trace de Tealium para obtener instrucciones más detalladas sobre la aplicación de la herramienta Trace de Tealium.
Demostración de integración
Posibles excesos de puntos de datos
Hay tres formas principales en las que puedes incurrir accidentalmente en excedentes de datos al integrar Braze a través de Tealium:
Envío de datos duplicados - envía sólo deltas Braze de atributos
Tealium no envía deltas Braze de atributos de usuario. Por ejemplo, si tienes una acción EventStream que realiza un seguimiento del nombre, correo electrónico y número de móvil de un usuario, Tealium enviará los tres atributos a Braze cada vez que se desencadene la acción. Tealium no buscará lo que ha cambiado o se ha actualizado y sólo enviará esa información.
Solución:
Puede comprobar su backend para evaluar si un atributo ha cambiado o no y, en caso afirmativo, llamar a los métodos pertinentes de Tealium para actualizar el perfil del usuario. Esto es lo que suelen hacer los usuarios que integran Braze directamente.
O
Si no almacenas tu propia versión de un perfil de usuario en tu backend y no puedes saber si los atributos cambian o no, puedes utilizar AudienceStream y crear enriquecimientos para enviar sólo los atributos de usuario cuando los valores hayan cambiado.
Enviar datos irrelevantes o sobrescribir datos innecesariamente
Si tienes varios EventStreams dirigidos a la misma fuente de eventos, todas las acciones habilitadas para ese conector se dispararán automáticamente cada vez que se desencadene una sola acción, lo que también podría provocar que los datos se sobrescribieran en Braze.
Solución:
Configure una especificación de evento o feed independiente para realizar un seguimiento de cada acción.
O
Desactiva las acciones (o conectores) que no quieras que se activen utilizando los botones del panel de control de Tealium.
Inicializar Braze demasiado pronto
Los usuarios que se integren con Tealium utilizando la etiqueta SDK de la Web de Braze pueden ver un aumento espectacular de sus MAU. Si Braze se inicializa al cargar la página, Braze creará un perfil anónimo cada vez que un internauta navegue por el sitio web por primera vez. Algunos pueden querer rastrear el comportamiento del usuario sólo cuando los usuarios han completado alguna acción, como “Iniciar sesión” o “Ver vídeo”, para reducir su recuento de MAU.
Solución:
Configure reglas de carga para determinar exactamente cuándo y dónde se carga una etiqueta en su sitio.
Editar esta página en GitHub