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.
- Chuyển đến trang Dấu hiệu về độ tuổi trong Play Console.
- 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.
- 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 = 0vàageUpper = 14. - Người từ 15 tuổi trở lên sẽ trả về
ageLower = 15.
- Trẻ từ 0 đến 14 tuổi sẽ trả về
- 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 = 0vàageUpper = 12. - Trẻ từ 13 đến 16 tuổi sẽ trả về
ageLower = 13vàageUpper = 16. - Người từ 17 tuổi trở lên sẽ trả về
ageLower = 17.
- Trẻ từ 0 đến 12 tuổi sẽ trả về
- 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 = 0vàageUpper = 10. - Trẻ 11 hoặc 12 tuổi sẽ trả về
ageLower = 11vàageUpper = 12. - Trẻ 13 hoặc 14 tuổi sẽ trả về
ageLower = 13vàageUpper = 14. - Người từ 15 tuổi trở lên sẽ trả về
ageLower = 15.
- Trẻ từ 0 đến 10 tuổi sẽ trả về
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 |
|
|
| ageLower | Số nguyên |
|
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 |
|
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 |
|
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.
|
| significantChangeApprovalDate | Ngày |
|
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 |
|
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:
ageRangeSourcelàAgeRangeSource.TIER_D.ageLowerlà một số (ví dụ: 18).ageUpperlànull.- Các trường phản hồi khác là
null.
Mọi nơi khác:
ageRangeSourcelàAgeRangeSource.TIER_A.ageLowerlà một số (ví dụ: 18).ageUpperlà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:
ageRangeSourcelàAgeRangeSource.TIER_C.ageLowerlà một số (ví dụ: 18).ageUpperlànull.- Các trường phản hồi khác là
null
Mọi nơi khác:
ageRangeSourcelàAgeRangeSource.TIER_A.ageLowerlà một số (ví dụ: 18).ageUpperlà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:
ageRangeSourcelàAgeRangeSource.TIER_A.ageLowerlà một số (ví dụ: 18).ageUpperlà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:
ageRangeSourcelàAgeRangeSource.TIER_B.ageLowerlà một số (ví dụ: 13).ageUpperlà 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:
ageRangeSourcelànull.ageLowerlànull.ageUpperlà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:
ageRangeSourcelàAgeRangeSource.TIER_B.ageLowerlà một số (ví dụ: 13).ageUpperlà một số (ví dụ: 15).significantChangeStatuslàSignificantChangeStatus.APPROVED.significantChangeApprovalDatelà một Ngày (ví dụ: "2026-01-15").installIdlà giá trị nhận dạng chuỗi (ví dụ: "abc123xyz789").