Существует ряд настроек, которые вы можете активировать или деактивировать для устройств с Privacy Sandbox на Android.
Отображение пользовательского интерфейса управления Privacy Sandbox
Privacy Sandbox на Android позволяет пользователям устройств контролировать, включены ли API-интерфейсы конфиденциальности (PPAPI) и среда выполнения SDK на их собственных устройствах. Начиная с Developer Preview 5, параметр отображения пользовательского интерфейса управления отключен по умолчанию. В целях разработки и тестирования вам может потребоваться включить пользовательский интерфейс управления. Чтобы включить пользовательский интерфейс управления, используйте следующие команды 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
По умолчанию пользовательский контроль на устройстве отключен. Чтобы включить API Privacy Sandbox и среду выполнения SDK на устройстве, коснитесь переключателя.
![Диаграмма](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=0&hl=ru)
Включите Privacy Sandbox на устройстве.
Хотя в предыдущем разделе пользователь устройства мог выбрать, хочет ли он запускать Privacy Sandbox на своем устройстве, в этом разделе объясняется, как разработчик может включить API-интерфейсы на устройстве с помощью команд adb
.
Включите 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 Privacy Sandbox.
Вам необходимо принудительно загрузить файл регистрации на свое устройство, выполнив следующие действия:
- Вы должны получить электронное письмо от службы поддержки Privacy Sandbox с идентификатором вашей учетной записи регистрации и URL-адресом, указывающим на файл регистрации.
На вашем устройстве, на котором установлена версия Developer Preview, переопределите список регистрации с помощью этой команды.
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(Необязательно, но рекомендуется) Verify override возвращает путь, заданный на предыдущем шаге.
adb shell device_config get adservices mdd_measurement_manifest_file_url
Запустите вызов API от одного из API сохранения конфиденциальности. (например,
registerSource()
из API отчетов об атрибуции,getTopics()
из API тем илиjoinCustomAudience()
из API защищенной аудитории). Ожидается, что этот вызов завершится неудачно.Принудительно запустите задание загрузки.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
Теперь вы можете начать вызывать API-интерфейсы сохранения конфиденциальности в Developer Preview. Теперь вызов, сделанный на шаге 4, должен быть успешным.
Деактивировать регистрацию
В выпусках Developer Preview вы можете получить доступ к API защищенной аудитории и тем без регистрации, выполнив следующие команды adb
для деактивации регистрации.
Защищенная аудитория
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"