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](https://developers.google.cn/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=19&hl=pt)
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:
- 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.
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>"
(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
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 oujoinCustomAudience()
da API Protected Audience. Espera-se que essa chamada falhe.Force a execução do job de download.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
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"