Tìm hiểu về các phản hồi đối với dấu hiệu về độ tuổi

Tài liệu này giải thích các phản hồi về dấu hiệu độ tuổi do Play Age Signals API trả về.

(Không bắt buộc) Nhận nhóm tuổi tuỳ chỉnh

Các nhóm tuổi mặc định mà API trả về là 0-12, 13-15, 16-17 và 18+.

Ngoài ra, để tuỳ chỉnh các nhóm tuổi mặc định theo độ tuổi tối thiểu để dùng ứng dụng của bạn, bạn có thể cung cấp các độ tuổi tối thiểu này cho ứng dụng của mình trên trang Dấu hiệu về độ tuổi trong Google Play Console.

  1. Chuyển đến trang Dấu hiệu về độ tuổi trong Play Console.
  2. Trên thẻ Độ tuổi tuỳ chỉnh, hãy nhập tối đa 3 độ tuổi tối thiểu cho ứng dụng của bạn. Các độ tuổi tối thiểu phải cách nhau ít nhất 2 năm và bạn có thể thay đổi thông tin này mỗi năm một lần.
  3. Nhấp vào Lưu.

Độ tuổi được trả về sẽ ghi đè phản hồi mặc định của API. Ví dụ:

  • Nếu bạn đặt một độ tuổi tối thiểu (15) trong Google Play Console:
    • Trẻ từ 0 đến 14 tuổi sẽ trả về ageLower = 0 và ageUpper = 14.
    • Người từ 15 tuổi trở lên sẽ trả về ageLower = 15.
  • Nếu bạn đặt hai độ tuổi tối thiểu (13 và 17):
    • Trẻ từ 0 đến 12 tuổi sẽ trả về ageLower = 0 và ageUpper = 12.
    • Trẻ từ 13 đến 16 tuổi sẽ trả về ageLower = 13 và ageUpper = 16.
    • Người từ 17 tuổi trở lên sẽ trả về ageLower = 17.
  • Nếu bạn đặt 3 độ tuổi tối thiểu (11, 13 và 15):
    • Trẻ từ 0 đến 10 tuổi sẽ trả về ageLower = 0 và ageUpper = 10.
    • Trẻ 11 hoặc 12 tuổi sẽ trả về ageLower = 11 và ageUpper = 12.
    • Trẻ 13 hoặc 14 tuổi sẽ trả về ageLower = 13 và ageUpper = 14.
    • Người từ 15 tuổi trở lên sẽ trả về ageLower = 15.

Trường phản hồi về dấu hiệu độ tuổi

Phản hồi của Play Age Signals API (thử nghiệm) bao gồm các trường và giá trị sau. Bạn có trách nhiệm cung cấp trải nghiệm phù hợp với lứa tuổi bằng cách sử dụng các tín hiệu này.

Trường phản hồi Loại Giá trị Mô tả
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • vô hiệu
  • TIER_A: Người dùng đã cung cấp thông tin về độ tuổi của họ cho Google. Google có thể đã hoặc chưa xác nhận thông tin này.
  • TIER_B: Độ tuổi của người dùng do cha mẹ hoặc người giám hộ quản lý.
  • TIER_C*: Tuổi của người dùng được đánh giá bằng thẻ tín dụng, địa chỉ email, quy trình đánh giá ảnh chân dung tự chụp, giấy tờ tuỳ thân do chính phủ cấp hoặc mã số thuế.
  • TIER_D*: Độ tuổi của người dùng được kiểm tra bằng cách kết hợp giấy tờ tuỳ thân do chính phủ cấp và quy trình đánh giá ảnh chân dung tự chụp, hoặc thẻ căn cước điện tử.
  • null: Trả về khi ageSignalsStatus là NOT_SHARED hoặc VERIFICATION_REQUIRED.
* Chỉ được trả về ở những khu vực chịu sự điều chỉnh của luật về quyền riêng tư, nơi bắt buộc phải xác minh tuổi (ví dụ: US-TX).
ageLower Số nguyên
  • 0 đến 18 tuổi
  • vô hiệu
Giới hạn dưới (bao gồm cả giá trị này) của nhóm tuổi của người dùng. Kết hợp với ageUpper để xác định dải.

Trả về null nếu ageSignalsStatus là NOT_SHARED hoặc VERIFICATION_REQUIRED.

ageUpper Số nguyên
  • 2 đến 18 tuổi
  • vô hiệu
Giới hạn trên (bao gồm cả giá trị này) của nhóm tuổi của người dùng.

Trả về null cho dải cao nhất (ví dụ: 18+) hoặc nếu ageSignalsStatus là NOT_SHARED hoặc VERIFICATION_REQUIRED.

significantChangeStatus Enum
  • APPROVED
  • ĐANG CHỜ GIẢI QUYẾT
  • ĐÃ TỪ CHỐI
  • vô hiệu
Hàm này chỉ trả về một giá trị khác rỗng ở những khu vực tài phán có áp dụng các thay đổi quan trọng.
  • APPROVED: Thay đổi quan trọng gần đây nhất (và tất cả thay đổi trước đó) đã được phê duyệt.
  • PENDING: Cha mẹ chưa phê duyệt một hoặc nhiều thay đổi quan trọng đang chờ xử lý.
  • DECLINED: Cha mẹ đã từ chối phê duyệt một hoặc nhiều thay đổi quan trọng.
  • null: Được trả về cho:
    • Tất cả tài khoản không được giám sát
    • Những tài khoản được giám sát chưa ghi nhận thay đổi quan trọng nào.
significantChangeApprovalDate Ngày
  • DateStamp
  • vô hiệu
Ngày có hiệu lực của thay đổi quan trọng được phê duyệt gần đây nhất. Tất cả thay đổi có ngày có hiệu lực trước ngày này cũng được phê duyệt. Trả về null nếu không có thay đổi nào.

Kết hợp với `significantChangeStatus` để biết trạng thái phê duyệt cho thay đổi quan trọng này

installId Chuỗi
  • Chữ và số
  • vô hiệu
Mã nhận dạng do Google Play chỉ định cho các lượt cài đặt của người dùng được giám sát, dùng để thông báo cho bạn về việc thu hồi quyết định phê duyệt ứng dụng. Xem tài liệu về quyết định phê duyệt ứng dụng bị thu hồi.

Ví dụ 1

Đối với người dùng là người lớn đã xác minh tuổi bằng thẻ căn cước điện tử, bạn sẽ nhận được thông tin sau:

  • Ở khu vực có quy định cụ thể, nơi bắt buộc phải xác minh tuổi:

    • ageRangeSource là AgeRangeSource.TIER_D.
    • ageLower là một số (ví dụ: 18).
    • ageUpper là null.
    • Các trường phản hồi khác là null.
  • Mọi nơi khác:

    • ageRangeSource là AgeRangeSource.TIER_A.
    • ageLower là một số (ví dụ: 18).
    • ageUpper là null.
    • Các trường phản hồi khác là null.

Ví dụ 2

Đối với người dùng là người lớn đã xác minh tuổi bằng các phương thức ước tính tuổi (chẳng hạn như quy trình đánh giá ảnh chân dung tự chụp, thẻ tín dụng hoặc mã số thuế), bạn sẽ nhận được thông tin sau:

  • Ở khu vực có quy định cụ thể, nơi bắt buộc phải xác minh tuổi:

    • ageRangeSource là AgeRangeSource.TIER_C.
    • ageLower là một số (ví dụ: 18).
    • ageUpper là null.
    • Các trường phản hồi khác là null
  • Mọi nơi khác:

    • ageRangeSource là AgeRangeSource.TIER_A.
    • ageLower là một số (ví dụ: 18).
    • ageUpper là null.
    • Các trường phản hồi khác là null.

Ví dụ 3

Đối với người dùng ở khu vực không bắt buộc phải xác minh tuổi và chia sẻ thông tin này với ứng dụng, bạn sẽ nhận được thông tin sau:

  • ageRangeSource là AgeRangeSource.TIER_A.
  • ageLower là một số (ví dụ: 18).
  • ageUpper là null.
  • Các trường phản hồi khác là null.

Ví dụ 4

Đối với người dùng được giám sát là trẻ vị thành niên có độ tuổi do người giám hộ quản lý và người giám hộ đó đã chia sẻ độ tuổi đó với các ứng dụng, bạn sẽ nhận được thông tin sau:

  • ageRangeSource là AgeRangeSource.TIER_B.
  • ageLower là một số (ví dụ: 13).
  • ageUpper là một số (ví dụ: 15).
  • Các trường phản hồi khác là null.

Ví dụ 5

Đối với người dùng chưa đồng ý (hoặc có cha mẹ chưa đồng ý) chia sẻ thông tin về độ tuổi ở một khu vực không bắt buộc phải xác minh tuổi, bạn sẽ nhận được thông tin sau:

  • ageRangeSource là null.
  • ageLower là null.
  • ageUpper là null.
  • Các trường phản hồi khác là null.

Ví dụ 6

Đối với người dùng là trẻ vị thành niên được giám sát có độ tuổi do người giám hộ quản lý, có một thay đổi quan trọng đã được phê duyệt và có hoạt động theo dõi số thiết bị đã cài đặt đang hoạt động, bạn sẽ nhận được những thông tin sau:

  • ageRangeSource là AgeRangeSource.TIER_B.
  • ageLower là một số (ví dụ: 13).
  • ageUpper là một số (ví dụ: 15).
  • significantChangeStatus là SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate là một Ngày (ví dụ: "2026-01-15").
  • installId là giá trị nhận dạng chuỗi (ví dụ: "abc123xyz789").