Dokumen ini menjelaskan respons sinyal usia yang ditampilkan oleh Play Age Signals API.
(Opsional) Menerima rentang usia kustom
Rentang usia default yang ditampilkan API adalah 0-12, 13-15,
16-17, dan 18+.
Atau, untuk menyesuaikan rentang usia default sesuai dengan usia minimum aplikasi, Anda dapat memberikan usia minimum ini untuk aplikasi di halaman Sinyal usia di Konsol Google Play.
- Buka halaman Sinyal usia di Konsol Play.
- Di tab Rentang usia kustom, masukkan hingga tiga usia minimum untuk aplikasi Anda. Usia minimum harus memiliki selisih setidaknya 2 tahun dan dapat diubah sekali setahun.
- Klik Simpan.
Rentang usia yang ditampilkan akan menggantikan respons API default. Contoh:
- Jika Anda menetapkan satu usia minimum (15) di Konsol Google Play:
- Anak berusia 0 hingga 14 tahun akan menampilkan
ageLower = 0danageUpper = 14. - Anak berusia 15 tahun ke atas akan menampilkan
ageLower = 15.
- Anak berusia 0 hingga 14 tahun akan menampilkan
- Jika Anda menetapkan dua usia minimum (13 dan 17 tahun):
- Anak berusia 0 hingga 12 tahun akan menampilkan
ageLower = 0danageUpper = 12. - Anak berusia 13 hingga 16 tahun akan menampilkan
ageLower = 13danageUpper = 16. - Pengguna berusia 17 tahun ke atas akan menampilkan
ageLower = 17.
- Anak berusia 0 hingga 12 tahun akan menampilkan
- Jika Anda menetapkan tiga usia minimum (11, 13, dan 15):
- Anak berusia 0 hingga 10 tahun akan menampilkan
ageLower = 0danageUpper = 10. - Anak berusia 11 atau 12 tahun akan menampilkan
ageLower = 11danageUpper = 12. - Anak berusia 13 atau 14 tahun akan menampilkan
ageLower = 13danageUpper = 14. - Anak berusia 15 tahun ke atas akan menampilkan
ageLower = 15.
- Anak berusia 0 hingga 10 tahun akan menampilkan
Kolom respons sinyal usia
Respons Play Age Signals API (beta) mencakup kolom dan nilai berikut. Anda bertanggung jawab untuk memberikan pengalaman sesuai usia menggunakan sinyal ini.
| Kolom respons | Jenis | Nilai | Deskripsi |
|---|---|---|---|
| ageRangeSource | Enum |
|
|
| ageLower | Bilangan Bulat |
|
Batas bawah inklusif rentang usia pengguna. Gabungkan dengan ageUpper untuk menentukan rentang.
Menampilkan null jika ageSignalsStatus adalah NOT_SHARED atau VERIFICATION_REQUIRED. |
| ageUpper | Bilangan Bulat |
|
Batas atas inklusif rentang usia pengguna.
Menampilkan null untuk rentang tertinggi (misalnya, 18+) atau jika ageSignalsStatus adalah NOT_SHARED atau VERIFICATION_REQUIRED. |
| significantChangeStatus | Enum |
|
Ini hanya menampilkan nilai bukan null di wilayah hukum tempat perubahan signifikan berlaku.
|
| significantChangeApprovalDate | Tanggal |
|
Tanggal mulai berlaku perubahan signifikan yang terakhir disetujui. Semua perubahan dengan tanggal mulai berlaku sebelum tanggal ini juga disetujui. Menampilkan null jika tidak ada perubahan.
Gabungkan dengan `significantChangeStatus` untuk mendapatkan status persetujuan untuk perubahan signifikan ini |
| installId | String |
|
ID yang ditetapkan untuk penginstalan pengguna yang diawasi oleh Google Play, yang digunakan untuk tujuan memberi tahu Anda tentang persetujuan aplikasi yang dicabut. Tinjau dokumentasi untuk persetujuan aplikasi yang dicabut. |
Contoh 1
Untuk pengguna dewasa yang memverifikasi usianya menggunakan Tanda Pengenal Digital, Anda akan menerima hal berikut:
Di wilayah dengan aturan khusus yang mewajibkan verifikasi usia:
ageRangeSourceAgeRangeSource.TIER_D.ageLoweradalah angka (misalnya, 18).ageUppernull.- Kolom respons lainnya adalah
null.
Wilayah lainnya:
ageRangeSourceAgeRangeSource.TIER_A.ageLoweradalah angka (misalnya, 18).ageUppernull.- Kolom respons lainnya adalah
null.
Contoh 2
Untuk pengguna dewasa yang memverifikasi usianya menggunakan metode estimasi usia (seperti penilaian selfie, kartu kredit, atau Nomor Pajak), Anda akan menerima hal berikut:
Di wilayah dengan aturan khusus yang mewajibkan verifikasi usia:
ageRangeSourceAgeRangeSource.TIER_C.ageLoweradalah angka (misalnya, 18).ageUppernull.- Kolom respons lainnya adalah
null
Wilayah lainnya:
ageRangeSourceAgeRangeSource.TIER_A.ageLoweradalah angka (misalnya, 18).ageUppernull.- Kolom respons lainnya adalah
null.
Contoh 3
Untuk pengguna yang berada di wilayah tempat verifikasi usia tidak wajib dan membagikannya kepada aplikasi, Anda akan menerima hal berikut:
ageRangeSourceAgeRangeSource.TIER_A.ageLoweradalah angka (misalnya, 18).ageUppernull.- Kolom respons lainnya adalah
null.
Contoh 4
Untuk pengguna di bawah umur yang diawasi dan usianya dikelola oleh wali yang telah membagikannya ke aplikasi, Anda akan menerima hal berikut:
ageRangeSourceAgeRangeSource.TIER_B.ageLoweradalah angka (misalnya, 13).ageUpperadalah angka (misalnya, 15).- Kolom respons lainnya adalah
null.
Contoh 5
Untuk pengguna yang belum menyetujui (atau yang orang tuanya belum menyetujui) berbagi usia di wilayah yang tidak mewajibkan verifikasi usia, Anda akan menerima hal berikut:
ageRangeSourcenull.ageLowernull.ageUppernull.- Kolom respons lainnya adalah
null.
Contoh 6
Untuk pengguna di bawah umur yang diawasi dan usianya dikelola oleh wali, dengan perubahan signifikan yang disetujui dan pelacakan penginstalan aktif, Anda akan menerima hal berikut:
ageRangeSourceAgeRangeSource.TIER_B.ageLoweradalah angka (misalnya, 13).ageUpperadalah angka (misalnya, 15).significantChangeStatusSignificantChangeStatus.APPROVED.significantChangeApprovalDateadalah Tanggal (misalnya, "2026-01-15").installIdadalah ID string (misalnya, "abc123xyz789").