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.