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.
- Accédez à la page Signaux d'âge de la Play Console.
- 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.
- 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 = 0etageUpper = 14. - Pour un utilisateur de 15 ans ou plus, la valeur renvoyée est
ageLower = 15.
- Pour un enfant de 0 à 14 ans, la fonction renvoie
- Si vous définissez deux âges minimaux (13 et 17 ans) :
- Pour un enfant de 0 à 12 ans,
ageLower = 0etageUpper = 12sont renvoyés. - Un enfant de 13 à 16 ans renverra
ageLower = 13etageUpper = 16. - Un utilisateur de 17 ans ou plus renverra
ageLower = 17.
- Pour un enfant de 0 à 12 ans,
- Si vous définissez trois âges minimums (11, 13 et 15 ans) :
- Pour un enfant de 0 à 10 ans, les valeurs
ageLower = 0etageUpper = 10sont renvoyées. - Un enfant de 11 ou 12 ans renverra
ageLower = 11etageUpper = 12. - Un adolescent de 13 ou 14 ans renverra
ageLower = 13etageUpper = 14. - Pour un utilisateur de 15 ans ou plus, la valeur renvoyée est
ageLower = 15.
- Pour un enfant de 0 à 10 ans, les valeurs
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 |
|
|
| ageLower | Nombre entier |
|
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 |
|
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 |
|
Cette méthode ne renvoie une valeur non nulle que dans les juridictions où des modifications importantes sont applicables.
|
| significantChangeApprovalDate | Date |
|
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 |
|
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 :
ageRangeSourceestAgeRangeSource.TIER_D.ageLowerest un nombre (par exemple, 18).ageUpperestnull.- Les autres champs de réponse sont
null.
Toute autre région :
ageRangeSourceestAgeRangeSource.TIER_A.ageLowerest un nombre (par exemple, 18).ageUpperestnull.- 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 :
ageRangeSourceestAgeRangeSource.TIER_C.ageLowerest un nombre (par exemple, 18).ageUpperestnull.- Les autres champs de réponse sont
null.
Toute autre région :
ageRangeSourceestAgeRangeSource.TIER_A.ageLowerest un nombre (par exemple, 18).ageUpperestnull.- 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 :
ageRangeSourceestAgeRangeSource.TIER_A.ageLowerest un nombre (par exemple, 18).ageUpperestnull.- 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 :
ageRangeSourceestAgeRangeSource.TIER_B.ageLowerest un nombre (par exemple, 13).ageUpperest 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 :
ageRangeSourceestnull.ageLowerestnull.ageUpperestnull.- 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 :
ageRangeSourceestAgeRangeSource.TIER_B.ageLowerest un nombre (par exemple, 13).ageUpperest un nombre (par exemple, 15).significantChangeStatusestSignificantChangeStatus.APPROVED.significantChangeApprovalDateest une date (par exemple, "2026-01-15").installIdest un identifiant de chaîne (par exemple, "abc123xyz789").