Utilizzare l'API Play Age Signals (beta)

Utilizzando l'API Play Age Signals (beta), accetti i Termini di servizio e ti impegni a rispettare tutte le Norme per gli sviluppatori di Google Play. Per richiedere lo stato e la fascia d'età dell'utente, chiami l'API dalla tua app in fase di runtime. L'API Play Age Signals restituisce dati solo per gli utenti che si trovano in regioni in cui Play è tenuto per legge a fornire dati sulle categorie di età.

Play restituisce una fascia d'età in base alle fasce d'età definite dalle giurisdizioni e dalle regioni applicabili. Le età predefinite restituite dall'API nelle giurisdizioni e nelle regioni applicabili sono 0-12, 13-15, 16-17 e 18+, ma possono variare in base ai requisiti regionali.

Integrare l'API Play Age Signals nella tua app

Per integrare l'API Play Age Signals nella tua app, aggiungi la seguente dipendenza al file build.gradle dell'app:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

Richiedere indicatori dell'età

Ecco un esempio di come effettuare una richiesta di indicatori dell'età:

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

Gli indicatori dell'età vengono memorizzati da Google Play sul dispositivo per ogni utente. Quando un utente con un Account Google supervisionato entra in una nuova fascia d'età, Google Play aggiorna automaticamente gli indicatori di età memorizzati nella cache per quell'utente entro 2-8 settimane dopo il suo compleanno.

(Facoltativo) Ricevere fasce d'età personalizzate

Le fasce d'età predefinite restituite dall'API nelle giurisdizioni e nelle regioni applicabili sono 0-12, 13-15, 16-17 e 18+. Queste fasce potrebbero cambiare in futuro in base ai requisiti locali.

In alternativa, per personalizzare le fasce d'età in base alle età minime della tua app, puoi fornire queste età minime per la tua app nella pagina Age Signals di Google Play Console. L'API Age Signals restituisce le fasce d'età personalizzate. Ad esempio, se fornisci età minime di 9, 15 e 17 anni, un utente di 14 anni rientrerà nella fascia di età 10-15 anni. Le età minime devono essere distanti almeno 2 anni e possono essere modificate una volta all'anno.

Per personalizzare le fasce d'età restituite dall'API Age Signals, puoi fornire le età minime per la tua app:

1. Vai alla pagina Indicatori di età in Play Console.
2. Nella scheda Età minime per l'app, inserisci fino a tre età minime per la tua app.
3. Fai clic su Salva.

Risposte agli indicatori dell'età

La risposta dell'API Play Age Signals (beta) include i seguenti campi e valori. I valori sono soggetti a modifica. Se vuoi i valori più recenti, richiedi una risposta API all'apertura dell'app. È tua responsabilità fornire esperienze adatte all'età utilizzando questi indicatori.

Gestire i codici di errore dell'API

Se la tua app effettua una richiesta API Play Age Signals (beta) e la chiamata non va a buon fine, la tua app riceve un codice di errore. Questi errori possono verificarsi per vari motivi, ad esempio perché l'app Play Store è obsoleta.

Strategia di ripetizione

Nelle situazioni in cui l'utente è in sessione, ti consigliamo di implementare una strategia di nuovi tentativi con un numero massimo di tentativi come condizione di uscita, in modo che l'errore interrompa l'esperienza utente il meno possibile.