Afficher un graphique interactif d'objectif de poids dans un paywall

Suivez cette recette pour afficher le poids projeté de chaque utilisateur sous forme de graphique dans un flow de paywall. L’utilisateur saisit son poids actuel et son poids cible dans un flow d’onboarding. Votre application collecte ces deux valeurs. Le graphique affiche la progression hebdomadaire que l’utilisateur peut espérer avec votre application, de l’une à l’autre. Votre application affiche le graphique sous forme de vue native dans un élément personnalisé. La vue dessine le graphique sans bibliothèque de graphiques.

Avant de commencer

Créez deux flows distincts — un pour l’onboarding, et un pour le paywall. Ajoutez chacun à un placement. Le code de cette recette récupère le flow du paywall depuis le placement avec l’ID weight_paywall.

1. Demander le poids actuel et l’objectif dans le flow d’onboarding

Dans le Flow & Paywall Builder, ajoutez deux saisies Number à l’onboarding flow :

  • Une pour le poids actuel en kilogrammes, avec l’Element ID weight.
  • Une pour le poids cible en kilogrammes, avec l’Element ID goal_weight.

Pour que votre application lise les poids de la même façon dans toutes les langues, sélectionnez Integer dans le menu déroulant Format des deux saisies. Une saisie envoie sa valeur à votre application sous forme de texte, exactement tel que l’utilisateur l’a tapé. Le code de cette recette interprète « 70.5 » et « 70,5 » différemment. Les nombres entiers n’ont pas de séparateur décimal.

Pour vous assurer que votre application reçoive les deux valeurs, terminez l’onboarding flow par un écran sans saisies. Sur cet écran, ajoutez un bouton avec l’action Close flow. Les saisies envoient leurs valeurs lorsqu’elles perdent le focus ou lorsque l’utilisateur passe à un autre écran.

2. Ajouter l’élément personnalisé à l’écran du paywall

Dans le flow du paywall, ajoutez un élément personnalisé à un écran et configurez-le pour le graphique :

  • Type : line_chart.
  • ID : weight_goal.
  • Hauteur : Conservez la hauteur Fixed par défaut. Le graphique remplit l’élément personnalisé.

Ne placez pas l’élément personnalisé dans des conteneurs qui répondent au toucher, comme un carousel, afin que seul le graphique réagisse au glissement.

À l’intérieur de l’élément personnalisé, ajoutez une Image avec un exemple de graphique de poids. Les utilisateurs la voient comme contenu de secours lorsque leur version de votre application n’affiche pas le graphique.

3. Enregistrer le poids actuel et l’objectif dans votre app

Récupérez le poids actuel et l’objectif à partir des événements flow_user_input du flow d’onboarding, comme indiqué dans Traiter les données des flows. Pour savoir que l’utilisateur a atteint le dernier écran, surveillez un événement flow_screen_showed avec is_last_screen défini à true. Lorsque le flow d’onboarding se ferme après cet écran, transmettez les deux poids à showWeightPaywall, la fonction qui ouvre le flow de paywall avec le graphique.

Lorsque l’utilisateur appuie sur le bouton avec l’action Close flow sur le dernier écran, le listener ouvre le flow de paywall à la place du flow d’onboarding.

4. Créer la vue du graphique

Créez un modèle de plan de poids et une vue avec le graphique. Le plan comporte une entrée par semaine, du poids actuel jusqu’au poids cible. Lorsque l’utilisateur fait glisser son doigt sur le graphique, la vue marque la semaine au point de contact et affiche le poids prévu pour cette semaine :

Le plan suppose que le poids évolue de 0,5 kg par semaine. Pour utiliser un autre taux, modifiez weeklyChange.

5. Associer le graphique à l’élément personnalisé

Écrivez un resolver qui retourne la vue du graphique pour le Type line_chart et l’ID weight_goal. Stockez le plan de poids dans une propriété du resolver :

Attachez le resolver lors de la création de la vue du flow de paywall. Créez le resolver avec le plan de poids à partir du poids actuel et du poids cible :

Si votre application définit un résolveur global, ce résolveur le remplace dans le flow du paywall. WeightChartResolver ne renvoie aucune vue pour les autres Types et IDs, car le flow du paywall dans cette recette ne contient pas d’autres éléments personnalisés. Si votre flow de paywall possède d’autres éléments personnalisés, transmettez le résolveur global à celui-ci. Appelez ensuite le résolveur global pour leurs Types et IDs, comme dans Afficher les données pour un seul flow.

6. Tester sur un appareil

Le Flow & Paywall Builder ne peut pas exécuter le code de votre application, donc son canvas affiche uniquement le paywall de secours. Pour prévisualiser le graphique :

  1. Publiez les deux flows. Pour voir les dernières versions publiées plutôt que les versions mises en cache, enregistrez l’appareil en tant que device de test.
  2. Lancez un build de votre application qui inclut le resolver. Complétez le flow d’onboarding avec un poids actuel et un poids cible. Vérifiez que la ligne du graphique commence au poids actuel et se termine au poids cible.
  3. Faites glisser votre doigt sur le graphique et vérifiez que le poids prévu pour la semaine sous votre doigt s’affiche au-dessus de la ligne.

Pour tester le fallback, faites en sorte que WeightChartResolver renvoie null, puis ouvrez à nouveau le flow du paywall.

Pour savoir pourquoi le paywall de secours s’affiche à la place du graphique, suivez les instructions de la section Tester sur un appareil du guide Android.