Skip to main content

개요

UMP(User Messaging Platform) SDK는 GDPR(일반 데이터 보호 규정) 및 CCPA(캘리포니아 소비자 개인정보 보호법) 준수를 위해 맞춤형 광고에 대한 사용자 동의를 관리합니다.
UMP 연동에는 adrop-ads-backfill 모듈이 필요합니다. 시작하기의 설치 가이드를 먼저 완료해주세요.

기본 사용법

Adrop 초기화 후 Consent Manager를 사용하여 사용자 동의를 요청합니다.

동의 상태

Consent Manager는 다음 상태 중 하나를 반환합니다:

개인정보 설정(Privacy Options)

사용자는 처음 동의한 뒤에도 동의를 바꿀 수 있어야 합니다. UMP가 개인정보 설정 진입점을 요구하면, 앱 설정 화면에 개인정보 설정 항목을 두고 거기에서 개인정보 설정 양식을 띄우세요.
adrop-ads와 adrop-ads-backfill 1.15.0 이상이 필요하며, 두 모듈을 같은 버전으로 유지하세요. 백필이 낮은 버전이면 상태가 항상 UNKNOWN으로 반환되고 양식도 표시되지 않습니다.

진입점 노출 필요 여부 확인

이미 동의한 사용자를 포함해 앱 실행마다 requestConsentInfoUpdate()를 호출하세요. 이 호출이 완료된 뒤에야 진입점 필요 여부가 이번 실행의 값을 반영합니다. 호출하지 않으면 재방문 사용자에게 진입점이 보이지 않습니다. 동의 양식 자체는 필요할 때만 표시됩니다.

개인정보 설정 양식 표시

양식이 닫히면 SDK가 변경된 동의를 반영한 뒤 AdropConsentResult를 전달합니다. 양식은 진입점 노출이 필요한 상태에서만 열리며, 그 외에는 저장된 동의를 바꾸지 않고 현재 상태와 에러를 함께 돌려줍니다.
양식이 열린 동안 사용자가 화면을 벗어나는 등 Activity가 이미 종료된 뒤에도 리스너가 호출됩니다. 콜백에서 Activity UI를 다루기 전에 isFinishing / isDestroyed를 확인하세요.

디버그 설정 (테스트 모드)

개발 중에 GDPR/CCPA 동의 흐름을 테스트하세요:

디버그 지역

디버그 설정은 개발 중에만 사용해야 합니다. 프로덕션 배포 전에 제거하거나 비활성화하세요.reset()은 테스트 전용이므로 운영 코드에서 호출하지 마세요. 사용자가 동의를 바꿀 수 있게 하려면 showPrivacyOptionsForm()을 사용하세요.

모범 사례

조기 요청

SDK 초기화 직후, 앱 라이프사이클 초기에 동의를 요청하고 앱 실행마다 호출하세요.

오류 처리

동의 오류를 적절히 처리하고 대체 동작을 제공하세요.

모든 시나리오 테스트

배포 전에 디버그 설정을 사용하여 모든 동의 시나리오를 테스트하세요.

개인정보 설정 제공

개인정보 설정 진입점이 필요한 상태면 설정 화면에 진입점을 노출해 사용자가 언제든 동의를 바꿀 수 있게 하세요.

관련 문서

타겟팅

사용자 및 문맥 타겟팅 설정

시작하기

SDK 설치 및 설정 가이드

레퍼런스

클래스, 리스너, 에러 코드