Implementar el modo Observer en Unity SDK

Si ya tienes tu propia infraestructura de compras y no estás listo para migrar completamente a Adapty, puedes explorar el modo Observer. En su forma básica, el modo Observer ofrece analíticas avanzadas e integración fluida con sistemas de atribución y analíticas.

Si esto se adapta a tus necesidades, solo tienes que:

Activarlo al configurar el SDK estableciendo el parámetro observerMode en true. Sigue las instrucciones de configuración para Unity.
Notificar las transacciones desde tu infraestructura de compras existente a Adapty.

Tip

En la versión 4 del SDK, también puedes presentar flows y paywalls renderizados por Adapty en el modo Observer: implementa IAdaptyUIObserverModeResolver y regístralo con SetObserverModeResolver para realizar la compra o restauración con tu propio código cuando el usuario pulse el botón correspondiente. Consulta Presentar flows en modo Observer.

Configuración del modo Observer

Activa el modo Observer si gestionas las compras y el estado de las suscripciones tú mismo y usas Adapty para enviar eventos de suscripción y análisis.

Important

Cuando se ejecuta en modo Observer, el SDK de Adapty no cerrará ninguna transacción, así que asegúrate de gestionarlo tú mismo.

Note

En el SDK 4.1, las interfaces de listener siguen la convención de prefijo C# con I — implementa IAdaptyEventListener en lugar de AdaptyEventListener — y la interfaz requiere un método adicional, OnReceivePromotedPurchase. Consulta la guía de migración.

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

Parámetros:

Parámetro	Descripción
observerMode	Un valor booleano que controla el modo Observer. El valor por defecto es `false`.

Uso de flows y paywalls de Adapty en modo Observer

Si también quieres usar los flows, paywalls y funciones de pruebas A/B de Adapty, puedes hacerlo, pero en el modo Observer se necesita algo de configuración adicional. Esto es lo que tendrás que hacer además de los pasos anteriores:

Muestra los paywalls con Remote Config como de costumbre. Para flows y paywalls creados en el Flow Builder, consulta Presentar flows en modo Observer.
Asocia flows y paywalls con las transacciones de compra.