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 độ tuổi tuỳ chỉnh

Các dải độ 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 độ 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.
  • Nếu người dùng từ 15 tuổi trở lên, hàm sẽ trả về ageLower = 15.
• Nếu bạn đặt 2 độ 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 dùng từ 17 tuổi trở lên sẽ nhận được giá trị 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ẻ từ 11 đến 12 tuổi sẽ trả về ageLower = 11 và ageUpper = 12.
  • Trẻ từ 13 đến 14 tuổi sẽ nhận được ageLower = 13 và ageUpper = 14.
  • Nếu người dùng từ 15 tuổi trở lên, hàm sẽ trả về ageLower = 15.

Trường phản hồi của tín hiệu về độ 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.

Ví dụ 1

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

• 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.

Ví dụ 2

Đối với người dùng là người lớn đã khai báo tuổi (tự khai báo) và chia sẻ tuổi với các ứng dụng, bạn sẽ nhận được những 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ụ 3

Đối với người dùng là trẻ vị thành niên được giám sát và có độ tuổi do người giám hộ quản lý, đồng thời người giám hộ đã chia sẻ độ tuổi đó với các ứng dụ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).
• Các trường phản hồi khác là null.

Ví dụ 4

Đối với người dùng chưa đồng ý (hoặc cha mẹ của người dùng chưa đồng ý) chia sẻ độ tuổi, bạn sẽ nhận được thông báo sau:

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

Ví dụ 5

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

• 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.

Ví dụ 6

Đối với người dùng là trẻ vị thành niên được giám sát và có độ tuổi do người giám hộ quản lý, khi có một thay đổi quan trọng đã được phê duyệt và tính năng theo dõi lượt 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à một giá trị nhận dạng chuỗi (ví dụ: "abc123xyz789").