Comprendre les réponses des signaux d'âge

Ce document explique les réponses des signaux d'âge renvoyées par l'API Play Age Signals.

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

Les tranches d'âge par défaut renvoyées par l'API sont 0-12, 13-15, 16-17 et 18+.

Vous pouvez également personnaliser les tranches d'âge par défaut en fonction des âges minimaux pour votre appli en les indiquant sur la page Signaux d'âge de la Google Play Console.

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

Les tranches d'âge renvoyées remplaceront la réponse par défaut de l'API. Exemple :

  • Si vous définissez un âge minimal (15 ans) dans la Google Play Console :
    • Pour un enfant de 0 à 14 ans, la fonction renvoie ageLower = 0 et ageUpper = 14.
    • Pour un utilisateur de 15 ans ou plus, la valeur renvoyée est ageLower = 15.
  • Si vous définissez deux âges minimaux (13 et 17 ans) :
    • Pour un enfant de 0 à 12 ans, ageLower = 0 et ageUpper = 12 sont renvoyés.
    • Un enfant de 13 à 16 ans renverra ageLower = 13 et ageUpper = 16.
    • Un utilisateur de 17 ans ou plus renverra ageLower = 17.
  • Si vous définissez trois âges minimums (11, 13 et 15 ans) :
    • Pour un enfant de 0 à 10 ans, les valeurs ageLower = 0 et ageUpper = 10 sont renvoyées.
    • Un enfant de 11 ou 12 ans renverra ageLower = 11 et ageUpper = 12.
    • Un adolescent de 13 ou 14 ans renverra ageLower = 13 et ageUpper = 14.
    • Pour un utilisateur de 15 ans ou plus, la valeur renvoyée est ageLower = 15.

Champs de réponse des signaux d'âge

La réponse de l'API Play Age Signals (bêta) inclut les champs et valeurs suivants. Il vous incombe de proposer des expériences adaptées à l'âge à l'aide de ces signaux.

Champ de réponse Type Valeurs Description
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A : l'utilisateur a fourni des informations sur son âge à Google. Google peut avoir confirmé ou non ces informations.
  • TIER_B : l'âge de l'utilisateur est géré par un parent ou un représentant légal.
  • TIER_C* : l'âge de l'utilisateur est évalué à l'aide d'une carte de crédit, d'une adresse e-mail, d'un selfie, d'une pièce d'identité officielle ou d'un numéro d'identification fiscale.
  • TIER_D* : l'âge de l'utilisateur est confirmé à l'aide d'une pièce d'identité officielle et d'un selfie, ou d'une pièce d'identité numérique.
  • null : renvoyé lorsque ageSignalsStatus est défini sur NOT_SHARED ou VERIFICATION_REQUIRED.
* Renvoyé uniquement dans les régions réglementées où la vérification de l'âge est obligatoire (par exemple, US-TX).
ageLower Nombre entier
  • 0 à 18
  • null
Limite inférieure inclusive de la tranche d'âge de l'utilisateur. Combinez-le avec ageUpper pour déterminer la tranche d'âge.

Renvoie null si ageSignalsStatus est défini sur NOT_SHARED ou VERIFICATION_REQUIRED.

ageUpper Nombre entier
  • 2 à 18
  • null
Limite supérieure inclusive de la tranche d'âge de l'utilisateur.

Renvoie null pour la tranche d'âge la plus élevée (par exemple, 18 ans et plus) ou si ageSignalsStatus est défini sur NOT_SHARED ou VERIFICATION_REQUIRED.

significantChangeStatus Enum
  • APPROUVÉ
  • EN ATTENTE
  • REFUSÉ
  • null
Cette méthode ne renvoie une valeur non nulle que dans les juridictions où des modifications importantes sont applicables.
  • APPROUVÉ : la modification importante la plus récente (et toutes les modifications précédentes) a été approuvée.
  • PENDING : le parent n'a pas encore approuvé une ou plusieurs modifications importantes en attente.
  • DECLINED : les parents ont refusé d'approuver une ou plusieurs modifications importantes.
  • null : renvoyé pour :
    • Tous les comptes non supervisés
    • Comptes supervisés pour lesquels aucune modification importante n'a encore été enregistrée.
significantChangeApprovalDate Date
  • DateStamp
  • null
Date d'entrée en vigueur de la modification importante approuvée la plus récemment. Toutes les modifications dont la date d'entrée en vigueur est antérieure à cette date sont également approuvées. Renvoie null si aucune modification n'existe.

Combinez-le avec "significantChangeStatus" pour obtenir l'état d'approbation de cette modification importante.

installId Chaîne
  • Alphanumérique
  • null
ID attribué par Google Play aux installations d'utilisateurs supervisés, utilisé pour vous informer de la révocation de l'approbation d'une application. Consultez la documentation sur les approbations d'applications révoquées.

Exemple 1

Pour un utilisateur adulte qui a validé son âge à l'aide d'une pièce d'identité numérique, vous recevez les informations suivantes :

  • Dans une région réglementée où la vérification de l'âge est obligatoire :

    • ageRangeSource est AgeRangeSource.TIER_D.
    • ageLower est un nombre (par exemple, 18).
    • ageUpper est null.
    • Les autres champs de réponse sont null.
  • Toute autre région :

    • ageRangeSource est AgeRangeSource.TIER_A.
    • ageLower est un nombre (par exemple, 18).
    • ageUpper est null.
    • Les autres champs de réponse sont null.

Exemple 2

Pour un utilisateur adulte qui a validé son âge à l'aide de méthodes d'estimation de l'âge (comme l'évaluation d'un selfie, une carte de crédit ou un numéro d'identification fiscale), vous recevez les informations suivantes :

  • Dans une région réglementée où la vérification de l'âge est obligatoire :

    • ageRangeSource est AgeRangeSource.TIER_C.
    • ageLower est un nombre (par exemple, 18).
    • ageUpper est null.
    • Les autres champs de réponse sont null.
  • Toute autre région :

    • ageRangeSource est AgeRangeSource.TIER_A.
    • ageLower est un nombre (par exemple, 18).
    • ageUpper est null.
    • Les autres champs de réponse sont null.

Exemple 3

Pour un utilisateur situé dans une région où la vérification de l'âge n'est pas obligatoire et qui la partage avec des applications, vous recevez les informations suivantes :

  • ageRangeSource est AgeRangeSource.TIER_A.
  • ageLower est un nombre (par exemple, 18).
  • ageUpper est null.
  • Les autres champs de réponse sont null.

Exemple 4

Pour un utilisateur mineur supervisé dont l'âge est géré par un représentant légal qui l'a partagé avec des applications, vous recevez les informations suivantes :

  • ageRangeSource est AgeRangeSource.TIER_B.
  • ageLower est un nombre (par exemple, 13).
  • ageUpper est un nombre (par exemple, 15).
  • Les autres champs de réponse sont null.

Exemple 5

Pour un utilisateur qui n'a pas accepté (ou dont le parent n'a pas accepté) de partager son âge dans une région où la vérification de l'âge n'est pas obligatoire, vous recevez les informations suivantes :

  • ageRangeSource est null.
  • ageLower est null.
  • ageUpper est null.
  • Les autres champs de réponse sont null.

Exemple 6

Pour un utilisateur mineur supervisé dont l'âge est géré par un représentant légal, avec une modification importante approuvée et un suivi d'installation actif, vous recevez les éléments suivants :

  • ageRangeSource est AgeRangeSource.TIER_B.
  • ageLower est un nombre (par exemple, 13).
  • ageUpper est un nombre (par exemple, 15).
  • significantChangeStatus est SignificantChangeStatus.APPROVED.
  • significantChangeApprovalDate est une date (par exemple, "2026-01-15").
  • installId est un identifiant de chaîne (par exemple, "abc123xyz789").