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

独自の購入インフラを持っており、まだ Adapty への完全な移行を検討していない場合は、オブザーバーモードを活用できます。基本的な使い方では、オブザーバーモードによって高度なアナリティクスや、アトリビューション・分析システムとのシームレスな連携が可能になります。

これで十分な場合は、以下の 2 つだけ対応すれば OK です:

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

ペイウォールや A/B テストも利用したい場合は、以下に説明する追加のセットアップが必要です。

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

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

オブザーバーモードで動作している場合、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` です。

オブザーバーモードで Adapty のペイウォールを使用する

Adapty のペイウォールや A/B テスト機能も使用したい場合は可能ですが、オブザーバーモードでは追加のセットアップが必要です。上記の手順に加えて、以下を行ってください:

リモートコンフィグペイウォールは通常どおり表示する。ペイウォールビルダーのペイウォールについては、iOS 向けの専用セットアップガイドに従う。
購入トランザクションにペイウォールを紐付ける。