Catatan rilis Android Privacy Sandbox

Privacy Sandbox di Android menawarkan program Pratinjau Developer dan Beta. Kami akan memperkenalkan API dan fitur baru di Pratinjau Developer dari waktu ke waktu dan mempromosikan API yang telah distabilkan ke program Beta. Masukan dianjurkan.

Jika Anda baru menggunakan Privacy Sandbox di Android, mulailah dengan Ringkasan Program. Untuk mulai membangun Privacy Sandbox ke dalam project, siapkan lingkungan pengembangan Anda dan dapatkan Privacy Sandbox di Android pada perangkat pengujian atau emulator Anda.

Rilis saat ini

Pratinjau Android VanillaIceCream

Protected Audience API

  • Kemampuan untuk meneruskan iklan kontekstual yang diautentikasi ke Protected Auction telah ditambahkan. Hal ini juga mencakup pemfilteran negatif untuk aplikasi yang telah diinstal di perangkat serta pembatasan frekuensi pada jumlah klik, tayangan, penayangan, atau kemenangan. Penerapan ini berbeda dengan iterasi sebelumnya karena iklan kontekstual harus ditandatangani oleh teknologi iklan. Baca cara menerapkannya di panduan developer.
  • ContextualAds diganti namanya menjadi SignedContextualAds bersama dengan pengambil dan penyetel terkait di AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Jika aplikasi kontekstual yang tidak diautentikasi diteruskan, aplikasi tersebut akan dihapus dari lelang

Attribution Reporting API

Privacy Sandbox di Android Beta update November 2023

Rilis Privacy Sandbox di Android Beta ini menyertakan update pada API Privacy Sandbox di perangkat Android 14 publik. SDK dan image perangkat tersedia untuk didownload menggunakan SDK Manager Android Studio sebagai Android API 34, Extension Level 10, dan secara fungsional mirip dengan [Pratinjau Developer 9][b25], dengan beberapa modifikasi penting.

Protected Audience API

  • Teknologi iklan kini dapat menggunakan [delegasi audiens kustom][b26] untuk bergabung dengan audiens kustom atas nama pembeli yang tidak memiliki kehadiran di perangkat.
  • Android kini mendukung pengoperasian lelang di layanan Bidding dan Lelang.
  • Lelang Protected Audience mendukung penagihan CPC.
  • Lelang dan pelaporan Protected Audience kini mendukung header versi data untuk sinyal bidding tepercaya.
  • Lelang Protected Audience mendukung pemfilteran pembatasan frekuensi pada peristiwa WIN.
  • Protected Audience kini mendukung [integrasi dengan Attribution Reporting API][b27].

Attribution Reporting API

  • Attribution Reporting API kini mendukung [integrasi dengan Protected Audience][b28]

Runtime SDK

  • Kemampuan dari SDK untuk memuat SDK lain dalam Runtime SDK untuk mendukung kasus penggunaan mediasi

Rilis sebelumnya

Pratinjau Developer 10

Tanggal rilis: 19 Desember 2023

Batasan umum

  • Ada masalah yang menyebabkan layanan Google Play error di latar belakang dan berulang kali memberi tahu pengguna:
    • Memulai ulang perangkat dapat mengatasi masalah ini.
    • Saat menguji, jika Anda mengalami masalah dengan pengaturan waktu habis panggilan asinkron, coba tambahkan perintah adb berikut untuk memperpanjang ambang batas hingga waktu habis:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Perangkat fisik saja: Penambahan Akun Google tidak didukung. Ikuti langkah-langkah berikut untuk menampilkan perangkat ke layar utama:
    • Instal image pratinjau di ponsel.
    • Buka wizard penyiapan tanpa menghubungkan ke Wi-Fi atau data seluler.
    • Setelah berada di layar utama, hubungkan ke Wi-Fi atau data seluler.
    • Boot ulang perangkat.

Protected Audience API

  • Kami memperkenalkan kemampuan baru, [Sinyal Aplikasi Terlindungi][dp98], untuk mendukung penayangan iklan instal aplikasi yang relevan. Dengan DP ini, kami merilis API guna memungkinkan teknologi iklan untuk:
    • Menyeleksi sinyal dengan menyimpan peristiwa aplikasi dalam penyimpanan di perangkat terlindung yang digunakan untuk menayangkan iklan instal aplikasi yang relevan.
    • Menjalankan Protected Auction pada layanan Bidding dan Lelang yang berjalan dalam Trusted Execution Environment, tempat layanan tersebut dapat mengakses sinyal masing-masing untuk membantu bidding dan pemilihan iklan.

Attribution Reporting API

  • Versi Attribution Reporting API ini:
    • Menambahkan integrasi Protected Audience, yang mengaktifkan dimensi audiens kustom dalam laporan ringkasan gabungan.
    • Mendukung Penyedia Google Cloud sebagai TEE untuk Layanan Penggabungan.
    • Menambahkan kolom shared_debug_key guna mendukung proses debug untuk atribusi lintas jaringan tanpa pengalihan.
    • Menambahkan header versi dalam permintaan laporan proses debug panjang.

Personalisasi di Perangkat

  • Rilis awal untuk peneliti dan pengembangan awal.
  • Personalisasi di Perangkat memperkenalkan cara inovatif untuk menyesuaikan produk dan layanan sekaligus memberikan perlindungan privasi pengguna akhir yang ditingkatkan. Personalisasi Di Perangkat menyediakan serangkaian layanan dan algoritma sebagai elemen penyusun untuk mencapai hal ini, termasuk, tetapi tidak terbatas pada:
    • Federated Compute (FC) yang memungkinkan pelatihan, evaluasi, dan personalisasi model menggunakan Federated Learning. Penggunaan Compute Federasi pada Personalisasi Perangkat akan didasarkan pada pelatihan model dan inferensi (secara opsional jika diperlukan).
    • Pencocokan berbasis Filter Cuckoo dan pencocokan silang antar-data yang terletak berbeda.
    • Pelatihan Diferensial Pribadi (DP) untuk model sparse menggunakan teknik baru seperti Minimalisasi Alternatif DP (untuk pelatihan data yang berlokasi berbeda), dan personalisasi model berdasarkan DP baliho. ### Pratinjau Developer 9

Tanggal rilis: 15 Agustus 2023

Batasan umum

  • Data lelang yang dibuat dengan memanggil Bidding dan Auction API tidak otomatis dihapus di DP9.
  • Memanggil getAdSelectionData dan persistAdSelectionResult saat izin dicabut akan menyebabkan error pada proses.
  • Fitur pemfilteran negatif tidak berfungsi dengan getAdSelectionData dan persistAdSelectionResult.

Protected Audience API

  • Teknologi iklan kini dapat menggunakan delegasi audiens kustom untuk menggabungkan audiens kustom ke pemanggil di perangkat.
  • Android kini mendukung pengoperasian lelang di Layanan Bidding dan Lelang - Lelang Protected Audience mendukung penagihan CPC.
  • Report Interactions API kini disebut reportEvent.
  • Nama metode pembatasan frekuensi dan jenis penghitung telah diganti.
  • Pelaporan debug tersedia untuk mendapatkan informasi tentang alasan lelang kalah atau untuk mengidentifikasi masalah dalam logika JavaScript.

Attribution Reporting API

  • Rilis ini meningkatkan laporan debug untuk Attribution Reporting API dengan:
    • Mendukung laporan debug panjang yang didukung di web.
    • Mengaktifkan laporan debug atribusi lintas web dan aplikasi (memerlukan AdId di pendaftaran web dan aplikasi).
  • Teknologi iklan dapat mengonfigurasi parameter derau untuk berbagai skenario pelaporan.
  • Rilis ini beralih ke atribusi berbasis origin, yang berarti:
    • Origin digunakan untuk pendaftaran.
    • Beberapa origin diterima dalam satu situs.
    • Pembatasan kapasitas baru satu origin per aplikasi sumber atau pendaftaran.
  • Teknologi iklan kini dapat menonaktifkan pendaftaran untuk menguji kasus penggunaan Pelaporan Atribusi secara lokal.

Runtime SDK

  • SDK hanya dapat memulai atau mengikat ke daftar layanan yang diizinkan.
  • SDK ini hanya dapat mengakses subset dari ContentProvider sistem (seperti com.android.providers.settings.SettingsProvider), saat data yang diperoleh tidak memiliki ID dan tidak dapat digunakan untuk membuat sidik jari pengguna. Pemeriksaan ini juga berlaku untuk mengakses ContentProvider menggunakan ContentResolver.
  • SDK hanya dapat mengakses subset penerima siaran yang dilindungi (seperti android.intent.action.AIRPLANE_MODE).
  • SDK dapat meluncurkan aktivitas milik aplikasi lain, tetapi dengan batasan tentang apa yang dapat dikirim dalam Intent.

Privacy Sandbox di Android Beta update Maret 2023

Rilis Privacy Sandbox di Android Beta pada Maret 2023 menyertakan update pada API Privacy Sandbox di perangkat Android 13 publik. Rilis ini mencakup API Ekstensi Layanan Iklan 5 dan secara fungsional mirip dengan Pratinjau Developer 6, dengan beberapa modifikasi utama.

Batasan umum

  • Tugas pengambilan di latar belakang yang berjalan secara berkala untuk mengupdate audiens kustom FLEDGE menyebabkan proses menjadi error. Karena masalah ini, FLEDGE dinonaktifkan secara default.

Umum

  • Anda dapat menggunakan Attribution Reporting API sejak rilis ini. API ini telah dinonaktifkan sebelumnya. Jika Anda menggunakan Attribution Reporting API pada rilis Beta sebelumnya, hapus data aplikasi atau perangkat Anda sebelum menggunakan rilis Beta ini dengan salah satu langkah berikut:
    • Di perangkat atau emulator, buka Setelan dan hapus penyimpanan khusus aplikasi (bukan hanya cache) untuk aplikasi apa pun yang digunakan untuk pengujian.
    • Reset perangkat fisik atau emulasi ke setelan pabrik.
    • Untuk perangkat emulasi, jalankan fungsi Hapus Data.
  • Pelaporan Atribusi kini mendukung kunci debug, yang memungkinkan developer menerima laporan yang tidak diubah dan laporan privasi yang ditingkatkan dari Attribution API. Kunci debug memberikan peluang untuk mendapatkan visibilitas yang lebih baik dalam cara penyusunan laporan saat Anda melakukan transisi ke Privacy Sandbox.
  • Pelaporan Atribusi baru-baru ini mengalami bug dengan Layanan Iklan yang menyebabkan registerSource dan registerTrigger gagal dengan pengecualian. Jika Anda mengalami masalah ini selama pengembangan, perbaikan telah diluncurkan dan masalah ini akan teratasi seiring waktu.
  • Fungsi pratinjau Topics API kini memiliki kesetaraan dengan Privacy Sandbox di Pratinjau Developer Android. Pemanggil Topics API dapat melihat pratinjau topik tanpa menyertakan panggilan pengambilan topik dalam penghitungan epoch mingguan atau memengaruhi daftar topik yang diamati untuk pemanggil. Lihat kolom shouldRecordObservation untuk mengetahui detailnya.

  • Untuk mengaktifkan pengujian di FLEDGE pada Android, daftar ke program Beta dan gunakan Akun Google yang sama tersebut untuk login ke perangkat pengujian Anda. Jika tidak, upaya untuk memanggil API akan menyebabkan IllegalStateException dengan pesan "Service is not available" (Layanan tidak tersedia). FLEDGE harus diaktifkan kembali dalam rilis Beta berikutnya.

    Sementara itu, pengujian menggunakan Pratinjau Developer dapat dilanjutkan dan dianjurkan, dan FLEDGE dapat diaktifkan secara manual di perangkat dengan peringatan berikut:

    Anda dapat mengaktifkan FLEDGE dengan perintah adb berikut. Namun, hal ini menyebabkan proses pengambilan di latar belakang error, yang berdampak negatif pada metrik kesehatan sistem. Ini bukan solusi permanen karena nilai ini dapat direset oleh platform.

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

Rilis sebelumnya

Pratinjau Developer 8

Tanggal rilis: 23 Mei 2023

Batasan umum

  • Meskipun filter batas frekuensi berjenis WIN dapat ditambahkan ke iklan Protected Audience, jenis WIN belum didukung, dan filter jenis ini diabaikan.
  • Untuk melaporkan tayangan yang menang kepada pembeli yang memenangkan lelang Protected Audience, pembeli harus terdaftar di Privacy Sandbox. Persyaratan ini tidak dapat diabaikan.
  • Untuk mengakses setelan Privacy Sandbox di perangkat yang menyediakan Privacy Sandbox, buka Settings> Google > Ads > Privacy Sandbox.
  • Tidak dapat men-deploy project dengan emulator di Android Studio Giraffe. Versi lain Android Studio akan berfungsi dengan baik. Perbaikan akan diluncurkan ke Android Studio Giraffe pada 26 Mei 2023.

Protected Audience API

Attribution Reporting API

  • Menambahkan filter pemicu OR. Artinya, filter sekarang terdiri dari kumpulan filter, yang merupakan daftar peta filter. Jika dalam kumpulan itu tidak ada peta filter yang cocok dengan data filter sumber, objek event_trigger_data akan diabaikan.
  • Masa berlaku tayangan dan periode pelaporan untuk API agregasi dan level peristiwa telah dipisahkan.
  • Menambahkan dukungan untuk kunci penghapusan duplikat dalam laporan gabungan.
  • Menambahkan scheduled_report_time ke laporan peristiwa untuk paritas dengan Privacy Sandbox untuk Web.
  • Menerapkan atribusi lintas jaringan tanpa pengalihan.

Runtime SDK

Pratinjau Developer 7

Tanggal rilis: 26 Januari 2023

FLEDGE di Android API

  • Parameter custom_audience_signals telah diganti namanya dalam metode JavaScript berikut:
    • generateBid() telah diganti namanya menjadi custom_audience_bidding_signals.
    • scoreAd() telah diganti namanya menjadi custom_audience_scoring_signals.
    • reportWin() telah diganti namanya menjadi custom_audience_reporting_signals.
  • Rilis ini menambahkan penggantian selectAds baru yang menggunakan AdSelectionFromOutcomeConfig untuk membandingkan hasil selectAds. Hal ini membuat SDK teknologi iklan dapat memanfaatkan API ini untuk menjalankan mediasi waterfall. Detail selengkapnya diuraikan dalam panduan developer.
  • selectAds() API kini mendukung caching untuk logika bidding dan penskoran yang diambil JavaScript selama proses pemilihan iklan.
    • Cache dapat dikontrol dengan header Cache-Control yang ditampilkan oleh server selama panggilan pengambilan JavaScript. Gunakan no-cache atau no-store untuk mencegah respons JavaScript di-cache, dan max-age untuk mengontrol durasi cache.
    • max-age entri cache saat ini disetel ke dua hari secara default.

Pelaporan Atribusi di Android API

  • Rilis ini menambahkan dukungan untuk pengalihan daisy-chain untuk registerSource() dan registerTrigger(). Konsumen API kini dapat menggunakan pengalihan HTTP sebagai respons server.

Rilis Beta awal, Januari 2023

Tanggal rilis: 9 Januari 2023

Privacy Sandbox di Android Beta 1 mewakili ketersediaan pertama Privacy Sandbox API di perangkat publik, dan menambahkan peningkatan pada area yang tercantum berikutnya.

Umum

  • Privacy Sandbox di Android Beta 1 secara fungsional setara dengan Pratinjau Developer 5, dengan beberapa fitur dan batasan tambahan yang tercantum di bawah ini.
  • Developer harus menyelesaikan proses pendaftaran untuk menggunakan API terkait iklan (termasuk Topics, FLEDGE, dan Attribution Reporting). Proses pendaftaran memverifikasi identitas developer dan mengumpulkan data khusus developer yang diperlukan oleh API.
  • Dengan rilis Privacy Sandbox di Android Beta 1, developer yang telah mendaftarkan dan mengirimkan detail ke daftar yang diizinkan dapat memperoleh kesempatan untuk melakukan pengujian di perangkat fisiknya sendiri. Untuk mengembangkan API stabil dalam rilis, download SDK Ad Services Extensions 4 yang baru.

Topics API

Attribution Reporting API

  • Attribution Reporting telah dinonaktifkan dan tidak tersedia untuk digunakan dalam rilis ini. Akses ke API ini akan diaktifkan kembali dalam rilis Beta berikutnya. Sebaiknya lanjutkan pengujian dengan Pratinjau Developer.

Runtime SDK

Batasan berikut diperkirakan akan diperbaiki dalam rilis platform Android utama berikutnya:

  • Rendering iklan dalam tampilan yang dapat di-scroll seperti RecyclerView saat ini tidak berfungsi dengan baik. Anda mungkin mengalami jank jika elemen diubah ukurannya. Peristiwa scroll sentuh pengguna tidak diteruskan ke runtime dengan benar.
  • Rendering WebView tidak tersedia dalam proses Runtime SDK.
  • Penyimpanan per SDK tidak tersedia.
  • Dukungan untuk getAdId API dan getAppSetId API belum diaktifkan.

Pratinjau Developer 6

Tanggal rilis: 31 Oktober 2022

Privacy Sandbox di Pratinjau Developer Android 6 menambahkan peningkatan pada area berikut:

Umum

  • Untuk menyiapkan peluncuran produksi, Pratinjau Developer 6 memperkenalkan tanda untuk menonaktifkan akses Privacy-Preserving API secara default. Untuk tujuan pengujian, aktifkan akses Privacy-Preserving API di Pratinjau Developer dengan menjalankan perintah berikut:

    adb shell device_config put adservices global_kill_switch false

  • AdIdManager API dan AppSetIdManager API memerlukan layanan Google Play versi 22.36.16 atau yang lebih tinggi.

    • Di perangkat yang didukung Android, pastikan versi yang tepat tercantum di bagian Setelan > Aplikasi > Layanan Google Play.
    • Jika Anda perlu mengupdate layanan Google Play ke versi yang tepat, login di emulator atau perangkat pengujian Android dengan Akun Google. Lalu buka Google Play Store > ikon profil > Setelan > Tentang. Di bagian judul Versi Play Store, ketuk Update Play Store.
    • Langkah ini hanya berlaku untuk pengembangan dan pengujian, namun tidak akan diperlukan setelah Privacy Sandbox diluncurkan kepada pengguna publik.

Topics API

  • Menambahkan Preview API untuk beralih antara getTopics mendaftar sebagai observer atau tidak.
  • Perubahan kecil pada kode inisialisasi untuk class GetTopicsRequest.
  • Panduan integrasi topik dirilis.

FLEDGE di Android API

  • Jika Anda melakukan pengujian terhadap server sungguhan, opsi mengaktifkan API akan diterapkan sekarang. Ikuti langkah-langkah ini untuk mengonfigurasi perangkat Anda. Langkah-langkah ini tidak diperlukan jika Anda menggunakan penggantian jarak jauh yang ada dalam aplikasi contoh.
  • Perubahan yang Dapat Menyebabkan Gangguan:
    • Mengganti Url dalam parameter dengan Uri. Ini berlaku untuk semua FLEDGE API dan JavaScript kustom untuk logika penskoran dan bidding.
    • Menghapus kolom owner dari input Custom Audience API.
  • Kini, audiens kustom yang tidak lengkap akan langsung memenuhi syarat untuk dimuat ulang di latar belakang.
  • Batas memori JavaScript kini ditetapkan menjadi 10 MB. Hal ini berlaku untuk logika penskoran dan bidding.

Attribution Reporting API

  • Teknologi iklan harus mendaftar sebelum dapat menggunakan Attribution Reporting API di Pratinjau Developer 6. Lihat Mendaftar ke akun Privacy Sandbox untuk mengetahui informasi selengkapnya.
  • Rilis ini memperkenalkan kunci debug sehingga developer dapat menerima laporan yang tidak diubah bersama dengan laporan privasi yang ditingkatkan dari Attribution Reporting API. Kunci debug memberikan peluang untuk mendapatkan visibilitas yang lebih baik dalam cara penyusunan laporan saat melakukan transisi dengan Privacy Sandbox.

Pratinjau Developer 5

Umum

  • Sebelum Anda dapat mengakses API Privacy Sandbox di Pratinjau Developer 5, Anda harus mengaktifkan API dan mengonfigurasi izin khusus API terlebih dahulu.
    • Desain untuk Privacy Sandbox di Android memungkinkan pengguna mengontrol apakah API perlindungan privasi dan Runtime SDK aktif di perangkat mereka. Setelan ini ditetapkan sebagai dinonaktifkan secara default di Pratinjau Developer 5. Anda dapat mengaktifkan akses API menggunakan perintah adb.
    • Aplikasi pemanggil harus menentukan izin khusus API dalam manifes dan konfigurasi AdServices terkait yang mengontrol akses untuk SDK tersemat.
  • Aplikasi harus memanggil API perlindungan privasi saat berjalan di latar depan.
  • AdIdManager dan AppSetIdManager saat ini tidak beroperasi. Fitur ini akan diaktifkan pada rilis berikutnya.

Runtime SDK

  • sendData() tidak akan digunakan lagi dalam versi mendatang.
  • loadSdk() kini menampilkan objek IBinder untuk memfasilitasi komunikasi 2 arah antara SDK yang mendukung runtime dan aplikasi yang ditentukan di AIDL.
  • Aplikasi memiliki akses ke peristiwa siklus proses SDK tambahan yang mendukung runtime, seperti saat proses SDK dihentikan.

Attribution Reporting API

Rilis ini memperkenalkan fitur tambahan di Attribution Reporting API, termasuk:

  • Dukungan laporan agregasi terenkripsi.
  • Dukungan pengukuran lintas aplikasi dan web.
  • Header gabungan dalam respons pendaftaran sumber dan pemicu:
    • Sumber: Attribution-Reporting-Register-Aggregatable-Source sekarang menjadi bagian dari Attribution-Reporting-Register-Source
    • Pemicu: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data dan Attribution-Reporting-Register-Aggregatable-Values telah digabungkan ke dalam satu header bernama Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects masih merupakan header terpisah

FLEDGE di Android API

Rilis ini mencakup beberapa fitur dan peningkatan baru, serta perubahan yang dapat menyebabkan gangguan:

  • Perubahan yang dapat menyebabkan gangguan:
    • runAdSelection() diganti namanya menjadi selectAds().
    • Mengganti parameter AdSelectionConfig.Builder.setAdSelectionSignals() dengan AdSelectionSignals, yang mewakili objek JSON.
    • Mengganti penggunaan String untuk mewakili pembeli/penjual teknologi iklan dengan objek AdTechIdentifier.
    • Menambahkan class TestCustomAudienceManager dan TestAdSelectionManager untuk mengganti pengambilan JavaScript jarak jauh.
    • Pemilik audiens kustom harus berupa nama paket aplikasi panggilan.
  • FLEDGE API kini memvalidasi aplikasi pemanggil terhadap serangkaian pembatasan dan batasan yang dijelaskan dalam panduan developer. Berikut adalah beberapa contoh yang penting.
    • selectAds dan reportImpression kini memiliki batas waktu eksekusi, setelah itu, panggilan akan dihentikan.
    • selectAds dan reportImpression sekarang memiliki batas memori yang terpakai selama eksekusi JavaScript. API akan menampilkan error jika pemakaian memori melebihi batas yang dikonfigurasi.
    • selectAds dan reportImpression kini memvalidasi objek AdSelectionConfig untuk memastikan kolom secara sintaksis valid dan bahwa URL berada di bawah eTLD+1 yang digunakan di kolom penjual.
    • AdServices kini memvalidasi audiens kustom pada saat pembuatan. Beberapa validasi ini mencakup memastikan waktu habis masa berlaku valid dan menerapkan batas jumlah audiens kustom yang dapat dibuat oleh aplikasi dan total ukuran iklan yang diberikan dalam panggilan joinCustomAudience. Validasi juga menerapkan bahwa URI yang disediakan untuk pengambilan sinyal dan logika bidding serta pengambilan latar belakang berada di domain pembeli.
  • Metadata audiens kustom diperbarui setiap hari melalui proses pengambilan latar belakang.
  • Audiens kustom dihapus saat aplikasi "pemilik" di-uninstal.
  • Menambahkan dukungan untuk menentukan Sinyal Penskoran Tepercaya dan Data Bidding Tepercaya selama pemilihan iklan. Lihat contoh kode untuk format respons.
  • FLEDGE untuk Android API bergantung pada WebView versi 105.0.5195.58 atau yang lebih tinggi. Lihat informasi penyiapan di panduan developer untuk mengetahui detailnya.

  • Masalah Umum:

    • Saat bergabung dengan audiens kustom, platform saat ini tidak langsung melakukan update latar belakang, jika salah satu metadata atau nilai AdData kosong atau null. Audiens kustom tidak akan memenuhi syarat untuk pemilihan iklan sebelum diupdate satu hari kemudian. Rilis mendatang akan membuat audiens kustom yang tidak lengkap langsung memenuhi syarat untuk melakukan update pengambilan di latar belakang. Batas memori default saat ini untuk eksekusi JavaScript terlalu rendah dan dapat menyebabkan beban kerja normal menimbulkan error pada JavaScript Engine pada perangkat. Eksekusi JavaScript Anda mungkin tiba-tiba berhenti dengan pesan error "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Anda dapat mengatasi masalah ini secara manual dengan mengonfigurasi ambang batas memori yang sesuai dengan perintah berikut:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Iklan audiens kustom yang tidak cocok dengan struktur JSON yang diperlukan akan diupdate selama pengambilan latar belakang.

Topics API

Update Alat

Android Studio Canary memiliki dukungan untuk membuat APK SDK dengan jenis modul baru. Panduan Developer Runtime SDK telah diupdate, dan aplikasi contoh Privacy Sandbox di GitHub mencerminkan update ini.

Pratinjau Developer 4

Tanggal rilis: 14 Juli 2022

Privacy Sandbox di Pratinjau Developer Android 4 menambahkan peningkatan pada area berikut:

Runtime SDK

  • Aplikasi kini dapat berkomunikasi dengan SDK berkemampuan runtime (RE-SDK) yang diaktifkan melalui penambahan sendData().
  • Penyimpanan lokal kini tersedia dalam proses Runtime SDK.
  • SDK juga dapat merender iklan atau konten berbasis video mandiri di Runtime SDK.
  • Menambahkan klarifikasi seputar penggunaan refleksi untuk menyertakan kemampuan menggunakan refleksi asalkan konten tidak berada dalam RE-SDK lain.

Attribution Reporting API

Rilis ini memperkenalkan perubahan untuk meningkatkan kejelasan terkait penggunaan Attribution Reporting API, seperti:

  • Perubahan dalam format laporan gabungan untuk meningkatkan keterbacaan.
  • Memperbarui kolom header untuk fitur Pemfilteran Konversi dan Bidding.
  • Menambahkan klarifikasi dalam referensi WebApp API untuk menjelaskan pendaftaran sumber dan pemicu, serta ketersediaan API privasi dan izin.

FLEDGE di Android API

Rilis ini mencakup fitur baru untuk membantu dalam pengujian dan kemampuan debug, serta peningkatan internal:

  • Menambahkan dukungan untuk mengganti URL jarak jauh untuk mengambil logika JavaScript selama pengembangan.
  • Peningkatan pelaporan error selama pemilihan iklan.
  • Audiens kustom yang tidak aktif kini difilter selama pemilihan iklan.

Topics API

Rilis ini mencakup beberapa perubahan signifikan pada Topics API, yang paling penting:

  • Jenis nilai yang ditampilkan dari getTopics() API telah diubah menjadi jenis objek Topic baru yang mengenkapsulasi ID bilangan bulat yang sesuai dengan Topik dalam Taksonomi, dan informasi tentang versi pengklasifikasi dan Taksonomi. Anda harus mengupdate aplikasi yang sudah ada menggunakan API ini.
  • Topics API kini memerlukan izin normal baru.
  • Pengantar sistem "Pengklasifikasi di Perangkat" untuk menetapkan Topik secara dinamis berdasarkan informasi aplikasi yang tersedia untuk publik.

Masalah umum

  • Rilis awal image perangkat ini (revisi 6) tidak dimuat di Android Emulator versi 31.2.10. Image perangkat yang diupdate dan mengatasi masalah tersebut telah tersedia mulai 27 Juli 2022.

Pratinjau Developer 3

Tanggal rilis: 9 Juni 2022

Privacy Sandbox di Pratinjau Developer Android 3 menambahkan fungsi untuk Attribution Reporting API dan FLEDGE di Android.

Attribution Reporting API

Attribution Reporting API meningkatkan privasi pengguna dengan menghapus ketergantungan pada ID pengguna lintas pihak, dan mendukung kasus penggunaan utama untuk atribusi dan pengukuran konversi di seluruh aplikasi.

Rilis ini mencakup resource developer untuk membantu Anda menguji fitur Attribution Reporting API berikut:

  • Mendaftarkan peristiwa sumber atribusi dan pemicu
  • Melatih atribusi dengan prioritas sumber dan pasca-penginstalan
  • Menerima laporan peristiwa
  • Menerima laporan gabungan yang tidak dienkripsi dalam rilis ini

Aplikasi contoh dan server teknologi iklan referensi disediakan untuk membantu pengujian

Masalah umum:

FLEDGE di Android

FLEDGE di Android memperkenalkan cara baru untuk menampilkan iklan berdasarkan audiens kustom yang ditentukan oleh developer aplikasi dan interaksi dalam aplikasi mereka. Solusi ini menyimpan informasi dan iklan terkait secara lokal, serta menyediakan framework untuk mengatur alur kerja pemilihan iklan.

Rilis ini mencakup resource developer untuk membantu Anda menguji FLEDGE berikut di fitur-fitur Android:

  • Bergabung atau keluar dari audiens kustom dan amati cara nilai parameter memengaruhi hasil lelang
  • Mengambil kode lelang JavaScript dari endpoint jarak jauh
  • Mengonfigurasi dan memulai lelang iklan di perangkat
  • Menangani pelaporan tayangan
  • Aplikasi contoh dan konfigurasi server tiruan disediakan untuk membantu pengujian

Masalah umum:

  • Audiens kustom dapat berpartisipasi dalam pemilihan iklan bahkan sebelum "waktu aktivasi".

Pratinjau Developer 2

Tanggal rilis: 17 Mei 2022

Pratinjau Developer 2 menyertakan pratinjau awal MeasurementManager attribution reporting API.

  • Anda dapat memanggil registerSource() dan registerTrigger() untuk mendaftarkan peristiwa iklan aplikasi dan menerima data pelaporan tingkat peristiwa untuk atribusi aplikasi-ke-aplikasi. Penerapan saat ini menggunakan atribusi kontak terakhir. Laporan dijadwalkan untuk dikirim seperti yang ditentukan oleh periode pelaporan. Lihat referensi MeasurementManager API untuk mengetahui informasi selengkapnya.

  • Upload laporan yang sebenarnya terjadi di akhir interval waktu tetap, bukan pada waktu persis seperti yang dijadwalkan. Interval upload pelaporan adalah 4 jam secara default, tetapi dapat diganti dengan perintah adb berikut:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Aplikasi contoh dan server teknologi iklan referensi untuk API pengujian akan dipublikasikan dalam rilis mendatang.

  • Fitur MeasurementManager attribution reporting API lainnya seperti pelaporan gabungan, atribusi pasca-penginstalan, dan pengalihan akan tersedia dalam rilis selanjutnya.

Pratinjau Developer 1

Tanggal rilis: 28 April 2022

Pratinjau Developer 1 menyertakan pratinjau awal Topics API dan Runtime SDK. Fungsi untuk FLEDGE di Android dan Attribution Reporting API akan tersedia dalam rilis mendatang.

  • Topics API
    • getTopics() API saat ini menampilkan nilai pengujian berdasarkan klasifikasi offline untuk sekumpulan aplikasi terbatas. Klasifikasi di perangkat belum diterapkan.
    • Anda dapat menggunakan perintah adb untuk mengganti interval epoch dan komputasi epoch pemicu paksa.
    • Baca Panduan developer topik untuk mengetahui detailnya.
  • Runtime SDK
    • Anda dapat mengemas dan membuat SDK yang mendukung runtime (RE SDK) menggunakan elemen <sdk-library> baru di file manifes aplikasi SDK. Instal RE SDK di emulator atau perangkat pengujian yang didukung seperti yang biasanya Anda instal aplikasi selama pengembangan.
    • Anda dapat mengintegrasikan aplikasi dengan RE SDK, memuatnya di Runtime SDK, dan menguji dampak akses terbatas pada kode SDK, yaitu izin, memori, dan komunikasi aplikasi ke SDK. Storage API untuk RE SDK belum diterapkan, dan akan tersedia dalam rilis mendatang.
    • SDK dapat merender iklan banner atau konten berbasis WebView di Runtime SDK.
    • Baca panduan developer Runtime SDK untuk informasi selengkapnya.
  • Pemeriksaan lint Android
    • Pemeriksaan lint Android mungkin secara keliru menampilkan peringatan dalam project yang dikompilasi dengan API level TiramisuPrivacySandbox. Misalnya, Anda mungkin melihat pesan peringatan: "Call requires API level 33". Anda dapat mengatasi masalah ini untuk sementara dengan menggunakan anotasi @SuppressLint("NewApi").