Responder a acciones de flow - Android
Si estás creando flows o paywalls con el Adapty Flow Builder o Paywall Builder, es fundamental configurar correctamente los botones:
- Añade un botón en el builder y asígnale una acción predefinida o crea un ID de acción personalizado.
- Escribe el código en tu app para gestionar cada acción que hayas asignado.
Esta guía explica cómo gestionar acciones personalizadas y predefinidas en tu código.
Solo las compras, restauraciones, cierres de flow/paywall y la apertura de URLs se gestionan automáticamente. El resto de acciones de botón requieren una implementación adecuada en el código de la app.
Cerrar flows y paywalls
Para añadir un botón que cierre tu flow o paywall:
- En el builder, añade un botón y asígnale la acción Close.
- En el código de tu app, implementa un handler para la acción
close.
En el SDK de Android, la acción close cierra el flow o paywall por defecto. Sin embargo, puedes sobrescribir este comportamiento en tu código si lo necesitas. Por ejemplo, cerrar un flow podría desencadenar la apertura de otro.
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
AdaptyUI.Action.Close -> (context as? Activity)?.onBackPressed() // default behavior
}
}Abrir URLs desde flows y paywalls
Si quieres añadir un grupo de enlaces (p. ej., términos de uso y restauración de compras), añade un elemento Link en el builder y trátalo igual que los botones con la acción Open URL.
Para añadir un botón que abra un enlace desde tu flow o paywall (p. ej., Terms of use o Privacy policy):
- En el builder, añade un botón, asígnale la acción Open URL e introduce la URL que quieres abrir.
- En el código de tu app, implementa un handler para la acción
openUrlque abra la URL recibida en un navegador.
En el SDK de Android, la acción openUrl activa la apertura de la URL por defecto. Sin embargo, puedes sobrescribir este comportamiento en tu código si lo necesitas.
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
is AdaptyUI.Action.OpenUrl -> {
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(action.url)) // default behavior
context.startActivity(intent)
}
}
}Gestionar acciones personalizadas
Para añadir un botón que gestione cualquier otra acción:
- En el builder, añade un botón, asígnale la acción Custom y asígnale un ID.
- En el código de tu app, implementa un handler para el ID de acción que hayas creado.
Por ejemplo, si tienes otro conjunto de ofertas de suscripción o compras únicas, puedes añadir un botón que muestre otro flow o paywall:
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
is AdaptyUI.Action.Custom -> {
if (action.customId == "openNewPaywall") {
// Display another flow or paywall
}
}
}
}Si estás construyendo paywalls con el Adapty paywall builder, es fundamental configurar los botones correctamente:
- Añade un botón en el Paywall Builder y asígnale una acción preexistente o crea un ID de acción personalizado.
- Escribe código en tu app para gestionar cada acción que hayas asignado.
Esta guía explica cómo gestionar acciones personalizadas y preexistentes en tu código.
Solo las compras, restauraciones, cierres de paywall y apertura de URLs se gestionan automáticamente. El resto de acciones de botón requieren una implementación adecuada en el código de la app.
Cerrar paywalls
Para añadir un botón que cierre tu paywall:
- En el Paywall Builder, añade un botón y asígnale la acción Close.
- En el código de tu app, implementa un manejador para la acción
closeque cierre el paywall.
En el SDK de Android, la acción close cierra el paywall por defecto. Sin embargo, puedes sobrescribir este comportamiento en tu código si lo necesitas. Por ejemplo, cerrar un paywall podría abrir otro.
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
AdaptyUI.Action.Close -> (context as? Activity)?.onBackPressed() // default behavior
}
}Abrir URLs desde paywalls
Si quieres añadir un grupo de enlaces (p. ej., términos de uso y restauración de compras), añade un elemento Link en el paywall builder y trátalo igual que los botones con la acción Open URL.
Para añadir un botón que abra un enlace desde tu paywall (p. ej., Terms of use o Privacy policy):
- En el paywall builder, añade un botón, asígnale la acción Open URL e introduce la URL que quieres abrir.
- En el código de tu app, implementa un manejador para la acción
openUrlque abra la URL recibida en un navegador.
En el SDK de Android, la acción openUrl activa la apertura de la URL de forma predeterminada. Sin embargo, puedes sobrescribir este comportamiento en tu código si lo necesitas.
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
is AdaptyUI.Action.OpenUrl -> {
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(action.url)) // default behavior
context.startActivity(intent)
}
}
}Iniciar sesión en la app
Para añadir un botón que permita a los usuarios iniciar sesión en tu app:
- En el Paywall Builder, añade un botón y asígnale la acción Login.
- En el código de tu app, implementa un handler para la acción
loginque identifique a tu usuario.
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
AdaptyUI.Action.Login -> {
val intent = Intent(context, LoginActivity::class.java)
context.startActivity(intent)
}
}
}Gestionar acciones personalizadas
Para añadir un botón que gestione cualquier otra acción:
- En el Paywall Builder, añade un botón, asígnale la acción Custom y asígnale un ID.
- En el código de tu app, implementa un controlador para el ID de acción que hayas creado.
Por ejemplo, si tienes otro conjunto de ofertas de suscripción o compras únicas, puedes añadir un botón que muestre otro paywall:
override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
when (action) {
is AdaptyUI.Action.Custom -> {
if (action.customId == "openNewPaywall") {
// Display another paywall
}
}
}
}