Erste Schritte mit der Privacy Sandbox für Android

Das Privacy Sandbox für Android-Betaprogramm bietet stabile APIs. Mit den Releases des Betaprogramms können Sie Lösungen für eingeschränkte Produktionstests auf Mobilgeräten mit Android 13 und höher für alle APIs sowie Android 12 und höher für die Attribution Reporting API (ARA) erstellen und testen. Wir beginnen mit einem kleinen Prozentsatz der Geräte und erhöhen die Anzahl im Laufe der Zeit. Dazu können sie Zugriff für eine begrenzte Anzahl von Geräten anfordern und alle Apps registrieren, die die Privacy Sandbox APIs verwenden.

Für die SDK Runtime führen wir eine geschlossene Betaversion durch, in der Entwickler die laufzeitfähige SDK-Bereitstellung für ausgewählte Apps testen können.

Wenn Entwickler die Betaversion verwenden möchten, müssen sie ihre Lösungen mit einer SDK-Erweiterung für API-Ebene 33 kompilieren.

Android SDK-Erweiterungen

Stabile APIs in Beta-Releases werden mit der neuen Release-Methode für Android SDK-Erweiterungen bereitgestellt. Diese Release-Methode ermöglicht die Veröffentlichung stabiler Android-Funktionen zwischen den Hauptversionen. Es gibt einen neuen Versionierungsmechanismus, mit dem neue APIs über Google Play-Systemupdates für Apps auf mehreren API-Levels verfügbar gemacht werden. Die Privacy Sandbox für Android SDK-Erweiterung heißt Ad Services Extensions. Weitere Informationen zu Android SDK-Erweiterungen

Jetzt starten

So beginnen Sie mit der Privacy Sandbox für Android:

Schritt 1: Für das Betaprogramm anmelden und registrieren

  • Registrieren: Führen Sie den Registrierungsprozess durch, um die Anzeigen-APIs zu verwenden.
  • Registrieren: Sie müssen sich registrieren, um am Betaprogramm teilnehmen zu können. Wenn Sie sich registrieren, haben Sie folgende Möglichkeiten:
    • Aktivieren Sie Ihre eigenen Geräte für interne Tests.
    • Geben Sie eine begrenzte Anzahl von veröffentlichten Apps im Google Play Store an, die direkt datenschutzfreundliche APIs oder SDK-Lösungen, die die APIs verwenden, einbinden können.
    • Testen Sie die runtimefähige SDK-Bereitstellung mit dem Google Play Store. Wenn Sie die SDK-Laufzeit nur auf dem Gerät testen müssen, ist dieser Schritt nicht erforderlich.

Schritt 2: Entwicklungsumgebung einrichten

Richten Sie die Privacy Sandbox im Android SDK in Android Studio ein.

Schritt 3: Berechtigungen für AdServices konfigurieren

Deklarieren Sie API-spezifische Berechtigungen und konfigurieren Sie den SDK-Zugriff auf Ressourcen, die von der Ziel-API verwaltet werden.

Schritt 4: Geräte- oder Emulator-Image einrichten

Für End-to-End-Tests müssen Sie mit einem unterstützten Android 13-Gerät interagieren oder ein Emulator-Image für die richtige SDK-Erweiterung verwenden.

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

Konfigurieren Sie die Einstellungen, um Privacy Sandbox unter Android zu aktivieren oder zu deaktivieren.

Bekannte Probleme beheben

Um bekannte Probleme mit der PP API-Integration auf Geräten mit Android 12 und niedriger zu vermeiden, sollten Entwickler, die APIs für Werbedienste auf diesen Geräten verwenden, Folgendes tun:

  1. Prüfen Sie, ob die Manifestdatei der Client-App das Tag <uses-library> extservices enthält. Das entsprechende Tag ist:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Wenn Sie die androidx.privacysandbox.ads Jetpack-Bibliothek verwenden, müssen Sie mindestens Version 1.1.0-beta05 verwenden.

Welche Ressourcen für Entwickler sind verfügbar?

Das Betaprogramm der Privacy Sandbox für Android umfasst die folgenden Tools und Ressourcen.

SDK- und Emulatorsystem-Images

Mit Android Studio können Sie die neuesten Ad Services-Erweiterungs- und Emulator-System-Images über SDK Manager herunterladen. Weitere Informationen zum Einrichten der Entwicklungsumgebung und zum Einrichten des API-Zugriffs

API-Referenz

Die vollständige API-Referenz ist verfügbar.

Support und Feedback

Wenn Sie Privacy Sandbox auf Android-Geräten testen und entwickeln, lesen Sie die Release-Notes und verwenden Sie den Issue Tracker, um Probleme zu melden und Feedback zu geben.

Entwicklungsumgebung auf dem neuesten Stand halten

Wir empfehlen Ihnen nachdrücklich, Ihre Entwicklungsumgebung mit der neuesten Version auf dem neuesten Stand zu halten. So haben Sie die neuesten Funktionen und Sicherheits-Patches und Ihre Umgebung ist mit den neuesten Versionen Ihrer Abhängigkeiten kompatibel. Wenn du über neue Releases informiert werden möchtest, melde dich für E-Mail-Updates an.