Pengujian yang difasilitasi Chrome

Untuk mempersiapkan penghentian cookie pihak ketiga, kami menyediakan mode pengujian yang difasilitasi Chrome yang memungkinkan situs melihat pratinjau perilaku dan fitur situs tanpa cookie pihak ketiga. Panduan ini menyediakan ikhtisar mode pengujian yang akan disediakan Chrome dan cara mengaksesnya label grup eksperimen.

Browser Chrome dalam konteks ini mengacu pada klien Chrome: penginstalan Chrome di perangkat. Setiap data pengguna individual direktori merupakan klien yang berbeda.

Grup eksperimen: sekumpulan browser Chrome yang memiliki fitur tertentu diaktifkan, dinonaktifkan, atau dikonfigurasi. Dalam konteks yang difasilitasi Chrome pengujian, yaitu sekumpulan browser yang labelnya ditetapkan.

Label: dalam konteks ini, nilai header permintaan yang ditetapkan untuk browser yang termasuk dalam grup eksperimen. Setiap browser dalam grup eksperimen akan tetap berada di grup tersebut selama periode pengujian yang difasilitasi Chrome, memastikan bahwa label untuk tetap konsisten di seluruh penguji.

Kami telah menawarkan dua mode yang berbeda:

• Mode A: Mulai November 2023, organisasi yang menguji PS R&M API telah mampu memilih untuk menerima label yang konsisten pada subkumpulan Chrome browser untuk memungkinkan pengujian terkoordinasi di berbagai penguji.
• Mode B: Mulai 4 Januari 2024, Chrome menonaktifkan cookie pihak ketiga secara global untuk sebagian browser Chrome.

Jika dinonaktifkan di Mode B, cookie pihak ketiga akan tetap dinonaktifkan hingga penggunaan cookie pihak ketiga dihentikan sepenuhnya.

Kami telah bekerja sama dengan CMA untuk memastikan bahwa mode pengujian ini selaras dengan kerangka kerja pengujian (dan untuk pihak ketiga sebagaimana diuraikan dalam panduan pengujian industri. Oleh karena itu, CMA memperkirakan bahwa hasil dari pengujian dalam mode ini dapat digunakan dalam penilaiannya terhadap Privacy Sandbox. CMA telah menunjukkan bahwa cenderung lebih menekankan pada hasil dari Desain Eksperimental 2, yang menggunakan label Mode B dan label Mode A 1. Lihat panduan CMA 26 Oktober untuk informasi lebih lanjut tentang Desain Eksperimental 2.

Label dapat diakses menggunakan nilai Sec-Cookie-Deprecation sementara yang tersedia dari header HTTP atau JavaScript API. Untuk mengetahui detail penerapan, lihat bagian Mengakses label menggunakan nilai Sec-Cookie-Deprecation.

Kami juga akan mengirimkan proposal ini melalui Proses pengembangan blink, di mana desain teknis dan tahap pencapaian rilis Chrome akan diselesaikan. Meskipun ini adalah implementasi yang ingin kami sampaikan, diskusi tambahan tambahan dan persetujuan berarti detail ini masih dapat berubah. Kita akan melanjutkan memperbarui halaman ini seiring dengan progres rencana, dan Anda dapat terus memberikan masukan atau pertanyaan.

Mode A: Grup browser berlabel

Organisasi yang berpartisipasi dalam pengujian akan dapat memilih untuk menerima label tetap untuk sebagian browser Chrome, memungkinkan eksperimen terkoordinasi di berbagai teknologi iklan pada kumpulan browser yang sama. Misalnya, jika browser termasuk dalam grup eksperimen label_only_3 (seperti ditunjukkan dalam tabel berikut), semua teknologi iklan yang berpartisipasi akan dapat melihat label label_only_3 yang sama dan berkoordinasi dengan semestinya: gunakan PS R&M API, tetapi jangan gunakan cookie pihak ketiga. Kami mengharapkan peserta laman untuk memastikan label diteruskan ke peserta lain untuk memungkinkan eksperimen yang konsisten di seluruh proses pemilihan iklan dan pengukuran.

Misalnya, hal ini memungkinkan beberapa peserta menjalankan lelang Protected Audience tanpa cookie pihak ketiga di seluruh grup browser yang konsisten. Peserta penjual lelang akan meneruskan label yang diamati kepada pembeli untuk memfasilitasi pengujian terkoordinasi.

Label tidak mempengaruhi perilaku apa pun di Chrome tersebut, termasuk ketersediaan cookie pihak ketiga. Label menyediakan untuk eksperimen independen terkoordinasi, tetapi hal ini tergantung pada pihak yang berpartisipasi untuk menerapkan parameter yang relevan untuk eksperimen. Jika Anda menguji efek penghapusan cookie pihak ketiga, setiap peserta bertanggung jawab untuk mengecualikan data cookie pihak ketiga untuk browser dengan label tersebut.

Tujuannya adalah untuk memiliki grup yang mewakili traffic Chrome normal. Bahwa berarti cookie pihak ketiga dan PS R&M API akan tersedia, meskipun beberapa bagian pengguna mungkin telah menggunakan setelan atau ekstensi untuk mengubah atau menonaktifkan baru.

Label umumnya akan tetap ada selama sesi penjelajahan di Chrome, dan di seluruh sesi. Namun, hal ini tidak dijamin, karena ada skenario jarang terjadi saat mereset browser sepenuhnya juga dapat mereset label saat ini.

Kami berencana menyertakan 8,5% browser Chrome Stabil untuk Mode A, dan proposal awal kami membagi populasi tersebut menjadi sembilan grup. Sub-kelompok yang lebih kecil dimaksudkan untuk memungkinkan fleksibilitas teknologi iklan dalam menggabungkan label untuk eksperimen sendiri dengan berbagai ukuran. Grup tidak tumpang tindih.

Perhatikan bahwa label control_1.* dimaksudkan untuk digunakan sebagai "Kontrol 1" seperti yang diuraikan dalam panduan CMA tentang pengujian industri, sehingga peserta pengujian tidak boleh menggunakan Topics API atau menjalankan lelang Protected Audiences untuk traffic ini. Karena label tidak memengaruhi perilaku browser, partisipan tidak boleh meneruskan topik yang diamati atau menjalankan lelang Protected Audience saat mendeteksi label grup control_1.*.

Kami menyambut masukan apakah pilihan kelompok ini memenuhi kebutuhan peserta tidak di organisasi lain.

Grup browser Mode A label_only_ telah tersedia sejak November 2023, dan Mode A control_1_* grup tersedia mulai 4 Januari 2024.

Mode B: Menonaktifkan 1% cookie pihak ketiga

Chrome menonaktifkan cookie pihak ketiga untuk sekitar 1% browser Chrome Stabil mulai 4 Januari 2024 (dan juga di browser Dev, Canary, dan Beta selama Kuartal 4 2023). Organisasi yang menguji PS R&M API tidak perlu mengaktifkan mode ini, karena mode ini diterapkan secara seragam di seluruh populasi browser. Beberapa fitur situs mungkin terkena dampak jika situs belum mengadopsi solusi alternatif, seperti CHIPS atau Set Situs Terkait.

Selain itu, kami berencana menyediakan sebagian kecil traffic dalam Mode B yang telah menonaktifkan API R&M PS. API lainnya, seperti Set Situs Terkait, CHIPS, dan FedCM, tidak akan dinonaktifkan. Kami memperkirakan bahwa kombinasi ini akan membantu menetapkan dasar pengukuran performa untuk browser tanpa cookie pihak ketiga dan tanpa PS R&M API.

Sebagai bagian dari Mode B, kami juga menyediakan label untuk browser yang terpengaruh. Tujuan label tersedia bersamaan dengan saat API dinonaktifkan. Kami menyarankan untuk membagi populasi menjadi tiga grup treatment_1.* tempat cookie pihak ketiga dinonaktifkan, tetapi PS R&M API tersedia, dan satu grup control_2 tempat baik cookie pihak ketiga maupun PS R&M API dinonaktifkan.

Untuk membantu proses debug integrasi Attribution Reporting API dan Private Aggregation API serta membantu peserta pengujian lebih memahami dampak derau, laporan debug ARA dan laporan debug Private Aggregation akan tetap tersedia untuk browser dalam Mode B, selama pengguna belum memblokir cookie pihak ketiga secara eksplisit. Laporan debug tidak akan tersedia di control_2, karena PS R&M API tidak tersedia di slice tersebut. Laporan debug akan tetap dihentikan bersamaan dengan penghentian cookie pihak ketiga.

• Untuk Attribution Reporting API, karena cookie pihak ketiga dinonaktifkan, asal pelaporan tidak akan dapat menetapkan cookie ar_debug dan harus mengandalkan penetapan kolom debug_key (untuk laporan atribusi-sukses) dan kolom debug_reporting (untuk laporan panjang) untuk memilih ikut serta atau tidak menerima laporan proses debug.
• Untuk Private Aggregation API, asal pelaporan harus bergantung pada panggilan enableDebugMode() untuk mengontrol keikutsertaan dalam menerima laporan proses debug. Perusahaan harus terus mempertimbangkan bagaimana kewajiban peraturan mungkin berlaku untuk penggunaan Atribusi Reporting API dan Private Aggregation API, termasuk laporan debug.

Mode A terus berjalan dan grup ini berbeda dengan grup Mode A, karena pengguna akan berada dalam Mode A, Mode B, atau tidak sama sekali. Peserta pengujian harus menggunakan traffic control_1.* sebagai grup kontrol yang mewakili status quo dengan cookie pihak ketiga.

Chrome juga telah membatasi cookie untuk 20% klien Chrome Canary, Dev, dan Beta.

Penyertaan dalam salah satu grup eksperimen ini akan memiliki efek yang sama dengan yang setara dengan Stabil.

Seperti halnya Mode A, PS R&M API tidak dijamin akan tersedia, karena pengguna dapat menonaktifkannya dari setelan Privasi dan keamanan Chrome. Demikian juga, cookie pihak ketiga tidak dijamin akan dinonaktifkan untuk setiap anggota Grup control_2, karena pengguna dapat mengakses UI browser untuk mengizinkan pihak ketiga cookie untuk situs.

Pemantauan eksperimen

Pastikan untuk memantau volume traffic relatif dari setiap perlakuan dan label kontrol. treatment_1.1 harus memiliki jumlah traffic yang hampir sama dengan treatment_1.2 dan treatment_1.3.

Sebaiknya gunakan pertimbangan terkait traffic yang berisi label yang berasal dari Versi Chrome sebelum versi 120. Jika tim Anda yang biasanya menangani traffic tidak valid mengidentifikasi agen pengguna yang menunjukkan karakteristik traffic, maka masuk akal untuk memfilternya dari hasil pengujian.

Label pra-periode

Hingga Januari 2024, kami menjalankan periode pra-periode untuk beberapa grup eksperimen. Periode sebelum ini waktu yang diizinkan Chrome untuk menyesuaikan ukuran dan memilih secara statistik secara akurat kelompok yang tidak bias. Pra-periode ini berjalan untuk semua grup yang dijadwalkan untuk dimulai pada bulan Januari: grup Mode B dan grup Control_1.*. Tidak perlu bagi tindakan developer atau situs di sini—grup pra-periode ini tidak akan mengalami perubahan perilaku atau ketersediaan API—tetapi Anda harus menyadari bahwa Anda mungkin label preperiod yang ditampilkan dalam beberapa situasi. Saat browser yang menerima Label preperiod dapat ditransisikan ke salah satu grup eksperimen, ini tidak dijamin, jadi sebaiknya jangan berasumsi bahwa browser dengan label ini yang dijamin akan ada dalam eksperimen.

Grup eksperimen adalah subkumpulan populasi yang diteliti; dalam kasus, salah satu dari kelompok berlabel.

Mengakses label menggunakan nilai Sec-Cookie-Deprecation

Untuk durasi Mode A dan Mode B, kami telah memperkenalkan Nilai Sec-Cookie-Deprecation dapat diakses menggunakan header HTTP keikutsertaan dan JavaScript API, yang menyediakan label untuk Mode A atau B yang berlaku untuk browser grup eksperimen (sebagaimana didefinisikan oleh persentase di atas), jika termasuk dalam salah satu ini.

Mengakses label melibatkan akses ke informasi yang disimpan di perangkat pengguna. Di beberapa beberapa wilayah hukum (seperti Uni Eropa dan Inggris Raya), kami memahami bahwa aktivitas ini setara dengan penggunaan cookie dan oleh karena itu, mengakses label memerlukan persetujuan pengguna. Sebelum Anda mulai meminta label, sebaiknya Anda mencari nasihat hukum mengenai apakah kewajiban izin ini berlaku untuk Anda atau tidak.

Mengakses header HTTP Sec-Cookie-Deprecation

Untuk menerima header permintaan Sec-Cookie-Deprecation, situs harus ditetapkan terlebih dahulu cookie receive-cookie-deprecation. Cookie ini harus menggunakan Partitioned yang berarti bahwa keikutsertaan untuk menerima header harus dilakukan sesuai tingkat atas.

Misalnya, jika 3p-example.site ingin menerima header Sec-Cookie-Deprecation pada resource-nya yang disematkan di example.com, 3p-example.site harus menetapkan cookie berikut dalam konteks tersebut.

Set-Cookie: receive-cookie-deprecation=1; Secure; HttpOnly; Path=/; SameSite=None; Partitioned;  Max-Age=15552000

Atribut cookie Secure, HttpOnly, SameSite, dan Partitioned bersifat wajib. Anda dapat menetapkan atribut Domain, Path, Expires, dan Max-Age seperti yang paling sesuai dengan kebutuhan Anda, meskipun Path=/ adalah default yang baik. Contoh di sini menetapkan Max-Age=15552000 sehingga masa berlaku cookie tidak berakhir hingga setelah 180 hari.

Anda mungkin ingin mulai menetapkan cookie receive-cookie-deprecation=1 sebelum periode pengujian yang difasilitasi Chrome dimulai, untuk memastikan bahwa browser dalam grup eksperimen mencakup Sec-Cookie-Deprecation segera setelah tersedia.

Misalnya, dengan asumsi browser berada dalam grup example_label_1, permintaan berikutnya yang menyertakan cookie ini juga akan menyertakan header Sec-Cookie-Deprecation.

Sec-Cookie-Deprecation: example_label_1

Jika browser bukan bagian dari grup, header tidak akan dikirim. Label terikat dengan keberadaan cookie, jadi jika cookie dihapus, diblokir sepenuhnya, atau diblokir untuk situs tertentu, maka label tidak akan terkirim. Karena atribut Partitioned ditujukan untuk penggunaan berkelanjutan setelah cookie pihak ketiga tidak digunakan lagi sepenuhnya, artinya cookie Partitioned dapat ditetapkan saat cookie pihak ketiga diblokir.

Mengakses cookieDeprecationLabel JavaScript API

Nilai Sec-Cookie-Deprecation juga dapat diakses menggunakan navigator.cookieDeprecationLabel.getValue() JavaScript API. Ini akan mengembalikan yang di-resolve menjadi string yang berisi label grup yang berlaku. Misalnya, jika browser berada dalam grup example_label_1:

// Feature detect temporary API first
if ('cookieDeprecationLabel' in navigator) {
 // Request value and resolve promise
 navigator.cookieDeprecationLabel.getValue().then((label) => {
   console.log(label);
   // Expected output: "example_label_1"
 });
}

Jika browser bukan bagian dari grup, API tidak akan tersedia atau nilainya akan berupa string kosong, jadi pastikan Anda melakukan deteksi fitur.

JavaScript API dapat dipanggil terlepas dari keberadaan Cookie receive-cookie-deprecation. Namun, jika cookie diblokir sepenuhnya atau khususnya untuk situs, API ini tidak akan tersedia atau menampilkan string kosong.

Seperti halnya nilai yang diberikan klien, pastikan Anda membersihkan dan memvalidasi dari header atau JavaScript API sebelum digunakan.

Demo dan pengujian

Mulai Chrome 120 dan seterusnya, terdapat tanda yang tersedia untuk mengaktifkan developer lokal pengujian permintaan dan membaca label.

Tanda chrome://flags/#tpc-phase-out-facilitated-testing memungkinkan Anda mengaktifkan pemilihan label pengujian. Label ini diawali dengan fake_ hingga membedakannya dari label yang sebenarnya. Mengaktifkan tanda ini tidak akan mengikutsertakan browser ke dalam grup eksperimental mana pun.

Anda dapat melihat cara kerja label di goo.gle/cft-demo.

Karena pendaftaran diberlakukan untuk relevansi dan pengukuran Privacy Sandbox API, Anda mungkin perlu mengganti penerapan untuk pengujian lokal menggunakan chrome://flags/#privacy-sandbox-enrollment-overrides dan menyediakan demo tempat asal. Atau, sertakan penanda command line berikut jika Anda menjalankan Chrome dari terminal: --args --disable-features=EnforcePrivacySandboxAttestations

Menu drop-down tanda mencakup beberapa opsi. Penguji akan utamanya tertarik dengan entri bertanda "{i>Force<i}" karena hal itu memastikan eksperimen akan diaktifkan terlepas dari konfigurasi perangkat lainnya.

Untuk menguji label grup eksperimen saja, pilih "Enabled Force Control 1" atau "Enabled Force LabelOnly". Tindakan ini akan menyebabkan browser mengirim label "fake_control_1.1" atau "fake_label_only_1.1".

Di Chrome M120 atau yang lebih baru, Anda juga dapat menggunakan entri berikut.

Untuk menguji pemblokiran cookie pihak ketiga, pilih "Aktifkan Perlakuan Paksa". Ini akan mengirimkan "fake_Treatment_1.1" label grup eksperimen, tetapi juga mengubah halaman setelan cookie dan setelan cookie saat ini untuk memblokir cookie pihak ketiga.

Untuk menguji pemblokiran cookie pihak ketiga tanpa API iklan pribadi, pilih "Tekan Kontrol 2". Ini akan mengirimkan "fake_control_2" label grup eksperimen, perbarui halaman setelan cookie, memblokir cookie pihak ketiga, dan juga menyembunyikan API iklan pribadi.

Perhatikan bahwa ada masalah ketika browser akan tetap menggunakan versi baru setelan dan halaman setelan cookie yang memblokir cookie pihak ketiga, meskipun menonaktifkan penanda. Kami sedang berusaha mengatasi masalah ini, tetapi untuk sementara ini Anda dapat menguji nilai tanda ini di direktori data Chrome terpisah dengan meluncurkan Chrome dengan tanda command line --user-data-dir=<new dir>.

Masukan

Kami menggunakan label "chrome-testing" di repositori dukungan developer di GitHub untuk mengelola pertanyaan. Kami menerima masukan dan diskusi Anda tentang pertanyaan awal:

• Apakah Anda berencana melakukan pengujian menggunakan Mode A, Mode B, atau keduanya?
• Memilih ukuran label untuk pengujian yang difasilitasi Chrome
• Penggunaan Petunjuk Klien untuk pengujian yang difasilitasi Chrome

Anda juga dapat mengajukan pertanyaan atau diskusi baru di repositori menggunakan "pengujian yang difasilitasi Chrome" {i>template<i}.