Unity SDKでオブザーバーモードを実装する

すでに独自の購入インフラを持っており、Adaptyへの完全な移行を検討していない場合は、オブザーバーモードを試してみてください。基本的な形では、オブザーバーモードは高度な分析機能と、アトリビューションおよび分析システムとのシームレスな統合を提供します。

これがニーズに合っている場合は、次の2つの手順を行うだけです。

Adapty SDK を設定する際に、observerMode パラメータを true に設定してオンにします。Unity のセットアップ手順に従ってください。
既存の購入インフラから Adapty にトランザクションを報告します。

Tip

SDK v4では、Observerモードでも Adapty がレンダリングするフローとペイウォールを表示できます。IAdaptyUIObserverModeResolver を実装し、SetObserverModeResolver で登録することで、ユーザーが対応するボタンをタップしたときに独自のコードで購入や復元を実行できます。詳しくはObserverモードでのフローの表示をご覧ください。

オブザーバーモードの設定

購入処理とサブスクリプションのステータス管理を自前で行い、サブスクリプションイベントの送信と分析にのみ Adapty を利用する場合は、オブザーバーモードを有効にしてください。

Important

オブザーバーモードで動作している場合、Adapty SDK はトランザクションをクローズしません。そのため、トランザクションの処理は必ずご自身で行ってください。

Note

SDK 4.1 では、リスナーインターフェースが C# の I プレフィックス規則に従って変更されています。AdaptyEventListener の代わりに IAdaptyEventListener を実装してください。また、このインターフェースには 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	オブザーバーモードを制御するブール値です。デフォルト値は `false` です。

Observer Modeでのフローとペイウォールの使用

フロー、ペイウォール、A/B テストの機能も使いたい場合は、Observer Modeで追加の設定が必要です。上記の手順に加えて、以下の対応が必要になります。

リモートコンフィグペイウォールを通常通り表示します。フローおよびペイウォールビルダーで作成したペイウォールについては、オブザーバーモードでフローを表示するを参照してください。
フローとペイウォールを購入トランザクションに紐付けます。