Mostrar un gráfico interactivo de objetivo de peso en un paywall
Sigue esta receta para mostrar el peso proyectado de cada usuario como un gráfico en un flow de paywall. El usuario introduce su peso actual y su peso objetivo en un flow de onboarding. Tu app recopila ambos valores. El gráfico muestra el progreso semanal que el usuario puede esperar con tu app, del valor inicial al objetivo. Tu app renderiza el gráfico como una vista nativa de Swift Charts en un elemento personalizado.
Esta receta solo cubre apps de iOS. Las apps creadas con otros frameworks solo muestran el contenido de respaldo de los elementos personalizados. La compatibilidad con Android y frameworks multiplataforma está próxima.
Antes de empezar
- Actualiza tu app a Adapty iOS SDK 4.4 o posterior. Las versiones anteriores del SDK muestran el contenido de respaldo para cada elemento personalizado.
- Configura tu app para obtener y mostrar flows.
- Crea dos flows separados: uno para el onboarding y otro para el paywall. Añade cada uno a un placement. El código de esta receta obtiene el flow del paywall desde el placement con el ID
weight_paywall.
1. Solicitar el peso actual y el objetivo en el onboarding
En el Flow & Paywall Builder, añade dos entradas de tipo Number al onboarding:
- Una para el peso actual en kilogramos, con el Element ID
weight. - Una para el peso objetivo en kilogramos, con el Element ID
goal_weight.
Para que tu app lea los pesos de la misma forma en todos los idiomas, selecciona Integer en el desplegable Format de ambos campos. Un campo envía su valor a tu app como texto, exactamente como lo escribe el usuario. El código de esta receta interpreta “70.5” y “70,5” de forma diferente. Los números enteros no tienen separador decimal.
Para asegurarte de que tu app recibe ambos valores, termina el flow de onboarding con una pantalla que no tenga campos. En esa pantalla, añade un botón con la acción Close flow. Los campos envían sus valores cuando pierden el foco o cuando el usuario pasa a otra pantalla.
2. Añade el elemento personalizado a la pantalla del paywall
En el flow del paywall, añade un elemento personalizado a una pantalla y configúralo para el gráfico:
- Type:
line_chart. - ID:
weight_goal. - Height: Mantén la altura Fixed predeterminada. El gráfico ocupa todo el elemento personalizado.
No coloques el elemento personalizado dentro de contenedores que respondan al toque, como un carrusel. De lo contrario, al arrastrar por el gráfico también se mueve el carrusel.
Dentro del elemento personalizado, añade una Image con un gráfico de peso de muestra. Los usuarios la verán como respaldo cuando su versión de la aplicación no muestre el gráfico.
3. Guarda el peso actual y el objetivo en tu app
Recoge el peso actual y el objetivo de los eventos flow_user_input del flow de onboarding, tal como se describe en Procesar datos de flows. Para saber que el usuario llegó a la última pantalla, observa un evento flow_screen_showed con is_last_screen establecido en true. Cuando el flow de onboarding se cierre tras esa pantalla, pasa ambos pesos a showWeightPaywall, el método que abre el flow de paywall con el gráfico.
El siguiente código es para UIKit. Un solo controlador de vista es el delegado de ambos flows. También debe implementar los métodos de compra y restauración del protocolo AdaptyFlowControllerDelegate. Este ejemplo los omite. Para verlos, consulta Presentar flows y paywalls en UIKit.
En SwiftUI, usa los closures didReceiveAnalyticEvent y didDisappear del modificador .flow en lugar de los métodos delegados. Presenta el flow del paywall con un segundo modificador .flow.
4. Crear la vista del gráfico
Crea un modelo de plan de peso y una vista SwiftUI con el gráfico. El plan tiene una entrada por semana, desde el peso actual hasta el peso objetivo. Cuando el usuario arrastra a lo largo del gráfico, la vista marca la semana en el punto de toque y muestra el peso proyectado para esa semana:
El plan asume que el peso cambia 0,5 kg por semana. Para usar otra tasa, edita weeklyChange.
El arrastre a lo largo del gráfico requiere iOS 17 o posterior. En iOS 16, los usuarios ven la línea, pero no pueden arrastrar a lo largo de ella.
5. Asocia el gráfico al elemento personalizado
Escribe un resolver que devuelva la vista del gráfico para el tipo line_chart y el ID weight_goal. Guarda el plan de peso en una propiedad del resolver:
Adjunta el resolver al flow del paywall cuando obtengas su configuración. Crea el resolver con el plan de peso a partir del peso actual y el objetivo:
Si tu app define un resolver global, este resolver lo reemplaza en el flow del paywall. WeightChartResolver devuelve nil para cualquier otro Type e ID, porque el flow del paywall de esta receta no tiene otros elementos personalizados. Si tu flow del paywall tiene otros elementos personalizados, pasa el resolver global a este. Luego llama al resolver global para sus Types e IDs, como en Adjuntar un resolver a un flow.
6. Prueba en un dispositivo
El Flow & Paywall Builder no puede ejecutar el código de tu app, por lo que el lienzo solo muestra el respaldo. Para previsualizar el gráfico:
- Publica ambos flows. Para ver las últimas versiones publicadas en lugar de las almacenadas en caché, registra el dispositivo como dispositivo de prueba.
- Ejecuta una compilación de tu app que incluya el resolver, en iOS 17 o posterior. Completa el flow de onboarding con un peso actual y un peso objetivo. Verifica que la línea del gráfico empiece en el peso actual y termine en el peso objetivo.
- Arrastra a lo largo del gráfico y verifica que el peso proyectado para la semana bajo tu dedo aparece encima de la línea.
Para probar el respaldo, elimina el argumento customElementsResolver de la llamada a getFlowConfiguration y abre el flow de paywall de nuevo.
Para averiguar por qué aparece el respaldo en lugar del gráfico, sigue las instrucciones de la sección Probar en un dispositivo de la guía de iOS.