Implémenter le mode Observateur dans le SDK Unity

Si vous disposez déjà de votre propre infrastructure d’achat et n’êtes pas prêt à passer entièrement à Adapty, vous pouvez explorer le mode Observateur. Dans sa forme de base, le mode Observateur offre des analyses avancées et une intégration transparente avec les systèmes d’attribution et d’analyse.

Si cela correspond à vos besoins, il vous suffit de :

L’activer lors de la configuration du SDK en définissant le paramètre observerMode sur true. Suivez les instructions de configuration pour Unity.
Signaler les transactions depuis votre infrastructure d’achat existante à Adapty.

Tip

Dans le SDK v4, vous pouvez également présenter des flows et des paywalls rendus par Adapty en mode Observer : implémentez IAdaptyUIObserverModeResolver et enregistrez-le avec SetObserverModeResolver pour effectuer l’achat ou la restauration avec votre propre code lorsqu’un utilisateur appuie sur le bouton correspondant. Voir Présenter des flows en mode Observer.

Configuration du mode Observateur

Activez le mode Observateur si vous gérez vous-même les achats et le statut des abonnements, et que vous utilisez Adapty uniquement pour envoyer des événements d’abonnement et des analyses.

Important

En mode Observateur, le SDK Adapty ne clôture aucune transaction — veillez donc à les gérer vous-même.

Note

Dans le SDK 4.1, les interfaces de listener suivent la convention C# avec préfixe I — implémentez IAdaptyEventListener plutôt que AdaptyEventListener — et l’interface requiert une méthode supplémentaire, OnReceivePromotedPurchase. Consultez le guide de migration.

using UnityEngine;
using AdaptySDK;

public class AdaptyListener : MonoBehaviour, AdaptyEventListener {
    void Start() {
        DontDestroyOnLoad(this.gameObject);
        Adapty.SetEventListener(this);

        var builder = new AdaptyConfiguration.Builder("YOUR_PUBLIC_SDK_KEY")
            .SetObserverMode(true); // Enable observer mode

        Adapty.Activate(builder.Build(), (error) => {
            if (error != null) {
                // handle the error
                return;
            }
        });
    }

    public void OnLoadLatestProfile(AdaptyProfile profile) { }
    public void OnInstallationDetailsSuccess(AdaptyInstallationDetails details) { }
    public void OnInstallationDetailsFail(AdaptyError error) { }
}

Paramètre	Description
observerMode	Une valeur booléenne qui contrôle le mode Observateur. La valeur par défaut est `false`.

Utilisation des flows et paywalls Adapty en Observer Mode

Si vous souhaitez également utiliser les flows, les paywalls et les fonctionnalités de test A/B d’Adapty, c’est possible — mais cela nécessite une configuration supplémentaire en mode Observer. Voici ce que vous devrez faire en plus des étapes ci-dessus :

Affichez les paywalls Remote Config normalement. Pour les flows et paywalls créés dans le Flow Builder, consultez Présenter des flows en mode Observer.
Associez les flows et paywalls aux transactions d’achat.