Récupérer les paywalls et produits pour les paywalls Remote Config dans le SDK Unity

Avant de présenter la configuration distante et les paywalls personnalisés, vous devez récupérer les informations les concernant. Notez que ce sujet traite de Remote Config et des paywalls personnalisés. Pour obtenir des instructions sur la récupération des flows ou des paywalls personnalisés dans le Flow Builder ou le Paywall Builder, consultez Récupérer les flows et paywalls.

Récupérer les informations d’un flow

Dans Adapty, un produit est une combinaison de produits provenant de l’App Store et de Google Play. Ces produits multi-plateformes sont intégrés dans des flows et des paywalls, ce qui vous permet de les présenter dans des placements spécifiques de votre application mobile.

Pour afficher les produits, vous devez obtenir un AdaptyFlow depuis l’un de vos placements à l’aide de 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
    }
);

Ne codez pas les identifiants de produit en dur ! Puisque 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 bien 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 du placement.

Paramètres de réponse :

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, (products, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // products - the requested products array
});

Paramètres de la réponse :

Lors de la mise en œuvre de votre propre design de flow, 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 illustrées ci-dessous.

Accélérer la récupération des flows avec le 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 en préoccuper. Toutefois, 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 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.

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

        // flow - the requested flow
    }
);

Avant de présenter le Remote Config et les paywalls personnalisés, vous devez récupérer les informations les concernant. Notez que ce sujet concerne le Remote Config et les paywalls personnalisés. Pour obtenir des instructions sur la récupération des paywalls pour les paywalls personnalisés avec le Paywall Builder, consultez Récupérer les paywalls du Paywall Builder et leur configuration.

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 multiplateformes 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.

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

N’écrivez 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 à tout moment. 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 à écrire en dur est l’identifiant du placement.

Paramètres de réponse :

Récupérer les produits

Une fois que vous avez le paywall, vous pouvez récupérer le tableau de produits qui lui correspond :

Adapty.GetPaywallProducts(paywall, (products, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // products - the requested products array
});

Paramètres de réponse :

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 illustrées ci-dessous, mais consultez le document lié pour obtenir des informations complètes sur toutes les propriétés disponibles.

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, 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. Cependant, il est 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 :