iOS SDKにオブザーバーモードを実装する

独自の購入インフラをすでに持っており、完全に Adapty へ移行する準備ができていない場合は、Observer モードを検討してみてください。基本的な形では、Observer モードによって高度な分析機能と、アトリビューション・分析システムとのシームレスな連携が利用できます。

このモードで十分な場合、必要な作業は次の2つだけです：

Adapty SDK の設定時に observerMode パラメータを true に設定して、Observer モードを有効にする。
既存の購入インフラから Adapty へトランザクションを報告する。

フロー、ペイウォール、A/B テストも必要な場合は、以下に説明する追加設定が必要です。

オブザーバーモードのセットアップ

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

Important

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


@main
struct YourApp: App {
  init() {
    // Configure Adapty SDK
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard
      .with(observerMode: true) 
      
    let config = configurationBuilder.build()
    
    // Activate Adapty SDK asynchronously
    Task {
      do {
        try await Adapty.activate(with: configurationBuilder)
      } catch {
        // Handle error appropriately for your app
        print("Adapty activation failed: ", error)
      }
    }
    
    var body: some Scene {
      WindowGroup {
        // Your content view
      }
    }
  }
}


Task {
  do {
    let configurationBuilder = AdaptyConfiguration
      .builder(withAPIKey: "YOUR_PUBLIC_SDK_KEY") // Get from Adapty dashboard
      .with(observerMode: true) 
    
    let config = configurationBuilder.build()
    try await Adapty.activate(with: config)
  } catch {
    // Handle error appropriately for your app
    print("Adapty activation failed: ", error)
  }
}

パラメータ:

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

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

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

カスタムペイウォールは通常どおり表示します。フローおよびペイウォールビルダーで作成したフロー＆ペイウォールについては、ObserverモードでフローをPresentを参照してください。
フロー＆ペイウォールを購入トランザクションに関連付けます。