KappS 지식 베이스 · 블로그

2026년 Google Play 연령 신호 API: 연령대, 중대 변경 승인, 그리고 단계별 튜토리얼

블로그 튜토리얼

연령 확인의 무게중심이 앱에서 스토어로 옮겨갔습니다. 텍사스 SB 2420이 시행에 들어갔고, 브라질의 디지털 ECA는 2026년 3월 17일부터 연령 신호를 반환하기 시작했으며, Google Play는 이제 개발자에게 예전에는 추측해야 했던 답, 즉 이 사용자가 몇 살인지를 건네줍니다. Play Age Signals API(베타)는 그 답으로 통하는 클라이언트 측 관문입니다. 이 튜토리얼은 재작업을 피할 수 있는 통합 순서를 따라갑니다.

먼저 바로잡아야 할 프레임이 하나 있습니다. Google Play가 API를 의무화하는 것은 아닙니다. 해당 관할권에서 배포되는 앱에 법적 의무가 부과되며, Google는 도구를 제공하고 컴플라이언스 결정은 여러분에게 맡깁니다. 그 결정을 문서로 남기세요. 감사 기록이 슬랙 스레드에 대한 기억보다 낫습니다.

1단계 — 2026년에 실제로 무엇이 바뀌었는지 파악하기

모두 Google 자체 문서에서 나온 세 가지 날짜별 사실이 범위를 규정합니다:

  • 텍사스. 2025년 12월에 내려진 사전 금지 명령이 연방 항소법원에서 정지되면서 App Store 책임법(SB 2420)이 시행되었습니다. 대상 사용자의 경우 Google Play는 2026년 5월 28일 이후 생성된 계정에 대해 연령 신호를 반환하며, 다른 미국 주들의 연령 확인 법안에 앞서 추가 업데이트가 예고되어 있습니다(Play Console 도움말).
  • 브라질. 2026년 3월 17일부터 API는 디지털 ECA 요건에 따라 브라질 사용자의 연령 신호를 반환합니다(연령 신호 개요).
  • 의무 분담. 스토어가 검증하고, 부모가 승인하며, 개발자는 연령대와 주요 변경 사항에 대한 부모 승인 상태를 수집하고 주요 변경이 발생하면 스토어에 알려야 합니다. Play의 FAQ에도 Age Signals API가 필요하지 않다고 명시되어 있습니다. 법률이 요구하는 것은 연령에 적합한 경험입니다.

실제로 이 API는 가장 어려운 부분(보유하고 싶지 않은 신원 데이터를 수집하지 않고는 생년월일을 직접 확인할 수 없음)을 해결하고, 여러분이 실제로 통제할 수 있는 부분, 즉 13~15세 구간과 18세 이상 구간에서 앱이 다르게 동작하는 방식을 남겨줍니다.

2단계 — 의존성을 추가하고 노출 한도를 준수하세요

클라이언트 라이브러리는 com.google.android.play:age-signals이며, Google는 최신 버전인 0.0.4를 권장합니다. 지원 폼 팩터는 Android 6.0(API 레벨 23) 이상을 실행하는 휴대폰, 폴더블, 태블릿입니다. 앱 모듈에 추가하세요:

  • implementation 'com.google.android.play:age-signals:0.0.4'

놓치기 쉬운 두 가지 제약이 있습니다. 첫째, 이것은 클라이언트 측 런타임 API입니다: 연령 신호는 앱이 열려 있을 때 검색되며 백엔드로 푸시되지 않으므로, 서버 측 게이트는 앱이 획득한 정보를 기반으로 작동하고 이를 어떻게 전송할지 결정해야 합니다. 둘째, 이 API를 사용하면 서비스 약관에 동의하고 Google Play 개발자 정책을 준수하는 데 동의하는 것입니다.

3단계 — 나이를 묻기 전에 접근 권한부터 요청하기

가장 흔한 실수는 checkAgeSignals()를 먼저 호출하는 것입니다. 공유 상태는 requestAgeSignalsAccess(activity)로 확인해야 하며, 이 함수는 세 가지 상태 중 하나를 반환하고 각 상태마다 다른 UI가 필요합니다.

  • 공유됨 — 연령 신호를 읽을 수 있습니다. 자동 공유 대상 지역에서 인증 또는 자가 신고한 성인과, 부모가 연령을 공유한 감독 대상 미성년자가 해당됩니다.
  • NOT_SHARED — 사용자 또는 보호자가 거부했습니다. 대체 환경이 적용되며, 반복해서 다시 요청하지 마세요.
  • VERIFICATION_REQUIRED — 해당되는 미국 주에서는 신호가 존재하기 전에 사용자가 Play 스토어에서 확인을 완료해야 합니다. 사용자를 그곳으로 보내고, 복귀 시 요청이 멱등성을 유지하도록 하세요.

지역별 동작은 설계상 차이가 있습니다. 선택이 요구되는 지역(예: EU, 영국, 브라질)에서는 사용자가 공유 전 확인, 항상 공유, 공유 안 함 중에서 선택하며, 공유 전 확인 설정에서는 Play가 내장 인앱 프롬프트를 표시합니다. 해당하는 미국 주에서는 인앱 프롬프트가 전혀 없습니다. Play 스토어가 인증을 담당하며, 호출은 SHARED 또는 VERIFICATION_REQUIRED를 반환합니다. 감독 계정의 경우 부모가 Family Link 앱에서 공유를 관리합니다. 사용자가 프롬프트를 닫으면 Play가 몇 번 다시 표시한 후 더 이상 표시하지 않습니다. 따라서 NOT_SHARED에 대한 강제 차단은 기술적 기본값이 아니라 제품 차원의 결정입니다.

4단계 — null을 오독하지 않고 응답 필드 읽기

checkAgeSignals()는 분기 로직을 결정하는 필드를 반환합니다(응답 참조):

  • ageLower / ageUpper — 사용자 연령대의 포함 범위입니다. 기본 연령대는 0-12, 13-15, 16-17, 18+입니다. 최상위 개방형 연령대에서 ageUpper는 null입니다.
  • ageRangeSource — TIER_A 자기 신고, TIER_B 부모·보호자 관리, TIER_C 신용카드·이메일·셀피 평가·정부 발급 신분증·세금 ID로 확인, TIER_D 정부 발급 신분증과 셀피 평가 또는 디지털 ID. 등급은 신뢰도 수준으로 간주하고, 선택한 분기 옆에 기록하세요.
  • significantChangeStatus / significantChangeApprovalDate — APPROVED, PENDING, DECLINED, 또는 해당 관할권이 적용되지 않는 경우 null.
  • installId — 관리 대상 설치에 할당되며, 승인 취소된 앱 알림에 사용됩니다.

함정: null 범위는 "아동"을 의미하지 않습니다. 인증된 성인의 경우에도 두 범위가 모두 null로 반환되며, 상태가 NOT_SHARED이거나 VERIFICATION_REQUIRED일 때도 null로 반환됩니다. 코드에서 "null"을 "제한"으로 매핑하면 결제하는 성인 이용자를 차단하게 됩니다. 상태를 먼저 분기하고 그다음 범위를 분기하며, 상태가 달리 말하지 않는 한 null 범위는 "알 수 없음, 기본 등급 사용"으로 처리하세요.

5단계 — 제품에 필요하다면 Play Console에서 맞춤 연령대를 설정하세요

기본 구간은 실제 제품 규칙과 거의 일치하지 않습니다. Play Console의 연령 신호 페이지에서 맞춤 연령 범위 탭은 최대 세 개의 최소 연령을 허용하며, 최소 연령 간격은 최소 2년 이상이어야 하고 연 1회 변경할 수 있습니다. 최소 연령을 15로 설정하면 0~14세 사용자는 ageLower=0, ageUpper=14를 반환하고 15세 이상 사용자는 ageLower=15만 반환합니다. 13과 17로 설정하면 0-12, 13-16, 17+의 세 구간이 생성됩니다.

변경이 연 1회이므로 저장하기 전에 제품 규칙과 스토어 등록정보 약속을 기준으로 구간을 정하세요. 나중에 조정하는 것은 설정 변경이 아니라 변경 요청입니다.

6단계 — 주요 변경 사항 및 인앱 결제 연령 등급 연결하기

"중대한 변경"은 Google이 아니라 여러분이 정의합니다. 새로운 소셜 기능, 데이터 공유 방식의 변경, 새로운 결제 수단 추가 등 중대한 변경을 할 때는 Play Console의 연령 신호 페이지에서 Play에 알리면 되며, 새 앱 버전은 필요하지 않습니다. 이후 부모가 승인 또는 거절하며, 결과는 significantChangeStatus를 통해 확인합니다. Play는 부모가 거절하더라도 앱 액세스를 취소하거나 앱을 비활성화하지 않는다고 명시합니다. 즉, 그에 따른 결과는 여러분이 정의해야 하며, 승인 철회에 대한 알림 경로는 installId를 통해 이루어집니다.

텍사스는 결제에 별도 트랙을 추가했습니다. 인앱 상품에는 앱의 콘텐츠 등급과 별개로 자체 연령 등급이 필요할 수 있습니다. Play Console이나 Publishing API에서 설정할 수 있으며, Play는 Play Billing을 사용하는 텍사스 이용자의 구매 승인 흐름에 이를 표시합니다. SKU 등급은 나중에 챙길 일이 아니라 출시 점검표의 일부로 다뤄야 합니다. 이를 건너뛴 구매 흐름은 크래시가 아니라 컴플라이언스 지적 사항으로 드러나는 유형의 허점입니다.

7단계 — 오류 코드를 11가지 사례로 나누지 말고 두 그룹으로 처리하세요

오류 표는 사실상 두 그룹으로 나뉩니다. 재시도 가능: -1 API 사용 불가, -2 Play 스토어 없음, -3 네트워크, -4 Play 서비스 없음, -5 서비스 바인딩 불가, -6 Play 스토어 버전 오래됨, -7 Play 서비스 버전 오래됨, -8 클라이언트 일시적 오류. 재시도 불가: -9 Google Play에서 설치하지 않은 앱, -10 더 이상 지원되지 않는 SDK 버전, -100 내부 오류(제목에 API 이름을 기재해 Play 개발자 지원팀에 문의).

첫 번째 그룹에는 종료 조건을 둔 지수 백오프 방식의 제한된 재시도를 적용하고, 실행 가능한 안내 메시지(Play 스토어 업데이트, 연결 확인)를 노출하세요. 두 번째 그룹은 즉시 기본 환경으로 실패 처리하고 로그를 남기세요. APP_NOT_OWNED에 대한 재시도 폭주는 배터리만 낭비할 뿐입니다. 사이드로드된 빌드는 항상 여기에 해당하며, 그래서 테스트에는 직접 설치한 APK가 아니라 문서화된 가짜 매니저가 필요합니다.

8단계 — 데이터 관리 체계를 방어 가능하게 유지

여기서 서로 다른 두 가지 데이터 질문이 혼동됩니다. Play Age Signals 클라이언트 라이브러리 자체는 데이터를 수집하거나 제3자와 공유하지 않으며, Play 스토어가 기기에서 신호를 처리합니다. 값을 읽은 후 이를 어떻게 사용할지는 전적으로 귀하의 몫이며, 정책 리스크가 바로 여기에 있습니다. 개인정보처리방침에 공개하고, 보유 기간은 연령에 적합한 경험에 필요한 범위로 유지하며, 신호를 광고·프로파일링·분석 목적으로 재사용하지 마세요. 약관은 연령에 적합한 경험 제공 목적으로만 사용을 제한하며, 오용 시 API 접근이 종료되고 앱 자체도 위험에 처합니다.

Google는 또한 변조된 빌드로 응답을 위조할 수 없도록 Play Integrity API와 함께 API를 호출할 것을 권장합니다. 이미 통합 중이라면 저렴한 추가 작업이지만, 사고가 난 뒤에 덧붙이면 비용이 큽니다.

출시 전 점검: 세 가지 상태 모두에 대한 접근 상태 처리, null 경계를 절대 "경미"로 취급하지 않기, 제품 규칙에 맞춰 맞춤 구간 고정, 중대 변경 알림 담당자 지정, 텍사스에 대한 인앱 결제 SKU 등급 설정, 재시도 가능한 오류 제한, 개인정보처리방침 업데이트, Play Integrity 검토. 여덟 가지 항목이며, 스토어가 대신 검증해 주는 것은 하나도 없습니다.

출처: developer.android.com의 Play Age Signals API 문서(개요, 연동, 응답, 오류 처리) 및 미국 앱스토어 법안 관련 Play Console 도움말, 모두 2026-10-23 확인. Google Play은 시행 기준이나 앱별 법적 판단을 공개하지 않으며, 본문에서 이를 추론하지 않습니다.

개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.

클릭하여 파일 선택 · 우클릭 → 붙여넣기, 또는 Ctrl/⌘+V로 스크린샷 붙여넣기

파일을 이 상자로 끌어다 놓아도 됩니다.

입력하신 이메일로 답변드립니다. 고객님의 정보는 KappS에만 보관됩니다.

✔ 제출 완료

메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.


← 수정으로 돌아가기