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 montre la progression hebdomadaire que l’utilisateur peut espérer avec votre application, d’une valeur à l’autre. Votre application affiche le graphique sous forme de vue Swift Charts native dans un élément personnalisé.

Tip

Cette recette couvre uniquement les applications iOS. Les applications créées avec d’autres frameworks affichent uniquement le contenu de secours des éléments personnalisés. La prise en charge d’Android et des frameworks multiplateforme est à venir.

Avant de commencer

  • Mettez à jour votre application vers Adapty iOS SDK 4.4 ou version ultérieure. Les versions antérieures du SDK affichent le contenu de secours pour chaque élément personnalisé.
  • Configurez votre application pour récupérer et afficher les flows.
  • 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 le poids cible dans le flow d’onboarding

Dans le Flow & Paywall Builder, ajoutez deux champs Number au flow d’onboarding :

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

Pour que votre application lise les poids de la même manière dans tous les paramètres régionaux, sélectionnez Integer dans le menu déroulant Format des deux champs. Un champ envoie sa valeur à votre application sous forme de texte, exactement tel que l’utilisateur le saisit. 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çoit les deux valeurs, terminez le flow d’onboarding avec un écran sans champ de saisie. Sur cet écran, ajoutez un bouton avec l’action Close flow. Les champs envoient leurs valeurs lorsqu’ils perdent le focus ou lorsque l’utilisateur passe à un autre écran.

2. Ajoutez 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 réactifs au toucher, comme un carrousel. Sinon, un glissement sur le graphique déplace également le carrousel.

À 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. Enregistrez le poids actuel et l’objectif dans votre app

Collectez le poids actuel et l’objectif à partir des événements flow_user_input du flow d’onboarding, comme 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 à true. Lorsque le flow d’onboarding se ferme après cet écran, transmettez les deux poids à showWeightPaywall, la méthode qui ouvre le flow de paywall avec le graphique.

Le code suivant est pour UIKit. Un seul view controller est le délégué des deux flows. Il doit également implémenter les méthodes d’achat et de restauration du protocole AdaptyFlowControllerDelegate. Cet exemple les omet. Pour les voir, consultez Présenter les flows et les paywalls dans UIKit.

Dans SwiftUI, utilisez les closures didReceiveAnalyticEvent et didDisappear du modificateur .flow à la place des méthodes de délégation. Présentez le flow de paywall avec un second modificateur .flow.

4. Créer la vue du graphique

Créez un modèle de plan de poids et une vue SwiftUI 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 indique la semaine au point de contact et affiche le poids projeté pour cette semaine :

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

Le déplacement le long du graphique nécessite iOS 17 ou une version ultérieure. Sur iOS 16, les utilisateurs voient la ligne, mais ne peuvent pas la faire glisser.

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

Rédigez un resolver qui renvoie 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 au flow du paywall lorsque vous récupérez sa configuration. Créez le resolver avec le plan de poids à partir du poids actuel et de l’objectif :

Si votre application définit un résolveur global, ce résolveur le remplace dans le flow du paywall. WeightChartResolver renvoie nil pour tout autre Type et ID, car le flow du paywall dans cette recette ne contient pas d’autres éléments personnalisés. Si votre flow de paywall comporte d’autres éléments personnalisés, transmettez le résolveur global à celui-ci. Appelez ensuite le résolveur global pour leurs Types et ID, comme dans Associer un résolveur à un 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 en cache, enregistrez l’appareil en tant qu’appareil de test.
  2. Lancez un build de votre application incluant le resolver, sur iOS 17 ou version ultérieure. Complétez le flow d’onboarding en saisissant 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 projeté pour la semaine correspondante s’affiche au-dessus de la ligne.

Pour tester le fallback, supprimez l’argument customElementsResolver de l’appel getFlowConfiguration, puis ouvrez à nouveau le flow de paywall.

Pour comprendre pourquoi le fallback s’affiche à la place du graphique, suivez les instructions de la section Tester sur un appareil du guide iOS.