Für Geräte, auf denen die Privacy Sandbox unter Android ausgeführt wird, können Sie eine Reihe von Einstellungen aktivieren oder deaktivieren.
Benutzeroberfläche der Privacy Sandbox-Nutzersteuerung anzeigen
Mit der Privacy Sandbox für Android können Gerätenutzer festlegen, ob die Privacy-Preserving APIs (PPAPI) und die SDK-Laufzeit auf ihren eigenen Geräten aktiviert sind oder nicht. Ab der Entwicklervorschau 5 ist die Einstellung zum Anzeigen der Benutzeroberfläche für die Nutzersteuerung standardmäßig deaktiviert. Zu Entwicklungs- und Testzwecken können Sie die Benutzeroberfläche für die Nutzersteuerung aktivieren. Verwenden Sie die folgenden adb
-Befehle, um die Benutzeroberfläche für die Nutzersteuerung zu aktivieren:
Für Beta- und Produktions-Builds:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.AdServicesSettingsActivity
Für Entwicklervorschauen:
adb shell am start -n com.google.android.adservices.api/com.android.adservices.ui.settings.activities.AdServicesSettingsMainActivity
Die Nutzersteuerung auf dem Gerät ist standardmäßig deaktiviert. Tippe auf den Umschalter, um die Privacy Sandbox API und die SDK-Laufzeit auf dem Gerät zu aktivieren.
![Diagramm](https://developers.google.cn/static/privacy-sandbox/assets/images/TurnOnDevicePrivacyAPIs.png?authuser=6&hl=de)
Die Privacy Sandbox auf dem Gerät aktivieren
Im vorherigen Abschnitt konnte der Gerätenutzer auswählen, ob die Privacy Sandbox auf seinem Gerät ausgeführt werden soll. In diesem Abschnitt wird erläutert, wie Entwickler die APIs auf einem Gerät mithilfe von adb
-Befehlen aktivieren können.
PPAPI auf dem Gerät aktivieren
PPAPI aktivieren
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 deaktivieren
Für Entwicklungs- und Testzwecke können Sie den PPAPI-Zugriff auf dem Gerät mit den folgenden Befehlen aktivieren oder deaktivieren:
Zum Aktivieren auf false
setzen:
adb shell device_config put adservices global_kill_switch false
Zum Deaktivieren auf true
setzen:
adb shell device_config put adservices global_kill_switch true
SDK-Laufzeit auf dem Gerät aktivieren
adb shell device_config put adservices disable_sdk_sandbox false
Schritte nach der Registrierung
Nach Abschluss der Registrierung müssen Sie einige weitere Schritte unternehmen, um Ihr Gerät auf die Verwendung der Privacy Sandbox APIs vorzubereiten.
Sie müssen den Download der Registrierungsdatei auf Ihrem Gerät erzwingen. Gehen Sie dazu so vor:
- Sie sollten vom Privacy Sandbox-Support eine E-Mail mit Ihrer Registrierungskonto-ID und einer URL erhalten, die auf die Registrierungsdatei verweist.
Überschreiben Sie auf dem Gerät, auf dem die Entwicklervorschau-Version ausgeführt wird, die Registrierungsliste mit diesem Befehl.
adb shell device_config put adservices mdd_measurement_manifest_file_url "<insert URL provided>"
(Optional, aber empfohlen) „Überprüfen Sie die Überschreibung“ gibt den im vorherigen Schritt festgelegten Pfad zurück.
adb shell device_config get adservices mdd_measurement_manifest_file_url
Lösen Sie einen API-Aufruf von einer der datenschutzfreundlichen APIs aus. (z.B.
registerSource()
in der Attribution Reporting API,getTopics()
in der Topics API oderjoinCustomAudience()
in der Protected Audience API). Dieser Aufruf wird voraussichtlich fehlschlagen.Erzwingen Sie die Ausführung des Downloadjobs.
adb shell cmd jobscheduler run -f com.google.android.adservices.api 14
Sie können die Privacy Preserving APIs jetzt in der Entwicklervorschau aufrufen. Der Aufruf in Schritt 4 sollte jetzt erfolgreich sein.
Registrierung deaktivieren
In den Entwicklervorschau-Releases können Sie auf die Protected Audience API und die Topics APIs zugreifen, ohne sich zu registrieren. Dazu führen Sie die folgenden adb
-Befehle zur Deaktivierung der Registrierung aus.
Protected Audience API
adb shell setprop debug.adservices.disable_fledge_enrollment_check true
Themen
adb shell setprop debug.adservices.disable_topics_enrollment_check true
Attributionsberichte
adb shell device_config put adservices disable_measurement_enrollment_check "true"