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

すでに独自の購入インフラを持っており、Adapty への完全な移行を検討していない場合は、オブザーバーモードをご利用いただけます。基本的な形では、オブザーバーモードは高度なアナリティクスと、アトリビューション・アナリティクスシステムとのシームレスな連携を提供します。

このニーズに合う場合は、以下の手順だけで設定できます：

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

Tip

SDK v4では、ObserverモードでAdapty描画のフローおよびペイウォールを表示することもできます。onObserverPurchaseInitiatedおよびonObserverRestoreInitiatedイベントハンドラを設定することで、ユーザーが対応するボタンをタップしたときに独自のコードで購入または復元を実行できます。詳細はObserverモードでフローを表示するをご参照ください。

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

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

Important

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


try {
  await adapty.activate({
    apiKey: 'YOUR_PUBLIC_SDK_KEY',
    params: {
      observerMode: true // Enable observer mode
    }
  });
} catch (error) {
  console.error('Failed to activate Adapty:', error);
}

パラメーター	説明
observerMode	オブザーバーモードを制御するブール値。デフォルト値は `false` です。

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

Observer Modeでも、Adapty のフロー、ペイウォール、A/B テスト機能を利用できます。ただし、追加のセットアップが必要です。上記の手順に加えて、以下の対応が必要です。

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