privacysandbox ads

  
Ta biblioteka umożliwia integrację z interfejsami API chroniącymi prywatność, które są częścią Piaskownicy prywatności na Androida.
Ostatnia aktualizacja Wersja stabilna Wersja kandydująca Wersja Beta Wersja alfa
12 marca 2025 r. - - 1.1.0-beta12 -

Deklarowanie zależności

Aby dodać zależność od pakietu privacysandbox-ads, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Odlotowe

dependencies {
 
    implementation "androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12"
   
    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
 
}

Kotlin

dependencies {

    implementation("androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12")

    implementation "androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12"
   
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz zagłosować na istniejący problem, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.1

Wersja 1.1.0-beta12

12 marca 2025 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 są dostępne. Wersja 1.1.0-beta12 zawiera te zatwierdzenia.

Nowe funkcje

  • Priorytet listy niestandardowych odbiorców: dodaliśmy pole priorytetu w przypadku listy niestandardowych odbiorców. Dzięki temu kupujący mogą określić wartość priorytetu w CustomAudience. Ta wartość służy do identyfikowania list odbiorców niestandardowych, które powinny być uwzględnione w aukcji, jeśli zestaw list odbiorców niestandardowych kupującego przekracza limity wielkości na kupującego.
  • Konfiguracja sprzedawcy: ta funkcja umożliwia sprzedawcom definiowanie parametrów aukcji w celu kontrolowania rozmiaru ładunku i uczestników aukcji. Konfiguracja aukcji sprzedawcy pozwoliłaby sprzedawcom określić:
    • Lista dozwolonych kupujących
    • W przypadku aukcji inicjowanych przez danego sprzedawcę tylko kupujący z listy dozwolonych mogliby brać udział w tej aukcji. CustomAudiences
    • Limit rozmiaru na kupującego
    • Sprzedawcy mogą określić limit dla każdego kupującego, aby regulować rozmiar danych przesyłanych przez każdego kupującego w ramach ładunku wysyłanego do SellerFrontendService. Jeśli kupujący przekroczy limit rozmiaru dla kupującego, do pobrania danych w oczekiwanym zakresie zostanie użyty priorytet CustomAudience ustawiony w konfiguracji danych ładunku kupującego.
    • Maksymalny limit rozmiaru ładunku
    • Różni sprzedawcy mogą mieć różne przydzielone zasoby i chcieć ustawić maksymalny limit wielkości ładunku aukcji na żądanie. Maksymalny limit rozmiaru będzie uwzględniać stałe rozmiary zasobników ustawione przez interfejs API ProtectedAudience.
  • Opóźnione aktualizacje niestandardowych list odbiorców: ta funkcja umożliwia kupującym planowanie opóźnionych aktualizacji niestandardowych list odbiorców. Każde żądanie aktualizacji umożliwia wywołującemu zaplanowanie opóźnionej aktualizacji za pomocą nowego interfejsu API scheduleCustomAudienceUpdate(). W przypadku każdej aktualizacji użytkownik może określić zestawy niestandardowych list odbiorców, do których chce dołączyć lub z których chce zrezygnować.

Zmiany w interfejsie API

  • Dodawanie konfiguracji sprzedawcy w interfejsie GetAdSelectionRequest API (Ibb5c7)
  • Udostępnianie interfejsu ScheduleCustomAudienceUpdate jako eksperymentalnego (I6b905)

Wersja 1.1.0-beta11

30 października 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 są dostępne. Wersja 1.1.0-beta11 zawiera te komisy.

Nowe funkcje

  • Ta aktualizacja usuwa obsługę pomiarów w Piaskownicy prywatności i interfejsów API adid w Androidzie R, które zostały wycofane. Wywołania, które mają pobrać klasy menedżera w Androidzie R, będą teraz zwracać wartość null.

Wersja 1.1.0-beta10

21 sierpnia 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 są dostępne. Wersja 1.1.0-beta10 zawiera te komity.

Zmiany w interfejsie API

  • Dodaj brakujące przeciążenia konstruktora Java dla interfejsów GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest i FetchAndJoinCustomAudienceRequest Experimental API. (I19e7f)

Wersja 1.1.0-beta09

10 lipca 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 są dostępne. Wersja 1.1.0-beta09 zawiera te komity.

Zmiany w interfejsie API

  • Dodano brakujące przeciążenia konstruktora Javy dla interfejsu GetAdSelectionDataRequest Experimental API. (Ifbf88).

Wersja 1.1.0-beta08

26 czerwca 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 są dostępne. Wersja 1.1.0-beta08 zawiera te komity.

Nowe funkcje

  • Dodano obsługę chronionych sygnałów aplikacji.
  • Obsługa wielu dostawców chmury w przypadku aukcji serwerów B&A.

Zmiany w interfejsie API

  • Eksperymentalny interfejs API GetAdSelectionDataRequest::seller nie może być pusty. (I68044)
  • Dodaj GetAdSelectionDataRequest::coordinatorOriginUri Eksperymentalny interfejs API. (I18c0b)
  • Dodano interfejs updateSignals API. (Ia8512)

Wersja 1.1.0-beta07

14 maja 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 są dostępne. Wersja 1.1.0-beta07 zawiera te komisy.

Nowe funkcje

  • Usługa GetTopics obsługuje teraz zaszyfrowane odpowiedzi w ramach usługi GetTopicsResponse.

Zmiany w interfejsie API

  • Dodano EncryptedTopic do zajęć GetTopicResponse. (Iab362)

Wersja 1.1.0-beta06

17 kwietnia 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 są dostępne. Wersja 1.1.0-beta06 zawiera te komity.

Uwaga

  • Od wersji 1.1.0-beta06 jetpacka privacysandbox-ads będzie można uzyskać dostęp do interfejsów PPAPI na wszystkich urządzeniach z Androidem R, na których włączono flagi. W przypadku każdego przypadku użycia, który nie powinien obsługiwać Androida R, w kodzie używającym kodu jetpacka privacysandbox-ads będą wymagane dodatkowe zabezpieczenia.

Nowe funkcje

  • Obsługa zgodności wstecznej z Androidem R.

Wersja 1.1.0-beta05

3 kwietnia 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 są dostępne. Wersja 1.1.0-beta05 zawiera te komity.

Poprawki błędów

  • Dodano wykrywanie błędów, gdy definicja klasy nie jest dostępna na urządzeniach z Androidem S z powodu braku znacznika uses-library w pliku manifestu.

Wersja 1.1.0-beta04

24 stycznia 2024 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 są dostępne. Wersja 1.1.0-beta04 zawiera te commity.

Nowe funkcje

  • Nowy interfejs API do obsługi raportowania zdarzeń użytkownika po aukcji
  • Dodano obsługę filtrowania ograniczeń liczby wyświetleń w przypadku reklam remarketingowych
  • Obsługa delegowania funkcji Dołącz do listy niestandardowych odbiorców
  • Obsługa skracania łańcucha zapośredniczenia kaskadowego
  • Obsługa aukcji chronionych na serwerach ustalania stawek i aukcji

Zmiany w interfejsie API

  • Wprowadzenie eksperymentalnego interfejsu API AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2)
  • Wprowadzenie ReportEventRequest::inputEvent eksperymentalnego interfejsu API (Ib94f3)
  • Ustaw opcjonalnie ReportImpressionRequest::adSelectionConfig (Ief280)
  • Wprowadzenie eksperymentalnych interfejsów API AdSelectionManager::getAdSelectionData i AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • Wprowadzenie eksperymentalnej wersji interfejsu CustomAudienceManager::fetchAndJoinCustomAudience (I09152)
  • Przedstawiamy AdSelectionManager::reportEvent eksperymentalny interfejs API (I0d7dc)
  • Wprowadziliśmy eksperymentalny interfejs API AdSelectionManager::updateAdCounterHistogram i zmieniliśmy AdData, aby wskazywał serię AdFilters (I87b83).

Poprawki błędów

  • Adresy URI wejściowe są teraz dopasowywane na podstawie wspólnej witryny lub wspólnego źródła, a nie wymagają dopasowania do dokładnej nazwy hosta.
  • Napraw test, który zawodzi z powodu braku schematu HTTPS (d573058)
  • Popraw schemat HTTPS w adresach URL stron internetowych (cecdcb8)
  • Dodanie adnotacji rzutowania do interfejsów pomiarowych (2dba359)

Wersja 1.1.0-beta03

15 listopada 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 są dostępne. Wersja 1.1.0-beta03 zawiera te commity.

Nowe funkcje

  • Obsługa zgodności wstecznej z Androidem S.

Wersja 1.1.0-beta02

4 października 2023 roku

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 są dostępne. Wersja 1.1.0-beta02 zawiera te commity.

Zmiany w interfejsie API

  • Usunięto sprawdzanie wersji T+ z klas zapytań o pomiar. Aby uzyskać dostęp do klas żądań privacysandbox MeasurementManager, klienci nie muszą sprawdzać wersji platformy T+ po swojej stronie. MeasurementManager będzie miał wartość null w ramach nowego zachowania. (Ieb105)

Wersja 1.1.0-beta01

23 sierpnia 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 zostały opublikowane bez wprowadzenia zmian. Wersja 1.1.0-beta01 zawiera te commity.

Wersja 1.1.0-alpha01

9 sierpnia 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 i androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 są dostępne. Wersja 1.1.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

  • Wprowadzenie listy registerSource (Iae92f)
  • Usunięto użycie eksperymentalnego interfejsu API isAtLeastU() (Ie9117, b/289269026)

Poprawki błędów

Wersja 1.0

Wersja 1.0.0-beta05

7 czerwca 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 są dostępne. Wersja 1.0.0-beta05 zawiera te commity.

Poprawki błędów

  • Dodanie do TopicsManager sprawdzania pakietu SDK 5
  • Zwiększenie zależności od coroutines Kotlin do wersji 1.7.1, aby zapobiec duplikowaniu błędów kompilacji klasy w Gradle

Wersja 1.0.0-beta04

10 maja 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 są dostępne. Wersja 1.0.0-beta04 zawiera te commity.

Poprawki błędów

  • Rozwiązanie problemu z zablokowaniem, gdy wywołujący wywołuje interfejsy API pomiaru adservices w wątku głównym. (I65361)

Wersja 1.0.0-beta03

19 kwietnia 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 są dostępne. Wersja 1.0.0-beta03 zawiera te komitowane zmiany.

Nowe funkcje

  • Włączony interfejs Preview API dla Topics.

Wersja 1.0.0-beta02

22 marca 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 są dostępne. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

  • Włącz interfejsy API MeasurementManager w pakiecie rozszerzenia SDK w wersji 5 lub nowszej.
  • Wyłączenie interfejsów API MeasurementManager w przypadku rozszerzenia pakietu SDK w wersji 4 i starszych.

Wersja 1.0.0-beta01

22 lutego 2023 roku

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 są publikowane bez istotnych zmian. Z gałęzi wewnętrznej została opublikowana wersja 1.0.0-beta01.

Zmiany w zachowaniu

  • Raportowanie atrybucji zostało wyłączone i nie jest dostępne w tej wersji.

Wersja 1.0.0-alpha01

11 stycznia 2023 r.

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 i androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 została opublikowana z gałęzi wewnętrznej.

  • Jest to nowa biblioteka Jetpacka, która umożliwia integrację z interfejsami API Piaskownicy prywatności chroniącymi prywatność (Topics, FLEDGE i Attribution Reporting).
  • Interfejsy API Piaskownicy prywatności Jetpacka mogą być używane jako zamienniki interfejsów API Piaskownicy prywatności dostępnych w rozszerzeniu SDK 4.