Interpretowanie odpowiedzi na sygnały dotyczące wieku

Z tego dokumentu dowiesz się, jakie odpowiedzi na sygnały dotyczące wieku zwraca 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. Otwórz stronę Sygnały dotyczące wieku w Konsoli Play.
  2. Na karcie Niestandardowe zakresy wiekowe wpisz maksymalnie 3 minimalne progi wiekowe dla swojej aplikacji. Muszą one różnić się 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 osoby w wieku od 0 do 14 lat funkcja zwróci wartości ageLower = 0 i ageUpper = 14.
    • Osoba w wieku 15 lat lub starsza otrzyma ageLower = 15.
  • Jeśli ustawisz 2 minimalne wieki (13 i 17 lat):
    • W przypadku dziecka w wieku od 0 do 12 lat zwraca wartości ageLower = 0 i ageUpper = 12.
    • Osoba w wieku 13–16 lat otrzyma ageLower = 13 i ageUpper = 16.
    • Osoba powyżej 17 roku życia otrzyma zwrot w wysokości ageLower = 17.
  • Jeśli ustawisz 3 minimalne progi wiekowe (11, 13 i 15 lat):
    • W przypadku dziecka w wieku od 0 do 10 lat zwracane są wartości ageLower = 0 i ageUpper = 10.
    • W przypadku 11- lub 12-latka funkcja zwróci wartości ageLower = 11 i ageUpper = 12.
    • Osoba w wieku 13 lub 14 lat otrzyma ageLower = 13 i ageUpper = 14.
    • Osoba w wieku 15 lat lub starsza otrzyma 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 użytkowników 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 sam zadeklarował swój wiek.
  • TIER_B: wiek użytkownika jest zarządzany przez rodzica lub opiekuna.
  • TIER_C: wiek użytkownika jest określany na podstawie karty kredytowej, adresu e-mail, selfie, dokumentu tożsamości wydanego przez organ państwowy lub numeru identyfikacji podatkowej.
  • TIER_D: wiek użytkownika jest sprawdzany na podstawie dokumentu tożsamości wydanego przez organ państwowy i oceny selfie lub cyfrowego dokumentu tożsamości.
  • null: zwracana, gdy wartość ageSignalsStatus to NOT_SHARED lub VERIFICATION_REQUIRED.
ageLower Liczba całkowita
  • 0–18
  • null
 Dolna granica przedziału wiekowego użytkownika (włącznie). Połącz go z parametrem 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 jeśli wartość ageSignalsStatus to 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 (i wszystkie poprzednie zmiany) została zatwierdzona.
  • OCZEKUJE: rodzic nie zatwierdził jeszcze co najmniej jednej oczekującej istotnej zmiany.
  • DECLINED: rodzice odrzucili zatwierdzenie co najmniej jednej istotnej zmiany.
  • null: zwracany w przypadku:
    • Wszystkie nienadzorowane konta
    • Konta nadzorowane, na których nie odnotowano jeszcze żadnych istotnych zmian.
significantChangeApprovalDate Data
  • DateStamp
  • null
 Data wejścia w życie ostatniej zatwierdzonej istotnej zmiany. Zatwierdzane są też wszystkie zmiany z datą wejścia w życie wcześniejszą 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 do instalacji użytkownika nadzorowanego przez Google Play, używany do powiadamiania Cię o cofnięciu zatwierdzenia aplikacji. Zapoznaj się z dokumentacją dotyczącą cofniętych zatwierdzeń aplikacji.

Przykład 1

W przypadku użytkownika, który potwierdził swój wiek za pomocą cyfrowego dokumentu tożsamości i udostępnia go aplikacjom, otrzymasz te informacje:

  • Obecny stan „ageRangeSource”: AgeRangeSource.TIER_D.
  • ageLower to liczba (np. 18).
  • Obecny stan „ageUpper”: null.
  • Pozostałe pola odpowiedzi to null.

Przykład 2

W przypadku dorosłego użytkownika, który zadeklarował swój wiek (samodzielnie) i udostępnia go aplikacjom, otrzymujesz te informacje:

  • 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 nadzorowanego użytkownika, który jest osobą niepełnoletnią, a jego 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 4

W przypadku użytkownika, który nie wyraził zgody na udostępnianie wieku (lub którego rodzic nie wyraził na to zgody), otrzymasz te informacje:

  • Obecny stan „ageRangeSource”: null.
  • Obecny stan „ageLower”: null.
  • Obecny stan „ageUpper”: null.
  • Inne pola odpowiedzi to null.

Przykład 5

W przypadku dorosłego użytkownika, którego wiek został zweryfikowany za pomocą metod szacowania wieku (np. na podstawie selfie, karty kredytowej lub numeru identyfikacji podatkowej) i który udostępnia go aplikacjom, otrzymasz te informacje:

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

Przykład 6

W przypadku nadzorowanego użytkownika, którego wiekiem zarządza opiekun, z zatwierdzoną istotną zmianą i aktywnym śledzeniem instalacji 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”).
Wstecz
Żądanie sygnałów dotyczących wieku
Dalej
Testowanie sygnałów dotyczących wieku