Neste documento, explicamos as respostas de indicadores de idade retornadas pela API Play Age Signals.
(Opcional) Receber faixas etárias personalizadas
As faixas etárias padrão que a API retorna são 0-12, 13-15, 16-17 e 18+.
Como alternativa, para personalizar as faixas etárias padrão de acordo com as idades mínimas do seu app, informe essas idades na página Indicadores de idade no Google Play Console.
- Acesse a página Indicadores de idade no Play Console.
- Na guia Faixas etárias personalizadas, insira até três idades mínimas para o app. Elas precisam ter uma diferença de pelo menos 2 anos e podem ser alteradas uma vez por ano.
- Clique em Salvar.
As faixas etárias retornadas vão substituir a resposta da API padrão. Exemplo:
- Se você definir uma idade mínima (15 anos) no Google Play Console:
- Uma pessoa de 0 a 14 anos vai retornar
ageLower = 0eageUpper = 14. - Uma pessoa com mais de 15 anos vai retornar
ageLower = 15.
- Uma pessoa de 0 a 14 anos vai retornar
- Se você definir duas idades mínimas (13 e 17):
- Uma criança de 0 a 12 anos vai retornar
ageLower = 0eageUpper = 12. - Para um jovem de 13 a 16 anos, o retorno será
ageLower = 13eageUpper = 16. - Uma pessoa com mais de 17 anos vai retornar
ageLower = 17.
- Uma criança de 0 a 12 anos vai retornar
- Se você definir três idades mínimas (11, 13 e 15):
- Uma criança de 0 a 10 anos vai retornar
ageLower = 0eageUpper = 10. - Uma criança de 11 ou 12 anos vai retornar
ageLower = 11eageUpper = 12. - Uma pessoa de 13 ou 14 anos vai retornar
ageLower = 13eageUpper = 14. - Uma pessoa com mais de 15 anos vai retornar
ageLower = 15.
- Uma criança de 0 a 10 anos vai retornar
Campos de resposta dos indicadores de idade
A resposta da API Play Age Signals (Beta) inclui os seguintes campos e valores. Você é responsável por oferecer experiências adequadas à faixa etária usando esses indicadores.
| Campo de resposta | Tipo | Valores | Descrição |
|---|---|---|---|
| ageRangeSource | Tipo enumerado |
|
|
| ageLower | Número inteiro |
|
O limite inferior inclusivo da faixa etária do usuário. Combine com ageUpper para determinar a faixa.
Retorna null se ageSignalsStatus for NOT_SHARED ou VERIFICATION_REQUIRED. |
| ageUpper | Número inteiro |
|
O limite superior inclusivo da faixa etária do usuário.
Retorna null para a faixa mais alta (por exemplo, maiores de 18 anos) ou se ageSignalsStatus for NOT_SHARED ou VERIFICATION_REQUIRED. |
| significantChangeStatus | Tipo enumerado |
|
Isso só retorna um valor não nulo em jurisdições em que mudanças significativas são aplicáveis.
|
| significantChangeApprovalDate | Data |
|
A data de início da vigência da mudança significativa mais recente que foi aprovada. Todas as mudanças com início da vigência anterior a essa data também são aprovadas. Retorna null se não houver mudanças.
Combine com "significantChangeStatus" para conferir o status de aprovação dessa mudança significativa. |
| installId | String |
|
Um ID atribuído pelo Google Play às instalações de usuários supervisionados, usado para notificar você sobre a revogação da aprovação de um app. Leia a documentação sobre aprovações de apps revogadas. |
Exemplo 1
Para um usuário adulto que confirmou a idade usando um documento de identificação digital, você recebe o seguinte:
Em uma região regulamentada onde a confirmação de idade é obrigatória:
ageRangeSourceéAgeRangeSource.TIER_D.ageLoweré um número (por exemplo, 18).ageUpperénull.- Outros campos de resposta são
null.
Em qualquer outro lugar:
ageRangeSourceéAgeRangeSource.TIER_A.ageLoweré um número (por exemplo, 18).ageUpperénull.- Outros campos de resposta são
null.
Exemplo 2
Para um usuário adulto que confirmou a idade usando métodos de estimativa de idade (como avaliação de selfie, cartão de crédito ou CPF/CNPJ), você recebe o seguinte:
Em uma região regulamentada onde a confirmação de idade é obrigatória:
ageRangeSourceéAgeRangeSource.TIER_C.ageLoweré um número (por exemplo, 18).ageUpperénull.- Outros campos de resposta são
null
Em qualquer outro lugar:
ageRangeSourceéAgeRangeSource.TIER_A.ageLoweré um número (por exemplo, 18).ageUpperénull.- Outros campos de resposta são
null.
Exemplo 3
Para um usuário que está em uma região onde a confirmação de idade não é obrigatória e a compartilha com apps, você recebe o seguinte:
ageRangeSourceéAgeRangeSource.TIER_A.ageLoweré um número (por exemplo, 18).ageUpperénull.- Outros campos de resposta são
null.
Exemplo 4
Para um usuário menor de idade supervisionado, cuja idade é gerenciada por um responsável que a compartilhou com apps, você recebe o seguinte:
ageRangeSourceéAgeRangeSource.TIER_B.ageLoweré um número (por exemplo, 13).ageUpperé um número (por exemplo, 15).- Outros campos de resposta são
null.
Exemplo 5
Para um usuário que não concordou (ou cujo familiar responsável não concordou) com o compartilhamento de idade em uma região onde a confirmação de idade não é obrigatória, você recebe o seguinte:
ageRangeSourceénull.ageLowerénull.ageUpperénull.- Outros campos de resposta são
null.
Exemplo 6
Para um usuário menor de idade supervisionado, com idade gerenciada por um responsável, com uma mudança significativa aprovada e rastreamento de instalação ativo, você recebe o seguinte:
ageRangeSourceéAgeRangeSource.TIER_B.ageLoweré um número (por exemplo, 13).ageUpperé um número (por exemplo, 15).significantChangeStatuséSignificantChangeStatus.APPROVED.significantChangeApprovalDateé uma data (por exemplo, "2026-01-15").installIdé um identificador de string (por exemplo, "abc123xyz789").