Implementar web paywalls en Unity SDK

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

Paywalls web abiertos

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

  1. Genera una URL única que permite a Adapty vincular un paywall concreto mostrado a un usuario específico con la página web a la que es redirigido.
  2. Detecta cuándo tus usuarios vuelven a la app y, a continuación, solicita Adapty.GetProfile a intervalos cortos para determinar si los derechos de acceso del perfil se han actualizado. De esta forma, si el pago fue exitoso y los derechos de acceso se actualizaron, la suscripción se activa en la app casi de inmediato.
Adapty.OpenWebPaywall(
    product,
    (error) =>
    {
        if (error != null)
        {
            Debug.LogError($"Failed to open web paywall: {error.Message}");
        }
        else
        {
            Debug.Log("Web paywall opened successfully");
        }
    }
);

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 distintos de los del paywall web.

Gestión de errores

Código de errorDescripciónAcción recomendada
AdaptyErrorCode.WrongParamEl paywall o producto no tiene configurada una URL de compra web, o no se pudo abrir la URL en el navegadorConsulta el mensaje de error para más detalles. Verifica la configuración del paywall/producto en el Adapty Dashboard, o comprueba la configuración del dispositivo.
AdaptyErrorCode.DecodingFailedNo 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

Comprueba la propiedad Message del error para obtener detalles específicos sobre qué salió mal, ya que WrongParam puede indicar varios problemas (URL de compra faltante, fallo al abrir el navegador, etc.).

Abre web paywalls en un navegador in-app

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

Por defecto, los web paywalls se abren en el navegador externo, lo que saca a los usuarios de tu aplicación.

Para ofrecer una experiencia más fluida, puedes abrirlos en un navegador in-app. Así, la página de compra web se muestra dentro de tu aplicación y los usuarios pueden completar las transacciones sin cambiar de app.

Para habilitarlo, pasa AdaptyWebPresentation.InAppBrowser al método OpenWebPaywall:

Adapty.OpenWebPaywall(
    product,
    AdaptyWebPresentation.InAppBrowser, // default — ExternalBrowser
    (error) =>
    {
        if (error != null)
        {
            Debug.LogError($"Failed to open web paywall: {error.Message}");
        }
        else
        {
            Debug.Log("Web paywall opened successfully");
        }
    }
);