연령 신호 응답 이해하기

이 문서에서는 Play Age Signals API에서 반환하는 연령 신호 응답을 설명합니다.

(선택사항) 맞춤 연령대 수신

API에서 반환하는 기본 연령대는 0-12, 13-15, 16-17, 18+입니다.

또는 앱의 최소 연령에 따라 기본 연령대를 맞춤설정하려면 Google Play Console의 연령 신호 페이지에서 앱의 최소 연령을 제공하면 됩니다.

  1. Play Console의 연령 신호 페이지로 이동합니다.
  2. 맞춤 연령대 탭에서 앱의 최소 연령을 최대 3개까지 입력합니다. 최소 연령 간의 차이는 2세 이상이어야 하며 연 1회 변경할 수 있습니다.
  3. 저장을 클릭합니다.

반환되는 연령대가 기본 API 응답을 재정의합니다. 예를 들면 다음과 같습니다.

  • Google Play Console에서 최소 연령을 15세로 설정하는 경우:
    • 0~14세는 ageLower = 0 및 ageUpper = 14를 반환합니다.
    • 만 15세 이상은 ageLower = 15를 반환합니다.
  • 최소 연령을 2개(13세 및 17세) 설정하는 경우:
    • 0~12세의 경우 ageLower = 0 및 ageUpper = 12가 반환됩니다.
    • 만 13~16세는 ageLower = 13 및 ageUpper = 16를 반환합니다.
    • 만 17세 이상은 ageLower = 17을 반환합니다.
  • 최소 연령을 3개(11, 13, 15) 설정하는 경우:
    • 0~10세는 ageLower = 0 및 ageUpper = 10를 반환합니다.
    • 11세 또는 12세는 ageLower = 11 및 ageUpper = 12를 반환합니다.
    • 만 13세 또는 14세인 경우 ageLower = 13 및 ageUpper = 14가 반환됩니다.
    • 만 15세 이상은 ageLower = 15를 반환합니다.

연령 신호 응답 필드

Play Age Signals API(베타) 응답에는 다음 필드와 값이 포함됩니다. 이러한 신호를 사용하여 연령에 적합한 환경을 제공할 책임은 개발자에게 있습니다.

응답 필드 유형 값 설명
ageRangeSource Enum
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: 사용자가 Google에 연령 정보를 제공했습니다. Google에서 이 정보를 확인했을 수도 있고 확인하지 않았을 수도 있습니다.
  • TIER_B: 사용자의 연령이 부모 또는 보호자에 의해 관리됩니다.
  • TIER_C*: 신용카드, 이메일 주소, 얼굴 인증, 정부 발급 신분증 또는 세금 ID를 사용하여 사용자의 연령을 확인합니다.
  • TIER_D*: 정부 발급 신분증과 셀피 평가 또는 디지털 신분증을 함께 사용하여 사용자의 연령을 확인합니다.
  • null: ageSignalsStatus가 NOT_SHARED 또는 VERIFICATION_REQUIRED인 경우 반환됩니다.
* 연령 인증이 필수인 규제 지역(예: 미국 텍사스주)에서만 반환됩니다.
ageLower 정수
  • 0~18
  • null
사용자 연령대의 하한값(포함)입니다. ageUpper와 결합하여 범위를 결정합니다.

ageSignalsStatus가 NOT_SHARED 또는 VERIFICATION_REQUIRED인 경우 null을 반환합니다.

ageUpper 정수
  • 2~18
  • null
사용자 연령대의 상한값(포함)입니다.

가장 높은 연령대(예: 만 18세 이상) 또는 ageSignalsStatus가 NOT_SHARED 또는 VERIFICATION_REQUIRED인 경우 null을 반환합니다.

significantChangeStatus Enum
  • 승인됨
  • 대기 중
  • DECLINED
  • null
이는 중대한 변경사항이 적용되는 관할권에서만 null이 아닌 값을 반환합니다.
  • APPROVED: 가장 최근의 주요 변경사항(및 이전의 모든 변경사항)이 승인되었습니다.
  • PENDING: 부모가 아직 하나 이상의 대기 중인 중요한 변경사항을 승인하지 않았습니다.
  • DECLINED: 부모가 하나 이상의 중요한 변경사항을 승인하지 않았습니다.
  • null: 다음에 대해 반환됩니다.
    • 감독되지 않는 모든 계정
    • 아직 중요한 변경사항이 기록되지 않은 감독 대상 계정입니다.
significantChangeApprovalDate 날짜
  • DateStamp
  • null
가장 최근에 승인된 주요 변경사항의 시행일입니다. 이 날짜 이전의 시행일이 있는 모든 변경사항도 승인됩니다. 변경사항이 없으면 null을 반환합니다.

`significantChangeStatus` 와 결합하여 이 중요한 변경사항의 승인 상태를 가져옵니다.

installId 문자열
  • 영숫자
  • null
Google Play에서 감독 대상 사용자 설치에 할당한 ID로, 앱 승인 취소를 알리는 데 사용됩니다. 취소된 앱 승인에 관한 문서를 검토합니다.

예 1

디지털 신분증을 사용하여 연령을 인증한 성인 사용자의 경우 다음을 수신합니다.

  • 연령 인증이 필수인 규제 지역:

    • ageRangeSource은 AgeRangeSource.TIER_D입니다.
    • ageLower은 숫자입니다(예: 18).
    • ageUpper은 null입니다.
    • 다른 응답 필드는 null입니다.
  • 기타 국가:

    • ageRangeSource은 AgeRangeSource.TIER_A입니다.
    • ageLower은 숫자입니다(예: 18).
    • ageUpper은 null입니다.
    • 다른 응답 필드는 null입니다.

예 2

연령 추정 방법(예: 셀피 평가, 신용카드, 세금 ID)을 사용하여 연령을 인증한 성인 사용자의 경우 다음을 받게 됩니다.

  • 연령 인증이 필수인 규제 지역:

    • ageRangeSource은 AgeRangeSource.TIER_C입니다.
    • ageLower은 숫자입니다(예: 18).
    • ageUpper은 null입니다.
    • 다른 응답 필드는 null입니다.
  • 기타 국가:

    • ageRangeSource은 AgeRangeSource.TIER_A입니다.
    • ageLower은 숫자입니다(예: 18).
    • ageUpper은 null입니다.
    • 다른 응답 필드는 null입니다.

예시 3

연령 인증이 필수가 아니며 앱과 공유하는 지역에 있는 사용자의 경우 다음을 수신합니다.

  • ageRangeSource은 AgeRangeSource.TIER_A입니다.
  • ageLower은 숫자입니다(예: 18).
  • ageUpper은 null입니다.
  • 다른 응답 필드는 null입니다.

예 4

보호자가 연령을 관리하고 앱과 공유한 감독 대상 미성년자 사용자의 경우 다음을 수신합니다.

  • ageRangeSource은 AgeRangeSource.TIER_B입니다.
  • ageLower은 숫자입니다(예: 13).
  • ageUpper은 숫자입니다(예: 15).
  • 다른 응답 필드는 null입니다.

예 5

연령 인증이 필수가 아닌 지역에서 연령 공유에 동의하지 않은 사용자(또는 부모가 동의하지 않은 사용자)의 경우 다음이 수신됩니다.

  • ageRangeSource은 null입니다.
  • ageLower은 null입니다.
  • ageUpper은 null입니다.
  • 다른 응답 필드는 null입니다.

예시 6

보호자가 연령을 관리하고, 중요한 변경사항이 승인되었으며, 활성 설치 추적이 사용 설정된 감독 대상 미성년자 사용자의 경우 다음을 수신합니다.

  • ageRangeSource은 AgeRangeSource.TIER_B입니다.
  • ageLower은 숫자입니다(예: 13).
  • ageUpper은 숫자입니다(예: 15).
  • significantChangeStatus은 SignificantChangeStatus.APPROVED입니다.
  • significantChangeApprovalDate는 날짜입니다(예: '2026-01-15').
  • installId는 문자열 식별자입니다(예: 'abc123xyz789').