Braze

Como una de las principales soluciones de captación de clientes, Braze ofrece una amplia gama de herramientas para notificaciones push, email, 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 el comportamiento de tus suscriptores, conocer sus preferencias y utilizar esa información para comunicarte con ellos de forma dirigida y efectiva. Por tanto, esta integración te permite rastrear eventos de suscripción en tu dashboard de Braze y relacionarlos 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 clientes mediante notificaciones push de Braze tras una integración sencilla y rápida, tal como se describe a continuación.

Cómo configurar la integración con Braze

Para integrar Braze, ve a Integrations -> Braze, activa el interruptor y rellena los campos.

El primer paso del proceso de integración es proporcionar las credenciales necesarias para establecer una conexión entre tus perfiles de Braze y Adapty. Necesitarás la REST API Key, tu Braze Instance ID y los App IDs para iOS y Android para que la integración funcione correctamente:

La REST API Key se puede crear en Braze Dashboard → Settings → API Keys. Asegúrate de que tu clave tenga el permiso users.track al crearla:

Para obtener el Braze Instance ID, fíjate en la URL de tu Braze Dashboard y accede a la sección de Braze Docs donde se especifica el ID de instancia. Tendrá un formato regional como US-03, EU-01, etc.
Los App IDs de iOS y Android también se encuentran en Braze Dashboard → Settings → API Keys. Cópialos desde aquí:

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 generan ingresos, como las conversiones de prueba y las renovaciones, Adapty enviará esta información a Braze como compras.

Aquí encontrarás las especificaciones completas de las propiedades de los eventos que se envían a Braze.

Atributos de usuario útiles

Adapty envía algunos atributos de usuario para la integración con Braze de forma predeterminada. Puedes consultar la lista que se muestra 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 `Sandbox` o `Production`
`store`	String	Contiene el nombre de la Store utilizada para realizar la compra. Valores posibles: `app_store` o `play_store`.
`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 `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():

let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")

Braze.getInstance(context).changeUser("adapty_customer_user_id")