Diese Seite wurde von der Cloud Translation API übersetzt.

Geräte für die Verwendung der Privacy Sandbox unter Android konfigurieren

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 — Benutzeroberfläche der Privacy Sandbox-Nutzersteuerung auf Android-Geräten

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 oder joinCustomAudience() 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"