Optimizar la obtención de paywalls en Kotlin Multiplatform SDK

Una obtención de paywall fiable en Kotlin Multiplatform hace tres cosas: renderiza rápido, devuelve el paywall orientado a la audiencia y tiene un respaldo elegante cuando la red es lenta. Las reglas a continuación cubren los patrones de temporización, caché y respaldo para lograrlo.

Se asume que Adapty.activate() y Adapty.identify() ya se han resuelto. Consulta Orden de llamadas en el SDK de Kotlin Multiplatform.

El consejo a continuación usa los nombres de métodos de v3. En SDK v4, getPaywall pasa a llamarse getFlow (consulta la guía de migración) — todas las reglas se aplican sin cambios.

Reglas y advertencias

Haz esto	No hagas esto	Por qué
Obtén el placement que estás a punto de mostrar.	No hagas prefetch de todos los placements a la vez al iniciar.	El prefetch masivo bloquea el hilo principal y produce una pantalla en negro durante el pico.
Llama a `getPaywall` después de que la atribución haya tenido oportunidad de resolverse — por ejemplo, 1–2 segundos después de `activate` o cuando se dispare `setOnProfileUpdatedListener`.	No llames a `getPaywall` al arrancar la app.	La atribución aún no ha llegado. El paywall se resuelve con la audiencia por defecto y omite silenciosamente los segmentos y la personalización de ASA.
Establece un `loadTimeout` y configura un paywall de respaldo para cada placement.	No esperes `getPaywall` indefinidamente.	Sin un timeout, los usuarios con mala conectividad ven una pantalla en blanco hasta que la red responde — o simplemente cierran la app.

Consulta Obtener paywalls y productos para la referencia de los parámetros fetchPolicy y loadTimeout, y Placements para elegir el placement adecuado.

Ajustar para conectividad deficiente

Para mercados con conectividad consistentemente deficiente (zonas rurales, transporte público, regiones afectadas por enrutamiento):

Establece fetchPolicy = AdaptyPaywallFetchPolicy.ReturnCacheDataElseLoad en cada obtención excepto la primera.
Configura un paywall de respaldo para cada placement en el Adapty Dashboard.
Establece loadTimeout entre 3 y 5 segundos y acepta el respaldo cuando se agote el tiempo.
No condicionales la visualización del paywall a Adapty.getProfile(). Llama a getPaywall de forma independiente para que un perfil lento no bloquee la interfaz.