瞭解年齡信號回應

本文說明 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 版) 回應包含下列欄位和值。您有責任使用這些信號提供適齡體驗。

回應欄位 類型 值 說明
ageRangeSource 列舉
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A:使用者已向 Google 提供年齡資訊。Google 可能已確認這項資訊,也可能尚未確認。
  • TIER_B:使用者的年齡由家長或監護人管理。
  • TIER_C*:使用者的年齡是透過信用卡、電子郵件地址、自拍照、政府核發的身分證件或稅號評估。
  • TIER_D*:使用者的年齡是透過政府核發的身分證件和自拍評估,或數位身分憑證來驗證。
  • null:如果 ageSignalsStatus 為 NOT_SHARED 或 VERIFICATION_REQUIRED,就會傳回這個值。
* 只有在強制要求年齡驗證的受管制區域 (例如美國德州),系統才會傳回這項資訊。
ageLower 整數
  • 0 至 18
  • null
使用者年齡範圍的下限 (含)。與 ageUpper 搭配使用,即可決定年齡層。

如果 ageSignalsStatus 為 NOT_SHARED 或 VERIFICATION_REQUIRED,則傳回 null。

ageUpper 整數
  • 2 至 18
  • null
使用者年齡範圍的上限 (含)。

如果年齡層最高 (例如 18 歲以上),或 ageSignalsStatus 為 NOT_SHARED 或 VERIFICATION_REQUIRED,則會傳回 null。

significantChangeStatus 列舉
  • 已核准
  • 待處理
  • 已拒絕
  • null
只有在適用重大異動的管轄區,這個方法才會傳回非空值。
  • 已核准:最近的重大變更 (和所有先前的變更) 已獲核准。
  • 待處理:家長尚未核准一或多項待處理的重大變更。
  • DECLINED:家長拒絕核准一或多項重大變更。
  • null:在下列情況下傳回:
    • 所有未受監督的帳戶
    • 尚未記錄任何重大變更的受監護帳戶。
significantChangeApprovalDate 日期
  • DateStamp
  • null
最近一次核准的重大變更生效日期。生效日期早於此日期的所有變更也已核准。如果沒有任何變更,則傳回 null。

與 `significantChangeStatus` 搭配使用,即可取得這項重大變更的核准狀態

installId String
  • 英數字元
  • null
Google Play 指派給受監護使用者安裝項目的 ID,用於通知您應用程式核准狀態已撤銷。請參閱撤銷應用程式核准的說明文件。

範例 1

如果成人使用者透過數位身分證件驗證年齡,您會收到下列資訊:

  • 在強制要求年齡驗證的管制地區:

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

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

範例 2

如果成人使用者透過年齡推估方法 (例如自拍照評估、信用卡或稅號) 驗證年齡,您會收到下列資訊:

  • 在強制要求年齡驗證的管制地區:

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

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

示例 3

如果使用者位於不強制要求年齡驗證的地區,並與應用程式分享年齡資訊,您會收到以下資訊:

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

示例 4

如果受監護的未成年使用者年齡由監護人管理,且監護人已向應用程式提供這項資訊,您會收到下列資訊:

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

示例 5

如果使用者 (或其家長) 尚未同意分享年齡資訊,且所在地區並未強制要求年齡驗證,您會收到下列資訊:

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

範例 6

如果受監護的未成年使用者年齡由監護人管理,且已核准重大變更並啟用有效安裝次數追蹤功能,您會收到以下資訊:

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