Vous pouvez activer ou désactiver un certain nombre de paramètres pour les appareils. avec Privacy Sandbox sur Android.
Afficher l'UI des commandes utilisateur de la Privacy Sandbox
La Privacy Sandbox sur Android permet aux utilisateurs de contrôler si les API protégeant la confidentialité (PPAPI) et le SDK Runtime sont activés sur leur propre appareil ou non. Depuis la version Preview développeur 5, le paramètre permettant d'afficher l'UI des commandes utilisateur est désactivé par défaut. Vous pouvez toutefois l'activer à des fins de développement et de test. Pour activer l'interface utilisateur des commandes utilisateur, utilisez
les commandes adb
suivantes:
Pour les builds bêta et de production:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity
Pour les versions Preview développeur:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity
Par défaut, la commande utilisateur est désactivée sur l'appareil. Pour activer l'API Privacy Sandbox et le SDK Runtime sur l'appareil, appuyez sur le bouton d'activation.
<ph type="x-smartling-placeholder">![Diagramme](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=0000&hl=fr)
Activer la Privacy Sandbox sur l'appareil
Alors que la section précédente permettait à l'utilisateur de l'appareil de choisir s'il voulait que la Privacy Sandbox s'exécute sur son appareil, cette section explique comment un développeur peut activer les API sur un appareil à l'aide des commandes adb
.
Activer l'API protégeant la confidentialité sur l'appareil
Activer l'API protégeant la confidentialité
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
Désactiver l'API protégeant la confidentialité
À des fins de développement et de test, vous pouvez activer ou désactiver l'accès de l'API protégeant la confidentialité sur l'appareil en exécutant les commandes suivantes :
Spécifiez false
pour l'activer :
adb shell device_config put adservices global_kill_switch false
Spécifiez true
pour le désactiver :
adb shell device_config put adservices global_kill_switch true
Activer le SDK Runtime sur l'appareil
adb shell device_config put adservices disable_sdk_sandbox false
Étapes après l'enregistrement
Une fois l'enregistrement terminé, vous devez suivre quelques étapes supplémentaires pour préparer votre appareil à utiliser les API Privacy Sandbox.
Vous devez forcer le téléchargement du fichier d'enregistrement sur votre appareil. Pour ce faire, procédez comme suit :
- Vous devriez recevoir un e-mail de l'assistance Privacy Sandbox avec l'ID de votre compte d'enregistrement et une URL pointant vers le fichier d'enregistrement.
Sur un appareil exécutant la version Preview développeur, remplacez la liste d'enregistrement à l'aide de cette commande.
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(Facultatif, mais recommandé) Vérifiez que le remplacement renvoie le chemin défini à l'étape précédente.
adb shell device_config get adservices mdd_measurement_manifest_file_url
Déclenchez un appel d'API depuis l'une des API protégeant la confidentialité (par exemple,
registerSource()
depuis l'API Attribution Reporting,getTopics()
depuis l'API Topics oujoinCustomAudience()
depuis l'API Protected Audience). Cet appel devrait échouer.Forcez l'exécution de la tâche de téléchargement.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
Vous pouvez maintenant commencer à appeler les API protégeant la confidentialité dans la version Preview développeur. L'appel effectué à l'étape 4 devrait maintenant aboutir.
Désactiver l'enregistrement
Dans les versions Preview développeur, vous pouvez accéder aux API Protected Audience et Topics sans avoir à vous enregistrer. Pour ce faire, exécutez les commandes adb
de désactivation de l'enregistrement suivantes.
Protected Audience
adb shell setprop debug.adservices.disable_fledge_enrollment_check true
Thèmes
adb shell setprop debug.adservices.disable_topics_enrollment_check true
Rapports sur l'attribution
adb shell device_config put adservices disable_measurement_enrollment_check "true"