Implementar paywalls web en Flutter SDK

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

Si estás trabajando con un paywall que has desarrollado tú mismo, necesitas gestionar los paywalls web mediante el método del SDK. El método .openWebPaywall:

  1. Genera una URL única que permite a Adapty vincular el paywall concreto mostrado a un usuario determinado con la página web a la que es redirigido.
  2. Detecta cuándo los usuarios vuelven a la app y luego solicita .getProfile a intervalos cortos para determinar si los derechos de acceso del perfil se han actualizado.

De esta forma, si el pago se ha completado 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
}

Existen dos versiones del método openWebPaywall:

  1. openWebPaywall(product), que genera URLs por paywall y añade también 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. Úsalo cuando los productos de tu paywall en Adapty sean diferentes a los del paywall web.

Gestionar errores

ErrorDescripciónAcción recomendada
AdaptyError.paywallWithoutPurchaseUrlEl paywall no tiene configurada una URL de compra webComprueba si el paywall se ha configurado correctamente 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 navegadorRevisa 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 in-app

La apertura de paywalls web en un navegador in-app está disponible a partir de la versión 3.15 del SDK de Adapty.

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

Para ofrecer una experiencia de usuario fluida, puedes abrir los paywalls web en un navegador in-app. Esto muestra la página de compra web dentro de tu aplicación, permitiendo a los usuarios completar las transacciones sin cambiar de app.

Para habilitarlo, 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
}