Реализация режима Observer в Unity SDK

Если у вас уже есть собственная инфраструктура покупок и вы не готовы полностью переходить на Adapty, вы можете воспользоваться режимом Observer. В базовом виде режим Observer предоставляет расширенную аналитику и бесшовную интеграцию с системами атрибуции и аналитики.

Если это соответствует вашим потребностям, вам нужно лишь:

Включить его при настройке SDK, установив параметр observerMode в значение true. Следуйте инструкциям по настройке для Unity.
Передавать транзакции из вашей существующей инфраструктуры покупок в Adapty.

Tip

В SDK v4 вы также можете отображать флоу и пейволы, отрисованные Adapty, в режиме Observer mode: реализуйте IAdaptyUIObserverModeResolver и зарегистрируйте его с помощью SetObserverModeResolver, чтобы выполнять покупку или восстановление вашим собственным кодом при нажатии пользователем соответствующей кнопки. Подробнее: Отображение флоу в режиме Observer mode.

Настройка режима Observer mode

Включите режим Observer mode, если вы самостоятельно обрабатываете покупки и статус подписки, а Adapty используете только для отправки событий подписки и аналитики.

Important

В режиме Observer mode SDK Adapty не закрывает транзакции — убедитесь, что вы обрабатываете их самостоятельно.

Note

В SDK 4.1 интерфейсы слушателей следуют соглашению C# о префиксе I — реализуйте IAdaptyEventListener вместо AdaptyEventListener. Кроме того, интерфейс требует ещё одного метода: OnReceivePromotedPurchase. Подробнее см. в руководстве по миграции.

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

Параметры:

Параметр	Описание
observerMode	Булево значение, управляющее режимом Observer. Значение по умолчанию — `false`.

Использование флоу и пейволов Adapty в режиме Observer Mode

Если вы хотите использовать флоу, пейволы и A/B-тесты Adapty, это возможно — но в режиме Observer Mode потребуется дополнительная настройка. Вот что нужно сделать помимо шагов, описанных выше:

Отображайте пейволы с Remote Config как обычно. Для флоу и пейволов, созданных во Flow Builder, см. Отображение флоу в режиме Observer.
Свяжите флоу и пейволы с транзакциями покупок.