Obtener onboardings en el SDK de Unity
Después de diseñar la parte visual de tu onboarding con el editor en el Adapty Dashboard, puedes mostrarlo en tu app de Unity. El primer paso es obtener el onboarding asociado al placement y su configuración de vista, tal como se describe a continuación.
Antes de empezar, asegúrate de que:
- Has instalado el SDK de Unity de Adapty en su versión 3.14.0 o superior.
- Has creado un onboarding.
- Has añadido el onboarding a un placement.
Obtener el onboarding y crear la vista
Cuando creas un onboarding con nuestro editor sin código, se almacena como un contenedor con una configuración que tu app necesita obtener y mostrar. Este contenedor gestiona toda la experiencia: qué contenido aparece, cómo se presenta y cómo se procesan las interacciones del usuario (como respuestas a cuestionarios o entradas de formularios). El contenedor también registra automáticamente los eventos de analíticas, por lo que no necesitas implementar un seguimiento de vistas por separado.
Para obtener el mejor rendimiento, obtén la configuración del onboarding con antelación para dar tiempo suficiente a que las imágenes se descarguen antes de mostrárselas a los usuarios.
Para obtener un onboarding, usa el método GetOnboarding:
Adapty.GetOnboarding("YOUR_PLACEMENT_ID", (onboarding, error) => {
if (error != null) {
// handle the error
return;
}
// the requested onboarding
});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: | El identificador de la localización del onboarding. Se espera que este parámetro sea un código de idioma compuesto de uno o dos subetiquetas separadas por el carácter menos (-). La primera subetiqueta corresponde al idioma y la segunda a la región. Ejemplo: Consulta Localizaciones y códigos de localización para más información sobre los códigos de localización 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 Ten en cuenta que la caché permanece intacta al reiniciar la app y solo se borra cuando se reinstala la app o mediante limpieza manual. El SDK de Adapty almacena los onboardings localmente en dos capas: la caché actualizada periódicamente descrita anteriormente y los onboardings de respaldo. También usamos CDN para obtener los onboardings 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 garantizar que siempre obtengas la versión más reciente de tus onboardings, asegurando 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 de espera, se devolverán los datos en caché o el respaldo local. Ten en cuenta que, en casos excepcionales, este método puede agotar el tiempo de espera un poco más tarde de lo especificado en |
Parámetros de respuesta:
| Parámetro | Descripción |
|---|---|
| Onboarding | Un objeto AdaptyOnboarding con: el identificador y la configuración del onboarding, Remote Config y otras propiedades. |
Tras obtener el onboarding, llama al método CreateOnboardingView.
El resultado del método CreateOnboardingView solo puede usarse una vez. Si necesitas usarlo de nuevo, llama al método CreateOnboardingView otra vez. Llamarlo dos veces sin volver a crearlo puede provocar el error AdaptyUIError.viewAlreadyPresented.
AdaptyUI.CreateOnboardingView(onboarding, (view, error) => {
// handle the result
});Parámetros:
| Parámetro | Presencia | Descripción |
|---|---|---|
| onboarding | obligatorio | Un objeto AdaptyOnboarding para obtener una vista del onboarding deseado. |
| externalUrlsPresentation | opcional por defecto: | Controla cómo se abren los enlaces en el onboarding. Opciones disponibles: - - Consulta Personalizar cómo se abren los enlaces en los onboardings para ver ejemplos de uso. |
Una vez que hayas cargado correctamente el onboarding y su configuración de vista, puedes mostrarlo en tu app móvil.
Acelerar la obtención del onboarding con el onboarding de audiencia por defecto
Normalmente, los onboardings se obtienen casi de inmediato, por lo que no necesitas preocuparte por acelerar este proceso. Sin embargo, en los casos en que tienes numerosas audiencias y onboardings, y tus usuarios tienen una conexión a internet débil, obtener un onboarding puede tardar más de lo que te gustaría. En estas situaciones, puede que quieras mostrar un onboarding por defecto para garantizar una experiencia de usuario fluida en lugar de no mostrar ninguno.
Para resolver esto, puedes usar el método GetOnboardingForDefaultAudience, que obtiene el onboarding del placement especificado para la audiencia All Users. Sin embargo, es fundamental entender que el enfoque recomendado es obtener el onboarding con el método getOnboarding, tal como se detalla en la sección Obtener el onboarding anterior.
Considera usar GetOnboarding en lugar de GetOnboardingForDefaultAudience, ya que este último tiene limitaciones importantes:
- Problemas de compatibilidad: Puede generar problemas al admitir varias versiones de la app, lo que requiere diseños compatibles con versiones anteriores o aceptar que las versiones más antiguas puedan mostrarse incorrectamente.
- Sin personalización: Solo muestra contenido para la audiencia “All Users”, eliminando la segmentación basada en país, atribución o atributos personalizados.
Si una obtención más rápida supera estos inconvenientes para tu caso de uso, usa GetOnboardingForDefaultAudience como se muestra a continuación. De lo contrario, usa GetOnboarding como se describe arriba.
Adapty.GetOnboardingForDefaultAudience("YOUR_PLACEMENT_ID", (onboarding, error) => {
if (error != null) {
// handle the error
return;
}
// the requested onboarding
});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: | El identificador de la localización del onboarding. Se espera que este parámetro sea un código de idioma compuesto de uno o dos subetiquetas separadas por el carácter menos (-). La primera subetiqueta corresponde al idioma y la segunda a la región. Ejemplo: |
| 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 Ten en cuenta que la caché permanece intacta al reiniciar la app y solo se borra cuando se reinstala la app o mediante limpieza manual. El SDK de Adapty almacena los onboardings localmente en dos capas: la caché actualizada periódicamente descrita anteriormente y los onboardings de respaldo. También usamos CDN para obtener los onboardings 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 garantizar que siempre obtengas la versión más reciente de tus onboardings, asegurando la fiabilidad incluso cuando la conexión a internet es escasa. |