Afficher un paywall conçu via Remote Config dans le SDK Flutter

Si vous avez personnalisé un paywall via Remote Config, vous devrez implémenter son rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme Remote Config offre une flexibilité adaptée à vos besoins, vous contrôlez ce qui est inclus et la façon dont votre paywall s’affiche. Nous fournissons une méthode pour récupérer la configuration distante, vous laissant libre de présenter votre paywall personnalisé configuré via Remote Config.

Récupérer le Remote Config du paywall et l’afficher

En v4, le flow contient une liste remoteConfigs — un Remote Config par localisation configurée. Choisissez l’entrée qui correspond à la langue de l’utilisateur et extrayez les valeurs dont vous avez besoin. Consultez Localisations et codes de langue pour sélectionner la bonne localisation.


try {
  final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');

  // one entry per configured localization; fall back to the first one
  final config = flow.remoteConfigs.firstWhereOrNull((c) => c.locale == 'en') ??
      flow.remoteConfig;

  final String? headerText = config?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

À ce stade, une fois que vous avez récupéré toutes les valeurs nécessaires, il est temps de les assembler pour composer une page attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, afin d’offrir une expérience fluide et agréable sur tous les appareils.

N’oubliez pas d’enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin qu’Adapty Analytics puisse collecter les données pour les funnels et les tests A/B.

Une fois l’affichage du paywall terminé, passez à la configuration du flux d’achat. Lorsque l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre paywall. Pour en savoir plus sur la méthode .makePurchase(), consultez Effectuer des achats.

Nous recommandons de créer un paywall de secours appelé fallback paywall. Ce paywall s’affichera à l’utilisateur en l’absence de connexion internet ou de cache disponible, garantissant une expérience fluide même dans ces situations.

Suivre les événements d’affichage du paywall

Adapty vous aide à mesurer les performances de vos paywalls. Si les données d’achat sont collectées automatiquement, l’enregistrement des affichages de paywalls nécessite votre intervention, car vous seul savez quand un utilisateur voit un paywall.

Pour enregistrer un événement d’affichage de paywall, appelez simplement .logShowFlow(flow: flow) — cela sera reflété dans vos métriques de paywall dans les funnels et les tests A/B.

L’appel de .logShowFlow(flow: flow) n’est pas nécessaire si vous affichez des flows ou des paywalls créés dans le builder.

try {
  await Adapty().logShowFlow(flow: flow);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Paramètres de la requête :

Paramètre	Présence	Description
flow	requis	Un objet `AdaptyFlow`.

Récupérer le Remote Config du paywall et l’afficher

Pour obtenir le Remote Config d’un paywall, accédez à la propriété remoteConfig et extrayez les valeurs dont vous avez besoin.

try {
  final paywall = await Adapty().getPaywall(placementId: "YOUR_PLACEMENT_ID");
  final String? headerText = paywall.remoteConfig?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

N’oubliez pas d’enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin qu’Adapty Analytics puisse collecter les données pour les funnels et les tests A/B.

Suivre les événements d’affichage du paywall

Pour enregistrer un événement d’affichage de paywall, appelez simplement .logShowPaywall(paywall) — cela sera reflété dans vos métriques de paywall dans les funnels et les tests A/B.

L’appel de .logShowPaywall(paywall) n’est pas nécessaire si vous affichez des paywalls créés dans le Paywall Builder.

try {
  final result = await Adapty().logShowPaywall(paywall: paywall);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Paramètres de la requête :

Paramètre	Présence	Description
paywall	requis	Un objet `AdaptyPaywall`.