Pierwsze kroki z Piaskownicą prywatności na Androida

Program testów beta Piaskownicy prywatności na Androida zapewnia stabilne interfejsy API. Wersje beta możesz wykorzystywać do tworzenia i testowania rozwiązań w ramach ograniczonego testowania produkcyjnego na urządzeniach mobilnych z Androidem 13 lub nowszym (w przypadku wszystkich interfejsów API) oraz na urządzeniach z Androidem 12 lub nowszym (w przypadku interfejsu Attribution Reporting API). Zaczniemy obsługiwać niewielki odsetek urządzeń i z czasem będziemy je zwiększać. Aby wziąć udział w programie, organizacje mogą poprosić o dostęp dla ograniczonej liczby urządzeń oraz zarejestrować aplikacje korzystające z interfejsów API Piaskownicy prywatności.

Udostępniamy zamkniętą wersję beta środowiska wykonawczego SDK, w ramach której deweloperzy mogą przetestować rozpowszechnianie pakietu SDK w środowisku wykonawczym w wybranych aplikacjach.

Aby korzystać z wersji beta, deweloperzy muszą skompilować swoje rozwiązania z aktualizacją rozszerzenia pakietu SDK na poziomie interfejsu API 33.

Rozszerzenia Android SDK

Stabilne interfejsy API w wersjach beta są dostarczane za pomocą nowej metody publikowania rozszerzeń pakietu SDK Androida. Ta metoda wersji umożliwia udostępnianie stabilnych funkcji Androida między głównymi wersjami. Ma nowy mechanizm obsługi wersji, który udostępnia nowe interfejsy API dla aplikacji na różnych poziomach API za pomocą aktualizacji systemowych Google Play. Rozszerzenie SDK Piaskownicy prywatności na Androida nosi nazwę Ad Services Extensions. Dowiedz się więcej o rozszerzeniach pakietu SDK do Androida.

Rozpocznij

Aby zacząć korzystać z Piaskownicy prywatności na Androida, wykonaj te czynności:

Krok 1. Zarejestruj się i zarejestruj w programie testów beta

  • Rejestracja: aby korzystać z interfejsów API związanych z reklamami, musisz przejść proces rejestracji.
  • Rejestracja: aby wziąć udział w programie testów beta, musisz się zarejestrować. Rejestracja umożliwia:
    • Włącz własne urządzenia na potrzeby testów wewnętrznych.
    • Określ ograniczoną liczbę opublikowanych aplikacji w Sklepie Google Play, które mogą bezpośrednio integrować interfejsy API chroniące prywatność lub rozwiązania pakietu SDK korzystające z tych interfejsów.
    • przetestować rozpowszechnianie pakietu SDK z włączonym środowiskiem uruchomieniowym w Sklepie Google Play; Jeśli chcesz przetestować tylko środowisko uruchomieniowe pakietu SDK na urządzeniu, nie musisz wykonywać tego kroku.

Krok 2. Skonfiguruj środowisko programistyczne

Skonfiguruj Piaskownicę prywatności w pakiecie Android SDK w Android Studio.

Krok 3. Skonfiguruj uprawnienia AdServices

Zadeklaruj uprawnienia dotyczące interfejsu API i skonfiguruj dostęp pakietu SDK do zasobów zarządzanych przez docelowy interfejs API.

Krok 4. Skonfiguruj obraz urządzenia lub emulatora

Aby przeprowadzić kompleksowe testy, musisz korzystać z obsługiwanego urządzenia z Androidem 13 lub użyć obrazu emulatora odpowiedniego rozszerzenia SDK.

Krok 5. Skonfiguruj urządzenia do korzystania z Piaskownicy prywatności na Androida

Skonfiguruj ustawienia, aby włączyć (lub wyłączyć) Piaskownicę prywatności na urządzeniach z Androidem.

Rozwiązywanie znanych problemów

Aby uniknąć znanych problemów z integracją interfejsu PP API na urządzeniach z Androidem 12 lub starszym, deweloperzy, którzy integrują interfejsy API usług reklamowych na tych urządzeniach, powinni wykonać te czynności:

  1. Sprawdź, czy plik manifestu aplikacji klienta zawiera tag <uses-library> extservices. Odpowiedni tag to:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. Jeśli używasz biblioteki jetpack androidx.privacysandbox.ads, upewnij się, że używasz wersji 1.1.0-beta05 lub nowszej.

Jakie zasoby są dostępne dla deweloperów?

Program Piaskownica prywatności na Androida w wersji beta obejmuje te narzędzia i zasoby:

Obrazy pakietu SDK i systemu emulatora

W Android Studio możesz pobrać najnowsze obrazy systemu rozszerzenia Ad Services i emulacji za pomocą Menedżera pakietu SDK. Dowiedz się więcej o konfigurowaniu środowiska programistycznego i konfigurowaniu dostępu do interfejsu API.

Dokumentacja API

Dostępna jest pełna dokumentacja interfejsu API.

Pomoc techniczna i komentarze

Podczas testowania i tworzenia aplikacji z użyciem Piaskownicy prywatności na Androida zapoznaj się z notatkami do wersji i użyj narzędzia do śledzenia problemów, aby zgłaszać problemy i przesyłać opinie.

Aktualizowanie środowiska programistycznego

Zdecydowanie zalecamy aktualizowanie środowiska programistycznego do najnowszej wersji. Dzięki temu masz dostęp do najnowszych funkcji i poprawek zabezpieczeń oraz masz pewność, że środowisko jest zgodne z najnowszymi wersjami zależności. Aby otrzymywać powiadomienia o nowych wersjach, zasubskrybuj e-maile z aktualizacjami.