Pierwsze kroki z Piaskownicą prywatności na Androida

Program Piaskownicy prywatności na urządzeniach z Androidem w wersji beta zapewnia stabilne interfejsy API. W 2023 r. planujemy wprowadzić kilka wersji beta. W ramach programu wersji beta możesz tworzyć i testować rozwiązania na potrzeby ograniczonych testów produkcyjnych na urządzeniach mobilnych z Androidem 13. Zaczniemy obsługiwać niewielki odsetek urządzeń, a z czasem będziemy zwiększać tę liczbę. Aby wziąć udział w programie, organizacje mogą poprosić o dostęp dla ograniczonej liczby urządzeń oraz zarejestrować aplikacje, które korzystają z interfejsów API Piaskownicy prywatności.

W ramach środowiska wykonawczego SDK udostępniamy zamknięte testy beta, w których deweloperzy mogą przetestować dystrybucję wybranych aplikacji w środowisku wykonawczym SDK.

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

Rozszerzenia Android SDK

Stabilne interfejsy API w wersjach beta są dostarczane przy użyciu nowej metody publikacji rozszerzeń Android SDK. Umożliwia ona publikowanie stabilnych funkcji Androida między głównymi wersjami. Zawiera on nowy mechanizm obsługi wersji, który udostępnia nowe interfejsy API aplikacjom na wielu poziomach API za pomocą aktualizacji systemowych Google Play. Rozszerzenie Piaskownica prywatności na Androida SDK nosi nazwę Rozszerzenia usług reklamowych. Dowiedz się więcej o rozszerzeniach w pakiecie SDK na Androida.

Rozpocznij

Aby rozpocząć, wykonaj te czynności:

Krok 1. Zarejestruj się w programie wersji beta

  • Zarejestruj się: aby korzystać z interfejsów API związanych z reklamami, przejdź proces rejestracji.
  • Zarejestruj się: aby wziąć udział w programie testów beta, musisz się register. Dzięki rejestracji możesz:
    • Włącz własne urządzenia na potrzeby testów wewnętrznych.
    • Określ pewną liczbę opublikowanych aplikacji w Sklepie Google Play, które mogą bezpośrednio integrować interfejsy API chroniące prywatność lub integrować rozwiązania SDK korzystające z tych interfejsów.
    • Przetestuj rozpowszechnianie pakietu SDK w środowisku wykonawczym w Sklepie Google Play. Ten krok nie jest wymagany, jeśli chcesz tylko przetestować środowisko wykonawcze SDK na urządzeniu.

Krok 2. Skonfiguruj środowisko programistyczne

Skonfiguruj w Android Studio pakiet SDK Piaskownicy prywatności na Androida.

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 wejść w interakcję z obsługiwanym urządzeniem z Androidem 13 lub użyć obrazu emulatora odpowiedniego rozszerzenia pakietu SDK.

Krok 5. Skonfiguruj urządzenia do 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 przeprowadzający integrację z interfejsami API usług reklamowych na urządzeniach z Androidem 12 i starszymi wersjami powinni wykonać te czynności:

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

Jakie materiały dla deweloperów są dostępne?

Program Piaskownicy prywatności na urządzeniach z Androidem w wersji beta obejmuje poniższe narzędzia i zasoby.

Obrazy systemu SDK i emulatora

Korzystając z Android Studio, możesz pobrać najnowsze obrazy systemu rozszerzeń i emulatorów usług reklamowych za pomocą Menedżera pakietów SDK. Dowiedz się więcej o tym, jak skonfigurować środowisko programistyczne i jak skonfigurować dostęp do interfejsu API.

Dokumentacja API

Dostępna jest pełna dokumentacja interfejsu API.

Pomoc techniczna i komentarze

W trakcie testowania i tworzenia aplikacji z wykorzystaniem 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.

Aktualizuj środowisko programistyczne

Zdecydowanie zalecamy aktualizowanie środowiska programistycznego do najnowszej wersji. Dzięki temu masz pewność, że masz najnowsze funkcje i poprawki zabezpieczeń, a Twoje środowisko jest zgodne z najnowszymi wersjami zależności. Aby otrzymywać powiadomienia o nowych wersjach, zasubskrybuj e-maile z najnowszymi informacjami.