Android의 개인 정보 보호 샌드박스를 사용하기 위한 기기 구성

기기에서 활성화하거나 비활성화할 수 있는 다양한 설정이 있습니다. Android의 개인 정보 보호 샌드박스를 실행하고 있습니다

개인 정보 보호 샌드박스 사용자 제어 UI 표시

Android의 개인 정보 보호 샌드박스를 사용하면 기기 사용자가 개인 정보 보호 API(PPAPI) 및 SDK 런타임을 자체 기기에서 사용 설정할지 여부를 제어할 수 있습니다. 개발자 프리뷰 5부터 사용자 제어 UI를 표시하는 설정이 기본적으로 비활성화됩니다. 개발 및 테스트 목적으로는 사용자 제어 UI를 사용 설정하는 것이 좋습니다. 사용자 제어 UI를 사용 설정하려면 다음을 사용합니다. 다음 adb 명령어를 실행합니다.

베타 및 프로덕션 빌드의 경우:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity

개발자 프리뷰:

adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity

기본적으로 사용자 제어는 기기에서 비활성화되어 있습니다. Privacy Sandbox API 및 SDK 런타임을 사용 설정하려면 기기에서 전환 스위치를 탭합니다.

<ph type="x-smartling-placeholder">
</ph> 다이어그램
Android 기기의 개인 정보 보호 샌드박스 사용자 제어 UI

기기에서 개인 정보 보호 샌드박스 사용 설정

이전 섹션에서는 기기 사용자가 기기에서 개인 정보 보호 샌드박스를 실행할지 선택하는 방법을 설명했고 이 섹션에서는 개발자가 adb 명령어를 사용하여 기기에서 API를 사용 설정하는 방법을 설명합니다.

기기에서 PPAPI 사용 설정

PPAPI 사용 설정

adb shell device_config put adservices ppapi_app_allow_list \"\*\"
adb shell device_config put adservices ppapi_app_signature_allow_list \"\*\"
adb shell device_config put adservices msmt_api_app_allow_list \"\*\" // for attribution
adb shell device_config put adservices adservice_system_service_enabled true
adb shell device_config put adservices adservice_enabled true
adb shell device_config put adservices adservice_enable_status true

PPAPI 비활성화

개발 및 테스트 목적으로 다음 명령어를 실행하여 기기에서 PPAPI 액세스를 활성화하거나 비활성화할 수 있습니다.

다음과 같이 false로 설정하여 활성화합니다.

adb shell device_config put adservices global_kill_switch false

다음과 같이 true로 설정하여 비활성화합니다.

adb shell device_config put adservices global_kill_switch true

기기에서 SDK 런타임 사용 설정

adb shell device_config put adservices disable_sdk_sandbox false

등록 후 단계

등록을 완료한 후 개인 정보 보호 샌드박스 API를 사용하도록 기기를 준비하려면 몇 가지 추가 단계를 거쳐야 합니다.

다음 단계에 따라 등록 파일을 기기에 강제 다운로드해야 합니다.

  1. 개인 정보 보호 샌드박스 지원팀으로부터 등록 계정 ID와 등록 파일을 가리키는 URL이 포함된 이메일을 받게 됩니다.

  2. 개발자 프리뷰 출시를 실행하는 기기에서 다음 명령어를 사용하여 등록 목록을 재정의합니다.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"

  3. (선택사항이지만 권장됨) 재정의가 이전 단계에서 설정된 경로를 반환하는지 확인합니다.

    adb shell device_config get adservices mdd_measurement_manifest_file_url

  4. Privacy Preserving API 중 하나에서 API 호출을 트리거합니다. Attribution Reporting API의 registerSource() 또는 Topics API의 getTopics(), Protected Audience API의 joinCustomAudience()를 예로 들 수 있습니다. 이 호출은 실패할 것으로 예상됩니다.

  5. 다운로드 작업을 강제 실행합니다.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

  6. 이제 개발자 프리뷰에서 Privacy Preserving API를 호출할 수 있습니다. 이제 4단계에서 실행한 호출이 성공적으로 실행됩니다.

등록 비활성화

개발자 프리뷰 출시에서는 다음 등록 비활성화 adb 명령어를 실행하여, 등록하지 않고도 Protected Audience API 및 Topics API에 액세스할 수 있습니다.

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

주제

adb shell setprop debug.adservices.disable_topics_enrollment_check true

기여도 보고

adb shell device_config put adservices disable_measurement_enrollment_check "true"