Настройка устройств для использования Privacy Sandbox на Android

Существует ряд настроек, которые вы можете активировать или деактивировать для устройств с 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 на устройстве, коснитесь переключателя.

Диаграмма
Пользовательский интерфейс управления Privacy Sandbox на устройстве Android.

Включите 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.

Вам необходимо принудительно загрузить файл регистрации на свое устройство, выполнив следующие действия:

  1. Вы должны получить электронное письмо от службы поддержки Privacy Sandbox с идентификатором вашей учетной записи регистрации и URL-адресом, указывающим на файл регистрации.
  2. На вашем устройстве, на котором установлена ​​версия Developer Preview, переопределите список регистрации с помощью этой команды.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
    "<insert URL provided>"
  3. (Необязательно, но рекомендуется) Verify override возвращает путь, заданный на предыдущем шаге.

    adb shell device_config get adservices mdd_measurement_manifest_file_url
  4. Запустите вызов API от одного из API сохранения конфиденциальности. (например, registerSource() из API отчетов об атрибуции, getTopics() из API тем или joinCustomAudience() из API защищенной аудитории). Ожидается, что этот вызов завершится неудачно.

  5. Принудительно запустите задание загрузки.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
  6. Теперь вы можете начать вызывать 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"