Comprendere le risposte dell'API Age Signals

Questo documento spiega le risposte relative agli indicatori di età restituite dall'API Play Age Signals.

(Facoltativo) Ricevi fasce d'età personalizzate

Le fasce d'età predefinite restituite dall'API sono 0-12, 13-15, 16-17 e 18+.

In alternativa, puoi personalizzare le fasce d'età predefinite in base alle età minime della tua app indicandole nella pagina Indicatori dell'età di Google Play Console.

  1. Vai alla pagina Indicatori dell'età in Play Console.
  2. Nella scheda Fasce d'età personalizzate, inserisci fino a tre età minime per la tua app. Le età minime devono essere separate da almeno 2 anni e possono essere modificate una volta all'anno.
  3. Fai clic su Salva.

Le fasce d'età restituite sostituiranno la risposta dell'API predefinita. Ad esempio:

  • Se imposti un'età minima (15 anni) in Google Play Console:
    • Per un'età compresa tra 0 e 14 anni, verranno restituiti ageLower = 0 e ageUpper = 14.
    • Per un utente di età superiore ai 15 anni, verrà restituito ageLower = 15.
  • Se imposti due età minime (13 e 17 anni):
    • Per un bambino di età compresa tra 0 e 12 anni, restituirà ageLower = 0 e ageUpper = 12.
    • Per un utente di età compresa tra 13 e 16 anni, verranno restituiti ageLower = 13 e ageUpper = 16.
    • Un utente di età superiore ai 17 anni restituirà ageLower = 17.
  • Se imposti tre età minime (11, 13 e 15 anni):
    • Per un'età compresa tra 0 e 10 anni, verranno restituiti ageLower = 0 e ageUpper = 10.
    • Un bambino di 11 o 12 anni restituirà ageLower = 11 e ageUpper = 12.
    • Un utente di 13 o 14 anni restituirà ageLower = 13 e ageUpper = 14.
    • Un utente di età superiore ai 15 anni restituirà ageLower = 15.

Campi di risposta dell'API Age Signals

La risposta dell'API Play Age Signals (beta) include i seguenti campi e valori. È tua responsabilità fornire esperienze adatte all'età utilizzando questi indicatori.

Campo di risposta Tipo Valori Descrizione
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: l'utente ha fornito a Google le informazioni sulla sua età. Google potrebbe aver confermato o meno queste informazioni.
  • TIER_B: l'età dell'utente è gestita da un genitore o da un tutore.
  • TIER_C*: l'età dell'utente viene valutata utilizzando la carta di credito, l'indirizzo email, la valutazione del selfie, il documento di identità ufficiale o l'ID fiscale.
  • TIER_D*: l'età dell'utente viene verificata utilizzando una combinazione di documento di identità ufficiale e valutazione del selfie o un documento di identità digitale.
  • null: restituito quando ageSignalsStatus è NOT_SHARED o VERIFICATION_REQUIRED.
* Restituito solo nelle regioni regolamentate in cui la verifica dell'età è obbligatoria (ad esempio, US-TX).
ageLower Numero intero
  • 0 to 18
  • null
Il limite inferiore inclusivo della fascia d'età dell'utente. Combinalo con ageUpper per determinare la fascia.

Restituisce null se ageSignalsStatus è NOT_SHARED o VERIFICATION_REQUIRED.

ageUpper Numero intero
  • 2 to 18
  • null
Il limite superiore inclusivo della fascia d'età dell'utente.

Restituisce null per la fascia più alta (ad esempio, 18+) o se ageSignalsStatus è NOT_SHARED o VERIFICATION_REQUIRED.

significantChangeStatus Enum
  • APPROVATO
  • IN ATTESA
  • RIFIUTATO
  • null
Questo metodo restituisce un valore non nullo solo nelle giurisdizioni in cui sono applicabili modifiche significative.
  • APPROVED: la modifica significativa più recente (e tutte le modifiche precedenti) è stata approvata.
  • PENDING: il genitore non ha ancora approvato una o più modifiche significative in attesa.
  • DECLINED: i genitori hanno negato l'approvazione per una o più modifiche significative.
  • null: restituito per:
    • Tutti gli account non supervisionati
    • Account supervisionati per i quali non sono ancora state registrate modifiche significative.
significantChangeApprovalDate Data
  • DateStamp
  • null
La data di validità della modifica significativa approvata più di recente. Anche tutte le modifiche con date di validità precedenti a questa data sono approvate. Restituisce null se non esistono modifiche.

Combinalo con "significantChangeStatus" per ottenere lo stato di approvazione di questa modifica significativa

installId Stringa
  • Alfanumerico
  • null
Un ID assegnato alle installazioni degli utenti supervisionati da Google Play, utilizzato per informarti della revoca dell'approvazione dell'app. Consulta la documentazione relativa alle approvazioni delle app revocate.

Esempio 1

Per un utente adulto che ha verificato la propria età utilizzando un documento di identità digitale, ricevi quanto segue:

  • In una regione regolamentata in cui la verifica dell'età è obbligatoria:

    • ageRangeSource: AgeRangeSource.TIER_D.
    • ageLower è un numero (ad esempio, 18).
    • ageUpper: null.
    • Gli altri campi della risposta sono null.
  • In tutti gli altri continenti:

    • ageRangeSource: AgeRangeSource.TIER_A.
    • ageLower è un numero (ad esempio, 18).
    • ageUpper: null.
    • Gli altri campi della risposta sono null.

Esempio 2

Per un utente adulto che ha verificato la propria età utilizzando metodi di stima dell'età (ad esempio valutazione del selfie, carta di credito o ID fiscale), ricevi quanto segue:

  • In una regione regolamentata in cui la verifica dell'età è obbligatoria:

    • ageRangeSource: AgeRangeSource.TIER_C.
    • ageLower è un numero (ad esempio, 18).
    • ageUpper: null.
    • Altri campi di risposta sono null
  • In tutti gli altri continenti:

    • ageRangeSource: AgeRangeSource.TIER_A.
    • ageLower è un numero (ad esempio, 18).
    • ageUpper: null.
    • Gli altri campi della risposta sono null.

Esempio 3

Per un utente che si trova in una regione in cui la verifica dell'età non è obbligatoria e la condivide con le app, ricevi quanto segue:

  • ageRangeSource: AgeRangeSource.TIER_A.
  • ageLower è un numero (ad esempio, 18).
  • ageUpper: null.
  • Gli altri campi della risposta sono null.

Esempio 4

Per un utente minorenne supervisionato la cui età è gestita da un tutore che l'ha condivisa con le app, ricevi quanto segue:

  • ageRangeSource: AgeRangeSource.TIER_B.
  • ageLower è un numero (ad esempio, 13).
  • ageUpper è un numero (ad esempio, 15).
  • Gli altri campi della risposta sono null.

Esempio 5

Per un utente che non ha accettato (o il cui genitore non ha accettato) la condivisione dell'età in una regione in cui la verifica dell'età non è obbligatoria, ricevi quanto segue:

  • ageRangeSource: null.
  • ageLower è pari a null.
  • ageUpper: null.
  • Gli altri campi della risposta sono null.

Esempio 6

Per un utente minorenne supervisionato la cui età è gestita da un tutore, con una modifica significativa approvata e il monitoraggio delle installazioni attivo, ricevi quanto segue:

  • ageRangeSource: AgeRangeSource.TIER_B.
  • ageLower è un numero (ad esempio, 13).
  • ageUpper è un numero (ad esempio, 15).
  • significantChangeStatus: SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate è una data (ad esempio, "2026-01-15").
  • installId è un identificatore di stringa (ad esempio, "abc123xyz789").