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

Si vous avez personnalisé un paywall à l’aide du Remote Config, vous devrez implémenter son rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Le Remote Config offrant une flexibilité adaptée à vos besoins, c’est vous qui décidez de ce qu’il contient et de l’apparence de votre paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous donnant ainsi toute latitude pour afficher votre paywall personnalisé configuré via le Remote Config.

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

Dans la v4, le flow contient une liste remoteConfigs — un Remote Config par localisation configurée. Sélectionnez l’entrée correspondant à la langue de l’utilisateur et extrayez les valeurs nécessaires. Consultez Localisations et codes de langue pour choisir 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 reçu toutes les valeurs nécessaires, il est temps de les afficher et de les assembler en une page visuellement attrayante. Assurez-vous que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, offrant une expérience fluide et conviviale sur tous les appareils.

Warning

Veillez à enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin de permettre à Adapty Analytics de collecter les données pour les funnels et les tests A/B.

Une fois le paywall affiché, configurez le flux d’achat. Lorsque l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre paywall. Pour plus de détails sur la méthode .makePurchase(), consultez Effectuer des achats.

Nous vous recommandons de créer un paywall de secours. Ce paywall s’affichera à l’utilisateur lorsqu’il n’y a pas de connexion internet ou de cache disponible, garantissant une expérience fluide même dans ces situations.

Suivre les événements d’affichage de paywall

Adapty vous aide à mesurer les performances de vos paywalls. Bien que les données sur les achats soient collectées automatiquement, l’enregistrement des affichages de paywalls nécessite votre intervention, car vous seul savez quand un client 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 entonnoirs et les tests A/B.

Important

Il n’est pas nécessaire d’appeler .logShowFlow(flow: flow) 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`.

Si vous avez personnalisé un paywall avec Remote Config, vous devez implémenter le rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme Remote Config offre une flexibilité adaptée à vos besoins, c’est vous qui décidez de ce qui est inclus et de l’apparence de votre paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous laissant toute liberté pour afficher votre paywall personnalisé configuré via Remote Config.

Obtenir le Remote Config d’un 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) {
}

À ce stade, une fois que vous avez reçu toutes les valeurs nécessaires, il est temps de les afficher et de les assembler en une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des appareils mobiles, pour offrir une expérience fluide et agréable sur tous les appareils.

Warning

Pensez à enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin qu’Adapty Analytics puisse collecter les données nécessaires aux funnels et aux tests A/B.

Une fois le paywall affiché, configurez le flux d’achat. Quand 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. Ce paywall de secours 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 de paywall

Adapty vous aide à mesurer les performances de vos paywalls. Les achats sont suivis automatiquement, mais l’enregistrement des affichages de paywalls nécessite votre intervention, car vous seul savez quand un client voit un 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 entonnoirs et les tests A/B.

Important

Il n’est pas nécessaire d’appeler .logShowPaywall(paywall) 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`.