privacysandbox ads

  
Library ini memungkinkan integrasi dengan Privacy Preserving API, yang merupakan bagian dari Privacy Sandbox di Android.
Update Terbaru Rilis Stabil Kandidat Rilis Rilis Beta Rilis Alfa
12 Maret 2025 - - 1.1.0-beta12 -

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada privacysandbox-ads, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

Groovy

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"
   
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Versi 1.1

Versi 1.1.0-beta12

12 Maret 2025

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta12 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta12 dirilis. Versi 1.1.0-beta12 berisi commit ini.

Fitur Baru

  • Prioritas Audiens Kustom: Kami telah menambahkan kolom prioritas di audiens kustom. Hal ini memungkinkan pembeli menentukan nilai prioritas dalam CustomAudience. Nilai ini akan digunakan untuk mengidentifikasi audiens kustom yang harus disertakan dalam lelang jika kumpulan audiens kustom pembeli melebihi batas ukuran per pembeli
  • Konfigurasi Penjual: Fitur ini memungkinkan penjual menentukan parameter lelang untuk mengontrol ukuran payload dan peserta lelang. Konfigurasi lelang penjual akan memungkinkan penjual untuk menentukan:
    • Daftar pembeli yang diizinkan
    • Untuk lelang yang dimulai oleh penjual tertentu, hanya pembeli dalam daftar yang diizinkan yang dapat memberikan kontribusi CustomAudiences untuk lelang
    • Batas ukuran per pembeli
    • Penjual dapat menentukan batas per pembeli untuk mengatur ukuran data yang diupload oleh setiap pembeli ke dalam payload yang dikirim ke SellerFrontendService. Jika pembeli melebihi batas ukuran per pembeli, prioritas CustomAudience yang ditetapkan dalam konfigurasi payload pembeli akan digunakan untuk mendapatkan data dalam batas yang diharapkan.
    • Batas ukuran maksimum untuk payload
    • Penjual yang berbeda mungkin memiliki alokasi resource yang berbeda dan mungkin ingin menetapkan batas ukuran maksimum untuk payload lelang per permintaan. Batas ukuran maksimum akan mengikuti bucket ukuran tetap yang ditetapkan oleh ProtectedAudience API.
  • Pembaruan Audiens Kustom yang Tertunda: Fitur ini memungkinkan pembeli menjadwalkan pembaruan yang ditangguhkan untuk Audiens Kustom. Setiap permintaan update memungkinkan pemanggil menjadwalkan update tertunda menggunakan scheduleCustomAudienceUpdate() API baru. Untuk setiap pembaruan, pengguna dapat menentukan kumpulan Audiens Kustom yang akan diikuti atau ditinggalkan.

Perubahan API

  • Menambahkan Konfigurasi Penjual di GetAdSelectionRequest API (Ibb5c7)
  • Memperkenalkan ScheduleCustomAudienceUpdate API sebagai eksperimental (I6b905)

Versi 1.1.0-beta11

30 Oktober 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta11 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta11 dirilis. Versi 1.1.0-beta11 berisi commit ini.

Fitur Baru

  • Update ini menghapus dukungan untuk API pengukuran dan adid privacysandbox di Android R, yang tidak digunakan lagi. Panggilan untuk mendapatkan class pengelola di Android R kini akan menampilkan null.

Versi 1.1.0-beta10

21 Agustus 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta10 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta10 dirilis. Versi 1.1.0-beta10 berisi commit ini.

Perubahan API

  • Menambahkan overload konstruktor Java yang tidak ada untuk API Eksperimental GetAdSelectionDataOutcome, PersistAdSelectionResultRequest, ReportEventRequest, dan FetchAndJoinCustomAudienceRequest. (I19e7f)

Versi 1.1.0-beta09

10 Juli 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta09 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta09 dirilis. Versi 1.1.0-beta09 berisi commit ini.

Perubahan API

  • Menambahkan overload konstruktor Java yang tidak ada untuk GetAdSelectionDataRequest Experimental API. (Ifbf88).

Versi 1.1.0-beta08

26 Juni 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta08 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta08 dirilis. Versi 1.1.0-beta08 berisi commit ini.

Fitur Baru

  • Menambahkan dukungan untuk Protected App Signals.
  • Mendukung beberapa penyedia cloud untuk lelang server B&A.

Perubahan API

  • GetAdSelectionDataRequest::seller API eksperimental bersifat non-nullable. (I68044)
  • Menambahkan GetAdSelectionDataRequest::coordinatorOriginUri Experimental API. (I18c0b)
  • Menambahkan updateSignals API. (Ia8512)

Versi 1.1.0-beta07

14 Mei 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta07 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta07 dirilis. Versi 1.1.0-beta07 berisi commit ini.

Fitur Baru

  • GetTopics kini mendukung respons terenkripsi sebagai bagian dari GetTopicsResponse.

Perubahan API

  • Menambahkan EncryptedTopic ke class GetTopicResponse. (Iab362)

Versi 1.1.0-beta06

17 April 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta06 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta06 dirilis. Versi 1.1.0-beta06 berisi commit ini.

Catatan

  • Mulai rilis jetpack privacysandbox-ads 1.1.0-beta06, semua perangkat Android R yang mengaktifkan tanda akan dapat mengakses PPAPI. Untuk kasus penggunaan apa pun yang tidak boleh mendukung Android R, penjaga tambahan akan diperlukan dalam kode yang menggunakan kode jetpack privacysandbox-ads.

Fitur Baru

  • Dukungan kompatibilitas mundur untuk Android R.

Versi 1.1.0-beta05

3 April 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta05 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta05 dirilis. Versi 1.1.0-beta05 berisi commit ini.

Perbaikan Bug

  • Menambahkan deteksi error saat definisi class tidak ditemukan di perangkat Android S karena tag uses-library tidak ada dalam manifes.

Versi 1.1.0-beta04

24 Januari 2024

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta04 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta04 dirilis. Versi 1.1.0-beta04 berisi commit ini.

Fitur Baru

  • API baru untuk mendukung pelaporan peristiwa pengguna pasca-lelang
  • Menambahkan dukungan untuk Pemfilteran batas frekuensi untuk iklan pemasaran ulang
  • Mendukung delegasi Bergabung ke Audiens Kustom
  • Dukungan pemotongan rantai mediasi waterfall
  • Dukungan untuk Protected Auction di Server Bidding dan Lelang

Perubahan API

  • Memperkenalkan API eksperimental AdSelectionManager::selectAds(AdSelectionFromOutcomesConfig) (I86cd2)
  • Memperkenalkan API eksperimental ReportEventRequest::inputEvent (Ib94f3)
  • Menjadikan ReportImpressionRequest::adSelectionConfig opsional (Ief280)
  • Memperkenalkan API eksperimental AdSelectionManager::getAdSelectionData dan AdSelectionManager::persistAdSelectionResultUnified (Ie4d0e)
  • Memperkenalkan CustomAudienceManager::fetchAndJoinCustomAudience API eksperimental (I09152)
  • Memperkenalkan AdSelectionManager::reportEvent API eksperimental (I0d7dc)
  • Memperkenalkan AdSelectionManager::updateAdCounterHistogram API eksperimental dan mengubah AdData untuk menunjukkan serangkaian AdFilters (I87b83)

Perbaikan Bug

  • URI input kini dicocokkan di situs/origin bersama, bukan memerlukan pencocokan nama host yang sama persis.
  • Memperbaiki pengujian yang gagal karena skema HTTPS tidak ada (d573058)
  • Memperbaiki skema HTTPS yang tidak ada dari URL web (cecdcb8)
  • Menambahkan anotasi throws ke API pengukuran (2dba359)

Versi 1.1.0-beta03

15 November 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta03 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta03 dirilis. Versi 1.1.0-beta03 berisi commit ini.

Fitur Baru

  • Dukungan kompatibilitas mundur untuk Android S.

Versi 1.1.0-beta02

4 Oktober 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta02 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta02 dirilis. Versi 1.1.0-beta02 berisi commit ini.

Perubahan API

  • Menghapus pemeriksaan versi T+ dari class permintaan pengukuran. Klien tidak memerlukan pemeriksaan versi platform T+ di sisi mereka untuk mengakses class permintaan MeasurementManager privacysandbox. MeasurementManager akan menjadi null dengan perilaku baru. (Ieb105)

Versi 1.1.0-beta01

23 Agustus 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-beta01 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-beta01 dirilis tanpa perubahan. Versi 1.1.0-beta01 berisi commit berikut.

Versi 1.1.0-alpha01

9 Agustus 2023

androidx.privacysandbox.ads:ads-adservices:1.1.0-alpha01 dan androidx.privacysandbox.ads:ads-adservices-java:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit ini.

Perubahan API

  • Memperkenalkan daftar registerSource (Iae92f)
  • Menghapus penggunaan isAtLeastU() API eksperimental (Ie9117, b/289269026)

Perbaikan Bug

Versi 1.0

Versi 1.0.0-beta05

7 Juni 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta05 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta05 dirilis. Versi 1.0.0-beta05 berisi commit berikut ini.

Perbaikan Bug

  • Menambahkan pemeriksaan ekstensi sdk 5 ke TopicsManager
  • Meningkatkan dependensi coroutine Kotlin ke 1.7.1 untuk mencegah error build class duplikat di gradle

Versi 1.0.0-beta04

10 Mei 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta04 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta04 dirilis. Versi 1.0.0-beta04 berisi commit berikut ini.

Perbaikan Bug

  • Menyelesaikan masalah deadlock saat API pengukuran adservices dipanggil di thread utama oleh pemanggil. (I65361)

Versi 1.0.0-beta03

19 April 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta03 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta03 dirilis. Versi 1.0.0-beta03 berisi commit berikut ini.

Fitur Baru

  • Mengaktifkan Preview API untuk Topics.

Versi 1.0.0-beta02

22 Maret 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta02 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta02 dirilis. Versi 1.0.0-beta02 berisi commit berikut ini.

Perbaikan Bug

  • Mengaktifkan MeasurementManager API untuk Ekstensi SDK versi 5 dan yang lebih baru.
  • Menonaktifkan MeasurementManager API untuk Ekstensi SDK versi 4 dan yang lebih lama.

Versi 1.0.0-beta01

22 Februari 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-beta01 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-beta01 dirilis tanpa perubahan penting. Versi 1.0.0-beta01 dirilis dari cabang internal.

Perubahan Perilaku

  • Attribution Reporting telah dinonaktifkan dan tidak tersedia untuk digunakan dalam rilis ini.

Versi 1.0.0-alpha01

11 Januari 2023

androidx.privacysandbox.ads:ads-adservices:1.0.0-alpha01 dan androidx.privacysandbox.ads:ads-adservices-java:1.0.0-alpha01 dirilis. Versi 1.0.0-alpha01 dirilis dari cabang internal.

  • Ini adalah library Jetpack baru yang memungkinkan integrasi dengan Privacy Preserving API Privacy Sandbox (Topics, FLEDGE, dan Attribution Reporting).
  • API Privacy Sandbox Jetpack dapat digunakan sebagai pengganti langsung untuk API Privacy Sandbox yang disediakan di Extension SDK 4.