mParticle de Rokt
Con la CDP 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 Campaign y Canvas de Braze.
- 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 puede encontrar en la página de resumen de la API (por ejemplo, US-01 o US-02). |
| Clave del identificador de la aplicación de Braze | Tu clave de identificador de la aplicación. Se puede encontrar en Administrar configuración > Clave de API en el panel de Braze. |
| Clave de API REST del espacio de trabajo | (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
Usa la asociación entre Braze y mParticle para configurar tu integración e importar audiencias de mParticle directamente a Braze para reorientar, creando un ciclo 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 responderlas.
Reenvío de audiencias
mParticle ofrece tres formas de configurar los atributos de pertenencia a una cohorte, controladas por la configuración “Enviar segmentos como”. Consulta las siguientes secciones para conocer el procesamiento de cada opción:
- Atributo de cadena único
- Atributo de array único
- Un atributo por segmento
- Atributo de array único y atributo de cadena único
- Atributo de array único y un atributo por segmento
- Atributo de cadena único y un atributo por segmento
- Atributo de array único, atributo de cadena único y un atributo por segmento
Atributo de cadena único
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 encuentran en el panel de mParticle en Audiences.
Por ejemplo, si una audiencia de mParticle “Ibiza dreamers” tiene un ID de audiencia “11036”, puedes segmentar a estos usuarios con el filtro SegmentMembership — matches regex — 11036.
Aunque esta es la opción predeterminada en mParticle, la mayoría de los usuarios optan por usar atributos de array únicos para una mejor experiencia de filtrado al crear Segments en Braze.
Esta solución no es recomendable si tienes más de unas pocas audiencias, ya que los atributos personalizados pueden tener hasta 255 caracteres de longitud, por lo que no podrás almacenar decenas o cientos de audiencias en un perfil de usuario con este método. Si tienes un gran número de cohortes por usuario, recomendamos encarecidamente la configuración “un atributo por segmento”.
Atributo de array único
mParticle crea un único atributo personalizado de tipo array en Braze para cada usuario, llamado SegmentMembershipArray. El valor de este atributo es un array 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.
Los atributos de tipo array de Braze tienen una longitud máxima predeterminada de 500. Si alguno de tus usuarios es miembro de más de 500 audiencias, Braze truncará su información de pertenencia. Para una solución alternativa, ponte en contacto con tu director de cuentas de Braze para aumentar tu umbral máximo de longitud de array.
Un atributo por segmento
mParticle creará un atributo personalizado booleano para cada audiencia a la que pertenece 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 array único y atributo de cadena único
mParticle enviará atributos tal como se describe en las secciones de atributo de array único y atributo de cadena único.
Atributo de array único y un atributo por segmento
mParticle enviará atributos tal como se describe en las secciones de atributo de array único y un atributo por segmento.
Atributo de cadena único y un atributo por segmento
mParticle enviará atributos tal como se describe en las secciones de atributo de cadena único y un atributo por segmento.
Atributo de array único, atributo de cadena único y un atributo por segmento
mParticle enviará atributos tal como se describe en las secciones de atributo de array único, atributo de cadena único y un atributo por segmento.
Paso 1: Crear una audiencia en mParticle
Para crear una audiencia en mParticle:
- Ve a Audiences > Single Workspace > + New Audience.
- Para conectar Braze como salida para tu audiencia, debes proporcionar los siguientes campos:
| Nombre del campo | Descripción |
|---|---|
| Clave de API | En el panel de Braze, ve a Configuración > Claves 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 de notificaciones push reenviados en una actualización de audiencia. |
| Enviar segmentos como | El método de envío de audiencias a Braze. Consulta la sección Reenvío de audiencias para más detalles. |
| Clave de API REST del espacio de trabajo | Clave de API REST de Braze con permisos completos. Se puede crear 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 dejar el valor predeterminado, Customer ID. |
| Tipo de identidad de 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. |
- Por último, guarda tu audiencia.
Deberías empezar a ver las audiencias sincronizarse con Braze en unos minutos. La pertenencia a audiencias solo se actualizará para usuarios con external_ids (es decir, no usuarios anónimos). Para obtener más información sobre la creación de audiencias de mParticle en Braze, consulta la documentación de mParticle sobre Configuración.
Paso 2: Segmentar usuarios en Braze
En Braze, para crear un segmento de estos usuarios, ve a Segments en Engagement y asigna un nombre a tu segmento. A continuación se presentan dos ejemplos de Segments según la opción que seleccionaste para Enviar segmentos como. Para más detalles sobre cada opción, consulta Reenvío de audiencias.
- Atributo de array único: Selecciona
SegmentMembershipArraycomo tu filtro. A continuación, usa la opción “includes value” e introduce el ID de audiencia deseado.
- Un atributo por segmento: Selecciona tu atributo personalizado como filtro. A continuación, usa la opción “equals” y elige la lógica apropiada.
Una vez guardado, puedes hacer referencia a este segmento durante la creación de Canvas o Campaign en el paso de segmentación de usuarios.
Desactivación y eliminación de conexiones
Dado que mParticle no mantiene directamente Segments en Braze, no eliminará Segments cuando la conexión de audiencia correspondiente de mParticle sea eliminada o desactivada. Cuando esto ocurre, 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 la eliminación, ajusta los filtros de audiencia para forzar que el tamaño de la audiencia sea 0 antes de eliminar una audiencia. Una vez que 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 array.
Mapeado de datos
Los datos se pueden mapear a Braze utilizando la integración de kit integrado si deseas conectar tus aplicaciones móviles y web a Braze a través de mParticle. También puedes usar 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 una salida:
Configura los ajustes de salida de Braze
En mParticle, ve a Setup > Outputs > Add Outputs y selecciona Braze para abrir la configuración del kit de Braze. Haz clic en Save cuando hayas terminado.
| Nombre del ajuste | Descripción |
|---|---|
| Clave del identificador de aplicación de Braze | Tu clave del identificador de aplicación de 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 dejar esto con el valor predeterminado, Customer ID. |
| Tipo de identidad de correo electrónico | El tipo de identidad de usuario de mParticle que se reenviará como correo electrónico a Braze. Recomendamos dejar esto con el valor predeterminado, Email. |
| Instancia de Braze | El clúster al que se reenviarán tus datos de Braze; este debe ser el mismo clúster en el que se encuentra tu panel. |
| Habilitar el reenvío del flujo de eventos | (Servidor a servidor) Cuando se habilita, todos los eventos se reenviarán en tiempo real. Si no, todos los eventos se reenviarán de forma masiva. Al elegir habilitar el reenvío del flujo de eventos, asegúrate de que los datos que envías a Braze respeten los límites de velocidad. |
Integración de kit integrado
Los SDK de mParticle y Braze estarán presentes en tu aplicación a través de la integración de kit integrado. 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 usas para rastrear datos de usuario se mapearán automáticamente a los métodos del SDK de Braze.
Estos mapeados del SDK de mParticle para Android, iOS y Web son de código abierto y se pueden encontrar en la página de GitHub de mParticle.
La integración del SDK del kit integrado 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 relevante).
Para Content Cards e integraciones de mensajes dentro de la aplicación personalizados, llama directamente a los métodos del SDK de Braze.
Paso 1: Integra los SDK de mParticle
Integra los SDK de mParticle apropiados en tu aplicación según las necesidades de tu plataforma:
Paso 2: Completa la integración del kit de eventos de Braze de mParticle
Si bien el SDK de Braze no necesita incluirse directamente en tu sitio web o aplicación para esta integración de mParticle, se debe instalar el siguiente kit Appboy de mParticle para reenviar datos desde tu aplicación a Braze.
La guía de integración del kit de eventos de Braze de mParticle te guiará a través de instrucciones personalizadas de alineación de mParticle y Braze según tus necesidades de mensajería (push, seguimiento de ubicación, etc.).
Paso 3: Configuración de conexiones para tu salida de Braze
En mParticle, ve a Connections > Connect > [Tu plataforma deseada] > Connect Output para añadir Braze como salida. Luego, selecciona Save.
No todos los ajustes de conexión se aplican a todas las plataformas y tipos de integración. Para 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 API de servidor
Este es un complemento para enrutar los datos de tu backend a Braze si estás utilizando 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.
La integración de servidor a servidor no es compatible con las características de la interfaz de Braze, como los mensajes dentro de la aplicación, Content Cards o las notificaciones push. También hay 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.
Para que los datos del lado del servidor se reenvíen a Braze, deben incluir un external_id; los usuarios anónimos no se reenviarán.
Configuración de conexiones para tu salida de Braze
En mParticle, ve a Connections > Connect > [Tu plataforma deseada] > Connect Output para añadir Braze como salida. Haz clic en Save cuando hayas terminado.
No todos los ajustes de conexión se aplican a todas las plataformas y tipos de integración. Para 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 “Enriched User Attributes” o “Enriched User Identities”, te recomendamos revisar Excedentes de puntos de datos para asegurarte de que eres consciente de cómo estos ajustes afectarán el 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 cadenas, valores numéricos, booleanos u objetos de fecha. No admiten matrices ni objetos anidados.
- Los atributos personalizados admiten cadenas, valores numéricos, booleanos, objetos de fecha y matrices, pero no admiten objetos ni objetos anidados.
Braze no admite marcas de tiempo anteriores al año 0 ni posteriores al año 3000 en atributos personalizados de tipo Time. Braze ingiere estos valores cuando son enviados por mParticle, pero el valor se almacenará como una cadena.
Mapeado de datos
| Tipo de dato de mParticle | Tipo de dato 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 se encuentre dentro de sus claves de atributo de usuario reservadas se registrará en Braze como un atributo personalizado. Los atributos de usuario admiten cadenas, valores numéricos, booleanos, fechas y matrices, pero no admiten objetos ni objetos anidados. |
| Evento personalizado | Evento personalizado | Los eventos personalizados de mParticle son reconocidos por Braze como un evento personalizado. Los atributos del evento se reenvían como propiedades del evento personalizado. Los atributos del evento pasados a Braze como propiedades del evento admiten cadenas, valores numéricos, booleanos u objetos 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 del ajuste para agrupar datos de eventos de comercio para registrar compras a nivel de pedido o a nivel de producto. Por ejemplo, si es false, un solo evento entrante con dos productos, promociones o impresiones únicos generará al menos dos eventos salientes de Braze. Si se establece en true, generará un solo 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. Cuando se establece “bundle commerce event data” como false, los atributos de producto pasados a Braze como propiedades del evento de compra admiten cadenas, valores numéricos, booleanos u objetos 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 del ajuste para agrupar datos de eventos de comercio para registrar compras a nivel de pedido o a nivel de producto. Por ejemplo, si es false, un solo evento entrante con dos productos, promociones o impresiones únicos generará al menos dos eventos salientes de Braze. Si se establece en true, generará un solo 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 del evento de Braze. Para más información sobre los campos de comercio adicionales que se registrarán, consulta la documentación de mParticle Cuando se establece “bundle commerce event data” como false, los atributos de producto pasados a Braze como propiedades del evento admiten cadenas, valores numéricos, booleanos u objetos de fecha, pero no admiten matrices ni objetos anidados. |
Mapeado de identidad de usuario
Para cada salida de mParticle, puedes seleccionar el tipo de identidad externa que se enviará a Braze como el external_id. Si bien el valor predeterminado es customer ID, puedes elegir mapear otro ID, como MPID, para enviarlo a Braze como el external_id. Ten en cuenta que elegir un identificador distinto al customer ID puede influir en cómo 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 de cuándo se asigna MPID, a todos los usuarios se les asignará un
external_idal inicio de la sesión. - La configuración de Currents puede requerir un mapeado adicional debido a las diferencias en los tipos de datos entre MPID y
external_id.
Reenvío de solicitudes de eliminación (solicitudes de los interesados)
Reenvía solicitudes de eliminación a Braze configurando una salida de solicitud de los interesados hacia Braze. Para reenviar solicitudes de eliminación a Braze, sigue la documentación de mParticle.
Posibles excedentes de puntos de datos
Atributos de usuario enriquecidos
Habilitar atributos/identidades de usuario enriquecidos (solo servidor a servidor)
En la configuración de conexión de mParticle, Braze recomienda desactivar Include Enriched User Attributes. Si está habilitada, 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 genera un alto consumo de puntos de datos, ya que mParticle envía a Braze los mismos atributos sin cambios en cada llamada.
Por ejemplo, si un usuario añade su nombre, apellido y número de teléfono durante su primera sesión y posteriormente se suscribe a un boletín informativo y añade la misma información junto con un correo electrónico, lo que desencadena un evento de suscripción al boletín:
- Si está activada (por defecto), se generarán cinco puntos de datos. (evento de suscripción, dirección de correo electrónico, nombre, apellido y número de teléfono)
- Si está desactivada, se generarán dos puntos de datos (evento de suscripción y dirección de correo electrónico)
Desactivar esta configuración no comprobará si los datos han cambiado. Sin embargo, evitará que la integración envíe todos los atributos de usuario del perfil del usuario que no se recibieron en el lote de entrada original o que no se establecieron explícitamente como atributo del evento. Es importante seguir comprobando que solo se pasen las diferencias a Braze.
Consideraciones al desactivar los atributos de usuario enriquecidos
Hay algunas consideraciones que debes tener en cuenta al desactivar Include Enriched User Attributes:
- La integración servidor a servidor usa la API de eventos de mParticle para enviar eventos a Braze. Cada solicitud se desencadena por un evento. Cuando un atributo de usuario cambia, como actualizar 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 que desencadene el usuario. Cuando Include Enriched User Attributes está desactivada, este nuevo valor de atributo no asociado a un evento específico no se pasará a Braze.
- Para resolver esto, recomendamos crear un evento separado de “actualización de atributo de usuario” que solo envíe los atributos de usuario específicos que se hayan actualizado a Braze. Ten en cuenta que con este enfoque, seguirás registrando un punto de datos adicional por el evento de “actualización de atributo de usuario”, pero el uso de puntos de datos será mucho menor que enviar todos los atributos de usuario en cada llamada con la característica habilitada.
- Los atributos calculados se pasan a Braze como un atributo de usuario enriquecido, por lo que cuando se desactivan los “atributos de usuario enriquecidos”, estos dejarán de pasarse a Braze. Para reenviar atributos calculados a Braze cuando los “atributos de usuario enriquecidos” estén desactivados, un feed de atributos calculados podría ayudar sin enviar todos los atributos. El feed enviará una actualización descendente a Braze cuando un atributo calculado cambie.
Solución de problemas
Solución de problemas de notificaciones push de iOS con el kit de eventos de Braze
Si las notificaciones push no funcionan al utilizar el kit de eventos de Braze (integración de kit embebido) en iOS, comprueba lo siguiente:
- Reenvío de tokens de notificaciones push: Confirma que mParticle está reenviando los tokens de notificaciones push a Braze. En tu panel de mParticle, verifica que la conexión del kit de Braze tenga habilitado el push y que la credencial de push de Apple correcta esté configurada en el panel de Braze.
- Orden de inicialización del kit: El kit de Braze debe inicializarse antes de que tu aplicación solicite los permisos de push. Si los permisos de push se solicitan antes de que el kit esté activo, es posible que el token de notificaciones push no se reenvíe a Braze. Comprueba que el SDK de mParticle se inicie de forma temprana en el ciclo de vida de tu aplicación.
- Method swizzling: El kit de mParticle para Apple utiliza method swizzling para reenviar automáticamente los tokens de notificaciones push y gestionar los eventos de notificaciones push. Si has deshabilitado el swizzling o si otro SDK está interfiriendo, es posible que los tokens de notificaciones push no lleguen a Braze. Verifica que el swizzling esté habilitado en tu configuración de mParticle.
- Gestión manual de tokens: Si gestionas los tokens de notificaciones push de forma manual (por ejemplo, implementando
application:didRegisterForRemoteNotificationsWithDeviceToken:), asegúrate de pasar el token a mParticle asignándolo a la propiedad del token de notificaciones push, por ejemplo:MParticle.sharedInstance().pushNotificationToken = deviceToken. El kit lo reenviará entonces a Braze. - Discrepancia de entorno: Confirma que el entorno de la credencial de APN (desarrollo frente a producción) coincida con la compilación de tu aplicación. Para más detalles, consulta Solución de problemas de push en iOS.
- Tiempo de inicialización del kit: Si accedes a la instancia de Braze desde
didFinishLaunchingWithOptions, es posible que el kit de mParticle no esté listo cuando llega una notificación push. Inicializa la gestión de push enuserNotificationCenter(_:didReceive:withCompletionHandler:)(o el delegado de respuesta de notificación equivalente) para que el kit de Braze esté activo cuando el usuario abra una notificación.
Envío de datos innecesarios o duplicados a Braze
Braze contabiliza un punto de datos cada vez que se envía un atributo a Braze, incluso si el valor no ha cambiado. Por esta razón, Braze recomienda reenviar únicamente los datos necesarios para actuar dentro de Braze y asegurarse de que solo se envíen los deltas de los atributos.
Los eventos no aparecen en Braze
Si los eventos o atributos de mParticle no aparecen en Braze, el problema suele deberse a una configuración incorrecta en tu conexión de mParticle o en el mapeado de eventos, no a una interrupción de Braze. Comprueba lo siguiente:
- Salida de conexión: Confirma que Braze está habilitado como salida para la conexión correspondiente y que la instancia de Braze correcta, el identificador de la aplicación y la clave de API REST están configurados.
- Mapeado de identidad: Las sincronizaciones de servidor a servidor y de audiencias requieren un
external_id. Los usuarios anónimos no se reenvían. - Mapeado de eventos: Verifica que los eventos se enrutan a la salida de Braze y que los tipos de datos no compatibles (objetos anidados, arrays en propiedades del evento) no se están descartando.
Si la configuración parece correcta pero los datos siguen sin llegar, contacta con el soporte de mParticle para revisar los registros de entrega de su lado.