Fetching paywalls and their configuration from the Paywall Builder is the first step to displaying them in your Unity app. Once you have the paywall and its view configuration, you can render it on the device (covered in the next step).

Fetch paywall designed with Paywall Builder

If you’ve customized a paywall using the Paywall Builder, fetch it with the GetPaywall method:

const string placementId = "YOUR_PLACEMENT_ID";

Adapty.GetPaywall(placementId, null, (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // the requested paywall
});

Request parameters:

Parameter	Presence	Description
placementId	required	The identifier of the desired placement. This is the value you specified when creating a placement in your Adapty Dashboard.
locale	optional	The identifier of the paywall localization. This parameter is expected to be a language code composed of one or two subtags separated by the minus (-) sign. The first subtag is for the language, the second one is for the region. Examples: en, en-US, pt-BR. Learn more about localizations.
fetchPolicy	optional	By default, SDK will try to load data from the server and will return cached data in case of failure. We recommend this variant because it ensures your users always see the most up-to-date data. However, if you want to ensure responses are received as quickly as possible, you might opt for .returnCacheDataElseLoad.

Fetch View Configuration

Once you have the paywall, fetch the view configuration for it with the GetPaywallConfiguration method:

Adapty.GetPaywallConfiguration(paywall, (configuration, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // use the configuration
});

After fetching the view configuration, you can render the paywall.

Speed up paywall fetching with default audience paywall

Typically, paywalls are fetched as part of a placement, which means the SDK needs to determine the user’s audience and then retrieve the paywall. This process can take a bit of time, especially on the first run.

To speed things up, you can fetch the paywall for the Default Audience using the GetPaywallForDefaultAudience method. This method is faster because it skips the audience determination step.

Adapty.GetPaywallForDefaultAudience(placementId, null, (paywall, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // the requested paywall for default audience
});

Después de diseñar la parte visual de tu paywall con el nuevo Paywall Builder en el Adapty Dashboard, puedes mostrarlo en tu aplicación móvil. El primer paso es obtener el paywall asociado al placement y su configuración de vista, tal como se describe a continuación.

Por favor, ten en cuenta que este tema hace referencia a paywalls personalizadas con Paywall Builder. Si estás implementando tus paywalls de forma manual, consulta el tema Obtener paywalls y productos para paywalls con Remote Config en tu app móvil.

Antes de empezar a mostrar paywalls en tu app móvil (haz clic para expandir)

1. Crea tus productos en el Adapty Dashboard.
2. Crea un paywall e incorpora los productos en él en el Adapty Dashboard.
3. Crea placements e incorpora tu paywall en ellos en el Adapty Dashboard.
4. Instala el SDK de Adapty en tu aplicación móvil.

Obtener un paywall diseñado con Paywall Builder

Si has diseñado un paywall con el Paywall Builder, no tienes que preocuparte por renderizarlo en el código de tu app móvil para mostrárselo al usuario. Este tipo de paywall contiene tanto lo que debe mostrarse como la forma en que debe mostrarse. Aun así, necesitas obtener su ID a través del placement, su configuración de vista y luego presentarlo en tu app móvil. Para garantizar un rendimiento óptimo, es fundamental obtener el paywall y su configuración de vista lo antes posible, dando tiempo suficiente para que las imágenes se descarguen antes de mostrárselas al usuario.

Para obtener un paywall, usa el método GetPaywall:

Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

Parámetros:

Parámetro	Presencia	Descripción
placementId	requerido	El identificador del Placement deseado. Es el valor que especificaste al crear un placement en el Adapty Dashboard.
locale	opcional por defecto: en	El identificador de la localización del paywall. Se espera que este parámetro sea un código de idioma compuesto por uno o dos subetiquetas separadas por el carácter menos (-). La primera subetiqueta corresponde al idioma y la segunda a la región. Ejemplo: en significa inglés, pt-br representa el portugués de Brasil. Consulta Localizaciones y códigos de idioma para más información sobre los códigos de idioma y cómo recomendamos usarlos.
fetchPolicy	por defecto: .reloadRevalidatingCacheData	Por defecto, el SDK intentará cargar los datos desde el servidor y devolverá los datos en caché en caso de fallo. Recomendamos esta opción porque garantiza que tus usuarios siempre reciban los datos más actualizados. Sin embargo, si crees que tus usuarios tienen una conexión a internet inestable, considera usar .returnCacheDataElseLoad para devolver los datos en caché si existen. En este caso, puede que los usuarios no obtengan los datos más recientes, pero experimentarán tiempos de carga más rápidos sin importar lo irregular que sea su conexión. La caché se actualiza con regularidad, por lo que es seguro usarla durante la sesión para evitar peticiones de red. Ten en cuenta que la caché permanece intacta al reiniciar la aplicación y solo se borra cuando se reinstala la app o mediante limpieza manual. El SDK de Adapty almacena los paywalls localmente en dos capas: la caché de actualización regular descrita arriba y los paywalls de respaldo. También usamos CDN para obtener los paywalls más rápido y un servidor de respaldo independiente en caso de que el CDN no sea accesible. Este sistema está diseñado para asegurarse de que siempre obtengas la versión más reciente de tus paywalls, garantizando la fiabilidad incluso cuando la conexión a internet es escasa.
loadTimeout	por defecto: 5 seg	Este valor limita el tiempo de espera para este método. Si se alcanza el tiempo límite, se devolverán los datos en caché o el fallback local. Ten en cuenta que en casos excepcionales este método puede superar ligeramente el tiempo de espera especificado en loadTimeout, ya que la operación puede estar compuesta por diferentes peticiones internamente.
Parámetros de respuesta:

Parámetro	Descripción
Paywall	Un objeto AdaptyPaywall con una lista de IDs de productos, el identificador del paywall, Remote Config y otras propiedades.

Obtener la configuración de vista de un paywall diseñado con Paywall Builder

Tras obtener el paywall, comprueba si incluye un ViewConfiguration, lo que indica que fue creado con Paywall Builder. Esto te guiará sobre cómo mostrar el paywall. Si el ViewConfiguration está presente, trátalo como un paywall del Paywall Builder; si no, gestiónalo como un paywall de Remote Config. En el SDK de Unity, llama directamente al método CreatePaywallView sin necesidad de obtener la configuración de la vista manualmente.

var parameters = new AdaptyUICreatePaywallViewParameters()
  .SetPreloadProducts(preloadProducts)
  .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
  // handle the result
});

Parámetros:

Parámetro	Presencia	Descripción
paywall	obligatorio	Un objeto AdaptyPaywall para obtener un controlador del paywall deseado.
loadTimeout	por defecto: 5 seg	Este valor limita el tiempo de espera para este método. Si se alcanza el timeout, se devolverán datos en caché o el fallback local. Ten en cuenta que en casos excepcionales este método puede superar ligeramente el tiempo especificado en loadTimeout, ya que la operación puede componerse de diferentes solicitudes internamente.
PreloadProducts	opcional	Proporciona un array de AdaptyPaywallProducts para optimizar el momento en que se muestran los productos en pantalla. Si se pasa nil, AdaptyUI obtendrá automáticamente los productos necesarios.
CustomTags	opcional	Define un diccionario de etiquetas personalizadas y sus valores resueltos. Las etiquetas personalizadas actúan como marcadores de posición en el contenido del paywall y se reemplazan dinámicamente con cadenas específicas para personalizar el contenido. Consulta el tema Custom tags in paywall builder para más detalles.
CustomTimers	opcional	Define un diccionario de temporizadores personalizados y sus fechas de finalización. Los temporizadores personalizados te permiten mostrar cuentas atrás en tu paywall.

Una vez que tengas la vista, presenta el paywall.

Personalizar recursos

Para personalizar imágenes y vídeos en tu paywall, implementa los recursos personalizados.

Las imágenes hero y los vídeos tienen IDs predefinidos: hero_image y hero_video. En un bundle de recursos personalizados, puedes hacer referencia a estos elementos por sus IDs y personalizar su comportamiento.

Para otras imágenes y vídeos, necesitas asignar un ID personalizado en el Adapty Dashboard.

Por ejemplo, puedes:

• Mostrar una imagen o vídeo diferente a algunos usuarios.
• Mostrar una imagen de vista previa local mientras se carga una imagen principal remota.
• Mostrar una imagen de vista previa antes de reproducir un vídeo.

Aquí tienes un ejemplo de cómo puedes proporcionar assets personalizados mediante un diccionario sencillo:

var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
    { "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
    { "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomAssets(customAssets)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});

Configurar temporizadores definidos por el desarrollador

Para usar temporizadores personalizados en tu aplicación Unity, puedes pasar un diccionario con los IDs de los temporizadores y sus fechas de finalización directamente al método SetCustomTimers. Aquí tienes un ejemplo:

var customTimers = new Dictionary<string, DateTime> {
    { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
    { "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomTimers(customTimers)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});

En este ejemplo, CUSTOM_TIMER_NY y CUSTOM_TIMER_6H son los Timer IDs de los temporizadores definidos por el desarrollador que configuraste en el Adapty Dashboard. El resolver de temporizadores garantiza que tu app actualice dinámicamente cada temporizador con el valor correcto. Por ejemplo:

• CUSTOM_TIMER_NY: El tiempo restante hasta el fin del temporizador, como el día de Año Nuevo.
• CUSTOM_TIMER_6H: El tiempo restante en un período de 6 horas que comenzó cuando el usuario abrió el paywall.

Acelera la carga del paywall con el paywall de audiencia predeterminada

Normalmente, los paywalls se cargan casi al instante, así que no tienes que preocuparte por optimizar este proceso. Sin embargo, si tienes muchas audiencias y paywalls, y tus usuarios tienen una conexión a internet lenta, la carga del paywall puede tardar más de lo deseable. En esos casos, puede que quieras mostrar un paywall predeterminado para garantizar una experiencia fluida en lugar de no mostrar ningún paywall. Para solucionar esto, puedes usar el método GetPaywallForDefaultAudience, que obtiene el paywall del placement especificado para la audiencia All Users. Sin embargo, es fundamental entender que el enfoque recomendado es obtener el paywall con el método getPaywall, tal como se describe en la sección Obtener el paywall más arriba.

Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

Parámetros:

Parámetro	Presencia	Descripción
placementId	obligatorio	El identificador del Placement deseado. Es el valor que especificaste al crear un placement en el Adapty Dashboard.
locale	opcional por defecto: en	El identificador de la localización del paywall. Se espera que este parámetro sea un código de idioma compuesto por uno o dos subetiquetas separadas por el carácter menos (-). La primera subetiqueta corresponde al idioma y la segunda a la región. Ejemplo: en significa inglés, pt-br representa el portugués de Brasil.
fetchPolicy	por defecto: .reloadRevalidatingCacheData	Por defecto, el SDK intentará cargar los datos desde el servidor y devolverá los datos en caché en caso de error. Recomendamos esta opción porque garantiza que tus usuarios siempre reciban los datos más actualizados. Sin embargo, si crees que tus usuarios tienen una conexión a internet inestable, considera usar .returnCacheDataElseLoad para devolver los datos en caché si existen. En este caso, los usuarios podrían no obtener los datos absolutamente más recientes, pero experimentarán tiempos de carga más rápidos, independientemente de la calidad de su conexión. La caché se actualiza con regularidad, por lo que es seguro usarla durante la sesión para evitar peticiones de red. Ten en cuenta que la caché permanece intacta al reiniciar la app y solo se borra al desinstalarla o mediante una limpieza manual. El SDK de Adapty almacena los paywalls localmente en dos capas: la caché de actualización regular descrita anteriormente y los paywalls de respaldo. También usamos CDN para obtener los paywalls más rápido y un servidor de respaldo independiente por si el CDN no está disponible. Este sistema está diseñado para garantizar que siempre obtengas la versión más reciente de tus paywalls, asegurando la fiabilidad incluso cuando la conexión a internet es escasa.