プラットフォーム年齢シグナル
ゲームプラットフォーム（Apple iOS、Google Play、Xbox、Meta Horizon、およびk-ID自体）は、プレイヤーに関する年齢データを提供できます。このデータは、自己申告の年齢と一緒に、またはその代わりにk-IDに渡すことができます。k-IDはこれを使用して、適切な場合に年齢ゲートを抑制し、年齢の矛盾を解決し、シグナルが確認済みと見なされる場合は、追加の確認手順なしに年齢確認要件を満たします。
プラットフォーム年齢シグナルは高リスク機能のための年齢保証と連携して機能します。たとえば、確認済みのApple iOSシグナルは、年齢ゲートをスキップし、別の確認手順なしにブラジルのルートボックス権限を解除することができます。
はじめに
以下のような場合にこの機能セットを使用してください：
- プラットフォームがすでに知っているプレイヤーの年齢情報を再利用する
- 確認済みの成人シグナルに対して年齢ゲートをスキップする
- ブラジルのルートボックスやターゲット広告など、高リスク権限をプレイヤーに再確認を求めずに解除する
- プラットフォームの年齢シグナルが自己申告の年齢と矛盾する場合を検出する
クイック統合パス
| ゲームに… | k-IDに送信するもの | 通常の動作 |
|---|---|---|
| Apple iOS、Google Play、またはk-IDからの確認済み成人シグナルがある | GET /age-gate/get-requirements と POST /age-gate/check の両方にプラットフォームシグナル | 年齢ゲートをスキップでき、確認済み年齢権限を即座に有効にできる |
| XboxやMeta Horizonなどの未確認シグナルがある | get-requirements と check にプラットフォームシグナル | k-IDは保守的な年齢解決に使用できるが、確認済み年齢権限を満たすことはできない |
| カテゴリベースのプラットフォームシグナルがある | カテゴリを直接、または最初に POST /age-gate/get-platform-age-range で変換 | k-IDがカテゴリを管轄区域固有の年齢範囲に解決する |
| プラットフォームシグナルがまったくない | 通常の年齢ゲート入力 | 標準の年齢ゲートフローが適用され、高リスク権限は後で年齢保証が必要になる場合がある |
APIマップ
これらは統合中に開発者が最もよく使用するエンドポイントです：
| エンドポイント | 呼び出すタイミング | 重要な理由 |
|---|---|---|
GET /age-gate/get-requirements | 年齢ゲートを表示する前 | ゲートを表示するかどうか、確認済み年齢権限がまだ保証を必要とするかどうかを確認 |
GET /session/get | check またはチャレンジ完了後 | 権限を更新し、ageVerification を確認 |
POST /age-gate/check | プレイヤーの年齢入力を取得した後、常に | セッションを作成または更新し、確認済みプラットフォームシグナルが許可する場合に確認済み年齢をセッションに記録 |
POST /session/upgrade | プレイヤーが高リスク機能を使用しようとするとき | リクエストされた権限を即座に有効にするか、年齢保証チャレンジを作成 |
POST /age-gate/get-platform-age-range | カテゴリベースのプラットフォームシグナルのみ | プラットフォームカテゴリを ageLow と ageHigh に変換 |
エンドツーエンドフロー
推奨リクエストシーケンス
- 起動時にプラットフォームシグナルを取得します。 プラットフォームが年齢データを公開している場合、
get-requirementsとcheckの両方で使用できるように、できるだけ早く取得してください。 GET /age-gate/get-requirementsを呼び出します。 年齢ゲートを表示するかどうか、権限がまだ確認済み年齢を必要とするかどうかを確認します。- 常に
POST /age-gate/checkを呼び出します。 ゲートがスキップされる場合でも、セッションを作成または更新するためにcheckが必要です。 sessionIdと現在の権限を保存します。 ゲームが機能アクセスを制御するために使用するものです。- 必要なときのみ
POST /session/upgradeを呼び出します。 プレイヤーがまだ有効になっていない高リスク機能を積極的に使用しようとするときに行います。
shouldDisplay が false だが送信するプラットフォームシグナルが実際にない場合は、保守的なフォールバックとして age: 1 を指定して POST /age-gate/check を呼び出してください。
POST /age-gate/check がプラットフォームシグナルをどのように使用するか
主要コンセプト
PlatformAgeSignal オブジェクト
プラットフォームから報告された年齢シグナルを記述する統合オブジェクトです。category または ageLow と ageHigh の両方を提供します。両方を同時に提供しないでください。
{
"name": "apple-ios",
"ageLow": 18,
"ageHigh": 25,
"declarationType": "governmentIDChecked",
"verificationId": null
}
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | はい | プラットフォーム識別子：apple-ios、google-play、xbox、meta-horizon、または k-id |
category | string | いいえ | プラットフォーム固有の年齢カテゴリ（たとえば、digital-youth、TN、teen） |
ageLow | integer | いいえ | プラットフォームからの最小年齢（年）。ageHigh と一緒に指定する必要があります。 |
ageHigh | integer | いいえ | プラットフォームからの最大年齢（年）。ageLow と一緒に指定する必要があります。 |
declarationType | string | いいえ | プラットフォームが年齢を決定した方法（たとえば、governmentIDChecked、VERIFIED） |
verificationId | string (UUID) | いいえ | k-id シグナルのみ：完了したk-ID確認レコードを参照 |
サポートされているプラットフォーム
| プラットフォーム | 受け入れる入力 | 確認済み宣言タイプ | 備考 |
|---|---|---|---|
apple-ios | ageLow + ageHigh のみ | paymentChecked、governmentIDChecked、guardianPaymentChecked、guardianGovernmentIDChecked | カテゴリ入力は400を返す |
google-play | ageLow + ageHigh のみ | VERIFIED、SUPERVISED | カテゴリ入力は400を返す |
| Xbox | category（child、teen、adult） | なし（年齢要件には未確認） | 範囲は管轄区域に依存 |
| meta-horizon | category（CH、TN、AD） | なし（年齢要件には未確認） | 範囲は管轄区域に依存（Meta Horizonを参照） |
| k-ID | category（digital-minor、digital-youth、adult） | KIDVerified（サーバー解決） | 確認済み宣言には、Compliance Studio内の同じ組織の有効な verificationId が必要 |
確認済みと未確認のシグナル
プラットフォームシグナルは、declarationType がそのプラットフォームの確認済みセットにある場合のみ確認済みと見なされます。確認済みシグナルは：
- シグナルが成人を示す場合（
ageLow >= civilAge）に年齢ゲートを抑制（shouldDisplay = false）できる - 権限の年齢確認閾値を満たすことができる（たとえば、別の確認手順なしにルートボックスを有効にする）
- 将来の権限チェックのためにセッションに
ageVerificationを記録する
未確認のシグナル（Xbox、Meta Horizon、または自己宣言のAppleやGoogleシグナルなど）は、年齢矛盾検出と保守的な年齢解決に引き続き役立ちますが、確認要件をバイパスすることはできません。
確認済み年齢閾値
一部の権限は、有効にする前に確認済み年齢が必要です。その場合、権限には verifiedAgeThreshold 値が含まれます。
たとえば、ブラジルでは、loot-boxes-paid-cosmetic-only、loot-boxes-paid-gameplay-impacting、targeted-ads、および profiling は確認済み年齢 18 が必要で、direct-marketing は確認済み年齢 12 が必要です。プレイヤーの実効年齢が閾値を下回っている場合、権限は PROHIBITED になります。プレイヤーが閾値を満たしているがまだ年齢を確認していない場合、以下のいずれかが満たされるまで権限は enabled: false のままです：
- 確認済みプラットフォームシグナルが閾値を満たす、または
- プレイヤーが高リスク機能のための年齢保証を完了する
年齢矛盾検出
主要な年齢パラメータ（dateOfBirth、age、または kuid）と platformAgeSignal の両方が /age-gate/check に提供された場合、システムは年齢カテゴリを比較します：
- プラットフォームが自己申告より若い（たとえば、プラットフォームが「子供」と言っているがプレイヤーが「成人」と言っている）：
AGE_CONFLICTを返す（400エラー） - プラットフォームが自己申告より年上： 許容可能；より保守的な（低い）年齢が使用される
- 同じカテゴリ： 矛盾なし；正常に進む
年齢矛盾検出は開発者ごとの機能フラグです。有効にするにはk-IDにお問い合わせください。
次のステップ
- 正確なリクエスト形式、プラットフォーム固有の注意事項、および検証ルールについては、プラットフォームシグナル詳細を参照してください。
- 確認済み年齢権限とセッションアップグレードの動作については、高リスク機能のための年齢保証を参照してください。