Afficher un paywall configuré via Remote Config dans le SDK iOS

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

N’oubliez pas de vérifier si un utilisateur est éligible à une offre de lancement sur iOS et d’adapter la vue du paywall pour gérer le cas où il y est éligible.

Obtenir le Remote Config d’un flow et l’afficher

Dans la v4, un flow contient une entrée AdaptyRemoteConfig par locale configurée dans le tableau remoteConfigs. Sélectionnez la locale correspondant aux préférences de l’utilisateur, puis lisez les valeurs dont vous avez besoin.

do {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
    let config = flow.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
    let flow = try? result.get()
    let config = flow?.remoteConfigs.first(where: { $0.locale == "en" })
        ?? flow?.remoteConfigs.first
    let headerText = config?.dictionary?["header_text"] as? String
}

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

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

Nous vous recommandons de créer un paywall de secours appelé fallback paywall. Ce paywall de secours s’affichera à l’utilisateur en l’absence de connexion internet ou de cache disponible, garantissant ainsi 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. Si les données d’achat sont collectées automatiquement, l’enregistrement des affichages de paywall requiert 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) — cela sera pris en compte dans vos métriques de paywall dans les entonnoirs et les tests A/B.

try await Adapty.logShowFlow(flow)

Paramètres de la requête :

Si vous avez personnalisé un paywall à l’aide d’un Remote Config, vous devrez implémenter le rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Étant donné que le 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 vue paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous donnant toute latitude pour afficher votre paywall personnalisé configuré via Remote Config.

N’oubliez pas de vérifier si un utilisateur est éligible à une offre de lancement sur iOS et d’adapter l’affichage du paywall pour gérer le cas où il y est éligible.

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.

do {
    let paywall = try await Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID")
    let headerText = paywall.remoteConfig?.dictionary?["header_text"] as? String
} catch {
    // handle the error
}

Adapty.getPaywall(placementId: "YOUR_PLACEMENT_ID") { result in
    let paywall = try? result.get()
    let headerText = paywall?.remoteConfig?.dictionary?["header_text"] as? String
}

À ce stade, une fois que vous avez récupéré 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, pour une expérience fluide et intuitive sur tous les appareils.

Une fois l’affichage du paywall configuré, passez à la mise en place 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 vous recommandons de créer un paywall de secours. Ce paywall s’affiche à 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. Si les achats sont collectés automatiquement, l’enregistrement des affichages de paywall vous incombe, car vous seul savez quand un utilisateur 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.

Adapty.logShowPaywall(paywall)