Privacy Sandbox mencakup pilihan proposal untuk memungkinkan kasus penggunaan iklan tanpa memerlukan pelacakan lintas situs. Uji coba origin memberi developer kesempatan untuk mengevaluasi dan memberikan masukan tentang teknologi web baru melalui pengujian di dunia nyata. Uji coba origin Relevansi dan Pengukuran Privacy Sandbox menyediakan satu uji coba yang memungkinkan situs menjalankan eksperimen terpadu di seluruh Attribution Reporting, Protected Audience API, Topics, Fenced Frames, dan Shared Storage. Developer dapat mendaftar ke uji coba origin tunggal ini yang memungkinkan Anda melakukan pengujian di seluruh Topics API, Protected Audience API, dan Attribution Reporting API. Panduan ini akan memandu Anda melalui langkah-langkah konfigurasi untuk mengakses API, memberi tahu Anda cara memvalidasi konfigurasi, dan menyediakan referensi lebih lanjut untuk pengujian terhadap API.
Memeriksa status uji coba origin
Juni 2023
Peningkatan 7% Agregasi Pribadi di Stable
Private Aggregation API akan tersedia di 7% traffic Stabil Chrome mulai Selasa, 6 Juni 2023. API ini akan tersedia di grup uji coba origin terpadu utama (5%), grup terisolasi Protected Audience (1%), dan grup terisolasi Shared Storage (1%). Alokasi traffic untuk Protected Audience dan Shared Storage tidak akan berubah karena Private Aggregation ditambahkan ke eksperimen terisolasi yang ada.
Alokasi traffic per Selasa, 6 Juni:
| API | Alokasi traffic | Status |
| Pelaporan Atribusi | Terpadu - 5% | 6% traffic Stabil per 13 Maret 2023 |
| Terisolasi - 1% - Khusus ARA | ||
| Frame dengan Fence | Terpadu - 5% | 7% traffic Stabil per 13 Maret 2023 |
| Terisolasi - 1% - Hanya Shared Storage + Private Aggregation + Fenced Frames | ||
| Terisolasi - 1% - Hanya Protected Audience + Private Aggregation + Fenced Frames | ||
| Protected Audience | Terpadu - 5% | 6% traffic Stabil per 13 Maret 2023 |
| Terisolasi - 1% - Hanya Protected Audience + Private Aggregation + Fenced Frames | ||
| Agregasi Pribadi | Terpadu - 5% | 7% traffic Stabil per 6 Juni 2023 |
| Terisolasi - 1% - Hanya Protected Audience + Private Aggregation + Fenced Frames | ||
| Terisolasi - 1% - Hanya Shared Storage + Private Aggregation + Fenced Frames | ||
| Shared Storage | Terpadu - 5% | 6% traffic Stabil per 13 Maret 2023 |
| Terisolasi - 1% - Hanya Shared Storage + Private Aggregation + Fenced Frames | ||
| Topik | Terpadu - 5% | 6% traffic Stabil per 13 Maret 2023 |
| Terisolasi - 1% - Hanya topik |
Perubahan sebelumnya
Lihat info sebelumnya tentang uji coba origin.
April 2023
Peluncuran Agregasi Pribadi 1% di Stable
Uji coba origin Private
Aggregation API akan tersedia di 1% traffic eksperimen terpadu Chrome Stabil
mulai Senin 17 April. Fungsi sendHistogramReport()
Private Aggregation dapat digunakan di worklet Protected Audience API
dan Shared Storage.
Alokasi traffic akan terlihat seperti berikut mulai Senin, 17 April:
| API | Alokasi traffic | Status |
| Pelaporan Atribusi | Terpadu - 5% | 6% traffic Stabil mulai 13 Maret 2023 |
| Terisolasi - 1% - Khusus ARA | ||
| Frame dengan Fence | Terpadu - 5% | 7% traffic Stabil mulai 13 Maret 2023 |
| Terisolasi - 1% - Shared Storage (Pemilihan URL) + Fenced Frame saja | ||
| Terisolasi - 1% - Hanya Protected Audience API + Fenced Frames | ||
| Protected Audience API | Terpadu - 5% | 6% traffic Stabil mulai 13 Maret 2023 |
| Terisolasi - 1% - Hanya Protected Audience API + Fenced Frames | ||
| Agregasi Pribadi | Terpadu - 1% | 1% traffic Stabil mulai 17 April 2023 |
| Shared Storage (Pemilihan URL) | Terpadu - 5% | 6% traffic Stabil mulai 13 Maret 2023 |
| Terisolasi - 1% - Shared Storage (Pemilihan URL) + Fenced Frame saja | ||
| Topik | Terpadu - 5% | 6% traffic Stabil mulai 13 Maret 2023 |
| Terisolasi - 1% - Hanya topik |
Maret 2023
Pembaruan linimasa
Awalnya kami menyampaikan bahwa kami akan memulai eksperimen terisolasi pada Senin, 13 Maret 2023, tetapi eksperimen baru akan dimulai pada Kamis, 16 Maret 2023 karena waktu tambahan yang diperlukan untuk menyiapkan eksperimen. Peningkatan kembali penggunaan Protected Audience API dari 4% menjadi 5% juga akan terjadi pada Kamis, 16 Maret 2023.
Peningkatan kembali penggunaan Protected Audience API sebesar 1%
Bulan lalu, kami mengurangi sementara traffic uji coba origin Protected Audience API dari 5% menjadi 4% dari Chrome stabil untuk pengujian. Pengujian awal telah selesai, dan kami berencana untuk meningkatkan kembali Protected Audience API menjadi 5% dari 4% untuk eksperimen terpadu pada Kamis, 16 Maret 2023.
Pengguna yang ditingkatkan akan menjadi kumpulan pengguna yang sama dengan yang diturunkan. Namun, grup minat sebelumnya telah berakhir, karena lebih dari 30 hari telah berlalu sejak penghentian bertahap.
Eksperimen terisolasi
Untuk meningkatkan proses pengujian kami dan terus mengamati metrik API uji coba origin, kami membuat eksperimen terisolasi untuk setiap API, selain eksperimen terpadu yang ada. Eksperimen baru akan dibuat untuk Attribution Reporting, Topics, kombinasi Protected Audience API dan Fenced Frames, serta kombinasi operasi Pemilihan URL Shared Storage dan Fenced Frames. Di setiap eksperimen terisolasi, hanya API yang ditetapkan yang akan tersedia untuk pengguna dalam grup tersebut.
| API | Alokasi traffic eksperimen yang terisolasi |
|---|---|
| Pelaporan Atribusi | 1% |
| Protected Audience API + Fenced Frames | 1% |
| Shared Storage (pemilihan URL) + Fenced Frames | 1% |
| Topik | 1% |
Mulai Kamis, 16 Maret, Anda akan mulai menerima tambahan 1% traffic Stabil Chrome untuk API yang tercantum di atas, selain 5% traffic yang Anda terima dari eksperimen terpadu yang ada. Pengguna baru akan dialokasikan ke setiap eksperimen.
Alokasi traffic
Alokasi traffic uji coba origin terpadu saat ini per Selasa, 28 Februari, adalah sebagai berikut:
| API | Alokasi traffic eksperimen terpadu saat ini |
|---|---|
| Pelaporan Atribusi | 5% |
| Frame dengan Fence | 5% |
| Protected Audience API | 4% |
| Shared Storage (Pemilihan URL) | 5% |
| Topik | 5% |
Alokasi traffic akan terlihat seperti berikut mulai Kamis, 16 Maret, setelah Protected Audience API diaktifkan kembali, dan eksperimen terisolasi baru dimulai:
| API | Alokasi traffic baru | Status |
|---|---|---|
| Pelaporan Atribusi | Terpadu - 5% | 6% traffic Stabil mulai 16 Maret 2023 |
| Terisolasi - 1% - Khusus ARA | ||
| Frame dengan Fence | Terpadu - 5% | 7% traffic Stabil mulai 16 Maret 2023 |
| Terisolasi - 1% - Shared Storage (Pemilihan URL) + Fenced Frame saja | ||
| Terisolasi - 1% - Hanya Protected Audience API + Fenced Frames | ||
| Protected Audience API | Terpadu - 5% (alokasi saat ini 4% + peningkatan kembali 1%) | 6% traffic Stabil mulai 16 Maret 2023 |
| Terisolasi - 1% - Hanya Protected Audience API + Fenced Frames | ||
| Shared Storage (Pemilihan URL) |
Terpadu - 5% | 6% traffic Stabil mulai 16 Maret 2023 |
| Terisolasi - 1% - Shared Storage (Pemilihan URL) + Fenced Frame saja | ||
| Topik | Terpadu - 5% | 6% traffic Stabil mulai 16 Maret 2023 |
| Terisolasi - 1% - Hanya topik |
Perubahan ini tidak akan memengaruhi penyiapan token uji coba origin yang ada, dan Anda tidak perlu memperpanjang atau membuat token uji coba origin baru.
Januari 2023
Sebagai bagian dari penyelidikan regresi Chrome, kami akan mengurangi traffic uji coba origin Protected Audience API dari 5% menjadi 4% dari Chrome Stabil untuk sementara, mulai 26 Januari 2023. Kami memperkirakan penyelidikan akan memakan waktu sekitar satu bulan, dan kami akan memberi tahu Anda saat traffic kembali ditingkatkan.
Perubahan ini akan terjadi secara otomatis, dan tidak akan memengaruhi token uji coba origin yang ada. Untuk pengguna dalam 1% traffic yang akan dihentikan, grup minat akan tetap ada di browser mereka. Pengguna yang sama akan menjadi bagian dari peningkatan kembali, dan grup minat mereka dapat digunakan kembali. Namun, grup minat akan berakhir dalam 30 hari, dan penyelidikan regresi mungkin memerlukan waktu lebih lama dari itu.
Selain itu, uji coba origin Shared Storage URL Selection API akan ditingkatkan menjadi 5% traffic Stabil Chrome mulai 26 Januari 2023.
| API | Catatan |
|---|---|
| Attribution Reporting | Tersedia di Stable, meningkat menjadi 5% mulai 26 Oktober 2022. |
| Topik | Tersedia di Stable, meningkat menjadi 5% mulai 26 Oktober 2022. |
| Protected Audience API | Tersedia di Stable, yang sementara diturunkan menjadi 4% mulai 26 Januari 2023. |
| Frame dengan Fence | Tersedia di Stable, meningkat menjadi 5% mulai 9 November 2022. |
| Shared Storage | Tersedia di versi Stabil, meningkat 5% mulai 26 Januari 2023. |
November 2022
API `selectURL` Shared Storage akan bergabung dalam uji coba origin pada 1% traffic Stabil Chrome mulai 9 November.
Seperti yang diumumkan sebelumnya dalam postingan blog Meningkatkan uji coba origin Pengukuran dan Relevansi Privacy Sandbox menjadi 5%, Attribution Reporting dan Topics kini berada di 5% dengan Protected Audience API dan Fenced Frames juga akan menyusul pada 9 November.
| API | Catatan |
|---|---|
| Attribution Reporting | Tersedia di Stable, meningkat menjadi 5% mulai 26 Oktober. |
| Topik | Tersedia di Stable, meningkat menjadi 5% mulai 26 Oktober. |
| Protected Audience API | Tersedia di Stable, meningkat menjadi 5% mulai 9 November. |
| Frame dengan Fence | Tersedia di Stable, meningkat menjadi 5% mulai 9 November. |
| Shared Storage | Akan tersedia di Versi Stabil, dimulai dari 1% mulai 9 November. |
Oktober 2022: Peningkatan 5%
Attribution Reporting, Topics, Protected Audience API, dan Fenced Frames saat ini tersedia di Chrome Stabil dan akan menjadi bagian dari peningkatan traffic.
Kami akan mulai meningkatkan traffic untuk Attribution Reporting dan Topics mulai minggu ini, Protected Audience API dan Fenced Frames akan ditingkatkan mulai 9 November.
Baca selengkapnya di postingan blog Meningkatkan uji coba origin Relevansi dan Pengukuran Privacy Sandbox menjadi 5%.
| API | Catatan |
|---|---|
| Attribution Reporting | Tersedia di Stabil, meningkat menjadi 5% setelah 26 Oktober. |
| Topik | Tersedia di Stabil, meningkat menjadi 5% setelah 26 Oktober. |
| Protected Audience API | Tersedia di Stable, meningkat menjadi 5% mulai 9 November. |
| Frame dengan Fence | Tersedia di Stable, meningkat menjadi 5% mulai 9 November. |
| Shared Storage | Saat ini hanya tersedia di Canary, Dev, dan Beta M105+. |
Oktober 2022
- Uji coba origin telah diperpanjang hingga Chrome 110.
- Memulai uji coba origin Chrome menjelaskan cara memperpanjang pendaftaran uji coba origin. Hal ini termasuk memberikan token baru ke origin yang berpartisipasi, yang merupakan proses yang sama dengan yang diikuti oleh perpanjangan uji coba origin lainnya.
Perpanjangan ini diberikan untuk memberi ekosistem waktu di saluran Stabil untuk terus menguji dan memvalidasi peningkatan API, sekaligus memberikan masukan yang konsisten dengan linimasa publik kami yang ada.
Linimasa Privacy Sandbox secara keseluruhan tetap tidak berubah.
API yang disertakan dalam uji coba:
| API | Catatan |
|---|---|
| Attribution Reporting | Panduan developer untuk uji coba origin. |
| Protected Audience API | Panduan developer untuk uji coba origin. |
| Topik | Panduan developer untuk uji coba origin. |
| Frame dengan Fence | Lihat panduan Protected Audience API untuk penggunaan uji coba origin. |
| Shared Storage | Saat ini hanya tersedia di Canary, Dev, dan Beta M105+. |
Agustus 2022
- Ketersediaan uji coba origin ditingkatkan hingga 1% pengguna desktop dari Chrome Stabil 104.
- Info terbaru akan menyusul saat ketersediaan mencakup pengguna seluler.
- Saluran pra-stabil (Canary, Beta) tetap berada di 50% pengguna.
- API tidak tersedia di Chrome untuk iOS.
Mei 2022
Ketersediaan uji coba origin meningkat hingga 50% pengguna dari Chrome 102 Beta.
API yang disertakan dalam uji coba:
| API | Catatan |
|---|---|
| Attribution Reporting | Panduan developer untuk uji coba origin. |
| Protected Audience API | Panduan developer untuk uji coba origin. |
| Topik | Panduan developer untuk uji coba origin. Topics sempat dinonaktifkan dalam uji coba origin karena bug yang memengaruhi stabilitas browser. |
| Frame dengan Fence | Frame Terpagar ditambahkan ke uji coba origin. Lihat panduan Protected Audience API untuk penggunaan eksperimen. |
April 2022
Uji coba origin dimulai dengan sebagian kecil pengguna dari Chrome 102 Beta.
API yang disertakan dalam uji coba:
| API | Catatan |
|---|---|
| Attribution Reporting | Postingan Intent to Experiment (I2E) individu. Attribution Reporting juga tersedia sebagai uji coba origin individu. |
| Protected Audience API | Postingan Intent to Experiment (I2E) individu. Protected Audience API hanya tersedia di desktop dengan sebagian fungsi. |
| Topik | Postingan Intent to Experiment (I2E) individu. |
Mendaftar dan mengonfigurasi uji coba origin
Untuk mengaktifkan uji coba origin di situs Anda, Anda harus mendaftar dan menyematkan token uji coba origin yang ditetapkan (string berbasis waktu untuk akses spesifik Anda ke uji coba origin). Pelajari lebih lanjut di Memulai uji coba origin Chrome.
Token uji coba origin diberikan segera, dan Anda dapat mencabut atau membuatnya ulang kapan saja.
Untuk setiap halaman tempat Anda ingin menggunakan uji coba origin, Anda harus menyertakan token uji coba dengan HTML atau respons halaman tertentu tersebut.
Gunakan tag <meta> di bagian <head> halaman:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Atau, sertakan header HTTP berikut dalam respons halaman:
Origin-Trial: TOKEN_GOES_HERE
Mengonfigurasi dengan iframe
Jika Anda menggunakan fitur uji coba origin dalam iframe (seperti joinAdInterestGroup() Protected Audience API), token harus diberikan dalam iframe dan cocok dengan origin iframe.
Mengonfigurasi lintas situs dengan JavaScript
Jika Anda menggunakan fitur uji coba origin melalui JavaScript lintas situs, seperti Anda adalah penyedia JavaScript pihak ketiga yang disertakan di halaman tingkat teratas, maka Anda harus:
- Pilih opsi Pencocokan pihak ketiga saat mendaftar ke uji coba origin.
- Kolom Asal Web harus berupa asal skrip Anda.
- Suntikkan tag
<meta>ke halaman tingkat teratas (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);
Men-debug uji coba origin
Anda dapat memeriksa status uji coba origin di panel DevTools > Aplikasi.
- Scroll ke bawah ke panel Frame.
- Pilih frame tempat Anda ingin menyetel token. Misalnya, frame atas untuk halaman tingkat teratas atau iframe tertentu untuk halaman yang disematkan.
- Di panel sebelah kanan, scroll ke bawah ke bagian Uji Coba Origin.
- Anda akan melihat entri untuk uji coba
PrivacySandboxAdsAPIs. - Luaskan entri ini untuk melihat status uji coba origin dan token spesifik Anda.
Uji coba origin terbatas untuk sebagian kecil pengguna Chrome dan browser Anda mungkin tidak berada dalam grup eksperimen. Akibatnya, Anda mungkin melihat pesan TrialNotAllowed
merah terhadap PrivacySandboxAdsAPIs. Saat Anda meluaskan entri untuk memeriksa Status Token, jika menampilkan pesan Success berwarna hijau, konfigurasi uji coba origin Anda sudah benar. Pengguna yang memenuhi syarat akan melihat pesan yang ditetapkan ke Enabled.
Jika Anda melihat pesan yang berbeda, lihat Memecahkan masalah uji coba origin Chrome untuk mengetahui checklist mendetail guna memvalidasi konfigurasi uji coba origin Anda.
Mendeteksi fitur
Seperti semua fitur web, Anda harus memeriksa apakah fitur tersebut dilaporkan tersedia di browser sebelum mencoba menggunakannya. Anda dapat melakukannya dengan memeriksa keberadaan API yang relevan di lokasi yang tepat:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Menentukan kelayakan pengguna
Uji coba origin berjalan untuk sebagian kecil pengguna Chrome. Pengiklan juga harus mengaktifkan fungsi yang relevan di setelan mereka agar memenuhi syarat untuk uji coba:
Setelan browser
Agar memenuhi syarat untuk uji coba, pengguna harus:
Menggunakan versi dan saluran Chrome tempat uji coba origin sedang berjalan.
- Lihat Status Uji Coba Origin untuk konfigurasi saat ini.
Berada dalam grup eksperimen aktif di Chrome.
Setelan pengguna
Agar memenuhi syarat untuk uji coba, pengguna juga harus:
- 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", yang juga dapat diakses melalui
chrome://settings/cookies. - berada dalam sesi penjelajahan standar dan bukan mode Samaran.
Meskipun uji coba origin hanya akan ditampilkan sebagai aktif kepada pengguna yang memenuhi syarat, Anda juga dapat menggunakan tombol developer untuk melakukan pengujian terhadap situs produksi Anda sendiri.
Mengontrol partisipasi Anda dalam uji coba origin
Mekanisme uji coba origin tetap sama: Anda mendapatkan token uji coba origin untuk konteks tempat Anda ingin bereksperimen dengan API. Dengan populasi pengujian yang diperluas, Anda harus memastikan bahwa Anda secara aktif memantau dan mengontrol tingkat traffic di tempat Anda memilih untuk mengaktifkan uji coba.
Pendekatan yang baik di sini adalah:
- Sertakan token uji coba origin secara default di semua konteks tempat Anda ingin melakukan eksperimen.
- Gunakan deteksi fitur untuk memeriksa API aktif.
- Jika API aktif (dan oleh karena itu, browser memenuhi syarat untuk eksperimen ini), pilih apakah akan menggunakannya atau tidak berdasarkan kriteria eksperimen Anda sendiri. Misalnya, jika Anda sudah memiliki infrastruktur pengujian A/B untuk bereksperimen pada persentase traffic, pengambilan sampel, atau beberapa atribut lainnya, maka pada tahap ini Anda dapat memutuskan fitur mana yang akan digunakan secara aktif.
Anda dapat mencegah partisipasi dalam uji coba origin sepenuhnya untuk setiap instance browser dengan tidak menyertakan token dalam respons. Misalnya, jika Anda telah memenuhi kuota sendiri untuk eksperimen atau perlu mengatasi masalah selama uji coba, tidak menyertakan token akan memastikan tidak ada fungsi eksperimental yang tersedia atau aktif di halaman.
Kontrol uji coba origin menurut wilayah geografis
Anda tidak dapat menonaktifkan uji coba origin untuk wilayah tertentu. Uji coba origin aktif di halaman yang berisi token, yang disertakan melalui header HTTP (sisi server) atau tag meta HTML (sisi klien).
Jika Anda dapat menentukan lokasi pengguna, Anda dapat menulis kode untuk menyertakan token uji coba origin berdasarkan informasi lokasi tersebut. Misalnya, Anda dapat mencoba menggunakan alamat IP untuk menentukan lokasi pengguna. Alamat IP dapat dipalsukan, jadi ini bukan solusi yang terjamin.
Namun, asal geografis tertentu dapat menetapkan Permissions Policy untuk mengontrol fitur yang dapat digunakan. Misalnya, us.example.com dan uk.example.com adalah asal geografis spesifik yang dapat dikontrol. Hal ini tidak berarti bahwa suatu wilayah telah memilih untuk tidak mengikuti uji coba origin.
Dengan Kebijakan Izin, situs menambahkan sedikit cuplikan kode ke halamannya yang memberikan petunjuk kepada browser. Saat halaman dimuat, browser akan membaca petunjuk Kebijakan Izin dan akan mengizinkan atau memblokir fitur (atau API) sebagaimana diuraikan dalam Kebijakan Izin. Jika situs ingin membatasi API di wilayah tertentu, developer dapat menetapkan kebijakan untuk semua halaman yang diminta dari wilayah tersebut.
Memperpanjang token
Masa berlaku token uji coba origin adalah enam minggu sejak tanggal penerbitannya (atau di akhir uji coba jika lebih awal).
Anda harus memperpanjang dan men-deploy token baru dalam jangka waktu tersebut agar dapat menggunakan fitur uji coba origin tanpa gangguan.
Memperpanjang masa berlaku token hanya memerlukan beberapa menit, dan Anda dapat men-deploy beberapa token untuk uji coba yang sama dalam halaman yang sama. Anda dapat men-deploy token yang diperbarui sebelum token yang ada berakhir, sehingga tidak ada gangguan layanan bagi pengguna.
Menguji secara lokal
Untuk panduan khusus tentang pengujian developer lokal, lihat:
API tidak aktif secara default dan harus diaktifkan dengan flag untuk pengujian. Anda harus memastikan bahwa Anda telah mengaktifkan setelan konfigurasi yang sama di atas, lalu:
- Gunakan versi dan saluran Chrome yang menyediakan fitur tersebut.
- Aktifkan semua API privasi Iklan di bagian
chrome://settings/adPrivacy.
Periksa panduan developer untuk mengetahui ketersediaan API dan fitur tertentu serta tanda tambahan untuk konfigurasi yang lebih terperinci.