Interpretowanie odpowiedzi na sygnały dotyczące wieku

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.

  1. W Konsoli Play otwórz stronę Sygnały dotyczące wieku.
  2. 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.
  3. 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 = 0 i ageUpper = 14.
    • W przypadku osoby, która ma co najmniej 15 lat, zwrócona zostanie wartość ageLower = 15.
  • Jeśli ustawisz 2 minimalne progi wiekowe (13 i 17 lat):
    • W przypadku dziecka w wieku od 0 do 12 lat zwróci ageLower = 0 i ageUpper = 12.
    • W przypadku dziecka w wieku 13–16 lat zwrócone zostaną wartości ageLower = 13 i ageUpper = 16.
    • W przypadku osoby, która ma co najmniej 17 lat, zwróci wartość ageLower = 17.
  • 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 = 0 i ageUpper = 10.
    • W przypadku 11- lub 12-latka zwrócone zostaną wartości ageLower = 11 i ageUpper = 12.
    • W przypadku 13- lub 14-latka zwrócone zostaną wartości ageLower = 13 i ageUpper = 14.
    • W przypadku osoby, która ma co najmniej 15 lat, zwrócona zostanie wartość ageLower = 15.

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
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: użytkownik podał Google informacje o swoim wieku. Google może, ale nie musi, potwierdzić te informacje.
  • TIER_B: wiek użytkownika jest zarządzany przez rodzica lub opiekuna.
  • TIER_C*: wiek użytkownika jest oceniany na podstawie karty kredytowej, adresu e-mail, oceny selfie, dokumentu tożsamości lub identyfikatora podatkowego.
  • TIER_D*: wiek użytkownika jest sprawdzany na podstawie dokumentu tożsamości i oceny selfie lub cyfrowego dokumentu tożsamości.
  • null: zwracana, gdy ageSignalsStatus ma wartość NOT_SHARED lub VERIFICATION_REQUIRED.
* Zwracane tylko w regionach objętych regulacjami, w których weryfikacja wieku jest obowiązkowa (np. US-TX).
ageLower Liczba całkowita
  • 0–18
  • null
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
  • 2–18
  • null
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
  • ZATWIERDZONY
  • OCZEKUJE
  • ODRZUCONO
  • null
Zwraca wartość inną niż null tylko w jurysdykcjach, w których obowiązują istotne zmiany.
  • ZATWIERDZONO: najnowsza istotna zmiana (oraz wszystkie wcześniejsze zmiany) została zatwierdzona.
  • OCZEKUJE: rodzic nie zatwierdził jeszcze co najmniej 1 oczekującej istotnej zmiany.
  • DECLINED: rodzice nie zatwierdzili co najmniej jednej istotnej zmiany.
  • null: zwracana w przypadku:
    • Wszystkie konta nienadzorowane
    • Konta nadzorowane, na których nie zarejestrowano jeszcze żadnych istotnych zmian.
significantChangeApprovalDate Data
  • DateStamp
  • null
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
  • Alfanumeryczne
  • null
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.
    • ageLower to liczba (np. 18).
    • Obecny stan „ageUpper”: null.
    • Inne pola odpowiedzi to null.
  • W pozostałych regionach:

    • Obecny stan „ageRangeSource”: AgeRangeSource.TIER_A.
    • ageLower to liczba (np. 18).
    • Obecny stan „ageUpper”: null.
    • Inne pola odpowiedzi to null.

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.
    • ageLower to liczba (np. 18).
    • Obecny stan „ageUpper”: null.
    • Inne pola odpowiedzi to null
  • W pozostałych regionach:

    • Obecny stan „ageRangeSource”: AgeRangeSource.TIER_A.
    • ageLower to liczba (np. 18).
    • Obecny stan „ageUpper”: null.
    • Inne pola odpowiedzi to null.

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.
  • ageLower to 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.
  • ageLower to liczba (np. 13).
  • ageUpper to 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.
  • ageLower to liczba (np. 13).
  • ageUpper to liczba (np. 15).
  • Obecny stan „significantChangeStatus”: SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate to data (np. „2026-01-15”).
  • installId to identyfikator w postaci ciągu znaków (np. „abc123xyz789”).