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

Si vous avez personnalisé un paywall via Remote Config, vous devrez 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 vue paywall. Adapty fournit une méthode pour récupérer la configuration distante, vous laissant toute liberté 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 paywall pour gérer le cas où il l’est.

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

En v4, un flow contient une entrée AdaptyRemoteConfig par locale configurée dans le tableau remoteConfigs. Choisissez la locale correspondant à la préférence 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 récupéré toutes les valeurs nécessaires, il est temps de les assembler en une page visuellement attractive. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, pour une expérience fluide et agréable sur tous les appareils.

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

Une fois l’affichage du paywall terminé, passez à la mise en place du flow d’achat. Quand l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre flow. 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 de secours 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 du paywall

Adapty vous aide à mesurer les performances de vos paywalls. Bien que les données d’achat soient collectées automatiquement, l’enregistrement des vues de paywall 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) — il sera alors pris en compte dans vos métriques de paywall dans les entonnoirs et les tests A/B.

Il n’est pas nécessaire d’appeler .logShowFlow(flow) si vous affichez des flows ou des paywalls rendus par le Flow Builder ou le Paywall Builder. Adapty suit les vues automatiquement dans ces cas.

try await Adapty.logShowFlow(flow)

Paramètres de la requête :

Paramètre	Présence	Description
flow	obligatoire	Un objet `AdaptyFlow` obtenu via `Adapty.getFlow(placementId:)`.

Si vous avez personnalisé un paywall via Remote Config, vous devrez 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 vue paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous laissant toute liberté pour présenter 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 la vue paywall pour gérer le cas où il l’est.

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

Pour récupérer le Remote Config d’un paywall, accédez à la propriété remoteConfig et extrayez les valeurs nécessaires.

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
}

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

Une fois l’affichage du paywall terminé, passez à la mise en place du flow 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.

Suivre les événements d’affichage du paywall

Pour enregistrer un événement d’affichage de paywall, appelez simplement .logShowPaywall(paywall) — il sera alors pris en compte dans vos métriques de paywall dans les entonnoirs et les tests A/B.

Il n’est pas nécessaire d’appeler .logShowPaywall(paywall) si vous affichez des paywalls créés dans le Paywall Builder.

Adapty.logShowPaywall(paywall)

Paramètres de la requête :

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