W tym dokumencie wyjaśniamy odpowiedzi na sygnały dotyczące wieku zwracane przez interfejs Play Age Signals API.
(Opcjonalnie) Otrzymywanie niestandardowych przedziałów wiekowych
Domyślne przedziały wiekowe zwracane przez interfejs API to 0-12, 13-15, 16-17 i 18+.
Możesz też dostosować domyślne przedziały wiekowe do minimalnego wieku użytkowników Twojej aplikacji, podając te minimalne progi wiekowe na stronie Sygnały dotyczące wieku w Konsoli Google Play.
- W Konsoli Play otwórz stronę Sygnały dotyczące wieku.
- Na karcie Niestandardowe przedziały wiekowe wpisz maksymalnie 3 minimalne progi wiekowe dla aplikacji. Muszą się one różnić o co najmniej 2 lata i można je zmienić raz na rok.
- Kliknij Zapisz.
Zwrócone przedziały wiekowe zastąpią domyślną odpowiedź interfejsu API. Przykład:
- Jeśli w Konsoli Google Play ustawisz jeden minimalny wiek (15 lat):
- W przypadku dziecka w wieku od 0 do 14 lat zwrócone zostaną wartości
ageLower = 0iageUpper = 14. - W przypadku osoby, która ma co najmniej 15 lat, zwrócona zostanie wartość
ageLower = 15.
- W przypadku dziecka w wieku od 0 do 14 lat zwrócone zostaną wartości
- Jeśli ustawisz 2 minimalne progi wiekowe (13 i 17 lat):
- W przypadku dziecka w wieku od 0 do 12 lat zwróci
ageLower = 0iageUpper = 12. - W przypadku dziecka w wieku 13–16 lat zwrócone zostaną wartości
ageLower = 13iageUpper = 16. - W przypadku osoby, która ma co najmniej 17 lat, zwróci wartość
ageLower = 17.
- W przypadku dziecka w wieku od 0 do 12 lat zwróci
- Jeśli ustawisz 3 minimalne progi wiekowe (11, 13 i 15 lat):
- W przypadku dziecka w wieku od 0 do 10 lat zwrócone zostaną wartości
ageLower = 0iageUpper = 10. - W przypadku 11- lub 12-latka zwrócone zostaną wartości
ageLower = 11iageUpper = 12. - W przypadku 13- lub 14-latka zwrócone zostaną wartości
ageLower = 13iageUpper = 14. - W przypadku osoby, która ma co najmniej 15 lat, zwrócona zostanie wartość
ageLower = 15.
- W przypadku dziecka w wieku od 0 do 10 lat zwrócone zostaną wartości
Pola odpowiedzi sygnałów dotyczących wieku
Odpowiedź interfejsu Play Age Signals API (beta) zawiera te pola i wartości. Twoim obowiązkiem jest dostarczanie treści dostosowanych do wieku odbiorcy na podstawie tych sygnałów.
| Pole odpowiedzi | Typ | Wartości | Opis |
|---|---|---|---|
| ageRangeSource | Typ wyliczeniowy |
|
|
| ageLower | Liczba całkowita |
|
Dolna granica przedziału wiekowego użytkownika (włącznie). Połącz go z atrybutem ageUpper, aby określić przedział.
Zwraca wartość null, jeśli ageSignalsStatus ma wartość NOT_SHARED lub VERIFICATION_REQUIRED. |
| ageUpper | Liczba całkowita |
|
Górna granica przedziału wiekowego użytkownika (włącznie).
Zwraca wartość null w przypadku najwyższego przedziału (np. 18+) lub gdy ageSignalsStatus ma wartość NOT_SHARED lub VERIFICATION_REQUIRED. |
| significantChangeStatus | Typ wyliczeniowy |
|
Zwraca wartość inną niż null tylko w jurysdykcjach, w których obowiązują istotne zmiany.
|
| significantChangeApprovalDate | Data |
|
Data wejścia w życie ostatniej zatwierdzonej istotnej zmiany. Zatwierdzane są też wszystkie zmiany z datami wejścia w życie wcześniejszymi niż ta data. Jeśli nie ma żadnych zmian, zwraca wartość null.
Połącz go z parametrem `significantChangeStatus`, aby uzyskać stan zatwierdzenia tej istotnej zmiany. |
| installId | Ciąg znaków |
|
Identyfikator przypisany przez Google Play do instalacji nadzorowanego użytkownika, używany do powiadamiania o cofnięciu zatwierdzenia aplikacji. Zapoznaj się z dokumentacją dotyczącą unieważnionych zatwierdzeń aplikacji. |
Przykład 1
W przypadku dorosłego użytkownika, który potwierdził swój wiek za pomocą cyfrowego dokumentu tożsamości, otrzymasz te informacje:
W regionie objętym dodatkowymi przepisami, w którym weryfikacja wieku jest obowiązkowa:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_D. ageLowerto liczba (np. 18).- Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null.
- Obecny stan „
W pozostałych regionach:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_A. ageLowerto liczba (np. 18).- Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null.
- Obecny stan „
Przykład 2
W przypadku dorosłego użytkownika, który potwierdził swój wiek za pomocą metod szacowania wieku (takich jak ocena selfie, karta kredytowa lub identyfikator podatkowy), otrzymasz te informacje:
W regionie objętym dodatkowymi przepisami, w którym weryfikacja wieku jest obowiązkowa:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_C. ageLowerto liczba (np. 18).- Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null
- Obecny stan „
W pozostałych regionach:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_A. ageLowerto liczba (np. 18).- Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null.
- Obecny stan „
Przykład 3
W przypadku użytkownika, który znajduje się w regionie, gdzie weryfikacja wieku nie jest obowiązkowa, i udostępnia te informacje aplikacjom, otrzymasz:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_A. ageLowerto liczba (np. 18).- Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null.
Przykład 4
W przypadku nadzorowanego nieletniego użytkownika, którego wiek jest zarządzany przez opiekuna, który udostępnił go aplikacjom, otrzymasz te informacje:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_B. ageLowerto liczba (np. 13).ageUpperto liczba (np. 15).- Inne pola odpowiedzi to
null.
Przykład 5
W przypadku użytkownika, który nie wyraził zgody (lub którego rodzic nie wyraził zgody) na udostępnianie wieku w regionie, w którym weryfikacja wieku nie jest obowiązkowa, otrzymasz te informacje:
- Obecny stan „
ageRangeSource”:null. - Obecny stan „
ageLower”:null. - Obecny stan „
ageUpper”:null. - Inne pola odpowiedzi to
null.
Przykład 6
W przypadku nadzorowanego nieletniego użytkownika, którego wiekiem zarządza opiekun, z zatwierdzoną istotną zmianą i aktywnymi instalacjami otrzymasz:
- Obecny stan „
ageRangeSource”:AgeRangeSource.TIER_B. ageLowerto liczba (np. 13).ageUpperto liczba (np. 15).- Obecny stan „
significantChangeStatus”:SignificantChangeStatus.APPROVED. significantChangeApprovalDateto data (np. „2026-01-15”).installIdto identyfikator w postaci ciągu znaków (np. „abc123xyz789”).