Récupérer les flows et paywalls - Unity

Après avoir conçu votre flow ou votre paywall dans le Paywall Builder, 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.

Récupérer un flow/paywall

Si vous avez conçu un flow ou un paywall avec le Flow Builder ou 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 flow ou 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 ID via le placement, sa configuration de vue, puis le présenter dans votre application mobile.

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

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 :

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 d’indicateur distinct à vérifier : si le placement a été conçu dans le Flow Builder (un flow) ou le Paywall Builder (un paywall), CreateFlowView retourne la vue prête à être affichée. Si le placement est un paywall personnalisé sans interface Builder, CreateFlowView retourne une erreur — gérez-la comme un paywall Remote Config.

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
});

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.

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

        // flow - the requested flow
    }
);

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 IDs prédéfinis : hero_image et hero_video. Dans un bundle de ressources personnalisées, 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.

Voici un exemple montrant comment fournir des ressources personnalisées 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
});

Configurer des minuteries définies par le développeur

Pour utiliser des minuteries personnalisées dans votre application Unity, passez un dictionnaire d’identifiants de minuteries et leurs dates de fin à 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(2026, 1, 1) }
};

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

AdaptyUI.CreateFlowView(flow, 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 configurez 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 du Nouvel An.
• CUSTOM_TIMER_6H : le temps restant dans une période de 6 heures qui a démarré lorsque l’utilisateur a ouvert le flow ou le paywall.

Après avoir conçu la partie visuelle de votre paywall avec le nouveau 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.

Veuillez noter que ce sujet concerne les paywalls personnalisés avec le Paywall Builder. Si vous implémentez vos paywalls manuellement, reportez-vous à la rubrique Récupérer les paywalls et les produits pour les paywalls Remote Config 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ètres de réponse :

Récupérer la configuration d’affichage d’un paywall créé avec Paywall Builder

Après avoir récupéré le paywall, vérifiez s’il inclut une ViewConfiguration, ce qui indique qu’il a été créé avec Paywall Builder. Cela vous guidera sur la façon d’afficher le paywall. Si la ViewConfiguration est présente, traitez-le comme un paywall Paywall Builder ; sinon, gérez-le comme un paywall Remote Config.

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

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

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

Paramètres :

Une fois que vous avez la vue, 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.

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
});

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.

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

Paramètres :