Configurer des appareils pour utiliser la Privacy Sandbox sur Android

Lorsque vous lisez la documentation concernant la Privacy Sandbox sur Android, cliquez sur le bouton Preview développeur ou Bêta pour sélectionner la version du programme que vous utilisez, car les instructions peuvent varier.

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 ce faire, exécutez la commande adb suivante :

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

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.

Schéma
Figure 1. UI des commandes utilisateur de la Privacy Sandbox sur un appareil Android

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 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 :

  1. 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.

  2. 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>"

  3. (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

  4. 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 ou joinCustomAudience() depuis l'API Protected Audience). Cet appel devrait échouer.

  5. Forcez l'exécution de la tâche de téléchargement.

    adb shell cmd jobscheduler run -f com.google.android.adservices.api  14

  6. 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'inscription 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"