Implementar paywalls web en Flutter SDK

Antes de empezar, asegúrate de haber configurado tu paywall web en el dashboard e instalado la versión 3.6.1 o posterior del SDK de Adapty.

Si trabajas con un paywall desarrollado por ti mismo, debes gestionar los paywalls web mediante el método del SDK. El método .openWebPaywall:

  1. Genera una URL única que permite a Adapty vincular un paywall específico mostrado a un usuario concreto con la página web a la que es redirigido.
  2. Detecta cuándo el usuario vuelve a la app y, a continuación, llama a .getProfile a intervalos cortos para determinar si los derechos de acceso del perfil han sido actualizados.

De este modo, si el pago se realizó correctamente y los derechos de acceso se han actualizado, la suscripción se activa en la app casi de inmediato.

try {
  await Adapty().openWebPaywall(product: <YOUR_PRODUCT>);
  // The web paywall will be opened
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle other errors
}

Hay dos versiones del método openWebPaywall:

  1. openWebPaywall(product) que genera URLs por paywall y también añade los datos del producto a las URLs.
  2. openWebPaywall(paywall) que genera URLs por paywall sin añadir los datos del producto a las URLs. Úsala cuando tus productos en el paywall de Adapty sean diferentes a los del web paywall.

Gestión de errores

ErrorDescripciónAcción recomendada
AdaptyError.paywallWithoutPurchaseUrlEl paywall no tiene una URL de compra web configuradaComprueba si el paywall está correctamente configurado en el Adapty Dashboard
AdaptyError.productWithoutPurchaseUrlEl producto no tiene una URL de compra webVerifica la configuración del producto en el Adapty Dashboard
AdaptyError.failedOpeningWebPaywallUrlNo se pudo abrir la URL en el navegadorComprueba la configuración del dispositivo o proporciona un método de compra alternativo
AdaptyError.failedDecodingWebPaywallUrlNo se pudieron codificar correctamente los parámetros en la URLVerifica que los parámetros de la URL sean válidos y estén correctamente formateados

Abrir paywalls web en un navegador integrado

Abrir paywalls web en un navegador integrado está disponible a partir del SDK de Adapty v3.15.

Por defecto, los paywalls web se abren en el navegador externo.

Para ofrecer una experiencia de usuario más fluida, puedes abrirlos en un navegador integrado. Esto muestra la página de compra web dentro de tu aplicación, permitiendo que los usuarios completen las transacciones sin cambiar de app.

Para activarlo, establece el parámetro in en .inAppBrowser:

try {
  await Adapty().openWebPaywall(
    product: <YOUR_PRODUCT>,
    openIn: AdaptyWebPresentation.inAppBrowser,
  );
  // The web paywall will be opened in the in-app browser
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle other errors
}