Pierwsze kroki z Piaskownicą prywatności na Androida

Program Piaskownica prywatności na Androida w wersji beta 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). Najpierw zaczniemy obsługiwać niewielki odsetek urządzeń, a z czasem zwiększymy tę liczbę. 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.

W przypadku środowiska wykonawczego SDK udostępniamy deweloperom wersję beta w wersji zamkniętej, aby mogli przetestować dystrybucję pakietu SDK obsługującego środowisko wykonawcze w wybranych aplikacjach.

Aby można było używać wersji beta, deweloperzy muszą skompilować swoje rozwiązania za pomocą aktualizacji rozszerzenia SDK 33 na poziomie interfejsu API.

Rozszerzenia Android SDK

Stabilne interfejsy API w wersjach beta są dostarczane za pomocą nowej metody publikowania rozszerzeń pakietu SDK Androida. Ta metoda umożliwia publikowanie stabilnych funkcji Androida między wersjami głównymi. Zawiera on nowy mechanizm wersji, który udostępnia nowe interfejsy API aplikacjom na różnych poziomach interfejsu API za pomocą aktualizacji systemu Google Play. Rozszerzenie Piaskownica prywatności na Androida SDK nosi nazwę rozszerzeń usług reklamowych. 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ę w programie testów beta

  • Zarejestruj się: ukończ proces rejestracji, aby korzystać z interfejsów API związanych z reklamami.
  • Rejestracja: aby wziąć udział w programie testów beta, musisz się zarejestrować. Dzięki rejestracji możesz:
    • 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 przez pakiet 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 pod kątem korzystania z Piaskownicy prywatności na urządzeniach z Androidem

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:
<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 materiały dla programistów są dostępne?

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

Obrazy systemu pakietu SDK i 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ępny jest pełny dokumentacja interfejsu API.

Pomoc techniczna i komentarze

Podczas testowania Piaskownicy prywatności na Androida zapoznaj się z informacjami o wersji i korzystaj z 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.