Anleitung zur Fehlerbehebung bei Privacy Sandbox für Android

In diesem Dokument wird beschrieben, wie Sie häufige Probleme beim Einrichten der Datenschutzeinstellungen Sandbox für Android Wenn Sie einen Fehler sehen, der in dieser Anleitung nicht gefunden wird, gehen Sie so vor: informieren Sie uns bitte.

Einige Fehler haben mehrere mögliche Gründe für die Ausgabe. Die folgenden sind einige der häufiger auftretenden Fehler und deren Behebung zu beheben. Fehlermeldung aus einem anderen Grund erhalten.

Vor der Fehlerbehebung

Updates der Gerätekonfiguration deaktivieren

Bei der Behebung von Problemen mit der Privacy Sandbox sollten Sie als Erstes die Updates für die Gerätekonfiguration deaktivieren. Dieses sorgt dafür, dass Ihr Gerät keine aktualisierten Konfigurationen vom Server abruft. und deaktivieren Sie unbeabsichtigt die Privacy Sandbox auf Ihrem Testgerät.

Deaktivieren Sie Aktualisierungen der Gerätekonfiguration mit diesem Befehl:

adb shell device_config set_sync_disabled_for_tests persistent

Wenn Sie die Aktualisierungen der Gerätekonfiguration nach dem Testen wieder aktivieren möchten, haben Sie folgende Möglichkeiten: Geben Sie dazu folgenden Befehl ein:

adb shell device_config set_sync_disabled_for_tests none

Ausführliche Protokollierung von AdServices aktivieren

Die ausführliche Protokollierung von Adservices bietet mehr Kontext zu den Fehlern die Sie sehen. Verwenden Sie zum Aktivieren den folgenden Befehl:

adb shell setprop log.tag.adservices VERBOSE

Achte darauf, dass dein Gerät richtig konfiguriert ist

Wenn Sie die Updates für Ihre Gerätekonfiguration gerade deaktiviert haben, empfehlen wir, diese auszuführen, um sicherzustellen, dass Ihr Gerät richtig konfiguriert ist und während der Tests auf diese Weise erfolgen.

  • Aktivieren Sie die PPAPIs mit den entsprechenden ADB-Befehlen.
  • Registrieren Sie Ihr Gerät oder deaktivieren Sie die Registrierung, je nach Ihren Zielen.

Code prüfen, um sicherzustellen, dass die PPAPIs verfügbar sind

Du kannst deiner Codebasis Checks hinzufügen, um sicherzustellen, dass dein Gerät die für die Privacy Sandbox benötigt wird.

Wenn Sie einen Betarelease über SDK-Erweiterungen verwenden, prüfen Sie, ob der richtige Build vorhanden ist. und die Version der SDK-Erweiterung:

Wenn Sie einen Betarelease über Jetpack-Bibliotheken verwenden, wird die Initialisierung gibt null zurück, wenn die Privacy Sandbox in Ihrem . Beispiel:

Suchen Sie bei jedem Release nach den Google Play-Diensten:

Sicherheitsausnahmen

Fehler von Sicherheitsausnahmen treten in der Regel auf, wenn etwas nicht autorisiert ist, auf eine Privacy Sandbox-Ressource zuzugreifen.

Berechtigung wurde nicht angefordert

Fehler:

Failed to get Ad ID: java.lang.SecurityException: Caller is not authorized to call this API. Permission was not requested.

Mögliche Ursache:

Sie müssen eine Berechtigung für den Zugriff auf die Anzeigen-ID deklarieren.

Problembehebung:

Deklariere die Berechtigung in deinem AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_AD_ID" />

Anrufer nicht autorisiert

Fehler:

Failed to find resolveInfo for adServices service. Intent action: android.adservices.adid.AdIdProviderService

Failed to find AdServices services

Caller not authorized

Mögliche Ursache:

Sie haben Ihr Gerät nicht richtig registriert. Vergewissern Sie sich, dass Sie alle Anleitung zur Registrierung, einschließlich der Anleitung zur Registrierung Schritte zur Konfiguration Ihres Geräts aus.

Mögliche Ursache:

Die Registrierungs-URLs stimmen nicht überein.

Problembehebung:

  1. Überprüfen Sie Ihre Einschreibungsdaten, um festzustellen, ob es Abweichungen zwischen den URL, die Sie in Ihrem Code verwenden, und die URL, die Sie bei der Datenschutzrichtlinie registriert haben Sandbox Beispiel: Sie verwenden https://adtech.example.com/source. aber die registrierte URL war https://adtech.example.com/register_source
  2. Passe deinen Code an die registrierte URL an. Beispielsweise könnten Sie die Zeile in der Beispielanwendung zum Anhängen von „/register_source“ in die URL einfügen. von „/source“.

Wenn dieser Fehler weiterhin angezeigt wird:

Möglicherweise ist Ihr Unternehmen nicht in der Anmeldeliste aufgeführt oder es ist registriert, aber nicht in der Manifest-Zulassungsliste der App enthalten ist. Ihre Organisation muss registriert sein mit der Privacy Sandbox zu beginnen. Wenden Sie sich dazu an android-ps-support@google.com.

Aufrufer ist nicht zulässig

Fehler:

Failed to get Ad ID: java.lang.SecurityException: Caller is not authorized to call this API. Caller is not allowed. Package [package name] is not allowed to call the API.

Mögliche Ursache:

Der Paketname ist nicht in der Zulassungsliste enthalten.

Problembehebung:

Lassen Sie alle Paketnamen in der Zulassungsliste zu:

Wenn Sie ADB Shell direkt verwenden:

Die zuvor aufgeführten Befehle funktionieren für Bash und andere Shells. Wenn Sie jedoch ADB starten, und versuchen, die Befehle auszuführen. Sie sollten den Anführungszeichen. Führen Sie stattdessen die folgenden Befehle aus:

Problembehebung:

Fügen Sie den Paketnamen der Zulassungsliste hinzu:

adb shell device_config put adservices ppapi_app_allow_list [package name]

Prüfen Sie, ob Ihr Paketname auf der Zulassungsliste steht:

adb shell device_config get adservices ppapi_app_allow_list

Bei Bedarf können Sie die Zulassungsliste mit diesem Befehl löschen:

adb shell device_config delete adservices ppapi_app_allow_list

Ausnahmen für illegalen Bundesstaat

Ausnahmen von einem unzulässigen Status signalisieren, dass eine Methode bei einem wenn sich die Umgebung oder Anwendung nicht in einer Status für den angeforderten Vorgang.

Ausnahmen von einem illegalen Bundesstaat: Der Dienst ist nicht verfügbar.

Fehler:

com.example.measurement.sampleapp E Failed binding to measurement service: java.lang.IllegalStateException: Service is not available

Mögliche Ursache:

Der Kill-Switch muss deaktiviert sein.

Problembehebung:

Sie können den Kill-Switch mit diesem Befehl deaktivieren:

adb shell 'device_config put adservices global_kill_switch false'

Mögliche Ursache:

Nutzereinwilligung wurde nicht erteilt.

Problembehebung:

Sie können den folgenden Befehl ausführen:

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

Nachdem der vorherige Befehl ausgeführt wurde, aktivieren Sie die Option Privacy Sandbox aktivieren“. auf „An“.

Fehler bei ADB-Befehlen

Job wurde nicht gefunden

Fehler:

Could not find job 14 in package com.google.android.adservices.api/ user 0

Mögliche Ursache:

Die Privacy Sandbox APIs wurden nicht ausgelöst.

Problembehebung: Rufen Sie vor dem Ausführen dieses Jobs eine der Privacy Sandbox APIs auf, z. B. registerSource(), getTopics() oder selectAds(). Dieser Anruf soll fehlschlagen, aber zum Aktivieren der API erforderlich ist. Führen Sie dann jobscheduler 14 noch einmal aus. .

Mögliche Ursache:

Google Play Store muss aktualisiert werden.

Problembehebung:

  1. Melde dich mit deinem Google-Konto auf deinem Gerät oder im Emulator an.
  2. Rufen Sie den Google Play Store auf > Profilsymbol > Einstellungen > Info: Tippen Sie unter der Überschrift Play Store-Version auf Play Store aktualisieren.

Supportticket einreichen

Wenn der Fehler durch diese Schritte nicht behoben wird, reichen Sie ein Ticket ein und enthalten die folgenden Informationen:

  1. Welche Version verwenden Sie, Entwicklervorschau oder Betaversion? Welche Versionen sind das? bei dir? Den Versionscode findest du unter Einstellungen > Über das Telefon > Build-Nummer.
  2. Wenn Sie einen Betarelease verwenden, führen Sie adb shell getprop | grep build.version.extensions aus und nehmen Sie die Ergebnisse in Ihr Ticket auf.
  3. Welche Version der Google Play-Dienste ist auf Ihrem Gerät installiert? Führen Sie adb shell dumpsys package com.google.android.gms | grep versionName aus und fügen Sie den Ergebnisse dieses Befehls in Ihrem Ticket.
  4. Vollständigen Fehlerbericht hinzufügen Einen vollständigen Fehlerbericht erhalten Sie, indem Sie adb bugreport ausführen oder folgen Sie der Anleitung.