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.
5f1e62c-adapty_braze.webp
  1. 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 tiene users.track, deberás reemplazarla por una nueva. Para más información, consulta Creating REST API keys en la documentación de Braze.
  2. 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-03 o EU-01. Por ejemplo, dashboard-03.braze.com corresponde a US-03.
  3. 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í:

702e628-adapty_braze_events_names.webp

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.

Warning

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.

Note

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 usuarioTipoValor
adapty_customer_user_idStringContiene 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_idStringContiene el valor del identificador único del Perfil de Usuario de Adapty, que se puede encontrar en el Dashboard de Adapty.
environmentString

Indica si el usuario opera en un entorno sandbox o de producción.

Los valores son Sandbox o Production

storeString

Contiene el nombre de la Store utilizada para realizar la compra.

Valores posibles:

app_store o play_store.

vendor_product_idString

Contiene el valor del ID de producto en la store de Apple/Google.

p. ej., org.locals.12345

subscription_expires_atString

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_subscriptionStringEl valor se establecerá en true en cualquier evento de compra o renovación, o en false si la suscripción ha expirado.
period_typeString

Indica el tipo de período más reciente para la compra o renovación.

Los valores posibles son

trial para un período de prueba o normal para el resto.

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.