Privacy Sandbox menyertakan pilihan proposal untuk memungkinkan kasus penggunaan iklan tanpa memerlukan pelacakan lintas situs. Uji coba origin memberikan peluang bagi developer untuk mengevaluasi dan memberikan masukan tentang teknologi web baru melalui pengujian dunia nyata. Dalam uji coba origin sebelumnya, situs dapat menguji API individual. Untuk Topics, FLEDGE dan Attribution Reporting API kami menyediakan uji coba origin tunggal yang memungkinkan situs menjalankan eksperimen terpadu di seluruh API yang membentuk versi awal siklus proses iklan secara menyeluruh. API ini tersedia untuk pengujian di Chrome 101 Beta dan yang lebih baru. Rilis Chrome 101 Beta juga mendapatkan update pada kontrol pengguna selagi kami terus melakukan iterasi pada opsi konfigurasi.
Sebagai developer, Anda dapat mendaftar ke satu uji coba origin ini yang akan memungkinkan Anda melakukan pengujian di berbagai Topics, FLEDGE, dan Attribution Reporting API. Panduan ini akan memandu Anda melakukan langkah-langkah konfigurasi untuk mengakses API, menjelaskan cara memvalidasi konfigurasi, dan menyediakan resource lebih lanjut untuk melakukan pengujian terhadap API.
Apa yang ada di uji coba origin?
Tujuan uji coba origin ini adalah untuk memungkinkan pengujian yang bermakna di seluruh siklus proses iklan di beberapa situs. Untuk melakukan perjalanan ini, uji coba origin mencakup:
- Topics untuk mengamati dan mengakses
topik browser melalui
document.browsingTopics(). - FLEDGE untuk mengelola grup minat
browser, beserta bidding dan pemilihan iklan berdasarkan grup
tersebut dan sinyal lainnya.
- Dalam uji coba origin ini, FLEDGE tersedia di desktop dan mencakup subset tertentu dari semua fungsi yang diusulkan. Baca detail uji coba origin FLEDGE untuk mengetahui informasi selengkapnya.
- Frame dengan pagar untuk merender URL buram dari pemenang lelang iklan FLEDGE.
- Attribution Reporting untuk
mengukur dan melaporkan performa selama siklus proses iklan.
- Sebagai bagian dari Attribution Reporting, laporan agregat harus diproses dan digabungkan oleh layanan agregasi untuk menghasilkan laporan ringkasan. Kami akan segera memublikasikan alat dan panduan tambahan untuk pengujian uji coba lokal dan origin.
- Jika Anda telah berpartisipasi dalam uji coba origin sebelumnya untuk Pelaporan Atribusi, perhatikan bahwa Anda harus melakukan update sesuai dengan perubahan API terbaru. Baca Panduan migrasi untuk mengetahui detailnya.
Meskipun penyiapan ini memungkinkan pengujian terpadu di semua API ini, Anda dapat memilih aspek yang akan diimplementasikan—sesuai dengan kebutuhan Anda.
Bagaimana cara developer mendaftar ke uji coba origin?
Daftar ke uji coba Relevansi dan Pengukuran Privacy Sandbox. Dengan tag HTML berikut, berikan token uji coba di setiap halaman tempat Anda ingin menjalankan kode API:
- Tag
<meta>di bagian<head>halaman tingkat atas:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE"> - Header HTTP di respons halaman tingkat atas:
Origin-Trial: TOKEN_GOES_HERE
Beberapa fungsi yang tersedia dalam uji coba origin ditujukan untuk digunakan dalam
konteks lintas situs, seperti saat Anda menyediakan layanan sebagai pihak ketiga
di situs tingkat atas. Jika perlu mengaktifkan uji coba origin untuk konteks tambahan ini, pastikan Anda memilih opsi untuk "Pencocokan pihak ketiga".
Untuk mengaktifkan uji coba origin dari JavaScript pihak ketiga, masukkan tag <meta>
ke halaman tingkat atas (yaitu halaman pihak pertama, bukan konten Anda sendiri)
dari skrip Anda. Contoh:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Pelajari lebih lanjut di panduan untuk memulai uji coba origin Chrome.
Bagaimana cara developer melakukan pengujian secara lokal?
Dokumentasi developer individual untuk Topics, FLEDGE, dan Attribution Reporting memberikan panduan khusus tentang pengujian developer lokal untuk setiap API. API tidak aktif secara default dan harus diaktifkan dengan tanda untuk pengujian.
Guna mengaktifkan API untuk pengujian, Anda harus:
- Gunakan Chrome 101 Beta atau yang lebih baru.
- FLEDGE memerlukan Chrome desktop.
- API tidak tersedia di Chrome versi iOS.
- Aktifkan API menggunakan flag
chrome://flags/#privacy-sandbox-ads-apis.- Tanda ini memaksa API aktif untuk memudahkan pengujian. Jika Anda ingin mereplikasi pengguna uji coba origin yang memenuhi syarat saat setelan tambahan mereka masih dapat menonaktifkan API, Anda harus meluncurkan Chrome menggunakan flag CLI:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs. - Setiap API mungkin memiliki lebih banyak flag tambahan untuk konfigurasi yang lebih mendetail. Periksa setiap panduan untuk mengetahui detailnya.
- Tanda tambahan mungkin bertentangan dengan tanda ini, jadi pertimbangkan untuk hanya menetapkan tanda ini jika Anda mengalami masalah.
- Tanda ini memaksa API aktif untuk memudahkan pengujian. Jika Anda ingin mereplikasi pengguna uji coba origin yang memenuhi syarat saat setelan tambahan mereka masih dapat menonaktifkan API, Anda harus meluncurkan Chrome menggunakan flag CLI:
- Aktifkan uji coba Privacy Sandbox di Setelan Chrome: Setelan >
Keamanan dan privasi > Privacy Sandbox. Ini juga dapat diakses
di
chrome://settings/adPrivacy. - Aktifkan cookie pihak ketiga di Setelan Chrome: Setelan >
Keamanan dan privasi. Setel Cookie dan data situs lainnya ke
"Izinkan semua cookie" atau "Blokir cookie pihak ketiga dalam mode Samaran". File ini
juga dapat diakses di
chrome://settings/cookies. - Masuk dalam sesi penjelajahan standar. Jangan gunakan mode Samaran.
Bagaimana cara developer memeriksa apakah uji coba origin dikonfigurasi dengan benar?
Memecahkan masalah uji coba origin Chrome menyediakan checklist mendetail untuk memvalidasi konfigurasi uji coba origin Anda.
DevTools menampilkan status uji coba origin di tab Applications di bagian Frame.
Meskipun uji coba origin hanya akan ditampilkan sebagai aktif kepada pengguna yang memenuhi syarat seperti yang dijelaskan di bawah, Anda juga dapat menggunakan tanda developer untuk menguji di situs produksi Anda sendiri.
Pengguna mana yang memenuhi syarat untuk uji coba origin?
Secara desain, uji coba origin dimaksudkan untuk hanya berjalan pada sebagian kecil dari keseluruhan traffic Chrome dan dengan demikian, Anda harus selalu berasumsi bahwa meskipun Anda telah mengaktifkan uji coba origin di situs Anda, pengguna mungkin tidak mengaktifkan API. Grup eksperimen aktif dalam uji coba origin akan dimulai dengan proporsi pengguna yang rendah dan kemungkinan akan ditingkatkan seiring berjalannya uji coba. Perhatikan bahwa persentase pengguna Chrome dalam eksperimen ini mungkin tidak cocok dengan persentase pengguna yang diaktifkan di situs Anda.
Namun, untuk memungkinkan pengujian terpadu di seluruh situs, kumpulan pengguna yang memenuhi syarat tersebut harus tetap konsisten. Misalnya, jika pengguna memenuhi syarat untuk uji coba origin saat melihat iklan di situs penayang yang berpartisipasi, pengguna yang sama tersebut harus tetap memenuhi syarat saat melakukan konversi di situs pengiklan yang berpartisipasi.
Agar memenuhi syarat, pengguna harus:
- menggunakan Chrome 101 Beta atau
yang lebih tinggi.
- FLEDGE memerlukan Chrome desktop.
- uji coba origin tidak tersedia di Chrome versi iOS.
- dijelajahi selama periode uji coba origin aktif.
- mengaktifkan uji coba Privacy Sandbox melalui Setelan > Keamanan dan
privasi > Privacy Sandbox, yang juga dapat diakses melalui
chrome://settings/adPrivacy. - mengaktifkan cookie pihak ketiga melalui Setelan > Keamanan dan privasi >
Cookie dan data situs lainnya yang disetel ke "Izinkan semua cookie" atau "Blokir
cookie pihak ketiga dalam mode samaran", juga dapat diakses melalui
chrome://settings/cookies. - berada dalam sesi penjelajahan standar dan bukan mode Samaran.
- berada dalam grup eksperimen aktif di Chrome.
Bagaimana seharusnya fitur developer mendeteksi dukungan API?
Seperti fitur platform web lainnya, Anda harus mendeteksi dukungan untuk fitur tersebut sebelum menggunakannya.
Topik
Periksa fungsi browsingTopics() di document dan
Kebijakan Izin](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeature)
untuk "browsing-topics".
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Jika Anda ingin bergabung dengan grup minat iklan, periksa fungsi joinAdInterestGroup di
navigator dan Kebijakan Izin untuk "join-ad-interest-group".
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
Jika Anda ingin menjalankan lelang, periksa fungsi runAdAuction di navigator, dan kebijakan izin untuk "run-ad-auction".
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Pelaporan Atribusi
Periksa objek attributionReporting di window dan
Kebijakan Izin untuk "pelaporan atribusi".
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
Di mana developer dapat memberikan masukan dan mendapatkan dukungan?
Halaman ringkasan masukan menjelaskan berbagai rute untuk memberikan masukan tentang berbagai aspek Privacy Sandbox. Ada bagian khusus untuk Topics, FLEDGE, dan Attribution Reporting yang menyediakan setiap link untuk setiap API.
Kami juga memberikan info terbaru secara rutin tentang seri Progress dalam Privacy Sandbox yang memberikan ringkasan berita penting.