mParticle de Rokt

Con la plataforma de datos de los clientes de mParticle, podrás hacer mucho más con tus datos. Los especialistas en marketing más sofisticados utilizan mParticle para orquestar los datos de todo su stack de crecimiento, lo que les permite ganar en los momentos clave del recorrido del cliente.

La integración de Braze y mParticle te permite controlar fácilmente el flujo de información entre ambos sistemas:

• Sincroniza las audiencias de mParticle con Braze para la segmentación de campañas de Braze y Canvas.
• Comparte datos entre las dos plataformas. Esto puede hacerse mediante la integración del kit de mParticle y la integración de servidor a servidor.
• Envía la interacción del usuario de Braze a mParticle a través de Currents, haciéndola procesable en todo el stack de crecimiento.

Requisitos previos

Requisito	Descripción
Cuenta de mParticle	Se necesita una cuenta de mParticle para beneficiarse de esta asociación.
Instancia de Braze	Tu instancia de Braze se encuentra en la página de resumen de la API (por ejemplo, US-01 o US-02).
Clave de identificación de la aplicación Braze	La clave de identificación de tu aplicación. Puedes encontrarla en Administrar configuración > Clave de API en el panel de Braze.
Clave de API REST del espacio de trabajo	(De servidor a servidor) Una clave de API REST de Braze Se puede crear en Consola para desarrolladores > Configuración de API > Clave de API en el panel de Braze.

Integración

Audiencias

Utiliza la asociación de Braze y mParticle para configurar tu integración e importar audiencias de mParticle directamente a Braze para reorientar, creando un bucle completo de datos de un sistema a otro.

Cualquier integración que configures registrará puntos de datos. Si tienes alguna pregunta sobre los matices de los puntos de datos de Braze, tu director de cuentas de Braze puede responderte.

Reenviar audiencias

mParticle ofrece tres formas de establecer los atributos de pertenencia a la cohorte, controlados por el ajuste de configuración “Enviar segmentos como”. Consulta las secciones siguientes para conocer el tratamiento de cada opción:

• Atributo de cadena única
• Atributo de matriz única
• Un atributo por segmento
• Atributo de matriz única y atributo de cadena única
• Atributo de matriz única y un atributo por segmento
• Atributo de cadena única y un atributo por segmento
• Atributo de matriz única, atributo de cadena única y un atributo por segmento

Atributo de cadena única

mParticle creará un único atributo personalizado llamado SegmentMembership. El valor de este atributo es una cadena de ID de audiencia de mParticle separados por comas que coinciden con el usuario. Estos ID de audiencia se pueden encontrar en el dashboard de mParticle en Audiencias.

Por ejemplo, si una audiencia de mParticle “Ibiza dreamers” tiene un ID de audiencia de “11036”, puedes segmentar estos usuarios con el filtro SegmentMembership — matches regex — 11036.

Aunque esta es la opción predeterminada en mParticle, la mayoría de los usuarios de la empresa optan por utilizar atributos de matriz única para la experiencia de filtrado al crear segmentos en Braze.

Atributo de matriz única

mParticle crea un único atributo de matriz personalizado en Braze para cada usuario, denominado SegmentMembershipArray. El valor de este atributo es una matriz de ID de audiencia de mParticle que coinciden con el usuario.

Por ejemplo, si un usuario es miembro de tres audiencias de mParticle con los ID de audiencia “13053”, “13052” y “13051”, puedes segmentar a los usuarios que coincidan con una de esas audiencias con el filtro SegmentMembershipArray — includes value — 13051.

Un atributo por segmento

mParticle creará un atributo personalizado Booleano para cada audiencia a la que pertenezca un usuario. Por ejemplo, si una audiencia de mParticle se llama “Possible Parisians”, puedes segmentar a estos usuarios con el filtro In Possible Parisians - equals - true.

Atributo de matriz única y atributo de cadena única

mParticle enviará los atributos tal y como se describen tanto en el atributo de matriz única como en el atributo de cadena única.

Atributo de matriz única y un atributo por segmento

mParticle enviará los atributos tal y como se describen tanto en el atributo de matriz única como en un atributo por segmento.

Atributo de cadena única y un atributo por segmento

mParticle enviará los atributos tal y como se describen tanto en el atributo de cadena única como en un atributo por segmento.

Atributo de matriz única, atributo de cadena única y un atributo por segmento

mParticle enviará los atributos tal y como se describen en el atributo de matriz única, el atributo de cadena única y un atributo por segmento.

Paso 1: Crear una audiencia en mParticle

Para crear una audiencia en mParticle:

1. Ve a Audiencias > Espacio de trabajo único > + Nueva audiencia.
2. Para conectar Braze como salida para tu audiencia, debes proporcionar los siguientes campos:

Nombre del campo	Descripción
Clave de API	Se encuentra en el panel de Braze en Configuración > Claves de API. Si utilizas la navegación anterior, puedes encontrar las claves de API en Consola para desarrolladores > Configuración de API.
Sistema operativo de la clave de API	Selecciona a qué sistema operativo corresponde tu clave de API de Braze. Esta selección limitará los tipos de tokens push reenviados en una actualización de audiencia.
Enviar segmentos como	El método de envío de audiencias a Braze. Para más detalles, consulta la sección Reenviar audiencias.
Clave de API REST del espacio de trabajo	Clave de API REST de Braze con permisos completos. Puede crearse en el panel de Braze desde Configuración > Claves de API.
Tipo de identidad externa	El tipo de identidad de usuario de mParticle que se reenviará como ID externo a Braze. Recomendamos dejarlo con el valor predeterminado, ID de cliente.
Tipo de identidad del correo electrónico	El tipo de identidad de usuario de mParticle que se reenviará como correo electrónico a Braze.
Instancia de Braze	Especifica a qué clúster se reenviarán tus datos de Braze.

3. Por último, guarda tu audiencia.

Deberías empezar a ver audiencias sincronizándose con Braze en unos minutos. La pertenencia a la audiencia solo se actualizará para los usuarios con external_ids (es decir, no para los usuarios anónimos). Para obtener más información sobre la creación de audiencias de Braze en mParticle, consulta la documentación de mParticle sobre los ajustes de configuración.

Paso 2: Segmentar usuarios en Braze

En Braze, para crear un segmento de estos usuarios, ve a Segmentos en Interacción y asigna un nombre a tu segmento. A continuación se muestran dos ejemplos de segmentos en función de la opción seleccionada para Enviar segmentos como. Para más detalles sobre cada opción, consulta Reenviar audiencias.

• Atributo de matriz única: Selecciona SegmentMembershipArray como filtro. A continuación, utiliza la opción “includes value” e introduce el ID de audiencia que desees.
  
  
• Un atributo por segmento: Selecciona tu atributo personalizado como filtro. A continuación, utiliza la opción “equals” y elige la lógica adecuada.

Una vez guardado, puedes hacer referencia a este segmento durante la creación de Canvas o campañas en el paso de segmentación de usuarios.

Desactivar y eliminar conexiones

Como mParticle no mantiene directamente los segmentos en Braze, no eliminará los segmentos cuando se elimine o desactive la conexión de audiencia de mParticle correspondiente. Cuando esto sucede, mParticle no actualizará los atributos de usuario de la audiencia en Braze para eliminar la audiencia de cada usuario.

Para eliminar la audiencia de un usuario de Braze antes de borrarla, ajusta los filtros de audiencia para forzar el tamaño de la audiencia a 0 antes de eliminar una audiencia. Cuando el cálculo de la audiencia se haya completado y devuelva 0 usuarios, elimina la audiencia. Entonces, la pertenencia a la audiencia se actualizará en Braze a false para la opción de atributo único o se eliminará el ID de audiencia del formato de matriz.

Mapeado de datos

Los datos pueden mapearse a Braze utilizando la integración de kit incrustado si quieres conectar tus aplicaciones móviles y web a Braze a través de mParticle. También puedes utilizar la integración de API de servidor a servidor para reenviar datos del lado del servidor a Braze.

Independientemente del enfoque que elijas, debes configurar Braze como salida:

Configura tus ajustes de salida de Braze

En mParticle, ve a Configuración > Salidas > Añadir salidas y selecciona Braze para abrir la configuración del kit de Braze. Guárdalo cuando lo hayas completado.

Nombre de la configuración	Descripción
Clave de identificación de la aplicación Braze	La clave de identificación de tu aplicación Braze se encuentra en el panel de Braze, en Configuración > Claves de API. Ten en cuenta que las claves de API serán diferentes para cada plataforma (iOS, Android y Web).
Tipo de identidad externa	El tipo de identidad de usuario de mParticle que se reenviará como ID externo a Braze. Recomendamos dejarlo con el valor predeterminado, ID de cliente.
Tipo de identidad del correo electrónico	El tipo de identidad de usuario de mParticle que se reenviará como correo electrónico a Braze. Recomendamos dejarlo en el valor predeterminado, Correo electrónico.
Instancia de Braze	El clúster al que se reenviarán tus datos de Braze; debería ser el mismo clúster en el que se encuentra tu dashboard.
Habilitar el reenvío de flujos de eventos	(De servidor a servidor) Si se habilita, todos los eventos se reenviarán en tiempo real. Si no, todos los eventos se reenviarán en bloque. Cuando decidas habilitar el reenvío de flujos de eventos, asegúrate de que los datos que pasas a Braze respetan los límites de velocidad.

Integración de kit incrustado

Los SDK de mParticle y Braze estarán presentes en tu aplicación a través de la integración del kit incrustado. Sin embargo, a diferencia de una integración directa con Braze, mParticle se encarga de llamar a la mayoría de los métodos del SDK de Braze por ti. Los métodos de mParticle que utilices para hacer seguimiento de los datos de usuario se mapearán automáticamente con los métodos del SDK de Braze.

Estos mapeados del SDK de mParticle para Android, iOS y Web son de código abierto y pueden encontrarse en la página de GitHub de mParticle.

La integración del SDK del kit incrustado te permite aprovechar nuestra línea de productos completa de características (push, mensajes dentro de la aplicación y todo el seguimiento de análisis de mensajes pertinente).

Paso 1: Integrar los SDK de mParticle

Integra los SDK de mParticle adecuados en tu aplicación en función de las necesidades de tu plataforma:

• mParticle para Android
• mParticle para iOS
• mParticle para Web

Paso 2: Completar la integración del kit de eventos Braze de mParticle

Aunque no es necesario incluir directamente el SDK de Braze en tu sitio web o aplicación para esta integración de mParticle, debe instalarse el siguiente kit Appboy de mParticle para reenviar los datos de tu aplicación a Braze.

La guía de integración del kit de eventos Braze de mParticle te guiará a través de las instrucciones de alineación personalizada de mParticle y Braze en función de tus necesidades de mensajería (push, seguimiento de ubicación, etc.).

Paso 3: Configuración de las conexiones para tu salida de Braze

En mParticle, ve a Conexiones > Conectar > [Tu plataforma deseada] > Conectar salida para añadir Braze como salida. A continuación, selecciona Guardar.

No todos los ajustes de conexión se aplicarán a todas las plataformas y tipos de integración. Para obtener un desglose de los ajustes de conexión y las plataformas a las que se aplican, consulta la documentación de mParticle.

Integración de la API del servidor

Se trata de un complemento para enrutar tus datos de backend a Braze si utilizas los SDK del lado del servidor de mParticle (por ejemplo, Ruby, Python, etc.). Para configurar esta integración de servidor a servidor con Braze, sigue la documentación de mParticle.

Configuración de las conexiones para tu salida de Braze

En mParticle, ve a Conexiones > Conectar > [Tu plataforma deseada] > Conectar salida para añadir Braze como salida. Guárdalo cuando lo hayas completado.

No todos los ajustes de conexión se aplicarán a todas las plataformas y tipos de integración. Para obtener un desglose de los ajustes de conexión y las plataformas a las que se aplican, consulta la documentación de mParticle.

Antes de habilitar “Atributos de usuario enriquecidos” o “Identidades de usuario enriquecidas”, te recomendamos que revises los excedentes de puntos de datos para asegurarte de que conoces cómo afectarán estas configuraciones al uso de puntos de datos.

Detalles del mapeado de datos

Tipos de datos

No todos los tipos de datos son compatibles entre ambas plataformas.

• Las propiedades de eventos personalizados admiten objetos de cadena, numéricos, Booleano o de fecha. No admiten matrices ni objetos anidados.
• Los atributos personalizados admiten objetos de cadena, numéricos, Booleano, de fecha y matrices, pero no admiten objetos ni objetos anidados.

Mapeado de datos

Tipo de datos de mParticle	Tipo de datos de Braze	Descripción
Atributos de usuario (reservados)	Atributo estándar	Por ejemplo, la clave de atributo de usuario reservada $FirstName de mParticle se mapea al campo de atributo estándar first_name de Braze.
Atributos de usuario (otros)	Atributo personalizado	Cualquier atributo de usuario pasado a mParticle que no corresponda a sus claves de atributo de usuario reservadas se registra en Braze como un atributo personalizado. Los atributos de usuario admiten cadenas, números, booleanos, fechas y matrices, pero no objetos ni objetos anidados.
Evento personalizado	Evento personalizado	Los eventos personalizados de mParticle son reconocidos por Braze como eventos personalizados. Los atributos de evento se reenvían como propiedades de evento personalizadas. Los atributos de evento pasados a Braze como propiedades de evento admiten objetos de cadena, numéricos, Booleano o de fecha, pero no admiten matrices ni objetos anidados.
Evento de comercio de compra	Evento de compra	Los eventos de comercio de compra se mapearán a eventos de compra de Braze. Alterna el valor de configuración de los datos de eventos de comercio agrupados para registrar las compras a nivel de pedido o a nivel de producto. Por ejemplo, si es false, un único evento entrante con dos productos, promociones o impresiones únicos daría lugar al menos a dos eventos salientes de Braze. Si se establece en true, daría lugar a un único evento saliente con una matriz anidada de productos, promociones o impresiones, respectivamente. Para más información sobre los campos de comercio adicionales que se registrarán, consulta la documentación de mParticle. Al establecer “bundle commerce event data” como false, los atributos de producto pasados a Braze como propiedades de evento de compra admiten objetos de cadena, numéricos, Booleano o de fecha, pero no admiten matrices ni objetos anidados.
Todos los demás eventos de comercio	Evento personalizado	Todos los demás eventos de comercio se mapearán a eventos personalizados. Alterna el valor de configuración de los datos de eventos de comercio agrupados para registrar las compras a nivel de pedido o a nivel de producto. Por ejemplo, si es false, un único evento entrante con dos productos, promociones o impresiones únicos daría lugar al menos a dos eventos salientes de Braze. Si se establece en true, daría lugar a un único evento saliente con una matriz anidada de productos, promociones o impresiones, respectivamente. Además de ciertos valores de comercio predeterminados, los atributos de producto se registrarán como propiedades de evento de Braze. Para más información sobre los campos de comercio adicionales que se registrarán, consulta la documentación de mParticle Al configurar “bundle commerce event data” como false, los atributos de producto pasados a Braze como propiedades de evento admiten objetos de cadena, numéricos, Booleano o de fecha, pero no admiten matrices ni objetos anidados.

Mapeado de identidades de usuario

Para cada salida de mParticle, puedes seleccionar el tipo de identidad externa que deseas enviar a Braze como external_id. Aunque el valor predeterminado es el ID de cliente, puedes elegir mapear otro ID, como MPID, para enviarlo a Braze como external_id. Ten en cuenta que elegir un identificador distinto del ID de cliente puede influir en la forma en que se envían los datos en Braze.

Por ejemplo, mapear MPID a tu external_id de Braze tendrá los siguientes efectos:

• Debido a la naturaleza del momento en que se asigna el MPID, a todos los usuarios se les asignará un external_id al iniciar la sesión.
• La configuración de Currents puede requerir un mapeado adicional debido a los diferentes tipos de datos entre MPID y external_id.

Transmisión de las solicitudes de borrado (solicitudes de los interesados)

Reenvía las solicitudes de borrado a Braze configurando una salida de solicitud del interesado a Braze. Para enviar solicitudes de borrado a Braze, sigue la documentación de mParticle.

Posibles excedentes de puntos de datos

Atributos de usuario enriquecidos

Habilitar el enriquecimiento de atributos/identidades de usuario (solo de servidor a servidor)

En los ajustes de conexión de mParticle, Braze recomienda desactivar Incluir atributos de usuario enriquecidos. Si se habilita, mParticle reenviará todos los atributos de usuario disponibles (como atributos estándar, atributos personalizados y atributos calculados) del perfil existente a Braze en cada evento registrado. Esto da lugar a un elevado consumo de puntos de datos, porque mParticle envía a Braze los mismos atributos sin cambios en cada llamada.

Por ejemplo, si un usuario añade su nombre, apellidos y número de teléfono durante su primera sesión y más tarde se registra en un boletín de noticias y añade la misma información y un correo electrónico, desencadenando un evento de registro en el boletín:

• Si está habilitado (por defecto), se incurrirá en cinco puntos de datos. (evento de registro, dirección de correo electrónico, nombre, apellidos y número de teléfono)
• Si está deshabilitado, se incurrirá en dos puntos de datos (evento de registro y dirección de correo electrónico)

Consideraciones para desactivar los atributos de usuario enriquecidos

Hay algunas consideraciones a tener en cuenta al desactivar Incluir atributos de usuario enriquecidos:

1. La integración de servidor a servidor utiliza la API de eventos de mParticle para enviar eventos a Braze. Cada solicitud es desencadenada por un evento. Cuando se cambia un atributo de usuario, como la actualización de una dirección de correo electrónico, pero no está asociado a un evento específico (por ejemplo, un evento personalizado de actualización de perfil), el nuevo valor solo se pasa a una salida como Braze como un “atributo enriquecido” en la carga útil del siguiente evento desencadenado por el usuario. Cuando Incluir atributos de usuario enriquecidos está desactivado, este nuevo valor de atributo no asociado a un evento específico no se pasará a Braze.
   • Para solucionarlo, recomendamos crear un evento “atributo de usuario actualizado” independiente que solo envíe a Braze los atributos de usuario específicos que se han actualizado. Ten en cuenta que, con este enfoque, seguirás registrando un punto de datos adicional para el evento “atributo de usuario actualizado”, pero el uso de puntos de datos será mucho menor que el envío de todos los atributos de usuario en cada llamada con la característica habilitada.
2. Los atributos calculados se transmiten a Braze como atributos de usuario enriquecidos, por lo que si se desactiva “Atributos de usuario enriquecidos” dejarán de transmitirse a Braze. Para enviar atributos calculados a Braze cuando “Atributos de usuario enriquecidos” están desactivados, una fuente de atributos calculados podría ayudar sin enviar todos los atributos. La fuente enviará una actualización a Braze cuando cambie un atributo calculado.

Solución de problemas

Solución de problemas de notificaciones push en iOS con el kit de eventos Braze

Si las notificaciones push no funcionan al usar el kit de eventos Braze (integración de kit incrustado) en iOS, comprueba lo siguiente:

1. Reenvío de tokens push: Confirma que mParticle está reenviando tokens push a Braze. En tu dashboard de mParticle, verifica que la conexión del kit de Braze tiene push habilitado y que la credencial push de Apple correcta está configurada en el panel de Braze.
2. Orden de inicialización del kit: El kit de Braze debe inicializarse antes de que tu aplicación solicite permisos de push. Si los permisos de push se solicitan antes de que el kit esté activo, el token push puede no reenviarse a Braze. Comprueba que el SDK de mParticle se inicia temprano en el ciclo de vida de tu aplicación.
3. Method swizzling: El kit de Apple de mParticle utiliza method swizzling para reenviar automáticamente tokens push y gestionar eventos de notificaciones push. Si has deshabilitado el swizzling u otro SDK está interfiriendo, los tokens push pueden no llegar a Braze. Verifica que el swizzling está habilitado en tu configuración de mParticle.
4. Gestión manual de tokens: Si gestionas los tokens push manualmente (por ejemplo, implementando application:didRegisterForRemoteNotificationsWithDeviceToken:), asegúrate de que estás pasando el token a mParticle asignándolo a la propiedad de token de notificación push, por ejemplo: MParticle.sharedInstance().pushNotificationToken = deviceToken. El kit lo reenviará entonces a Braze.
5. Discrepancia de entorno: Confirma que el entorno de la credencial APNs (desarrollo vs. producción) coincide con la compilación de tu aplicación. Para más detalles, consulta Solución de problemas de push en iOS.

Envío de datos innecesarios o duplicados a Braze

Braze cuenta un punto de datos cada vez que se pasa un atributo a Braze, aunque el valor no cambie. Por este motivo, Braze recomienda reenviar únicamente los datos necesarios para actuar dentro de Braze y asegurarse de que solo se transmiten deltas de atributos.