Adapty はすべてのユーザーに対して内部プロファイル ID を作成します。ただし、独自の認証システムがある場合は、独自の Customer User ID を設定する必要があります。Profiles セクションで Customer User ID によってユーザーを検索でき、またサーバーサイド API でも使用でき、すべてのインテグレーションに送信されます。

設定時に Customer User ID を設定する

設定時にユーザー ID がある場合は、.activate() メソッドの customerUserId パラメータとして渡すだけです：

   try {
       await Adapty().activate(
           configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
             ..withCustomerUserId(YOUR_CUSTOMER_USER_ID)
       );
   } catch (e) {
       // handle the error
   }

設定後に Customer User ID を設定する

SDK の設定時にユーザー ID がない場合は、.identify() メソッドを使っていつでも後から設定できます。このメソッドが最もよく使われるケースは、登録または認証後に匿名ユーザーから認証済みユーザーに切り替わるときです。

try {
  await Adapty().identify(customerUserId);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

リクエストパラメータ：

• Customer User ID（必須）：文字列のユーザー識別子。

ログアウトとログイン

.logout() メソッドを呼び出すことで、いつでもユーザーをログアウトできます：

try {
  await Adapty().logout();
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle unknown error
}

その後、.identify() メソッドを使ってユーザーをログインできます。

appAccountToken を設定する（iOS）

appAccountToken は、App Store のトランザクションを内部ユーザー ID に紐付けるための UUID です。
StoreKit はすべてのトランザクションにこのトークンを関連付けるため、バックエンドで App Store のデータとユーザーを照合できます。

ユーザーごとに生成した安定した UUID を使用し、同じアカウントに対してデバイスをまたいで再利用してください。 これにより、購入と App Store の通知が正しく紐付けられます。

トークンは 2 つの方法で設定できます — SDK の起動時またはユーザーの識別時です。

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, iosAppAccountToken: "YOUR_APP_ACCOUNT_TOKEN");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

難読化されたアカウント ID を設定する（Android）

Google Play では、ユーザーのプライバシーとセキュリティを強化するために、特定のユースケースで難読化されたアカウント ID が必要です。これらの ID により、Google Play はユーザー情報を匿名に保ちながら購入を識別できます。これは不正防止や分析において特に重要です。

アプリが機密性の高いユーザーデータを扱う場合、または特定のプライバシー規制に準拠する必要がある場合は、これらの ID を設定する必要があるかもしれません。難読化された ID により、Google Play は実際のユーザー識別子を公開せずに購入を追跡できます。

// During configuration:
try {
   await Adapty().activate(
       configuration: AdaptyConfiguration(apiKey: 'YOUR_API_KEY')
         ..withCustomerUserId(YOUR_CUSTOMER_USER_ID, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID")
   );
} catch (e) {
   // handle the error
}
// Or when identifying users
try {
    await Adapty().identify(customerUserId, androidObfuscatedAccountId: "OBFUSCATED_ACCOUNT_ID");
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
}

デバイスをまたいでユーザーを識別する

SDKが有効化されると、StoreKit（iOS）またはGoogle Play Billing（Android）からユーザーの既存のエンタイトルメントを自動的に読み取り、Adaptyバックエンドと同期します。有効なサブスクリプションは、アプリがrestorePurchasesを呼び出すことなく、Adaptyプロファイルに表示されます。

自動では行われないのは、新しいデバイスのプロファイルが元のデバイスと同じユーザーのものであることの認識です。AdaptyはCustomer User IDでプロファイルを照合するため、同一性の継続性はCUIDとして何を使用するかによって異なります。

デバイス間でAdaptyが検出できること

あなたの設定	Adaptyが検出すること	必要な対応
Customer User ID = device_id（アプリのログインなし）	新しいデバイスは異なるCUIDを取得するため、異なるプロファイルが作成されます。サブスクリプションはAccess level updatedイベントを通じて新しいプロファイルに同期されますが、subscription_startedは発火しません。新しいプロファイルは元の購入の継承者として扱われます。subscription_startedに基づくアナリティクスは、リターニングユーザーをカウント不足します。	リターニングユーザーが既存のプロファイルをデバイス間で照合できるよう、安定したアカウントIDをCustomer User IDとして使用してください。
Customer User ID = 安定したアカウントID（すべてのデバイスでログイン）	SDKはactivate()でサブスクリプションを自動同期し、identify()がCUIDで既存のプロファイルを照合します。	追加の設定は不要です。IDとサブスクリプションの両方が自動的に解決されます。
Apple Family Sharing の継承者	ファミリーメンバーはAccess level updatedイベントのみを通じてサブスクリプションを受け取ります。subscription_startedは発火しません。	Access level updatedをリッスンしてください。完全なイベントマトリクスはApple Family Sharingを参照してください。
同じApple/Googleアカウント、異なるアプリ内ユーザー	最初に購入を記録したプロファイルが親になります。その後のプロファイルは継承者チェーンを通じてサブスクリプションを確認し、Access level updatedイベントが1回発生します。	ログインを必須にし、あなたのモデルに合った共有モードを選択してください。

新しいデバイスでの購入の復元

ペイウォールにユーザーが操作できる「購入を復元」ボタンを設置してください。Apple App Review（ガイドライン3.1.1）で必須とされており、自動同期がエッジケースを見逃した場合のフォールバックとして機能します。このボタンはSDKのrestorePurchasesを呼び出す必要があります。

初回起動時にプログラムでrestorePurchasesを呼び出すことは、通常の使用では必要ありません。SDKはすでにactivate()で同等の処理を実行しています。プログラムによる呼び出しは、activate()完了後にアクセスが欠落している場合のデバッグなど、強制的に新しいレシートチェックを行う場合にのみ使用してください。