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.
- Vai alla pagina Indicatori dell'età in Play Console.
- 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.
- 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 = 0eageUpper = 14. - Per un utente di età superiore ai 15 anni, verrà restituito
ageLower = 15.
- Per un'età compresa tra 0 e 14 anni, verranno restituiti
- Se imposti due età minime (13 e 17 anni):
- Per un bambino di età compresa tra 0 e 12 anni, restituirà
ageLower = 0eageUpper = 12. - Per un utente di età compresa tra 13 e 16 anni, verranno restituiti
ageLower = 13eageUpper = 16. - Un utente di età superiore ai 17 anni restituirà
ageLower = 17.
- Per un bambino di età compresa tra 0 e 12 anni, restituirà
- Se imposti tre età minime (11, 13 e 15 anni):
- Per un'età compresa tra 0 e 10 anni, verranno restituiti
ageLower = 0eageUpper = 10. - Un bambino di 11 o 12 anni restituirà
ageLower = 11eageUpper = 12. - Un utente di 13 o 14 anni restituirà
ageLower = 13eageUpper = 14. - Un utente di età superiore ai 15 anni restituirà
ageLower = 15.
- Per un'età compresa tra 0 e 10 anni, verranno restituiti
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 |
|
|
| ageLower | Numero intero |
|
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 |
|
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 |
|
Questo metodo restituisce un valore non nullo solo nelle giurisdizioni in cui sono applicabili modifiche significative.
|
| significantChangeApprovalDate | Data |
|
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 |
|
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 anull.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").