Entender as respostas de indicadores de idade

Este documento explica 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, você pode informar essas idades mínimas na página "Indicadores de idade " do Google Play Console.

  1. Acesse a página "Indicadores de idade" no Play Console.
  2. Na guia Faixas etárias personalizadas, insira até três idades mínimas para seu app. Elas precisam ter uma diferença de pelo menos 2 anos e podem ser alteradas uma vez por ano.
  3. Clique em Salvar.

As faixas etárias retornadas vão substituir a resposta padrão da API. Exemplo:

  • Se você definir uma idade mínima (15) no Google Play Console:
    • Uma pessoa de 0 a 14 anos vai retornar ageLower = 0 e ageUpper = 14.
    • Uma pessoa de 15 anos ou mais vai retornar ageLower = 15.
  • Se você definir duas idades mínimas (13 e 17):
    • Uma pessoa de 0 a 12 anos vai retornar ageLower = 0 e ageUpper = 12.
    • Uma pessoa de 13 a 16 anos vai retornar ageLower = 13 e ageUpper = 16.
    • Uma pessoa de 17 anos ou mais vai retornar ageLower = 17.
  • Se você definir três idades mínimas (11, 13 e 15):
    • Uma pessoa de 0 a 10 anos vai retornar ageLower = 0 e ageUpper = 10.
    • Uma pessoa de 11 ou 12 anos vai retornar ageLower = 11 e ageUpper = 12.
    • Uma pessoa de 13 ou 14 anos vai retornar ageLower = 13 e ageUpper = 14.
    • Uma pessoa de 15 anos ou mais vai retornar ageLower = 15.

Campos de resposta de 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 à idade usando esses indicadores.

Campo de resposta Tipo Valores Descrição
ageRangeSource Tipo enumerado
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: o usuário declarou a própria idade.
  • TIER_B: a idade do usuário é gerenciada por um familiar ou responsável.
  • TIER_C: a idade do usuário é avaliada usando cartão de crédito, endereço de e-mail, avaliação de selfie, documento de identificação oficial ou número de identificação fiscal.
  • TIER_D: a idade do usuário é verificada usando uma combinação de documento de identificação oficial e avaliação de selfie ou documento de identificação digital.
  • null: retornado quando ageSignalsStatus é NOT_SHARED ou VERIFICATION_REQUIRED.
ageLower Número inteiro
  • 0 a 18
  • null
 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
  • 2 a 18
  • null
 O limite superior inclusivo da faixa etária do usuário.

Retorna null para a faixa mais alta (por exemplo, 18 anos ou mais) ou se ageSignalsStatus for NOT_SHARED ou VERIFICATION_REQUIRED.
significantChangeStatus Tipo enumerado
  • APROVADO
  • PENDENTE
  • RECUSADO
  • null
 Isso só retorna um valor não nulo em jurisdições em que mudanças significativas são aplicáveis.
  • APROVADO: a mudança significativa mais recente (e todas as anteriores) foi aprovada.
  • PENDENTE: o familiar responsável ainda não aprovou uma ou mais mudanças significativas pendentes.
  • RECUSADO: os familiares responsáveis negaram a aprovação de uma ou mais mudanças significativas.
  • null: retornado para:
    • Todas as contas sem supervisão
    • Contas supervisionadas que ainda não têm mudanças significativas registradas.
significantChangeApprovalDate Data
  • DateStamp
  • null
 A data de início da vigência da mudança significativa mais recente aprovada. Todas as mudanças com datas de vigência anteriores a essa data também são aprovadas. Retorna null se não houver mudanças.

Combine com `significantChangeStatus` para receber o status de aprovação dessa mudança significativa.
installId String
  • Alfanuméricos
  • null
 Um ID atribuído a instalações de usuários supervisionados pelo Google Play, usado para notificar você sobre a aprovação revogada do app. Consulte a documentação sobre aprovações revogadas de apps.

Exemplo 1

Para um usuário que verificou a idade usando o documento de identificação digital e o compartilhou com apps, você recebe o seguinte:

  • ageRangeSource é AgeRangeSource.TIER_D.
  • ageLower é um número (por exemplo, 18).
  • ageUpper é null.
  • Outros campos de resposta são null.

Exemplo 2

Para um usuário adulto que declarou a idade (autodeclarada) e a compartilhou 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 3

Para um usuário menor de idade supervisionado cuja idade é gerenciada por um familiar 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 4

Para um usuário que não concordou (ou cujo familiar responsável não concordou) com o compartilhamento de idade, você recebe o seguinte:

  • ageRangeSource é null.
  • ageLower é null.
  • ageUpper é null.
  • Outros campos de resposta são null.

Exemplo 5

Para um usuário adulto com uma idade avaliada verificada usando métodos de estimativa de idade (como avaliação de selfie, cartão de crédito ou número de identificação fiscal) que a compartilha com apps, você recebe o seguinte:

  • ageRangeSource é AgeRangeSource.TIER_C.
  • ageLower é um número (por exemplo, 18).
  • ageUpper é null.
  • Outros campos de resposta são null.

Exemplo 6

Para um usuário menor de idade supervisionado cuja idade é gerenciada por um familiar responsável, com uma mudança significativa aprovada e o acompanhamento 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").
Anterior
Solicitar indicadores de idade
Avançar
Testar indicadores de idade