Sebagai persiapan untuk menghadapi penghentian penggunaan cookie pihak ketiga, kami menyediakan Mode pengujian yang difasilitasi Chrome yang memungkinkan situs melihat pratinjau perilaku situs dan fitur ini berfungsi 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 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, 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 dinonaktifkan secara global cookie pihak ketiga untuk sebagian browser Chrome.
Lokasi cookie pihak ketiga dinonaktifkan di Mode B, mereka akan tetap dinonaktifkan hingga sepenuhnya cookie pihak ketiga.
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. Hasilnya, CMA mengantisipasi bahwa hasil 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 untuk 26 Oktober untuk informasi lebih lanjut tentang Desain Eksperimental 2.
Label dapat diakses menggunakan nilai Cookie-Deprecation
sementara yang tersedia
dari header HTTP atau JavaScript API. Lihat bagian nanti
Mengakses label menggunakan nilai Penghentian Penggunaan Cookie
untuk mengetahui detail penerapan.
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
yang ditampilkan di tabel berikut) maka semua teknologi iklan yang berpartisipasi akan dapat
melihat label label_only_3
yang sama dan berkoordinasi dengan sesuai: 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 untuk menjalankan Protected Audience lelang tanpa cookie pihak ketiga di seluruh grup browser yang konsisten. Tujuan 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 ini tergantung pada pihak yang berpartisipasi untuk menerapkan parameter yang relevan untuk eksperimen. Jika Anda menguji efek menghapus cookie pihak ketiga, maka setiap peserta bertanggung jawab untuk mengecualikan data cookie pihak ketiga untuk browser dengan label.
Tujuannya adalah 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 sepanjang sesi penjelajahan di Chrome, dan lintas sesi. Namun, hal ini tidak dijamin karena ada skenario yang jarang terjadi di mana menyetel ulang browser sepenuhnya juga dapat mengatur ulang label saat ini.
Kami berencana menyertakan 8,5% browser Stabil Chrome untuk Mode A, dan proposal awal membagi populasi itu menjadi sembilan kelompok. Sub-kelompok yang lebih kecil dimaksudkan untuk memungkinkan fleksibilitas teknologi iklan dalam menggabungkan label untuk eksperimen sendiri dengan berbagai ukuran. Grup tidak tumpang tindih.
Perlu diketahui bahwa label control_1.*
dimaksudkan untuk digunakan sebagai "Kontrol 1" sebagai
yang diuraikan dalam
panduan pengujian industri,
jadi peserta pengujian tidak boleh menggunakan
Topics API atau menjalankan Protected Audience
lelang untuk traffic ini. Karena label tidak mempengaruhi perilaku browser,
peserta tidak boleh lulus 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.
Label | % Traffic stabil |
---|---|
control_1.1 |
0,25 |
control_1.2 |
0,25 |
control_1.3 |
0,25 |
control_1.4 |
0,25 |
label_only_1 |
1,5 |
label_only_2 |
1,5 |
label_only_3 |
1,5 |
label_only_4 |
1,5 |
label_only_5 |
1,5 |
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% Chrome Stabil browser mulai 4 Januari 2024 (dan juga di Dev, Canary, dan Beta browser selama Q4 2023). Organisasi yang menguji PS R&M API tidak perlu ikut serta dalam mode ini, karena mode ini akan diterapkan secara merata di seluruh browser populasi. Tentu saja, ada kemungkinan bahwa beberapa fitur situs terkena dampak jika situs belum mengadopsi solusi alternatif, seperti CHIPS atau Set Situs Terkait.
Selain itu, kami berencana untuk menyediakan sebagian kecil traffic dalam Mode B yang menonaktifkan PS R&M API. API lainnya, seperti Set Situs Terkait, CHIPS, dan FedCM, tidak akan dinonaktifkan. Kami perkirakan kombinasi ini akan membantu untuk menetapkan dasar performa bagi 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
mengusulkan untuk membagi populasi menjadi tiga kelompok treatment_1.*
di mana
cookie pihak ketiga dinonaktifkan, tetapi PS R&M API tersedia, dan satu
Grup control_2
tempat kedua cookie pihak ketiga dan PS R&M API berada
dinonaktifkan.
Untuk membantu proses debug Attribution Reporting API dan Private Aggregation
Integrasi API dan untuk membantu peserta pengujian lebih memahami derau
Google, laporan debug ARA, dan laporan debug Agregasi Pribadi akan
tetap tersedia untuk browser dalam Mode B, selama pengguna
secara eksplisit memblokir cookie pihak ketiga. 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 dapat
untuk menetapkan cookie
ar_debug
dan harus mengandalkan setelan kolomdebug_key
(untuk laporan atribusi-sukses) dan kolomdebug_reporting
(untuk laporan panjang laporan) 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-grup ini berbeda dari grup Mode A,
pada pengguna akan berada dalam
Mode A, Mode B, atau tidak keduanya. Peserta pengujian
harus menggunakan traffic control_1.*
sebagai grup kontrol yang mewakili status
dengan cookie pihak ketiga.
Label | % Traffic stabil |
---|---|
treatment_1.1 |
0,25 |
treatment_1.2 |
0,25 |
treatment_1.3 |
0,25 |
control_2 |
0,25 |
Chrome juga telah membatasi cookie untuk 20% klien Chrome Canary, Dev, dan Beta.
Label | % traffic sebelum Stabil |
---|---|
prestable_treatment_1 |
10% |
prestable_control_2 |
10% |
Penyertaan dalam salah satu grup eksperimen ini akan memiliki efek yang sama seperti pada varian Stabilnya.
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 kontrol
label. treatment_1.1
harus memiliki jumlah traffic yang 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 sebelum periode
Hingga Januari 2024, kami menjalankan periode pra-periode untuk beberapa grup eksperimen:
jangka waktu untuk memungkinkan Chrome menyesuaikan ukuran dan memilih secara statistik secara akurat
kelompok yang tidak bias. Periode 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 grup ini kasus, salah satu dari kelompok berlabel.
Label akses menggunakan nilai Penghentian Penggunaan Cookie
Untuk durasi Mode A dan Mode B, kami telah memperkenalkan
Nilai 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 pengaksesan 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 terkait apakah kewajiban izin ini berlaku untuk Anda atau tidak.
Mengakses header HTTP Sec-Cookie-Penghentian
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 Sec-Cookie-Deprecation
header pada resource-nya yang disematkan di example.com
, maka 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
adalah
bersifat wajib. Atribut lainnya: Domain
, Path
, Expires
, dan Max-Age
dapat
ditetapkan sebagai yang paling sesuai dengan kebutuhan Anda, meskipun Path=/
adalah setelan 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 di grup example_label_1
, maka
permintaan yang menyertakan cookie ini juga akan menyertakan Sec-Cookie-Deprecation
{i>header<i}.
Sec-Cookie-Deprecation: example_label_1
Jika browser bukan bagian dari grup, tidak ada header yang 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 sepenuhnya tidak digunakan lagi, ini berarti cookie Partitioned
dapat
dapat disetel saat cookie pihak ketiga diblokir.
Mengakses cookiePenghentianLabel JavaScript API
Nilai Cookie-Deprecation
juga dapat diakses menggunakan
API JavaScript navigator.cookieDeprecationLabel.getValue()
. Ini akan mengembalikan
yang di-resolve menjadi string yang berisi label grup yang berlaku. Sebagai
misalnya, jika browser berada di 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 tidak memilih
browser ke salah satu grup eksperimental.
Anda dapat melihat cara kerja label ini 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
![chrome://flags/#tpc-phase-out-facilitated-testing](https://developers.google.com/static/privacy-sandbox/assets/images/cft-flag.png?hl=id)
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 "Aktifkan Kontrol Paksa 1" atau "Aktifkan Paksa LabelOnly". Hal ini akan menyebabkan browser mengirimkan "fake_control_1.1" atau "fake_label_only_1.1" label.
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_processing_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 "Paksa Kontrol 2". Ini akan mengirimkan parameter "fake_control_2" label grup eksperimen, perbarui halaman setelan cookie, memblokir cookie pihak ketiga, dan juga menyembunyikan API iklan pribadi.
Perhatikan bahwa ada masalah apabila browser 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 "chrome-testing" label di repositori dukungan developer pada GitHub untuk mengelola pertanyaan. Kami menyambut umpan balik 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}.