Récupérer les paywalls et produits pour les paywalls Remote Config dans le SDK Kotlin Multiplatform
Avant de présenter le Remote Config et les paywalls personnalisés, vous devez récupérer les informations les concernant. Notez que cette rubrique porte sur le Remote Config et les paywalls personnalisés. Pour savoir comment récupérer des flows ou des paywalls personnalisés dans le Flow Builder ou le Paywall Builder, consultez Obtenir des flows et des paywalls.
Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Consultez nos exemples d’applications, qui illustrent la configuration complète, notamment l’affichage des paywalls, les achats et d’autres fonctionnalités de base.
Avant de commencer à récupérer les flows et les produits dans votre application mobile (cliquez pour développer)
-
Créez vos produits dans l’Adapty Dashboard.
-
Créez un flow ou un paywall et intégrez-y les produits dans l’Adapty Dashboard.
-
Créez des placements et intégrez-y votre flow ou paywall dans l’Adapty Dashboard.
-
Installez le SDK Adapty dans votre application mobile.
Récupérer les informations d’un flow
Dans Adapty, un produit est une combinaison de produits issus de l’App Store et de Google Play. Ces produits cross-platform sont intégrés dans des flows et des paywalls, ce qui vous permet de les présenter à des emplacements spécifiques de votre application mobile.
Pour afficher les produits, vous devez obtenir un AdaptyFlow depuis l’un de vos placements avec la méthode getFlow.
Ne codez pas les IDs de produits en dur. Le seul ID à coder en dur est l’ID de placement. Les flows sont configurés à distance, donc le nombre de produits et les offres disponibles peuvent changer à tout moment. Votre application doit gérer ces changements dynamiquement — si un flow renvoie deux produits aujourd’hui et trois demain, affichez-les tous sans modifier le code.
Adapty.getFlow(
placementId = "YOUR_PLACEMENT_ID",
fetchPolicy = AdaptyPaywallFetchPolicy.Default,
loadTimeout = 5.seconds
).onSuccess { flow ->
// the requested flow
}.onError { error ->
// handle the error
}
| Paramètre | Présence | Description |
|---|---|---|
| placementId | requis | L’identifiant du Placement. Il s’agit de la valeur que vous avez indiquée lors de la création d’un placement dans votre Adapty Dashboard. |
| fetchPolicy | par défaut : AdaptyPaywallFetchPolicy.Default | Par défaut, le SDK tente de charger les données depuis le serveur et renvoie les données en cache en cas d’échec. Nous recommandons cette option, car elle garantit que vos utilisateurs obtiennent toujours les données les plus récentes. Cependant, si vous pensez que vos utilisateurs sont souvent confrontés à une connexion instable, envisagez d’utiliser Notez que le cache reste intact après le redémarrage de l’application et n’est effacé que lors de la désinstallation de l’application ou d’un nettoyage manuel. Le SDK Adapty stocke les flows et les paywalls sur deux niveaux : le cache mis à jour régulièrement décrit ci-dessus et les paywalls de secours. Nous utilisons également un CDN pour récupérer les flows et les paywalls plus rapidement, ainsi qu’un serveur de secours indépendant au cas où le CDN serait inaccessible. Ce système est conçu pour garantir que vous disposez toujours de la dernière version de vos flows et paywalls, tout en assurant la fiabilité même lorsque la connexion internet est limitée. |
| loadTimeout | par défaut : 5 sec | Cette valeur limite le délai d’attente de cette méthode. Si le délai est dépassé, les données en cache ou le fallback local sont renvoyés. Notez que dans de rares cas, cette méthode peut expirer légèrement après le délai indiqué dans |
Ne codez pas en dur les identifiants de produits ! Étant donné que les flows sont configurés à distance, les produits disponibles, leur nombre et les offres spéciales (comme les essais gratuits) peuvent changer au fil du temps. Assurez-vous que votre code gère ces scénarios.
Par exemple, si vous récupérez initialement 2 produits, votre application doit afficher ces 2 produits. Mais si vous en récupérez ensuite 3, votre application doit tous les afficher sans nécessiter de modifications du code. La seule chose que vous devez coder en dur est l’identifiant du placement.
Paramètres de réponse :
| Paramètre | Description |
|---|---|
| Flow | Un objet AdaptyFlow contenant : l’identifiant du flow, les variantes de paywall (paywalls — chacune avec ses propres identifiants de produits), une liste remoteConfigs (une entrée par locale configurée), ainsi que plusieurs autres propriétés. Pour récupérer les produits du flow, appelez getPaywallProducts(flow). |
Dans la v4, getFlow n’a pas de paramètre locale. Lorsque vous affichez un flow avec createFlowView, la localisation est résolue automatiquement. Pour les paywalls personnalisés, toutes les localisations disponibles sont retournées ensemble dans flow.remoteConfigs — choisissez celle qui correspond à la langue de l’appareil ou aux paramètres de votre application. Consultez Localisations et codes de langue pour plus de détails.
Récupérer les produits
Une fois que vous avez le flow, vous pouvez récupérer le tableau de produits qui lui correspond :
Adapty.getPaywallProducts(flow).onSuccess { products ->
// the requested products
}.onError { error ->
// handle the error
}Paramètres de la réponse :
| Paramètre | Description |
|---|---|
| Products | Liste d’objets AdaptyPaywallProduct contenant : identifiant du produit, nom du produit, prix, devise, durée de l’abonnement et plusieurs autres propriétés. |
Lorsque vous implémentez votre propre design de flow, vous aurez probablement besoin d’accéder à ces propriétés de l’objet AdaptyPaywallProduct. Les propriétés les plus couramment utilisées sont présentées ci-dessous, mais consultez le document lié pour obtenir tous les détails sur l’ensemble des propriétés disponibles.
| Propriété | Description |
|---|---|
| Title | Pour afficher le titre du produit, utilisez product.localizedTitle. La localisation est basée sur le pays du store sélectionné par l’utilisateur, et non sur la locale de l’appareil. |
| Price | Pour afficher le prix dans un format localisé, utilisez product.price.localizedString. Cette localisation est basée sur la locale de l’appareil. Vous pouvez également accéder au prix sous forme numérique via product.price.amount. La valeur est fournie dans la devise locale. Pour obtenir le symbole de devise correspondant, utilisez product.price.currencySymbol. |
| Subscription Period | Pour afficher la période (ex. : semaine, mois, année, etc.), utilisez product.subscriptionDetails?.localizedSubscriptionPeriod. Cette localisation est basée sur la locale de l’appareil. Pour récupérer la période d’abonnement de manière programmatique, utilisez product.subscriptionDetails?.subscriptionPeriod. Vous pouvez ensuite accéder à l’enum unit pour obtenir la durée (c’est-à-dire DAY, WEEK, MONTH, YEAR ou UNKNOWN). La valeur numberOfUnits vous donne le nombre d’unités de période. Par exemple, pour un abonnement trimestriel, vous verrez MONTH dans la propriété unit et 3 dans la propriété numberOfUnits. |
| Introductory Offer | Pour afficher un badge ou tout autre indicateur signalant qu’un abonnement contient une offre de lancement, consultez la propriété product.subscriptionDetails?.introductoryOfferPhases. Il s’agit d’une liste pouvant contenir jusqu’à deux phases de remise : la phase d’essai gratuit et la phase de prix de lancement. Chaque objet de phase contient les propriétés utiles suivantes :• paymentMode : un enum avec les valeurs FREE_TRIAL, PAY_AS_YOU_GO, PAY_UPFRONT et UNKNOWN. Les essais gratuits correspondent au type FREE_TRIAL.• price : le prix remisé sous forme numérique. Pour les essais gratuits, la valeur sera 0.• localizedNumberOfPeriods : une chaîne localisée selon la locale de l’appareil, décrivant la durée de l’offre. Par exemple, une offre d’essai de trois jours affiche 3 days dans ce champ.• subscriptionPeriod : vous pouvez également obtenir les détails individuels de la période d’offre avec cette propriété. Son fonctionnement est identique à celui décrit dans la section précédente pour les abonnements.• localizedSubscriptionPeriod : la période d’abonnement de la remise formatée pour la locale de l’utilisateur. |
Accélérer la récupération du flow avec un flow d’audience par défaut
En général, les flows sont récupérés presque instantanément, vous n’avez donc pas à vous inquiéter de cette étape. Cependant, si vous avez de nombreuses audiences et placements et que vos utilisateurs disposent d’une connexion internet faible, la récupération d’un flow peut prendre plus de temps que souhaité. Dans ce cas, vous pouvez afficher un flow par défaut pour garantir une expérience utilisateur fluide plutôt que de ne rien afficher du tout.
Pour remédier à cela, vous pouvez utiliser la méthode getFlowForDefaultAudience, qui récupère le flow du placement spécifié pour l’audience All Users. Il est toutefois essentiel de comprendre que l’approche recommandée est de récupérer le flow via la méthode getFlow, comme décrit dans la section Récupérer les informations du flow ci-dessus.
Pourquoi nous recommandons d’utiliser getFlow
La méthode getFlowForDefaultAudience présente quelques inconvénients majeurs :
- Problèmes potentiels de compatibilité ascendante : Si vous devez afficher des flows différents selon les versions de l’application (version actuelle et futures), vous risquez de rencontrer des difficultés. Vous devrez soit concevoir des flows compatibles avec la version actuelle (legacy), soit accepter que les utilisateurs de cette version rencontrent des problèmes avec des flows non rendus.
- Perte de ciblage : Tous les utilisateurs verront le même flow conçu pour l’audience All Users, ce qui signifie que vous perdez le ciblage personnalisé (notamment selon le pays, l’attribution marketing ou vos propres attributs personnalisés).
Si vous acceptez ces inconvénients pour bénéficier d’une récupération plus rapide du flow, utilisez la méthode getFlowForDefaultAudience comme suit. Sinon, restez sur la méthode getFlow décrite ci-dessus.
Adapty.getFlowForDefaultAudience(
placementId = "YOUR_PLACEMENT_ID",
fetchPolicy = AdaptyPaywallFetchPolicy.Default
).onSuccess { flow ->
// the requested flow
}.onError { error ->
// handle the error
}
| Paramètre | Présence | Description |
|---|---|---|
| placementId | requis | L’identifiant du Placement. C’est la valeur que vous avez spécifiée lors de la création d’un placement dans votre Adapty Dashboard. |
| fetchPolicy | par défaut : AdaptyPaywallFetchPolicy.Default | Par défaut, le SDK tente de charger les données depuis le serveur et renvoie les données en cache en cas d’échec. Nous recommandons cette option, car elle garantit que vos utilisateurs reçoivent toujours les données les plus récentes. Cependant, si vous pensez que vos utilisateurs sont souvent confrontés à une connexion instable, envisagez d’utiliser Notez que le cache est conservé après le redémarrage de l’application et n’est effacé que lors de la désinstallation ou d’un nettoyage manuel. |
Avant de présenter les Remote Config et les paywalls personnalisés, vous devez récupérer les informations les concernant. Notez que ce sujet concerne les Remote Config et les paywalls personnalisés. Pour obtenir des instructions sur la récupération des paywalls créés avec le Paywall Builder, consultez Récupérer les paywalls du Paywall Builder et leur configuration.
Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Consultez nos exemples d’applications, qui illustrent la configuration complète, notamment l’affichage des paywalls, les achats et d’autres fonctionnalités de base.
Avant de commencer à récupérer les paywalls et les produits dans votre application mobile (cliquez pour développer)
-
Créez vos produits dans l’Adapty Dashboard.
-
Créez un paywall et intégrez les produits dans votre paywall dans l’Adapty Dashboard.
-
Créez des placements et intégrez votre paywall dans le placement dans l’Adapty Dashboard.
-
Installez le SDK Adapty dans votre application mobile.
Récupérer les informations d’un paywall
Dans Adapty, un produit est une combinaison de produits issus de l’App Store et de Google Play. Ces produits cross-platform sont intégrés dans des paywalls, ce qui vous permet de les afficher dans des placements spécifiques de votre application mobile.
Pour afficher les produits, vous devez obtenir un Paywall depuis l’un de vos placements avec la méthode getPaywall.
N’inscrivez pas les IDs de produits en dur dans le code. Le seul ID à coder en dur est l’ID de placement. Les paywalls sont configurés à distance, donc le nombre de produits et les offres disponibles peuvent changer à tout moment. Votre application doit gérer ces changements dynamiquement — si un paywall renvoie deux produits aujourd’hui et trois demain, affichez-les tous sans modifier le code.
Adapty.getPaywall(
placementId = "YOUR_PLACEMENT_ID",
locale = "en",
fetchPolicy = AdaptyPaywallFetchPolicy.Default,
loadTimeout = 5.seconds
).onSuccess { paywall ->
// the requested paywall
}.onError { error ->
// handle the error
}
| Paramètre | Présence | Description |
|---|---|---|
| placementId | requis | L’identifiant du Placement. C’est la valeur que vous avez spécifiée lors de la création d’un placement dans votre Adapty Dashboard. |
| locale | optionnel par défaut : | L’identifiant de la localisation du paywall. Ce paramètre doit être un code de langue composé d’un ou plusieurs sous-tags séparés par le caractère moins (-). Le premier sous-tag correspond à la langue, le second à la région. Exemple : |
| fetchPolicy | par défaut : AdaptyPaywallFetchPolicy.Default | Par défaut, le SDK tente de charger les données depuis le serveur et renvoie les données en cache en cas d’échec. Nous recommandons cette option, car elle garantit que vos utilisateurs reçoivent toujours les données les plus récentes. Cependant, si vous pensez que vos utilisateurs ont une connexion instable, envisagez d’utiliser Notez que le cache reste intact après le redémarrage de l’application et n’est effacé que lors d’une réinstallation ou d’un nettoyage manuel. Le SDK Adapty stocke les paywalls sur deux couches : le cache mis à jour régulièrement décrit ci-dessus et les paywalls de secours. Nous utilisons également un CDN pour récupérer les paywalls plus rapidement, ainsi qu’un serveur de secours indépendant en cas d’indisponibilité du CDN. Ce système est conçu pour garantir que vous recevez toujours la dernière version de vos paywalls, tout en assurant la fiabilité même lorsque la connexion internet est limitée. |
| loadTimeout | par défaut : 5 sec | Cette valeur limite le délai d’expiration de cette méthode. Si le délai est atteint, les données en cache ou le fallback local sont renvoyés. Notez que dans de rares cas, cette méthode peut expirer légèrement après le délai spécifié dans |
Ne codez pas les identifiants de produits en dur ! Puisque les paywalls sont configurés à distance, les produits disponibles, leur nombre et les offres spéciales (comme les essais gratuits) peuvent changer au fil du temps. Assurez-vous que votre code gère ces scénarios.
Par exemple, si vous récupérez initialement 2 produits, votre application doit afficher ces 2 produits. Mais si vous en récupérez ensuite 3, votre application doit tous les afficher sans nécessiter de modification du code. La seule chose à coder en dur est l’identifiant de placement.
Paramètres de réponse :
| Paramètre | Description |
|---|---|
| Paywall | Un objet AdaptyPaywall contenant : une liste d’identifiants de produit, l’identifiant du paywall, le Remote Config, et plusieurs autres propriétés. |
Récupérer les produits
Une fois que vous avez le paywall, vous pouvez interroger le tableau de produits qui lui correspond :
Adapty.getPaywallProducts(paywall).onSuccess { products ->
// the requested products
}.onError { error ->
// handle the error
}Paramètres de la réponse :
| Paramètre | Description |
|---|---|
| Products | Liste d’objets AdaptyPaywallProduct contenant : l’identifiant du produit, son nom, son prix, la devise, la durée de l’abonnement et plusieurs autres propriétés. |
Lors de l’implémentation de votre propre design de paywall, vous aurez probablement besoin d’accéder à ces propriétés depuis l’objet AdaptyPaywallProduct. Les propriétés les plus couramment utilisées sont présentées ci-dessous, mais consultez le document lié pour obtenir tous les détails sur l’ensemble des propriétés disponibles.
| Propriété | Description |
|---|---|
| Title | Pour afficher le titre du produit, utilisez product.localizedTitle. La localisation est basée sur le pays du store sélectionné par l’utilisateur, et non sur la locale de l’appareil lui-même. |
| Price | Pour afficher une version localisée du prix, utilisez product.price.localizedString. Cette localisation est basée sur les informations de locale de l’appareil. Vous pouvez aussi accéder au prix sous forme numérique via product.price.amount. La valeur sera fournie dans la devise locale. Pour obtenir le symbole de la devise associée, utilisez product.price.currencySymbol. |
| Subscription Period | Pour afficher la période (par exemple : semaine, mois, année, etc.), utilisez product.subscriptionDetails?.localizedSubscriptionPeriod. Cette localisation est basée sur la locale de l’appareil. Pour récupérer la période d’abonnement de manière programmatique, utilisez product.subscriptionDetails?.subscriptionPeriod. Vous pouvez ensuite accéder à l’enum unit pour obtenir la durée (c’est-à-dire DAY, WEEK, MONTH, YEAR ou UNKNOWN). La valeur numberOfUnits vous donne le nombre d’unités de période. Par exemple, pour un abonnement trimestriel, vous verrez MONTH dans la propriété unit et 3 dans la propriété numberOfUnits. |
| Introductory Offer | Pour afficher un badge ou tout autre indicateur signalant qu’un abonnement contient une offre de lancement, consultez la propriété product.subscriptionDetails?.introductoryOfferPhases. Il s’agit d’une liste pouvant contenir jusqu’à deux phases de remise : la phase d’essai gratuit et la phase de prix de lancement. Chaque objet de phase contient les propriétés utiles suivantes :• paymentMode : un enum avec les valeurs FREE_TRIAL, PAY_AS_YOU_GO, PAY_UPFRONT et UNKNOWN. Les essais gratuits sont du type FREE_TRIAL.• price : le prix remisé sous forme numérique. Pour les essais gratuits, la valeur sera 0.• localizedNumberOfPeriods : une chaîne localisée selon la locale de l’appareil décrivant la durée de l’offre. Par exemple, une offre d’essai de trois jours affiche 3 days dans ce champ.• subscriptionPeriod : vous pouvez également obtenir les détails individuels de la période d’offre grâce à cette propriété. Elle fonctionne de la même façon pour les offres que ce qui est décrit dans la section précédente.• localizedSubscriptionPeriod : une période d’abonnement formatée pour la locale de l’utilisateur. |
Accélérer la récupération des paywalls avec le paywall d’audience par défaut
En général, les paywalls sont récupérés presque instantanément, donc vous n’avez pas à vous soucier d’accélérer ce processus. Cependant, si vous avez de nombreuses audiences et paywalls et que vos utilisateurs disposent d’une connexion internet faible, la récupération d’un paywall peut prendre plus de temps que souhaité. Dans ce cas, vous pouvez afficher un paywall par défaut pour garantir une expérience utilisateur fluide plutôt que de n’afficher aucun paywall.
Pour y remédier, vous pouvez utiliser la méthode getPaywallForDefaultAudience, qui récupère le paywall du placement spécifié pour l’audience All Users. Il est toutefois essentiel de comprendre que l’approche recommandée est de récupérer le paywall via la méthode getPaywall, comme expliqué dans la section Récupérer les informations du paywall ci-dessus.
Pourquoi nous recommandons d’utiliser getPaywall
La méthode getPaywallForDefaultAudience présente quelques inconvénients importants :
- Problèmes potentiels de compatibilité ascendante : si vous avez besoin d’afficher des paywalls différents selon les versions de l’application (version actuelle et versions futures), vous pourrez rencontrer des difficultés. Vous devrez soit concevoir des paywalls compatibles avec la version actuelle (legacy), soit accepter que les utilisateurs de cette version puissent rencontrer des problèmes avec des paywalls non affichés.
- Perte de ciblage : tous les utilisateurs verront le même paywall conçu pour l’audience All Users, ce qui signifie que vous perdez le ciblage personnalisé (notamment selon les pays, l’attribution marketing ou vos propres attributs personnalisés).
Si vous êtes prêt à accepter ces inconvénients pour bénéficier d’une récupération plus rapide des paywalls, utilisez la méthode getPaywallForDefaultAudience comme suit. Sinon, restez sur la méthode getPaywall décrite plus haut.
Adapty.getPaywallForDefaultAudience(
placementId = "YOUR_PLACEMENT_ID",
locale = "en",
fetchPolicy = AdaptyPaywallFetchPolicy.Default
).onSuccess { paywall ->
// the requested paywall
}.onError { error ->
// handle the error
}
| Paramètre | Présence | Description |
|---|---|---|
| placementId | requis | L’identifiant du Placement. C’est la valeur que vous avez spécifiée lors de la création d’un placement dans votre Adapty Dashboard. |
| locale | optionnel défaut : | L’identifiant de la localisation du paywall. Ce paramètre doit être un code de langue composé d’un ou plusieurs sous-tags séparés par le caractère moins (-). Le premier sous-tag désigne la langue, le second la région. Exemple : |
| fetchPolicy | défaut : AdaptyPaywallFetchPolicy.Default | Par défaut, le SDK tente de charger les données depuis le serveur et renvoie les données en cache en cas d’échec. Nous recommandons cette option, car elle garantit que vos utilisateurs disposent toujours des données les plus récentes. Cependant, si vos utilisateurs sont souvent confrontés à une connexion instable, envisagez d’utiliser Notez que le cache est conservé après le redémarrage de l’application et n’est effacé que lors de la désinstallation de l’application ou via un nettoyage manuel. |