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

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

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

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

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

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

Les tranches d'âge par défaut renvoyées par l'API dans les régions et juridictions concernées sont 0-12, 13-15, 16-17 et 18 ans et plus.

Vous pouvez également personnaliser les tranches d'âge par défaut en fonction des âges minimaux pour votre application. Pour cela, indiquez ces âges minimaux sur la page Signaux d'âge de la Google Play Console. Les tranches d'âge renvoyées remplaceront la réponse par défaut de l'API. Par exemple, si vous définissez des âges minimaux de 9, 15 et 17 ans, un utilisateur de 14 ans sera classé dans la tranche d'âge 10-15.

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

1. Accédez à la page Signaux d'âge dans la Play Console.
2. Dans l'onglet Tranches d'âge personnalisées, saisissez jusqu'à trois âges minimaux pour votre application. Les âges minimaux doivent être espacés d'au moins deux ans et ne peuvent être modifiés qu'une fois par an.
3. Cliquez sur Enregistrer.

Réponses des 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 API lorsque votre application s'ouvre. Il vous incombe de proposer des expériences adaptées à l'âge des utilisateurs à l'aide de ces signaux.

Exemples de réponses pour les utilisateurs au Brésil

Au Brésil, userStatus ne peut être que DECLARED, UNKNOWN ou null.

Pour un utilisateur qui a déclaré son âge et l'a partagé avec des applications, vous recevrez les informations suivantes :

• userStatus serait AgeSignalsVerificationStatus.DECLARED.
• ageLower doit être un nombre (par exemple, 13).
• ageUpper doit être un nombre ou null (par exemple, 15).
• Les autres champs de réponse seraient null.

Pour un utilisateur dont l'âge est inconnu, vous recevrez le message suivant :

• userStatus serait AgeSignalsVerificationStatus.UNKNOWN.
• Les autres champs de réponse seraient null.

Pour un utilisateur dont l'âge n'est pas partagé avec les applications, vous recevrez les informations suivantes :

• userStatus serait null.
• Les autres champs de réponse seraient null.

L'état de l'utilisateur peut passer à DECLARED une fois que son âge peut être partagé.

Exemples de réponses pour les utilisateurs situés dans les États américains

Dans les États américains concernés, userStatus peut être VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN ou null.

Pour un utilisateur validé, vous recevrez les éléments suivants :

• userStatus serait AgeSignalsVerificationStatus.VERIFIED.
• ageLower doit être un nombre (par exemple, 18).
• ageUpper doit être un nombre ou null (par exemple, null).
• Les autres champs de réponse seraient null.

Pour un utilisateur supervisé, vous recevrez le message suivant :

• userStatus serait AgeSignalsVerificationStatus.SUPERVISED.
• ageLower doit être un nombre (par exemple, 13).
• ageUpper doit être un nombre ou null (par exemple, 15).
• mostRecentApprovalDate serait un objet de date Java (par exemple, 2026-01-01) ou null (si aucune modification importante n'a été approuvée).
• installID correspond à un ID alphanumérique généré par Play (par exemple, 550e8400-e29b-41d4-a716-446655441111).

Si l'approbation d'une modification importante est en attente pour un utilisateur supervisé, vous recevrez le message suivant :

• userStatus serait AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower doit être un nombre (par exemple, 13).
• ageUpper doit être un nombre ou null (par exemple, 15).
• mostRecentApprovalDate serait un objet de date Java (par exemple, 2026-01-01) ou null (si aucune modification importante n'a été approuvée).
• installID correspond à un ID alphanumérique généré par Play (par exemple, 550e8400-e29b-41d4-a716-446655441111).

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

Si votre application envoie une requête à l'API Play Age Signals 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 est obsolète.

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.