瞭解年齡信號回應

本文說明 Play Age Signals API 傳回的年齡信號回應。

(選用) 接收自訂年齡層

API 傳回的預設年齡範圍為 0-12、13-15、16-17 和 18+。

如要根據應用程式的最低使用年齡自訂預設年齡層，請前往 Google Play 管理中心的「年齡信號」頁面，為應用程式提供這些最低使用年齡。

1. 前往 Play 管理中心的「年齡信號」頁面。
2. 在「自訂年齡範圍」分頁中，輸入應用程式最多三個最低年齡。各最低年齡間需相差至少 2 歲，且每年只能修改一次。
3. 按一下「儲存」。

傳回的年齡層範圍會覆寫預設的 API 回應。例如：

• 如果您在 Google Play 管理中心設定最低年齡 (15 歲)：
  • 0 到 14 歲的兒童會傳回 ageLower = 0 和 ageUpper = 14。
  • 如果年齡超過 15 歲，系統會傳回 ageLower = 15。
• 如果設定兩個最低年齡 (13 歲和 17 歲)：
  • 如果年齡介於 0 到 12 歲，則會傳回 ageLower = 0 和 ageUpper = 12。
  • 13 至 16 歲的使用者會傳回 ageLower = 13 和 ageUpper = 16。
  • 如果年齡超過 17 歲，則會傳回 ageLower = 17。
• 如果設定三個最低年齡 (11 歲、13 歲和 15 歲)：
  • 0 到 10 歲的兒童會傳回 ageLower = 0 和 ageUpper = 10。
  • 11 或 12 歲的使用者會傳回 ageLower = 11 和 ageUpper = 12。
  • 13 或 14 歲的兒童會傳回 ageLower = 13 和 ageUpper = 14。
  • 如果年齡超過 15 歲，系統會傳回 ageLower = 15。

年齡信號回應欄位

Play Age Signals API (Beta 版) 回應包含下列欄位和值。您有責任使用這些信號提供適齡體驗。

範例 1

如果使用者透過數位身分證件驗證年齡，並將資訊分享給應用程式，您會收到下列資訊：

• ageRangeSource 為 AgeRangeSource.TIER_D。
• ageLower 是數字 (例如 18)。
• ageUpper 為 null。
• 其他回應欄位為 null。

範例 2

如果成年使用者已聲明年齡 (自行聲明) 並與應用程式分享，您會收到下列資訊：

• ageRangeSource 為 AgeRangeSource.TIER_A。
• ageLower 是數字 (例如 18)。
• ageUpper 為 null。
• 其他回應欄位為 null。

示例 3

如果受監護的未成年使用者由監護人管理年齡，且監護人已將年齡資訊提供給應用程式，您會收到下列資訊：

• ageRangeSource 為 AgeRangeSource.TIER_B。
• ageLower 是數字 (例如 13)。
• ageUpper 是數字 (例如 15)。
• 其他回應欄位為 null。

示例 4

如果使用者 (或家長) 未同意分享年齡，您會收到以下資訊：

• ageRangeSource 為 null。
• ageLower 為 null。
• ageUpper 為 null。
• 其他回應欄位為 null。

示例 5

如果成人使用者透過年齡推估方法 (例如自拍照評估、信用卡或稅號) 驗證年齡，並將資訊提供給應用程式，您會收到以下資訊：

• ageRangeSource 為 AgeRangeSource.TIER_C。
• ageLower 是數字 (例如 18)。
• ageUpper 為 null。
• 其他回應欄位為 null。

範例 6

如果受監護的未成年使用者年齡由監護人管理，且您已核准重大變更並啟用安裝追蹤功能，系統會提供下列資訊：

• ageRangeSource 為 AgeRangeSource.TIER_B。
• ageLower 是數字 (例如 13)。
• ageUpper 是數字 (例如 15)。
• significantChangeStatus 為 SignificantChangeStatus.APPROVED。
• significantChangeApprovalDate 是日期 (例如「2026-01-15」)。
• installId 是字串 ID (例如「abc123xyz789」)。