Tealium

Tealium es un centro de datos universal y una plataforma de datos de los clientes compuesta por EventStream, AudienceStream e iQ Tag Management que te habilita para conectar datos móviles, web y alternativos de fuentes de terceros. La conexión de Tealium con Braze permite un flujo de datos de eventos personalizados, atributos de usuario y compras que le permiten actuar sobre sus datos en tiempo real.

La integración de Braze y Tealium le permite realizar un seguimiento de sus usuarios y enviar datos a varios proveedores de análisis de usuarios. Tealium te permite:

• Sincronice las audiencias de Tealium con AudienceStream con Braze para utilizarlas en la personalización de campañas y Canvases de Braze o en la creación de segmentos.
• Importar datos entre plataformas. Braze ofrece tanto una integración en paralelo de SDK para tus aplicaciones Android, iOS y Web, como una integración de servidor a servidor que puede utilizarse en cualquier plataforma que pueda informar de datos de eventos.
  
  

• eventstream
• audiencestream
• iq tag management

Requisitos previos

Requisito	Descripción
Cuenta Tealium	Para beneficiarse de esta asociación, es necesario disponer de una cuenta Tealium con acceso al servidor y/o al cliente.
Fuente instalada y bibliotecas fuente de Tealium	Origen de los datos enviados a Tealium, como aplicaciones móviles, sitios web o servidores backend. Debe instalar las bibliotecas en su aplicación, sitio o servidor antes de poder configurar correctamente un conector Tealium.
Punto final REST y SDK de Braze	La URL de tu punto final REST o SDK. Tu punto final dependerá de la URL Braze de tu instancia.
Clave de identificación de la aplicación Braze (sólo en modo lateral)	La clave de identificación de tu aplicación. Se encuentra en el panel de Braze > Administrar configuración > Clave de API.
Versión del código (sólo en paralelo)	Corresponde a la versión del SDK y debe estar en formato major.minor (por ejemplo, 3.2 y no 3.0.1). La versión del código debe ser 3.0 o superior.
Clave REST API (sólo de servidor a servidor)	Una clave de API REST Braze con permisos users.track y users.delete. Se puede crear en el panel de Braze > Consola para desarrolladores > Clave de API REST > Crear nueva clave de API.

Elija su tipo de integración

Integración	Detalles
De lado a lado	Utiliza el SDK de Tealium para traducir los eventos a las llamadas nativas de Braze, lo que permite acceder a características más profundas y un uso más completo de Braze que la integración de servidor a servidor. Si piensas utilizar comandos remotos Braze, ten en cuenta que Tealium no admite todos los métodos Braze (por ejemplo, las tarjetas de contenido). Para utilizar un método Braze que no esté asignado a través de un comando remoto correspondiente, tendrá que invocar el método añadiendo código Braze nativo a su código base.
De servidor a servidor	Reenvía los datos de Tealium a los puntos finales de la API REST de Braze. No es compatible con las funciones de la interfaz de usuario Braze, como la mensajería dentro de la aplicación, las tarjetas de contenido o las notificaciones push. También existen datos capturados automáticamente, como los campos a nivel de dispositivo, que no están disponibles a través de este método. Considera una integración en paralelo si deseas utilizar estas características.

Integración de SDK en paralelo

Comandos a distancia

Los comandos remotos son una función de las bibliotecas Tealium para iOS y Android que permiten realizar llamadas desde el SDK de Tealium -a través de los servidores Braze- a Braze. El módulo de comandos remotos Braze instalará y creará automáticamente las bibliotecas Braze necesarias y se encargará de toda la renderización de mensajes y el seguimiento analítico. Para utilizar el mando a distancia móvil Braze, necesitarás tener instaladas bibliotecas Tealium en tus aplicaciones.

Tealium ofrece dos formas de integrar Mobile Remote Command; además, no hay pérdida de funcionalidad entre los tipos de integración y el código nativo subyacente es idéntico.

Método de mando a distancia móvil	Pros	Contras
Etiqueta de mando a distancia	Modifique fácilmente las asignaciones y los datos enviados al mando a distancia mediante la interfaz de usuario de Tealium iQ. Esto nos permite enviar datos o eventos adicionales a un SDK de terceros después de que la aplicación ya esté en la tienda de aplicaciones, sin que el cliente tenga que actualizar la aplicación.	El módulo de administrador de etiquetas de la aplicación se basa en una webview oculta para procesar JavaScript.
Fichero de configuración JSON (Recomendado)	Utilizar el método JSON elimina la necesidad de tener una webview oculta en la aplicación y reduce enormemente el consumo de memoria. El archivo JSON puede alojarse de forma remota o local dentro de la aplicación del cliente.	Por el momento, no hay interfaz de usuario para gestionar esto, por lo que requiere un poco de esfuerzo adicional. Nota: Tealium está trabajando en la adición de una interfaz de usuario de gestión que va a resolver este problema y llevar el mismo nivel de flexibilidad a los comandos remotos JSON como lo han hecho con la versión de gestión de iQ Tag

Utilice las asignaciones de datos de comandos remotos Braze mobile para establecer atributos de usuario predeterminados y atributos personalizados y realizar un seguimiento de las compras y los eventos personalizados. Consulte la tabla siguiente para conocer los métodos de soldadura correspondientes.

Mando a distancia	Método Braze
appendcustomarrayattribute	addToCustomAttributeArrayWithKey()
notificación por correo electrónico	setEmailNotificationSubscriptionType()
incrementaratributopersonalizado	incrementCustomAttribute()
Initalizar	startWithApiKey()
logcustomevent	logEventoPersonalizado()
registrocompra	logCompra()
pushnotification	setPushNotificationSubscriptionType()
eliminaratributopersonalizado	setCustomAttributeWithKey()
setcustomattribute	setCustomAttributeArrayWithKey()
setcustomarrayattribute	setCustomAttributeArrayWithKey()
setlastknownlocation	setLastKnownLocationWithLatitude()
unsetcustomattribute	unsetCustomAttributeWithKey()
useralias	addAlias()
atributo de usuario	ABKUser()
identificador de usuario	cambiarUsuario()

Puede encontrar más detalles sobre cómo configurar el comando remoto móvil Braze y una descripción general de los métodos compatibles en la documentación para desarrolladores de Tealium:

• Mando a distancia
• Etiqueta de mando a distancia

Etiqueta SDK Web Braze

Utiliza la etiqueta SDK Braze Web para desplegar el SDK Braze Web en tu sitio web. Tealium iQ Tag Management permite a los clientes añadir Braze como etiqueta dentro del panel de control de Tealium para realizar un seguimiento de la actividad de los visitantes. Los profesionales del marketing suelen utilizar las etiquetas para conocer la eficacia de la publicidad en línea, el marketing por correo electrónico y la personalización de sitios web.

1. En Tealium, ve a iQ > Etiquetas > + Añadir etiqueta > Braze Web SDK.
2. En el cuadro de diálogo Configuración de etiquetas, introduzca la clave API (su clave de identificador de la aplicación Braze), la URL base (punto final del SDK Braze) y la versión del código del SDK Braze Web. También puede activar el registro para registrar información en la consola web con fines de depuración.
3. En el cuadro de diálogo Reglas de carga, elija “Cargar en todas las páginas” o seleccione Crear regla para determinar cuándo y dónde cargar una instancia de esta etiqueta en su sitio.
4. En las Asignaciones de datos seleccione Crear asignaciones para asignar datos Tealium a Braze. Las variables de destino de la etiqueta SDK Web de Braze están integradas en la pestaña Mapeado de datos de la etiqueta. En las tablas siguientes se enumeran las categorías de destino disponibles y se describe cada nombre de destino.
5. Selecciona el Acabado.

Recursos de integración en paralelo

• Mando a distancia iOS: Documentación de Tealium, repositorio GitHub de Tealium
• Mando a distancia Android: Documentación de Tealium, repositorio GitHub de Tealium
• Etiqueta SDK Web: Documentación sobre Tealium

Integración de servidor a servidor

Esta integración reenvía datos de Tealium a la API REST de Braze.

La integración de servidor a servidor no es compatible con las funciones de la interfaz de usuario Braze, como la mensajería dentro de la aplicación, las tarjetas de contenido o las notificaciones push. También existen datos capturados automáticamente (como los campos a nivel de dispositivo) que no están disponibles a través de este método.

Si deseas utilizar estos datos y estas características, considera nuestra integración de SDK en paralelo.

Paso 1: Configurar una fuente

Tealium requiere que primero configures una fuente de datos válida para que tu conector se nutra de ella.

1. En la barra lateral de Tealium, en el lado del servidor, ve a Fuentes > Fuentes de datos > + Añadir origen de datos.
2. Localiza la plataforma que desees dentro de las categorías disponibles, y nombra tu fuente, este es un campo obligatorio.
   
3. En las opciones de Especificaciones del evento, elija las especificaciones del evento que desea incluir. Las especificaciones de eventos le ayudan a identificar los nombres de los eventos y los atributos necesarios para realizar un seguimiento en su instalación. Estas especificaciones se aplicarán a los eventos entrantes.
   
   Tómate un tiempo para pensar qué datos son más valiosos para ti y qué especificaciones parecen las más adecuadas para tu caso de uso. También hay disponibles especificaciones personalizadas para eventos.
   
4. El siguiente diálogo avanza al paso Obtener Código. El código base y el código de seguimiento de eventos proporcionados aquí le servirán de guía para la instalación. Descargue el PDF proporcionado si desea compartir estas instrucciones con su equipo. Selecciona Guardar & Continuar cuando hayas terminado.
   
5. Ahora podrá ver su fuente guardada, así como añadir o eliminar especificaciones de eventos.
   
   Desde la vista detallada de la fuente de datos puede realizar las siguientes acciones:
   • Ver y copiar la clave de la fuente de datos
   • Ver instrucciones de instalación
   • Volver a la página Obtener código
   • Añadir o eliminar especificaciones de eventos
   • Navegue para ver los eventos en directo relacionados con una especificación de evento
   • Y más…
     
6. Por último, seleccione Guardar / Publicar en la parte superior de la página. Si no publicas tu fuente, no podrás encontrarla al configurar tu conector Braze.

Consulte Fuentes de datos para obtener más instrucciones sobre cómo configurar y editar su fuente de datos.

Paso 2: 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 sus socios.

1. Desde la barra lateral en Tealium bajo Server-Side, navegue a EventStream > Event Connectors.
2. 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.
3. Para añadir este conector, haz clic en la ficha del conector Braze. Al hacer clic, puede 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

Una vez configurada la fuente, vuelve a la página del conector Braze en EventStream > Conectores de eventos > + Añadir conector > Braze.

A continuación, selecciona el origen de datos que acabas de crear y, en Fuente de eventos, selecciona Todos los eventos o una especificación de eventos concreta, la ruta recomendada para enviar a Braze sólo los valores modificados. Seleccione Continuar.

Configuración

A continuació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 ha creado un conector anteriormente, puede utilizar uno existente de la lista de conectores disponibles y modificarlo para adaptarlo a sus necesidades con el icono del lápiz o eliminarlo con el icono de la papelera.

Acción

A continuación, asigna un nombre a tu acción de conector y selecciona un tipo de acción que enviará datos según la asignación que configures. Aquí, asignará atributos, eventos y compras Braze a nombres de atributos, eventos y compras Tealium.

• track user - batch and non-batch
• delete user - non-batch

Seleccione Continuar.

Tu conector aparece ahora en la lista de conectores de tu página de inicio de Tealium.

Asegúrate de seleccionar Guardar / Publicar para tu conector cuando hayas terminado. Las acciones que configuraste se dispararán ahora cuando se cumplan las conexiones desencadenantes.

Paso 3: Pruebe su 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úrese de que ha añadido la extensión de navegador Tealium Tools.

1. Para iniciar una nueva traza, seleccione Traza en la barra lateral, en Opciones del lado del servidor. Selecciona Iniciar y captura el ID de rastreo.
2. Abre la extensión del navegador e introduce el ID de rastreo en AudienceStream Trace.
3. Examina el registro en tiempo real.
4. Busca la acción que quieras validar seleccionando la entrada Acciones desencadenantes para ampliarla.
5. 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 de registrar accidentalmente puntos de datos innecesarios al integrar Braze a través de Tealium:

Envío de datos duplicados: envíe sólo deltas de atributos Braze

Tealium no envía deltas Braze de atributos de usuario. Por ejemplo, si tiene una acción EventStream que rastrea el nombre, el correo electrónico y el número de teléfono móvil de un usuario, Tealium enviará los tres atributos a Braze cada vez que se active 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 almacena su propia versión de un perfil de usuario en su backend y no puede saber si los atributos cambian o no, puede utilizar AudienceStream y crear enriquecimientos para enviar atributos de usuario sólo cuando los valores hayan cambiado. Consulte la documentación de Tealium sobre las reglas de enriquecimiento.

Envío de datos irrelevantes o sobrescritura innecesaria de datos.

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. Esto también podría provocar que se sobrescribieran datos en Braze y se registraran puntos de datos innecesarios.

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.