Responder a acciones de flow - iOS

Si estás construyendo flows o paywalls con el Adapty Flow Builder o Paywall Builder, es fundamental configurar los botones correctamente:

1. Añade un botón en el Paywall Builder y asígnale una acción ya existente o crea un ID de acción personalizado.
2. Escribe código en tu app para gestionar cada acción que hayas asignado.

Esta guía explica cómo gestionar acciones personalizadas y acciones preexistentes en tu código.

Cerrar flows y paywalls

Para añadir un botón que cierre tu flow o paywall:

1. En el editor, añade un botón y asígnale la acción Close.
2. En el código de tu app, implementa un manejador para la acción close.

.flow(
    isPresented: $flowPresented,
    flowConfiguration: flowConfiguration,
    didPerformAction: { action in
        switch action {
        case .close:
            flowPresented = false // dismiss the flow or paywall
        default:
            break
        }
    },
    didFailPurchase: { product, error in /* handle the error */ },
    didFinishRestore: { profile in /* check access level and dismiss */ },
    didFailRestore: { error in /* handle the error */ },
    didFailRendering: { error in flowPresented = false }
)

Abrir URLs desde flows y paywalls

Para añadir un botón que abra un enlace desde tu flow o paywall (p. ej., Terms of use o Privacy policy):

1. En el builder, añade un botón, asígnale la acción Open URL e introduce la URL que quieras abrir.
2. En el código de tu app, implementa un handler para la acción openURL que abra la URL recibida en un navegador.

.flow(
    isPresented: $flowPresented,
    flowConfiguration: flowConfiguration,
    didPerformAction: { action in
        switch action {
        case let .openURL(url):
            UIApplication.shared.open(url, options: [:]) // default behavior
        default:
            break
        }
    },
    didFailPurchase: { product, error in /* handle the error */ },
    didFinishRestore: { profile in /* check access level and dismiss */ },
    didFailRestore: { error in /* handle the error */ },
    didFailRendering: { error in flowPresented = false }
)

Manejar acciones personalizadas

Para añadir un botón que maneje cualquier otra acción:

1. En el builder, añade un botón, asígnale la acción Custom y dale un ID.
2. 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:

.flow(
    isPresented: $flowPresented,
    flowConfiguration: flowConfiguration,
    didPerformAction: { action in
        switch action {
        case let .custom(id):
            if id == "openNewPaywall" {
                // Display another flow or paywall
            }
        default:
            break
        }
    },
    didFailPurchase: { product, error in /* handle the error */ },
    didFinishRestore: { profile in /* check access level and dismiss */ },
    didFailRestore: { error in /* handle the error */ },
    didFailRendering: { error in flowPresented = false }
)

Si estás creando paywalls con el Paywall Builder de Adapty, es fundamental configurar los botones correctamente:

1. Añade un botón en el Paywall Builder y asígnale una acción preexistente o crea un ID de acción personalizado.
2. 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.

Cerrar paywalls

Para añadir un botón que cierre tu paywall:

1. En el Paywall Builder, añade un botón y asígnale la acción Close.
2. En el código de tu app, implementa un manejador para la acción close que descarte el paywall.

func paywallController(_ controller: AdaptyPaywallController,
                       didPerform action: AdaptyUI.Action) {
    switch action {
        case .close:
            controller.dismiss(animated: true) // default behavior
            break
    }
}

Abrir URLs desde paywalls

Para añadir un botón que abra un enlace desde tu paywall (por ejemplo, Terms of use o Privacy policy):

1. En el Paywall Builder, añade un botón, asígnale la acción Open URL e introduce la URL que quieres abrir.
2. En el código de tu app, implementa un handler para la acción openUrl que abra la URL recibida en un navegador.

func paywallController(_ controller: AdaptyPaywallController,
                       didPerform action: AdaptyUI.Action) {
    switch action {
        case let .openURL(url):
            UIApplication.shared.open(url, options: [:]) // default behavior
        break
    }
}

Iniciar sesión en la app

Para añadir un botón que permita a los usuarios iniciar sesión en tu app:

1. En el Paywall Builder, añade un botón y asígnale la acción Login.
2. En el código de tu app, implementa un handler para la acción login que identifique a tu usuario.

func paywallController(_ controller: AdaptyPaywallController,
                      didPerform action: AdaptyUI.Action) {
   switch action {
       case .login:
           // Show a login screen
           let loginVC = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "LoginViewController")
           controller.present(loginVC, animated: true)
   }
}

Gestionar acciones personalizadas

Para añadir un botón que gestione cualquier otra acción:

1. En el Paywall Builder, añade un botón, asígnale la acción Custom y asígnale un ID.
2. En el código de tu app, implementa un manejador 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:

func paywallController(_ controller: AdaptyPaywallController,
                      didPerform action: AdaptyUI.Action) {
   switch action {
       case let .custom(id):
           if id == "openNewPaywall" {
              // Display another paywall
              }
           }
           break
   }
}