Utiliser l'API Play Age Signals (bêta)

En utilisant l'API Play Age Signals (bêta), vous acceptez les Conditions d'utilisation et vous vous engagez à respecter l'ensemble du Règlement pour les développeurs Google Play. Pour demander l'état et la tranche d'âge de l'utilisateur, vous appelez l'API depuis votre application au moment de l'exécution. L'API Play Age Signals ne renvoie des données que pour les utilisateurs basés dans des régions où Play est légalement tenu de fournir des données sur les catégories d'âge.

Play renvoie une tranche d'âge basée sur les tranches d'âge définies par la juridiction et les régions applicables. Les tranches d'âge par défaut renvoyées par l'API dans les juridictions et régions applicables sont 0-12, 13-15, 16-17 et 18 ans et plus, mais elles peuvent changer en fonction des exigences régionales.

Intégrer l'API Play Age Signals à votre application

Pour intégrer l'API Play Age Signals à votre application, ajoutez la dépendance suivante au fichier build.gradle de votre application :

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

Demander des signaux d'âge

Voici un exemple de requête de signaux d'âge :

// 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.
          }
        });

Les signaux d'âge sont stockés par Google Play sur l'appareil pour chaque utilisateur. Lorsqu'un utilisateur disposant d'un compte Google supervisé change de tranche d'âge, Google Play met automatiquement à jour les signaux d'âge mis en cache pour cet utilisateur dans un délai de deux à huit semaines après son anniversaire.

(Facultatif) Recevoir des tranches d'âge personnalisées

Les tranches d'âge par défaut que l'API renvoie dans les juridictions et régions concernées sont 0-12, 13-15, 16-17 et 18 ans et plus. Elles peuvent changer à l'avenir en fonction des exigences locales.

Vous pouvez également personnaliser les tranches d'âge en fonction des âges minimaux de votre application. Pour cela, indiquez ces âges minimaux sur la page Signaux d'âge de la Google Play Console. L'API Age Signals renvoie les tranches d'âge personnalisées. Par exemple, si vous indiquez des âges minimums de 9, 15 et 17 ans, un utilisateur de 14 ans sera inclus dans la tranche d'âge de 10 à 15 ans. L'âge minimal doit être différent d'au moins deux ans et ne peut être modifié qu'une fois par an.

Pour personnaliser les tranches d'âge renvoyées par l'API Age Signals, vous pouvez fournir des âges minimaux pour votre application :

1. Accédez à la page Signaux d'âge dans la Play Console.
2. Dans l'onglet Âges minimaux requis pour l'appli, saisissez jusqu'à trois âges minimaux pour votre application.
3. Cliquez sur Enregistrer.

Réponses aux signaux d'âge

La réponse de l'API Play Age Signals (bêta) inclut les champs et valeurs suivants. Les valeurs sont susceptibles d'être modifiées. Si vous souhaitez obtenir les valeurs les plus récentes, demandez une réponse de l'API lorsque votre application s'ouvre. Vous êtes responsable de la fourniture d'expériences adaptées à l'âge à l'aide de ces signaux.

Gérer les codes d'erreur de l'API

Si votre application envoie une requête à l'API Play Age Signals (bêta) et que l'appel échoue, elle reçoit un code d'erreur. Ces erreurs peuvent se produire pour diverses raisons, par exemple si l'application Play Store n'est pas à jour.

Stratégie de nouvelle tentative

Lorsqu'une session utilisateur est en cours, nous vous recommandons d'implémenter une stratégie de nouvelle tentative avec un nombre maximal de tentatives comme condition de sortie afin que l'erreur perturbe le moins possible l'expérience utilisateur.