Configurar dispositivos para usar o Sandbox de privacidade do Android

Há várias configurações que você pode ativar ou desativar nos dispositivos que executam o Sandbox de privacidade do Android.

Mostrar a interface de controle do usuário do Sandbox de privacidade

O Sandbox de privacidade do Android permite que os usuários do dispositivo controlem se as APIs de preservação de privacidade (PPAPI, na sigla em inglês) e o SDK Runtime estão ativados nos próprios dispositivos ou não. Na prévia para desenvolvedores 5 e versões mais recentes, a configuração para mostrar a interface de controle do usuário fica desativada por padrão. Para fins de desenvolvimento e teste, ative a interface de controle do usuário. Para ativar a interface de controle do usuário, use os seguintes comandos adb:

Para builds Beta e de produção:

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

Para as prévias para desenvolvedores:

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

Por padrão, o controle do usuário é desativado no dispositivo. Para ativar a API Privacy Sandbox e o SDK Runtime, toque no botão de ativação no dispositivo.

Diagrama
IU de controle do usuário do Sandbox de privacidade em um dispositivo Android.

Ativar o Sandbox de privacidade no dispositivo

A seção anterior permitiu que o usuário escolhesse se o Sandbox de privacidade seria executado no dispositivo. Nesta seção, explicaremos como um desenvolvedor pode ativar as APIs em um dispositivo usando os comandos adb.

Ativar a PPAPI no dispositivo

Ativar a 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

Desativar a PPAPI

Para fins de desenvolvimento e teste, é possível ativar ou desativar o acesso à PPAPI no dispositivo executando estes comandos:

Defina como false para ativar:

adb shell device_config put adservices global_kill_switch false

Defina como true para desativar:

adb shell device_config put adservices global_kill_switch true

Ativar o SDK Runtime no dispositivo

adb shell device_config put adservices disable_sdk_sandbox false

Etapas após o registro

Depois de concluir o registro, há mais algumas etapas a serem seguidas para preparar seu dispositivo para usar as APIs do Sandbox de privacidade.

Force o download do arquivo de inscrição no seu dispositivo seguindo estas etapas:

  1. Você vai receber um e-mail do suporte do Sandbox de privacidade com o ID da conta e um URL que aponta para o arquivo de inscrição.
  2. No dispositivo com a versão da prévia para desenvolvedores, substitua a lista de nscrições iusando este comando.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
    "<insert URL provided>"
  3. (Opcional, mas recomendado) A verificação de substituição retorna o caminho definido na etapa anterior.

    adb shell device_config get adservices mdd_measurement_manifest_file_url
  4. Acione uma chamada de API de uma das APIs de preservação de privacidade. Por exemplo, registerSource() da API Attribution Reporting, getTopics() da API Topics ou joinCustomAudience() da API Protected Audience. Espera-se que essa chamada falhe.

  5. Force a execução do job de download.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14
  6. Agora, você pode começar a chamar as APIs de preservação de privacidade na prévia para desenvolvedores. A chamada feita na etapa 4 deve funcionar agora.

Desativar o registro

Nas versões da prévia para desenvolvedores, é possível acessar as APIs Protected Audience e Topics sem fazer o registro. Basta executar estes comandos adb de desativação de registro.

Protected Audience

adb shell setprop debug.adservices.disable_fledge_enrollment_check true

Tópicos

adb shell setprop debug.adservices.disable_topics_enrollment_check true

Relatórios de atribuição

adb shell device_config put adservices disable_measurement_enrollment_check "true"