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

Für Geräte mit Privacy Sandbox auf Android können Sie eine Reihe von Einstellungen aktivieren oder deaktivieren.

Benutzeroberfläche für die Privacy Sandbox-Einstellungen anzeigen

Mit der Privacy Sandbox für Android können Gerätenutzer festlegen, ob die datenschutzfreundlichen 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 Benutzersteuerung standardmäßig deaktiviert. Für Entwicklungs- und Testzwecke können Sie die Benutzeroberfläche für die Nutzersteuerung aktivieren. Verwenden Sie die folgenden adb-Befehle, um die Benutzersteuerung zu aktivieren:

Für Beta- und Produktionsversionen:

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

Standardmäßig ist die Nutzersteuerung auf dem Gerät deaktiviert. Wenn Sie die Privacy Sandbox API und die SDK Runtime auf dem Gerät aktivieren möchten, tippen Sie auf den Schalter.

Die Android-Seite, auf der die Privacy Sandbox API-Betaversion auf dem Gerät aktiviert oder deaktiviert werden kann.
Privacy Sandbox-Benutzersteuerung auf einem Android-Gerät

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 beschrieben, wie Entwickler die APIs auf einem Gerät mit 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

Zu Entwicklungs- und Testzwecken können Sie den PPAPI-Zugriff auf dem Gerät mit den folgenden Befehlen aktivieren oder deaktivieren:

Legen Sie false fest, um Folgendes zu aktivieren:

adb shell device_config put adservices global_kill_switch false

Legen Sie true fest, um Folgendes zu deaktivieren:

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

Nachdem Sie die Registrierung abgeschlossen haben, müssen Sie einige zusätzliche Schritte ausführen, um Ihr Gerät für die Verwendung der Privacy Sandbox APIs vorzubereiten.

Sie müssen die Registrierungsdatei auf Ihr Gerät herunterladen. Gehen Sie dazu so vor:

  1. Sie sollten eine E-Mail vom Privacy Sandbox-Support mit Ihrer Registrierungskonto-ID und einer URL erhalten, die auf die Registrierungsdatei verweist.

  2. Überschreiben Sie auf dem Gerät, auf dem die Entwicklervorschau ausgeführt wird, die Registrierungsliste mit diesem Befehl.

    adb shell device_config put adservices mdd_measurement_manifest_file_url
"<insert URL provided>"

  3. (Optional, aber empfohlen) Prüfen Sie, ob „override“ den im vorherigen Schritt festgelegten Pfad zurückgibt.

    adb shell device_config get adservices mdd_measurement_manifest_file_url

  4. Einen API-Aufruf über eine der datenschutzfreundlichen APIs auslösen (z.B. registerSource() von der Attribution Reporting API, getTopics() von der Topics API oder joinCustomAudience() von der Protected Audience API). Dieser Aufruf sollte fehlschlagen.

  5. Downloadjob erzwingen

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

  6. Sie können jetzt die APIs zur Wahrung des Datenschutzes in der Entwicklervorschau aufrufen. Der in Schritt 4 ausgeführte Aufruf sollte jetzt erfolgreich sein.

Registrierung deaktivieren

In Entwicklervorabversionen können Sie ohne Registrierung auf die Protected Audience API und die Topics API zugreifen. Führen Sie dazu die folgenden Befehle zur Deaktivierung der Registrierung aus.adb

Protected Audience

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"