Comprendere le risposte dell'API Age Signals

Questo documento spiega le risposte dell'indicatore di età restituite dall'API Play Age Signals.

(Facoltativo) Ricevi fasce d'età personalizzate

Gli intervalli di età predefiniti restituiti dall'API sono 0-12, 13-15, 16-17 e 18+.

In alternativa, per personalizzare le fasce d'età predefinite in base alle età minime della tua app, puoi indicarle 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 distanti almeno 2 anni e possono essere modificate una volta all'anno.
  3. Fai clic su Salva.

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

  • Se imposti un'età minima (15 anni) in Google Play Console:
    • Un bambino di età compresa tra 0 e 14 anni restituirà ageLower = 0 e ageUpper = 14.
    • Una persona di età superiore a 15 anni restituirà ageLower = 15.
  • Se imposti due età minime (13 e 17 anni):
    • Un bambino di età compresa tra 0 e 12 anni restituirà ageLower = 0 e ageUpper = 12.
    • Un utente di età compresa tra 13 e 16 anni restituirà ageLower = 13 e ageUpper = 16.
    • Una persona di età superiore a 17 anni restituirà ageLower = 17.
  • Se imposti tre età minime (11, 13 e 15 anni):
    • Un bambino di età compresa tra 0 e 10 anni restituirà ageLower = 0 e ageUpper = 10.
    • Un bambino di 11 o 12 anni restituirà ageLower = 11 e ageUpper = 12.
    • Un ragazzo di 13 o 14 anni restituirà ageLower = 13 e ageUpper = 14.
    • Una persona di età superiore a 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 dichiarato la propria età.
  • TIER_B: l'età dell'utente è gestita da un genitore o 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 oppure un documento di identità digitale.
  • null: restituito quando ageSignalsStatus è NOT_SHARED o VERIFICATION_REQUIRED.
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
 Restituisce un valore non nullo solo nelle giurisdizioni in cui sono applicabili modifiche significative.
  • APPROVATO: 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. Vengono approvate anche tutte le modifiche con date di validità precedenti a questa data. 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 comunicarti l'approvazione revocata dell'app. Consulta la documentazione relativa alle approvazioni delle app revocate.

Esempio 1

Per un utente che ha verificato la propria età utilizzando il documento d'identità digitale e lo condivide con le app, ricevi quanto segue:

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

Esempio 2

Per un utente adulto che ha dichiarato la propria età (autodichiarazione) e la condivide con le app, ricevi quanto segue:

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

Esempio 3

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 di risposta sono null.

Esempio 4

Per un utente che non ha acconsentito (o il cui genitore non ha acconsentito) alla condivisione dell'età, ricevi quanto segue:

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

Esempio 5

Per un utente adulto con un'età stimata verificata tramite metodi di stima dell'età (come la valutazione del selfie, la carta di credito o l'ID fiscale) che la condivide con le app, ricevi quanto segue:

  • ageRangeSource: AgeRangeSource.TIER_C.
  • ageLower è un numero (ad esempio, 18).
  • ageUpper: null.
  • Gli altri campi di 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").
Indietro
Richiedere indicatori dell'età
Avanti
Testare gli indicatori dell'età