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 application. Pour cela, indiquez ces âges minimaux sur la page Signaux d'âge de la Google Play Console.

  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.

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 une personne âgée de 0 à 14 ans, les valeurs renvoyées sont ageLower = 0 et ageUpper = 14.
    • Une personne âgée de 15 ans ou plus renverra ageLower = 15.
  • Si vous définissez deux âges minimum (13 et 17 ans) :
    • Pour un enfant de 0 à 12 ans, les valeurs renvoyées seront ageLower = 0 et ageUpper = 12.
    • Pour une personne âgée de 13 à 16 ans, ageLower = 13 et ageUpper = 16 seront renvoyés.
    • Une personne âgée de 17 ans ou plus recevra ageLower = 17.
  • Si vous définissez trois âges minimum (11, 13 et 15 ans) :
    • Pour un enfant de 0 à 10 ans, les valeurs renvoyées seront ageLower = 0 et ageUpper = 10.
    • Pour un enfant de 11 ou 12 ans, les valeurs renvoyées seront ageLower = 11 et ageUpper = 12.
    • Pour un utilisateur de 13 ou 14 ans, les valeurs renvoyées seront ageLower = 13 et ageUpper = 14.
    • Une personne âgée de 15 ans ou plus renverra 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 des utilisateurs à 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 déclaré son âge.
  • 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é ou d'un numéro d'identification fiscale.
  • TIER_D : l'âge de l'utilisateur est vérifié à l'aide d'une pièce d'identité officielle et d'une évaluation par selfie, ou d'une pièce d'identité numérique.
  • null : renvoyé lorsque ageSignalsStatus est défini sur NOT_SHARED ou VERIFICATION_REQUIRED.
ageLower Nombre entier
  • 0 à 18
  • null
Limite inférieure incluse 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
  • De 2 à 18
  • null
Limite supérieure incluse 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 changements importants sont applicables.
  • APPROUVÉ : la dernière modification importante (et toutes les modifications précédentes) a été approuvée.
  • EN ATTENTE : le parent n'a pas encore approuvé une ou plusieurs modifications importantes en attente.
  • REFUSÉ : 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 dernière modification importante approuvée. 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é aux installations des utilisateurs supervisés par Google Play, utilisé pour vous informer de l'annulation de l'approbation d'une application. Consultez la documentation sur les approbations d'applications révoquées.

Exemple 1

Pour un utilisateur qui a confirmé son âge à l'aide d'une pièce d'identité numérique et qui la partage avec des applications, vous recevez les informations suivantes :

  • ageRangeSource est AgeRangeSource.TIER_D.
  • 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 déclaré son âge (auto-déclaration) et l'a partagé 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 3

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 4

Pour un utilisateur qui n'a pas accepté (ou dont le parent n'a pas accepté) le partage de l'âge, vous recevez le message suivant :

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

Exemple 5

Pour un utilisateur adulte dont l'âge a été validé à l'aide de méthodes d'estimation de l'âge (comme l'évaluation par selfie, la carte de crédit ou le numéro d'identification fiscale) et qui le partage avec des applications, vous recevez les informations suivantes :

  • ageRangeSource est AgeRangeSource.TIER_C.
  • ageLower est un nombre (par exemple, 18).
  • 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 un changement important approuvé et le suivi des installations actif, vous recevez les informations suivantes :

  • 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").