Protected Audience는 android.adservices.customaudience 패키지의 일부로 맞춤 잠재고객에 참여하거나 맞춤 잠재고객을 탈퇴하기 위한 일련의 API를 제공합니다. 디버깅 목적으로 맞춤 잠재고객을 나열하고 확인하는 데 사용할 수 있는 CLI 명령어가 있습니다. 이 가이드에서는 광고 기술 개발자가 조인된 맞춤 잠재고객의 상태를 검사하기 위해 따라야 하는 단계를 설명합니다.
설정
보안 및 개인 정보 보호를 위해 맞춤 잠재고객은 기본적으로 표시되지 않으며 디버깅 목적으로만 직접 검사할 수 있습니다. 다음 요구사항이 충족되는 경우에만 이러한 명령어를 사용하여 표시됩니다.
- 시스템 전체 개발자 옵션이 사용 설정됨
android:debuggable="true"는CustomAudience가 조인된 앱의 AndroidManifest.xml 파일에서joinCustomAudience또는fetchAndJoinCustomAudience를 사용하여 선언됩니다.- 앱 추천 광고에 대한 동의가 사용 설정되어 있음
adservices 셸 명령어 사용 설정
- 기기를 다시 시작하여
adservices프로세스를 종료합니다. adservices가 실행되고 있지 않은지 확인합니다. 다음 명령어의 경우 빈 출력이 예상됩니다.
adb shell ps -A | grep adservices
그런 다음 adservices 셸 명령어를 사용 설정하려면 다음 명령어를 실행합니다.
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
맞춤 잠재고객 나열
특정 맞춤 잠재고객을 보려면 owner를 잠재고객을 만든 패키지로, buyer를 잠재고객을 관리하는 광고 네트워크의 식별자로 지정하여 다음 명령어를 실행합니다.
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
custom_audiences 배열이 포함된 JSON 객체가 출력됩니다.
이 배열에 있는 요소의 구조는 다음에 설명된 맞춤 잠재고객 보기 명령어의 출력과 일치합니다.
특정 맞춤 잠재고객 보기
특정 맞춤 잠재고객을 보려면 owner을 잠재고객을 만든 패키지로, buyer를 잠재고객을 관리하는 광고 네트워크의 식별자로, name를 잠재고객 이름으로 지정하여 다음 명령어를 실행합니다.
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
특정 맞춤 잠재고객 새로고침
특정 맞춤 잠재고객의 트리거 일일 업데이트를 수동으로 보려면 owner을 잠재고객을 만든 패키지로, buyer를 잠재고객을 관리하는 광고 네트워크의 식별자로, name를 잠재고객의 이름으로 지정하여 다음 명령어를 실행합니다.
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.