Entender as respostas de indicadores de idade

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.

  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 o 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 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 = 0 e ageUpper = 14.
    • Uma pessoa com mais de 15 anos vai retornar ageLower = 15.
  • Se você definir duas idades mínimas (13 e 17):
    • Uma criança de 0 a 12 anos vai retornar ageLower = 0 e ageUpper = 12.
    • Para um jovem de 13 a 16 anos, o retorno será ageLower = 13 e ageUpper = 16.
    • Uma pessoa com mais de 17 anos vai retornar ageLower = 17.
  • Se você definir três idades mínimas (11, 13 e 15):
    • Uma criança de 0 a 10 anos vai retornar ageLower = 0 e ageUpper = 10.
    • Uma criança 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 com mais de 15 anos vai retornar ageLower = 15.

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
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: o usuário forneceu as informações de idade ao Google. O Google pode ou não ter confirmado essas informações.
  • TIER_B: a idade do usuário é gerenciada por um familiar responsável.
  • TIER_C*: a idade do usuário é avaliada usando cartão de crédito, endereço de e-mail, selfie, documento de identidade oficial ou CPF/CNPJ.
  • 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.
* Retornado apenas nas regiões regulamentadas em que a confirmação de idade é obrigatória (por exemplo, US-TX).
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, maiores de 18 anos) 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.
  • APROVADA: 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.
  • DECLINED: os 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 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
  • Alfanuméricos
  • null
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").