Braze
Como una de las principales soluciones de captación de clientes, Braze ofrece una amplia gama de herramientas para notificaciones push, correo electrónico, SMS y mensajería in-app. Al integrar Adapty con Braze, puedes acceder fácilmente a todos tus eventos de suscripción en un solo lugar, lo que te permite activar comunicaciones automatizadas basadas en esos eventos.
Adapty proporciona un conjunto completo de datos que te permite rastrear eventos de suscripción de todas las stores en un solo lugar y puede usarse para actualizar los perfiles de tus usuarios en Braze. Con Adapty, puedes ver fácilmente cómo se comportan tus suscriptores, conocer sus preferencias y usar esa información para comunicarte con ellos de forma dirigida y efectiva. Por lo tanto, esta integración te permite rastrear eventos de suscripción en tu dashboard de Braze y vincularlos con tus campañas de adquisición.
Adapty envía eventos de suscripción, propiedades de usuario y compras a Braze, para que puedas crear comunicaciones dirigidas a los clientes mediante notificaciones push de Braze tras una integración breve y sencilla como se describe a continuación.
Cómo configurar la integración con Braze
Para conectar Adapty con Braze, abre Integrations → Braze en el Adapty Dashboard, activa el interruptor y completa las credenciales:
- REST API key y Braze Instance ID son obligatorios.
- iOS App ID y Android App ID son opcionales.
- Para crear la REST API key, en el dashboard de Braze, ve a Settings → APIs and Identifiers y haz clic en Create API Key. En los permisos de datos de usuario, selecciona
users.track. Braze no permite modificar los permisos de una clave una vez creada, por lo que si una clave no tieneusers.track, deberás reemplazarla por una nueva. Para más información, consulta Creating REST API keys en la documentación de Braze. - Para encontrar el Braze Instance ID, compara la URL de tu dashboard de Braze con la tabla de instancias en la documentación de Braze. El ID de instancia tiene un formato regional, como
US-03oEU-01. Por ejemplo,dashboard-03.braze.comcorresponde aUS-03. - Para encontrar el iOS App ID y el Android App ID, en el dashboard de Braze, ve a Settings → APIs and Identifiers → App Identifiers. Copia el valor de la columna Identifier para cada app. Para más información, consulta App identifier en la documentación de Braze.
Eventos, atributos de usuario y compras
Justo debajo de las credenciales hay tres grupos de eventos que puedes enviar a Braze desde Adapty. Activa simplemente los que necesites. También puedes cambiar los nombres de los eventos según lo que necesites enviar a Braze. Consulta la lista completa de eventos que ofrece Adapty aquí:
Adapty enviará eventos de suscripción y atributos de usuario a Braze mediante una integración servidor a servidor, lo que te permitirá verlos en tu Braze Dashboard y configurar campañas basándote en ellos.
Para los eventos que tienen ingresos, como las conversiones de prueba y las renovaciones, Adapty enviará esta información a Braze como compras.
Adapty envía ingresos a Braze únicamente como eventos de compra legacy. Braze ha puesto los eventos de compra legacy en modo de mantenimiento y no los habilita para nuevos clientes. Si tu workspace de Braze no los acepta, Braze rechaza cada evento que tenga ingresos con HTTP 400 y el mensaje Legacy purchase ingestion is disabled. Esos eventos, como primeras compras, renovaciones, conversiones de prueba y reembolsos, no llegan a Braze en absoluto, no solo sus ingresos.
Antes de activar la integración, asegúrate de que tu workspace de Braze acepta eventos de compra heredados. Para más información, consulta Purchase events en la documentación de Braze.
Aquí encontrarás las especificaciones completas de las propiedades de los eventos enviados a Braze.
Atributos de usuario útiles
Adapty envía por defecto algunos atributos de usuario para la integración con Braze. Consulta la lista que se incluye a continuación para determinar cuáles se adaptan mejor a tus necesidades.
| Atributo de usuario | Tipo | Valor |
|---|---|---|
adapty_customer_user_id | String | Contiene el valor del identificador único del usuario definido por el cliente. Se puede encontrar tanto en el Dashboard de Adapty como en Braze. |
adapty_profile_id | String | Contiene el valor del identificador único del Perfil de Usuario de Adapty, que se puede encontrar en el Dashboard de Adapty. |
environment | String | Indica si el usuario opera en un entorno sandbox o de producción. Los valores son |
store | String | Contiene el nombre de la Store utilizada para realizar la compra. Valores posibles:
|
vendor_product_id | String | Contiene el valor del ID de producto en la store de Apple/Google. p. ej., org.locals.12345 |
subscription_expires_at | String | Contiene la fecha de vencimiento de la suscripción más reciente. El formato del valor es: YYYY-MM-DDTHH:mm:ss.SSS+TZ p. ej., 2023-02-15T17:22:03.000+0000 |
active_subscription | String | El valor se establecerá en true en cualquier evento de compra o renovación, o en false si la suscripción ha expirado. |
period_type | String | Indica el tipo de período más reciente para la compra o renovación. Los valores posibles son
|
Todos los valores float se redondearán a int. Los strings permanecen igual.
Además de la lista predefinida de etiquetas disponibles, es posible enviar atributos personalizados mediante etiquetas. Esto permite mayor flexibilidad en el tipo de datos que se pueden incluir con la etiqueta y puede resultar útil para rastrear información específica relacionada con un producto o servicio. Todos los atributos de usuario personalizados se envían automáticamente a Braze si el usuario marca la casilla Send user attributes en la página de integración.
Configuración del SDK
Para vincular perfiles de usuario en Adapty y Braze, debes configurar el SDK de Braze con el mismo ID de usuario que Adapty o usar su método .changeUser():
Solución de problemas
access_level_updated aparece como fallido en el Event Feed
access_level_updated es un evento exclusivo de webhooks. Adapty nunca lo envía a esta integración. Sin embargo, Adapty registra un resultado para cada integración habilitada, y un evento no compatible se muestra como un error.