Obtenir des flows et paywalls - Unity

Ce que récupère GetFlow
✦
Flows Créés dans le Flow & Paywall Builder — rendus nativement sur l'appareil, sans WebView
✦
Paywalls de l'ancien Paywall Builder Tout le contenu créé dans l'ancien Paywall Builder

Après avoir conçu votre flow, vous pouvez l’afficher dans votre application mobile. La première étape consiste à récupérer le flow ou le paywall associé au placement ainsi que sa configuration d’affichage, comme décrit ci-dessous.

Tip

Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Découvrez nos applications exemples, qui illustrent la configuration complète, notamment l’affichage des paywalls, la réalisation d’achats et d’autres fonctionnalités de base.

Avant de commencer

Vous avez besoin de :

Récupérer un flow/paywall

Si vous avez conçu un flow ou un paywall dans le builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel flow ou paywall contient à la fois ce qui doit être affiché et comment le présenter. Vous devez néanmoins récupérer son ID via le placement, sa configuration de vue, puis l’afficher dans votre application mobile.

Pour des performances optimales, il est essentiel de récupérer le flow ou le paywall et sa configuration de vue le plus tôt possible, afin de laisser suffisamment de temps aux images de se télécharger avant de les présenter à l’utilisateur.

Tip

Pour préchauffer plusieurs placements à la fois, appelez Adapty.PreloadFlows (Unity SDK 4.3.0+). Cette méthode ne met en cache que le JSON du placement, donc CreateFlowView chargera toujours la mise en page et les images.

Pour obtenir un flow ou un paywall, utilisez la méthode GetFlow :

Adapty.GetFlow(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    TimeSpan.FromSeconds(5),
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow/paywall
    }
);

Paramètres :

ParamètrePrésenceDescription
placementIdrequisL’identifiant du Placement souhaité. Il s’agit de la valeur que vous avez spécifiée lors de la création d’un placement dans l’Adapty Dashboard.
fetchPolicydéfaut : AdaptyPlacementFetchPolicy.Default

fetchPolicy définit quelle couche le SDK lit en premier, pas s’il peut utiliser le cache. Par défaut, le SDK interroge d’abord le serveur et renvoie les données en cache si cette requête échoue. 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 font face à une connexion internet instable, envisagez AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad, qui inverse cet ordre — il lit d’abord le cache et contacte le serveur uniquement si rien n’est en cache. Les utilisateurs n’obtiendront peut-être pas les toutes dernières données, mais ils bénéficieront de temps de chargement plus rapides, quelle que soit la qualité de leur connexion. Le cache est mis à jour régulièrement, il est donc sûr de l’utiliser pendant la session pour éviter les requêtes réseau.

Une troisième politique, AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), se situe entre les deux : elle lit d’abord le cache tant que la copie en cache est plus récente que le TimeSpan que vous passez, et contacte le serveur une fois qu’il est plus ancien.

Notez que le cache reste intact lors du redémarrage de l’application et n’est effacé que lors de la désinstallation de l’application ou via un nettoyage manuel.

Le SDK Adapty stocke les flows et les paywalls localement en deux couches : le cache mis à jour régulièrement décrit ci-dessus et les paywalls de secours. Nous utilisons également un CDN pour les récupérer plus rapidement et un serveur de secours indépendant en cas d’inaccessibilité du CDN. Ce système est conçu pour vous garantir toujours la dernière version tout en assurant la fiabilité, même lorsque la connexion internet est limitée.

loadTimeoutdéfaut : 5 sec

Cette valeur limite le délai d’attente de cette méthode. Si le serveur Adapty ne répond pas à temps ou renvoie une erreur, le SDK retourne le flow mis en cache. Si rien n’est en cache et que le serveur a expiré ou renvoyé une erreur serveur, le SDK demande le flow au serveur de secours (une copie CDN qui ne sert que l’audience All Users du placement). En dernier recours, le SDK retourne le flow depuis votre fichier de secours.

Notez que dans de rares cas, cette méthode peut expirer légèrement après le délai spécifié dans loadTimeout, car l’opération peut être composée de différentes requêtes en arrière-plan.

Paramètres de réponse :

ParamètreDescription
FlowUn objet AdaptyFlow contenant le placement, les identifiants (InstanceIdentity, VariationId), le nom, le nom de la variante (VariationName, SDK 4.3.0+), les variantes de paywall (Paywalls — une liste d’AdaptyFlowPaywall), et les Remote Configs (RemoteConfigs — une liste avec une entrée par locale). Pour récupérer les produits réels en vue d’un préchargement, d’une interface personnalisée ou de vérifications programmatiques, appelez GetPaywallProducts(flow).

Récupérer la configuration de la vue

Après avoir récupéré le flow ou le paywall, chargez sa configuration de vue et créez la vue en une seule étape avec la méthode CreateFlowView. Il n’y a pas de flag séparé à vérifier : si le placement a été conçu dans le Flow & Paywall Builder (un flow) ou l’ancien Paywall Builder (un paywall), CreateFlowView renvoie la vue prête à être présentée. Si le placement est un paywall personnalisé sans interface Builder, CreateFlowView renvoie une erreur — affichez-le vous-même.

Important

Assurez-vous de publier le flow. Un flow avec des modifications non publiées a le statut Dirty, et son placement continue de servir la dernière version publiée.

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetPreloadProducts(true)
    .SetLoadTimeout(TimeSpan.FromSeconds(5));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    if (error != null) {
        // the flow has no view configured, or view creation failed
        return;
    }

    // use view
});
ParamètrePrésenceDescription
flowrequiredUn objet AdaptyFlow obtenu via Adapty.GetFlow.
LocaleoptionalL’identifiant de la localisation du Builder avec laquelle afficher le flow ou le paywall, par exemple en ou pt-br. Un flow est localisé lors de la création de sa vue, c’est donc le seul endroit pour choisir sa localisation. Le SDK ne lit pas la langue de l’appareil : si vous omettez ce paramètre, le flow s’affiche en en, ou dans sa langue par défaut si le flow ne possède pas de localisation en. Le code doit correspondre exactement à un code de localisation du flow. Voir Utiliser les localisations et les codes de langue.
LoadTimeoutoptionalCette 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 retournés. Notez que dans de rares cas, cette méthode peut expirer légèrement après la valeur indiquée dans LoadTimeout, car l’opération peut comporter plusieurs requêtes en interne.
PreloadProductsoptionalDéfinissez à true pour précharger les produits et améliorer les performances. Lorsque cette option est activée, les produits sont chargés à l’avance, ce qui réduit le temps d’affichage du flow ou du paywall.
CustomTagsoptionalLes valeurs de votre application pour les balises personnalisées du flow, dans un dictionnaire indexé par le nom complet de chaque balise. Passez le dictionnaire à la méthode SetCustomTags. Pour plus de détails, consultez Transmettre des données aux flows.
CustomTimersoptionalLes dates de fin des minuteries Developer defined du flow, dans un dictionnaire associant les ID de minuterie à des valeurs DateTime. Passez le dictionnaire à la méthode SetCustomTimers. Pour plus de détails, consultez Configurer les minuteries définies par le développeur.
ProductPurchaseParametersoptionalAndroid uniquement (ignoré sur iOS). Un dictionnaire associant AdaptyProductIdentifier à AdaptyPurchaseParameters. Utilisez ce paramètre pour configurer des options d’achat spécifiques, telles que des offres personnalisées ou des paramètres de mise à jour d’abonnement pour des produits individuels dans le flow ou le paywall.
EnableSafeAreaPaddingsoptionalAndroid uniquement (ignoré sur iOS). Lorsque la valeur est true, la vue du flow applique des marges de zone sécurisée. Valeur par défaut : true. La valeur par défaut convient à la plupart des cas.
Note

Si vous utilisez plusieurs langues, découvrez comment ajouter une localisation dans le Builder.

Une fois chargé, présentez le flow ou le paywall.

Obtenez un flow ou un paywall pour l’audience par défaut afin d’accélérer la récupération

En général, les flows et les paywalls sont récupérés quasi instantanément, vous n’avez donc pas à vous soucier d’optimiser ce processus. Cependant, si vous avez de nombreuses audiences et placements et que vos utilisateurs ont une connexion internet faible, la récupération d’un flow ou d’un paywall peut prendre plus de temps que souhaité. Dans ce cas, vous pouvez afficher un flow ou un paywall par défaut pour garantir une expérience utilisateur fluide plutôt que de ne rien afficher.

Pour y remédier, vous pouvez utiliser la méthode GetFlowForDefaultAudience, qui récupère le flow ou le paywall du placement spécifié pour l’audience All Users. Il est cependant essentiel de comprendre que l’approche recommandée est de récupérer le flow ou le paywall via la méthode GetFlow, comme expliqué dans la section Récupérer un flow/paywall ci-dessus.

Warning

Pourquoi nous recommandons d’utiliser GetFlow

La méthode GetFlowForDefaultAudience présente plusieurs 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 versions futures), vous pourriez rencontrer des difficultés. Vous devrez soit concevoir des flows compatibles avec la version actuelle (héritée), soit accepter que les utilisateurs de cette version puissent rencontrer des problèmes avec des flows qui ne s’affichent pas correctement.
  • 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 par pays, attribution marketing ou attributs personnalisés).

Si vous acceptez ces inconvénients pour bénéficier d’une récupération plus rapide du flow ou du paywall, utilisez la méthode GetFlowForDefaultAudience comme suit. Sinon, utilisez GetFlow décrit ci-dessus.

Adapty.GetFlowForDefaultAudience(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow
    }
);
ParamètrePrésenceDescription
placementIdrequisL’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.
fetchPolicydéfaut : AdaptyPlacementFetchPolicy.Default

fetchPolicy détermine quelle couche le SDK lit en premier, pas s’il peut utiliser le cache. Par défaut, le SDK interroge d’abord le serveur et retourne les données en cache si la requête échoue. 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 internet instable, envisagez AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad, qui inverse cet ordre — il lit d’abord le cache et ne contacte le serveur que lorsque rien n’est en cache. Les utilisateurs ne reçoivent pas forcément les toutes dernières données, mais le chargement est plus rapide, quelle que soit la qualité de leur connexion. Le cache est mis à jour régulièrement, il est donc sûr de l’utiliser pendant la session pour éviter des requêtes réseau.

Une troisième politique, AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), se situe entre les deux : elle lit d’abord le cache tant que la copie en cache est plus récente que le TimeSpan que vous passez, et contacte le serveur une fois qu’il est plus ancien.

Notez que le cache est conservé lors du redémarrage de l’application et n’est effacé qu’en cas de réinstallation ou de nettoyage manuel.

Personnaliser les ressources

Pour personnaliser les images et vidéos dans votre flow ou paywall, implémentez des ressources personnalisées.

Les images et vidéos hero ont des identifiants prédéfinis : hero_image et hero_video. Dans un bundle de ressources personnalisées, vous ciblez ces éléments par leurs identifiants et personnalisez leur comportement.

Pour les autres images et vidéos, vous devez définir un identifiant personnalisé dans l’Adapty Dashboard.

Par exemple, vous pouvez :

  • Afficher une image ou une vidéo différente selon les utilisateurs.
  • Afficher une image de prévisualisation locale pendant le chargement d’une image principale distante.
  • Afficher une image de prévisualisation avant de lancer une vidéo.
  • Afficher des médias inclus dans l’application, afin que le premier écran s’affiche sans téléchargement. Voir Afficher les médias du premier écran depuis le bundle de l’application.

Voici un exemple illustrant comment fournir des assets personnalisés via un dictionnaire simple :

var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
    { "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
    { "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetCustomAssets(customAssets)
    .SetLoadTimeout(TimeSpan.FromSeconds(3));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    // handle the result
});
Note

Si une ressource est introuvable ou ne parvient pas à se charger, le flow ou le paywall reviendra à son apparence par défaut telle que configurée dans le Builder.

Configurer les minuteurs définis par le développeur

Utilisez cette section pour un minuteur dont le comportement est Developer defined dans le Flow & Paywall Builder. Dans le builder, chaque minuteur de ce type possède un Timer ID (voir Laisser l’app définir la date de fin), et votre app définit la date de fin correspondante. Utilisez exactement le même Timer ID dans votre code que dans le builder, caractère par caractère, y compris la casse et les espaces. Si les IDs diffèrent, le minuteur ne reçoit aucune date de fin de la part de votre app.

Pour définir les dates de fin, passez un dictionnaire d’identifiants de minuterie et leurs dates de fin à la méthode SetCustomTimers. Un DateTime avec DateTimeKind.Utc correspond à une heure UTC ; un DateTime sans type est interprété comme l’heure locale de l’utilisateur. Voici un exemple :

var customTimers = new Dictionary<string, DateTime> {
    { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
    { "CUSTOM_TIMER_NY", new DateTime(DateTime.Now.Year + 1, 1, 1) } // next New Year's Day, local time
};

var parameters = new AdaptyUICreateFlowViewParameters()
    .SetCustomTimers(customTimers)
    .SetLoadTimeout(TimeSpan.FromSeconds(3));

AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // use view
});

Dans cet exemple, CUSTOM_TIMER_NY et CUSTOM_TIMER_6H sont les ID de minuterie de deux minuteries définies par le développeur dans le builder :

  • CUSTOM_TIMER_NY : Le temps restant jusqu’au prochain Jour de l’An.
  • CUSTOM_TIMER_6H : Le temps restant dans une période de 6 heures qui a démarré au moment où votre application a créé la vue.

Le SDK lit les minuteries personnalisées une seule fois, au moment où il crée la vue. Ainsi, une date calculée comme CUSTOM_TIMER_6H est comptée à partir de ce moment, même si l’utilisateur rouvre l’écran. Si la date est dans le passé, la minuterie affiche zéro immédiatement et son déclencheur On timer end s’exécute. Si le dictionnaire ne contient pas de clé pour un ID de minuterie, celle-ci effectue un compte à rebours d’une heure à partir de l’ouverture de l’écran.

Après avoir conçu la partie visuelle de votre paywall avec l’ancien Paywall Builder dans l’Adapty Dashboard, vous pouvez l’afficher dans votre application mobile. La première étape consiste à récupérer le paywall associé au placement et sa configuration d’affichage, comme décrit ci-dessous.

Warning

Les paywalls créés avec le Paywall Builder du SDK 3.x nécessitent la version 3.3.0 ou supérieure du SDK Unity.

Veuillez noter que ce sujet concerne les paywalls personnalisés avec le Paywall Builder. Si vous implémentez des paywalls custom, consultez la rubrique Récupérer les paywalls et produits pour les paywalls custom dans votre application mobile.

Tip

Vous souhaitez voir un exemple concret d’intégration du SDK Adapty dans une application mobile ? Découvrez nos applications exemples, qui illustrent la configuration complète, notamment l’affichage des paywalls, la réalisation d’achats et d’autres fonctionnalités de base.

Avant d’afficher des paywalls dans votre application mobile (cliquez pour développer)
  1. Créez vos produits dans l’Adapty Dashboard.
  2. Créez un paywall et intégrez-y les produits dans l’Adapty Dashboard.
  3. Créez des placements et intégrez-y votre paywall dans l’Adapty Dashboard.
  4. Installez le SDK Adapty dans votre application mobile.

Récupérer un paywall créé avec le Paywall Builder

Si vous avez conçu un paywall avec le Paywall Builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel paywall contient à la fois ce qui doit être affiché et la manière dont cela doit l’être. Vous devez néanmoins récupérer son identifiant via le placement, sa configuration d’affichage, puis le présenter dans votre application mobile.

Pour garantir des performances optimales, il est essentiel de récupérer le paywall et sa configuration de vue le plus tôt possible, afin de laisser suffisamment de temps aux images de se télécharger avant de les présenter à l’utilisateur.

Pour obtenir un paywall, utilisez la méthode GetPaywall :

Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

Paramètres :

ParamètrePrésenceDescription
placementIdrequisL’identifiant du Placement souhaité. Il s’agit de la valeur que vous avez spécifiée lors de la création d’un placement dans l’Adapty Dashboard.
locale

optionnel

par défaut : en

L’identifiant de la localisation du paywall. Ce paramètre doit être un code de langue composé d’un ou deux sous-tags séparés par le caractère moins (-). Le premier sous-tag correspond à la langue, le second à la région.

Exemple : en signifie anglais, pt-br représente le portugais brésilien.

Consultez Localisations et codes de langue pour plus d’informations sur les codes de langue et notre façon de les utiliser.

fetchPolicypar défaut : AdaptyPlacementFetchPolicy.Default

fetchPolicy définit quelle couche le SDK lit en premier, pas s’il peut utiliser le cache. Par défaut, le SDK interroge d’abord le serveur et renvoie les données en cache si cette requête échoue. 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 internet instable, envisagez AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad, qui inverse cet ordre — le SDK lit d’abord le cache et contacte le serveur uniquement si rien n’est en cache. Les utilisateurs n’obtiendront peut-être pas les toutes dernières données, mais le chargement sera plus rapide quelle que soit la qualité de leur connexion. Le cache est mis à jour régulièrement, il est donc sûr de l’utiliser pendant la session pour éviter les requêtes réseau.

Une troisième politique, AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), se situe entre les deux : elle lit d’abord le cache tant que la copie en cache est plus récente que le TimeSpan que vous passez, et contacte le serveur une fois qu’elle est plus ancienne.

Notez que le cache reste intact après le redémarrage de l’application et n’est effacé que lors de la réinstallation de l’application ou via un nettoyage manuel.

Le SDK Adapty stocke les paywalls localement en 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 et un serveur de secours indépendant en cas d’inaccessibilité du CDN. Ce système est conçu pour garantir que vous obtenez toujours la dernière version de vos paywalls tout en assurant la fiabilité même lorsque la connexion internet est limitée.

loadTimeoutpar défaut : 5 sec

Cette valeur limite le délai d’attente de cette méthode. Si le serveur Adapty ne répond pas à temps ou renvoie une erreur, le SDK renvoie le paywall depuis le serveur de secours (une copie CDN qui ne sert que l’audience All Users du placement), le cache, ou votre fichier de secours.

Notez que dans de rares cas, cette méthode peut expirer légèrement après le délai spécifié dans loadTimeout, car l’opération peut comporter différentes requêtes en coulisses.

Paramètres de réponse :

ParamètreDescription
PaywallUn objet AdaptyPaywall contenant une liste d’identifiants de produits, l’identifiant du paywall, la Remote Config, et plusieurs autres propriétés.

Récupérer la configuration d’affichage d’un paywall conçu avec le Paywall Builder

Important

Assurez-vous d’activer le bouton Show on device dans le Paywall Builder. Si cette option n’est pas activée, la configuration d’affichage ne sera pas disponible à la récupération.

Après avoir récupéré le paywall, vérifiez s’il contient un ViewConfiguration, ce qui indique qu’il a été créé avec le Paywall Builder. Cela vous indiquera comment afficher le paywall. Si le ViewConfiguration est présent, traitez-le comme un paywall Paywall Builder ; sinon, gérez-le comme un paywall personnalisé.

Dans le SDK Unity, appelez directement la méthode CreatePaywallView sans récupérer manuellement la configuration de la vue au préalable.

Warning

Le résultat de la méthode CreatePaywallView ne peut être utilisé qu’une seule fois. Si vous devez l’utiliser à nouveau, appelez de nouveau la méthode CreatePaywallView. L’appeler deux fois sans recréer peut entraîner l’erreur AdaptyUIError.viewAlreadyPresented.

var parameters = new AdaptyUICreatePaywallViewParameters()
  .SetPreloadProducts(preloadProducts)
  .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
  // handle the result
});

Paramètres :

ParamètrePrésenceDescription
paywallobligatoireUn objet AdaptyPaywall permettant d’obtenir un contrôleur pour le paywall souhaité.
loadTimeoutdéfaut : 5 secCette 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 seront retournés. Notez que dans de rares cas, cette méthode peut expirer légèrement après la valeur spécifiée dans loadTimeout, car l’opération peut impliquer différentes requêtes en interne.
PreloadProductsoptionnelFournissez un tableau d’AdaptyPaywallProducts pour optimiser le moment d’affichage des produits à l’écran. Si nil est passé, AdaptyUI récupérera automatiquement les produits nécessaires.
CustomTagsoptionnelDéfinissez un dictionnaire de tags personnalisés et leurs valeurs résolues. Les tags personnalisés servent de balises dans le contenu du paywall, remplacées dynamiquement par des chaînes spécifiques pour un contenu personnalisé. Consultez la rubrique Tags personnalisés dans le Paywall Builder pour plus de détails.
CustomTimersoptionnelDéfinissez un dictionnaire de minuteries personnalisées et leurs dates de fin. Les minuteries personnalisées permettent d’afficher des comptes à rebours dans votre paywall.
Note

Si vous prenez en charge plusieurs langues, ajoutez une localisation à votre paywall. Pour les codes à utiliser, consultez Localisations et codes de langue.

Une fois la vue obtenue, affichez le paywall.

Personnaliser les assets

Pour personnaliser les images et vidéos de votre paywall, implémentez des assets personnalisés.

Les images et vidéos hero ont des IDs prédéfinis : hero_image et hero_video. Dans un bundle d’assets personnalisé, vous ciblez ces éléments par leurs IDs et personnalisez leur comportement.

Pour les autres images et vidéos, vous devez définir un ID personnalisé dans l’Adapty Dashboard.

Par exemple, vous pouvez :

  • Afficher une image ou vidéo différente à certains utilisateurs.
  • Afficher une image de prévisualisation locale pendant le chargement d’une image principale distante.
  • Afficher une image de prévisualisation avant de lancer une vidéo.
Important

Pour utiliser cette fonctionnalité, mettez à jour le SDK Unity d’Adapty vers la version 3.8.0 ou supérieure.

Voici un exemple de la façon dont vous pouvez fournir des ressources personnalisées via un simple dictionnaire :

var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
    { "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
    { "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomAssets(customAssets)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});
Note

Si un asset est introuvable, le paywall reviendra à son apparence par défaut.

Configurer des minuteries définies par le développeur

Pour utiliser des minuteries personnalisées dans votre application Unity, vous pouvez passer un dictionnaire d’identifiants de minuteries et leurs dates de fin directement à la méthode SetCustomTimers. Voici un exemple :

var customTimers = new Dictionary<string, DateTime> {
    { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
    { "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) }
};

var parameters = new AdaptyUICreatePaywallViewParameters()
    .SetCustomTimers(customTimers)
    .SetLoadTimeout(new TimeSpan(0, 0, 3));

AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
    // handle the result
});

Dans cet exemple, CUSTOM_TIMER_NY et CUSTOM_TIMER_6H sont les Timer IDs des minuteries définies par le développeur que vous avez configurées dans l’Adapty Dashboard. Le résolveur de minuterie garantit que votre application met dynamiquement à jour chaque minuterie avec la valeur correcte. Par exemple :

  • CUSTOM_TIMER_NY : le temps restant jusqu’à la fin de la minuterie, par exemple le Jour de l’An.
  • CUSTOM_TIMER_6H : le temps restant dans une période de 6 heures qui a démarré lorsque l’utilisateur a ouvert le paywall.

Accélérer la récupération des paywalls avec le paywall d’audience par défaut

En règle générale, les paywalls sont récupérés presque instantanément, vous n’avez donc pas à vous soucier d’optimiser 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 ne rien afficher du tout.

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 cependant essentiel de comprendre que l’approche recommandée consiste à récupérer le paywall via la méthode getPaywall, comme décrit dans la section Récupérer le paywall ci-dessus.

Warning

Privilégiez GetPaywall plutôt que GetPaywallForDefaultAudience, car cette dernière présente des limitations importantes :

  • Problèmes de compatibilité : peut créer des difficultés lors de la prise en charge de plusieurs versions de l’application, nécessitant soit des designs rétrocompatibles, soit d’accepter que les anciennes versions s’affichent incorrectement.
  • Pas de personnalisation : affiche uniquement le contenu pour l’audience « Tous les utilisateurs », sans ciblage basé sur le pays, l’attribution ou des attributs personnalisés.

Si la rapidité de récupération compense ces inconvénients pour votre cas d’usage, utilisez GetPaywallForDefaultAudience comme indiqué ci-dessous. Sinon, utilisez GetPaywall comme décrit ci-dessus.

Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

Paramètres :

ParamètrePrésenceDescription
placementIdrequisL’identifiant du Placement souhaité. Il s’agit de la valeur que vous avez spécifiée lors de la création d’un placement dans l’Adapty Dashboard.
locale

optionnel

par défaut : en

L’identifiant de la localisation du paywall. Ce paramètre doit être un code de langue composé d’un ou deux sous-tags séparés par le caractère moins (-). Le premier sous-tag correspond à la langue, le second à la région.

Exemple : en désigne l’anglais, pt-br représente le portugais brésilien.

fetchPolicypar défaut : AdaptyPlacementFetchPolicy.Default

fetchPolicy détermine quelle couche le SDK lit en premier, et non s’il peut utiliser le cache. Par défaut, le SDK interroge d’abord le serveur et retourne les données en cache si la requête échoue. Nous recommandons cette option, car elle garantit que vos utilisateurs reçoivent toujours les données les plus récentes.

Toutefois, si vous pensez que vos utilisateurs sont souvent confrontés à une connexion internet instable, envisagez AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad, qui inverse cet ordre — il lit d’abord le cache et ne contacte le serveur que si rien n’est en cache. Les utilisateurs ne bénéficieront peut-être pas des toutes dernières données, mais les temps de chargement seront plus rapides, quelle que soit la qualité de leur connexion. Le cache est mis à jour régulièrement, il est donc sûr de l’utiliser au cours d’une session pour éviter les requêtes réseau.

Une troisième politique, AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), se situe entre les deux : elle lit d’abord le cache tant que la copie en cache est plus récente que le TimeSpan que vous passez, et interroge le serveur dès qu’elle est plus ancienne.

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 via un nettoyage manuel.

Le SDK Adapty stocke les paywalls localement 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.