Erste Schritte mit der Privacy Sandbox für Android

Das Betaprogramm der Privacy Sandbox für Android bietet stabile APIs. Wir planen, im Laufe des Jahres 2023 mehrere Betaversionen zu veröffentlichen. Mit den Releases des Betaprogramms können Sie Lösungen für eingeschränkte Produktionstests auf Android 13-Mobilgeräten erstellen und testen. Wir werden die Unterstützung für einen kleinen Prozentsatz von Geräten einführen und die Anzahl der Geräte nach und nach erhöhen. Für die Teilnahme können Organisationen den Zugriff für eine begrenzte Anzahl von Geräten anfordern und alle Apps registrieren, die die Privacy Sandbox APIs verwenden.

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

Damit Entwickler den Betarelease verwenden können, müssen sie ihre Lösungen mit einem Update der SDK-Erweiterung auf API-Level 33 kompilieren.

Android SDK-Erweiterungen

Stabile APIs in Betaversionen werden mit der neuen Veröffentlichungsmethode für Android SDK Extensions bereitgestellt. Diese Release-Methode ermöglicht die Veröffentlichung stabiler Android-Funktionen zwischen Hauptversionen. Sie umfasst einen neuen Versionsverwaltungsmechanismus, der neue APIs mithilfe von Google Play-Systemupdates für Apps auf mehreren API-Ebenen verfügbar macht. Die SDK-Erweiterung für die Privacy Sandbox für Android heißt Ad Services Extensions. Weitere Informationen zu Android SDK-Erweiterungen

Mehr erfahren

Führen Sie zunächst die folgenden Schritte aus:

Schritt 1: Für das Betaprogramm registrieren und registrieren

  • Registrieren:Führen Sie den Registrierungsvorgang durch, um die anzeigenbezogenen APIs zu verwenden.
  • Registrieren:Sie müssen sich register, um am Betaprogramm teilnehmen zu können. Durch die Registrierung haben Sie folgende Möglichkeiten:
    • Aktiviere deine eigenen Geräte für interne Testzwecke.
    • Geben Sie eine begrenzte Anzahl von veröffentlichten Apps im Google Play Store an, in die datenschutzfreundliche APIs direkt integriert werden können, oder um SDK-Lösungen einzubinden, die die APIs verwenden.
    • Teste die laufzeitfähige SDK-Bereitstellung im Google Play Store. Dieser Schritt ist nicht erforderlich, wenn Sie nur die SDK-Laufzeit auf dem Gerät testen möchten.

Schritt 2: Entwicklungsumgebung einrichten

Richten Sie die Privacy Sandbox für das Android SDK in Android Studio ein.

Schritt 3: AdServices-Berechtigungen konfigurieren

Erklären 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 musst du 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 unter Android konfigurieren

Konfigurieren Sie die Einstellungen, um die Privacy Sandbox für Android für die Ausführung auf Geräten 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 Anzeigendienst-APIs für Geräte mit Android 12 und niedriger verwenden, Folgendes tun:

  1. Prüfen Sie, ob die Manifestdatei der Client-App das extservices-Tag <uses-library> enthält. Das relevante Tag lautet wie folgt:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Wenn Sie die androidx.privacysandbox.ads jetpack-Bibliothek verwenden, achten Sie darauf, dass Sie die Version 1.1.0-beta05 oder höher verwenden.

Welche Ressourcen für Entwickler sind verfügbar?

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

SDK- und Emulator-System-Images

Mit Android Studio können Sie über den SDK-Manager die neuesten Ad Services-Erweiterungen und Emulator-System-Images 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

Lies dir beim Testen und Entwickeln mit der Privacy Sandbox für Android die Versionshinweise durch und verwende den Issue Tracker, um Probleme zu melden und Feedback zu geben.

Entwicklungsumgebung auf dem neuesten Stand halten

Wir empfehlen Ihnen dringend, Ihre Entwicklungsumgebung mit dem neuesten Release auf dem neuesten Stand zu halten. Dadurch wird sichergestellt, dass Sie über die neuesten Features und Sicherheitspatches verfügen und Ihre Umgebung mit den neuesten Versionen Ihrer Abhängigkeiten kompatibel ist. Registrieren Sie sich für E-Mail-Updates, um über neue Versionen informiert zu werden.