Uji coba origin terpadu pengukuran dan relevansi

Topics, Fenced Frames, dan Shared Storage. kata kunci: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, kategori:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Pemula

Privacy Sandbox menyertakan sejumlah proposal untuk memungkinkan penggunaan iklan kasus tanpa memerlukan pelacakan lintas situs. Asal uji coba memberikan kesempatan bagi developer untuk mengevaluasi dan memberikan masukan tentang teknologi web baru melalui pengujian di dunia nyata. Tujuan Relevansi dan terhadap Privacy Sandbox Uji coba origin pengukuran menyediakan uji coba tunggal yang memungkinkan situs menjalankan eksperimen terpadu di Attribution Reporting, Protected Audience API, Topics, Fenced Frames, dan Shared Penyimpanan. Developer dapat mendaftar ke uji coba origin tunggal ini yang memungkinkan Anda menguji di Topics, Protected Audience API, dan Attribution Reporting API. Ini akan membawa Anda melalui langkah-langkah konfigurasi untuk mengakses API, cara memvalidasi konfigurasi, dan menyediakan sumber daya lebih lanjut untuk pengujian terhadap API.

Memeriksa status uji coba origin

Juni 2023

Peningkatan Agregasi Pribadi sebesar 7% di Stabil

Private Aggregation API akan menjadi tersedia di 7% traffic Chrome Stabil mulai Selasa, 6 Juni 2023. API akan tersedia di grup uji coba origin terpadu utama (5%), Protected Grup terisolasi audiens (1%), dan grup terisolasi Penyimpanan Bersama (1%). Tujuan alokasi traffic untuk Protected Audience dan Shared Storage tidak akan berubah karena Agregasi Pribadi ditambahkan ke eksperimen terisolasi yang sudah ada.

Alokasi lalu lintas pada hari Selasa, 6 Juni:

API Alokasi traffic Status
Pelaporan Atribusi Terpadu - 5% 6% Traffic stabil per 13 Maret 2023
Diisolasi - 1% - khusus ARA
Kerangka Berpagar Terpadu - 5% 7% Traffic stabil per 13 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama + Agregasi Pribadi + Bingkai Berpagar saja
Terisolasi - 1% - Protected Audience + Agregasi Pribadi + Bingkai Berpagar saja
Protected Audience Terpadu - 5% 6% Traffic stabil per 13 Maret 2023
Terisolasi - 1% - Protected Audience + Agregasi Pribadi + Bingkai Berpagar saja
Agregasi Pribadi Terpadu - 5% 7% Traffic stabil per 6 Juni 2023
Terisolasi - 1% - Protected Audience + Agregasi Pribadi + Bingkai Berpagar saja
Terisolasi - 1% - Penyimpanan Bersama + Agregasi Pribadi + Bingkai Berpagar saja
Penyimpanan Bersama Terpadu - 5% 6% Traffic stabil per 13 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama + Agregasi Pribadi + Bingkai Berpagar saja
Topik Terpadu - 5% 6% Traffic stabil per 13 Maret 2023
Terisolasi - 1% - Hanya topik

Perubahan sebelumnya

Lihat info terbaru sebelumnya tentang uji coba origin.

April 2023

Peningkatan 1% Agregasi Pribadi di Stabil

Pribadi Uji coba origin Aggregation API akan tersedia di 1% Chrome Stabil traffic eksperimen terpadu mulai Senin, 17 April. sendHistogramReport() fungsi Private Aggregation tersedia untuk digunakan di Protected Audience API dan Penyimpanan Bersama {i>worklet<i}.

Mulai hari Senin, 17 April, alokasi traffic akan terlihat seperti berikut:

API Alokasi traffic Status
Pelaporan Atribusi Terpadu - 5% 6% traffic Stabil mulai 13 Maret 2023
Diisolasi - 1% - khusus ARA
Kerangka Berpagar Terpadu - 5% 7% traffic Stabil mulai dari 13 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama (Pemilihan URL) + Bingkai Berpagar saja
Terisolasi - 1% - khusus Protected Audience API + Fenced Frames
Protected Audience API Terpadu - 5% 6% traffic Stabil mulai 13 Maret 2023
Terisolasi - 1% - khusus Protected Audience API + Fenced Frames
Agregasi Pribadi Terpadu - 1% 1% traffic Stabil mulai 17 April 2023
Penyimpanan Bersama (Pilihan URL) Terpadu - 5% 6% traffic Stabil mulai dari 13 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama (Pemilihan URL) + Bingkai Berpagar saja
Topik Terpadu - 5% 6% traffic Stabil mulai dari 13 Maret 2023
Terisolasi - 1% - Hanya topik

Maret 2023

Pembaruan linimasa

Kami awalnya menyampaikan bahwa kami akan memulai eksperimen terpisah pada hari Senin, 13 Maret 2023, tetapi eksperimen baru kini akan dimulai pada Kamis, 16 Maret tahun 2023 karena waktu tambahan yang diperlukan untuk menyiapkan eksperimen. Angka 1% Peningkatan kembali Protected Audience API dari 4% menjadi 5% juga akan terjadi pada hari Kamis, 16 Maret 2023.

Peningkatan pencadangan 1% Protected Audience API

Bulan lalu, kami mengurangi sementara traffic uji coba origin Protected Audience API dari 5% menjadi 4% 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 melakukan peningkatan akan sama dengan kelompok pengguna yang diturunkan. Namun, grup minat mereka sebelumnya telah berakhir, karena lebih dari 30 hari telah berlalu sejak penghentian.

Eksperimen terisolasi

Untuk meningkatkan proses pengujian dan terus mengamati metrik API uji coba origin, kami membuat eksperimen terisolasi untuk setiap API, selain eksperimen terpadu yang sudah ada. Eksperimen baru akan dibuat untuk Attribution Reporting, Topics, kombinasi Protected Audience API dan Fenced Frames, serta kombinasi operasi Pemilihan URL dan Fenced Frames Penyimpanan Bersama. Di setiap eksperimen terisolasi, hanya API yang ditetapkan yang akan tersedia untuk pengguna dalam grup tersebut.

API Alokasi traffic
eksperimen terisolasi
Pelaporan Atribusi 1%
Protected Audience API + Fenced Frames 1%
Penyimpanan Bersama (pemilihan URL) + Bingkai Berpagar 1%
Topik 1%

Mulai Kamis, 16 Maret, Anda akan mulai menerima 1% tambahan Traffic Chrome Stabil untuk API yang tercantum di atas, selain traffic 5% yang terima dari eksperimen terpadu yang sudah ada. Pengguna baru akan dialokasikan pada setiap eksperimen.

Alokasi traffic

Alokasi traffic uji coba origin terpadu saat ini pada hari Selasa, 28 Februari, adalah sebagai berikut:

API Alokasi traffic eksperimen terpadu
saat ini
Pelaporan Atribusi 5%
Kerangka Berpagar 5%
Protected Audience API 4%
Penyimpanan Bersama (pemilihan URL) 5%
Topik 5%

Mulai hari Kamis, 16 Maret, alokasi traffic akan terlihat seperti berikut, setelah Protected Audience API diaktifkan kembali, dan eksperimen baru yang terisolasi dimulai:

API Alokasi traffic baru Status
Pelaporan Atribusi Terpadu - 5% 6% traffic Stabil mulai 16 Maret 2023
Diisolasi - 1% - khusus ARA
Kerangka Berpagar Terpadu - 5% 7% traffic Stabil mulai dari 16 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama (Pemilihan URL) + Bingkai Berpagar saja
Terisolasi - 1% - khusus Protected Audience API + Fenced Frames
Protected Audience API Terpadu - 5% (alokasi saat ini 4% + 1% peningkatan kembali) 6% traffic Stabil mulai 16 Maret 2023
Terisolasi - 1% - khusus Protected Audience API + Fenced Frames
Penyimpanan Bersama
(Pilihan URL)
Terpadu - 5% 6% traffic Stabil mulai 16 Maret 2023
Terisolasi - 1% - Penyimpanan Bersama (Pemilihan URL) + Bingkai Berpagar 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 sudah ada, dan Anda tidak perlu memperpanjang atau membuat token uji coba origin baru.

Januari 2023

Sebagai bagian dari investigasi regresi Chrome, kami akan mengurangi traffic uji coba origin Protected Audience API untuk sementara dari 5% menjadi 4% Chrome Stabil, mulai 26 Januari 2023. Kami memperkirakan penyelidikan akan memakan waktu sekitar satu bulan, dan kami akan memberi tahu Anda saat lalu lintas kembali meningkat.

Perubahan ini akan otomatis terjadi, dan tidak akan memengaruhi token uji coba origin yang sudah ada. Untuk pengguna dalam 1% traffic yang akan melakukan penghentian, grup minat akan tetap berada di browser mereka. Pengguna yang sama akan menjadi bagian dari peningkatan pencadangan, dan grup minat mereka dapat digunakan kembali. Namun, grup minat akan berakhir masa berlakunya setelah 30 hari, dan penyelidikan regresi mungkin memerlukan waktu lebih lama dari itu.

Selain itu, uji coba origin URL Selection API Shared Storage akan meningkat menjadi 5% traffic Chrome Stabil mulai 26 Januari 2023.

API Catatan
Pelaporan Atribusi Tersedia di Stabil, naik menjadi 5% mulai 26 Oktober 2022.
Topik Tersedia di Stabil, naik menjadi 5% mulai 26 Oktober 2022.
Protected Audience API Tersedia di Stabil, menurun sementara menjadi 4% mulai 26 Januari 2023.
Bingkai Berpagar Tersedia di Stabil, meningkat menjadi 5% mulai 9 November 2022.
Penyimpanan Bersama Tersedia di Stabil, naik 5% mulai 26 Januari 2023.

November 2022

`selectURL` API Penyimpanan Bersama akan bergabung dengan uji coba origin pada 1% traffic Chrome Stabil mulai tanggal 9 November.

Seperti yang diumumkan sebelumnya dalam Meningkatkan uji coba origin Pengukuran dan Relevansi Privacy Sandbox menjadi 5%, Attribution Reporting and Topics kini mencapai 5% dengan Protected Audience API dan Fenced Frames yang juga mengikuti pada 9 November.

API Catatan
Pelaporan Atribusi Tersedia di Stabil, naik menjadi 5% mulai 26 Oktober.
Topik Tersedia di Stabil, naik menjadi 5% mulai 26 Oktober.
Protected Audience API Tersedia di Stabil, naik menjadi 5% mulai 9 November.
Bingkai Berpagar Tersedia di Stabil, naik menjadi 5% mulai 9 November.
Penyimpanan Bersama Akan tersedia di Stabil, mulai 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 meningkat mulai 9 November.

Baca selengkapnya di postingan blog Meningkatkan uji coba origin Pengukuran dan Relevansi Privacy Sandbox hingga 5%.

API Catatan
Pelaporan Atribusi Tersedia di Stabil, naik menjadi 5% setelah 26 Oktober.
Topik Tersedia di Stabil, naik menjadi 5% setelah 26 Oktober.
Protected Audience API Tersedia di Stabil, naik menjadi 5% mulai 9 November.
Bingkai Berpagar Tersedia di Stabil, naik menjadi 5% mulai 9 November.
Penyimpanan Bersama Saat ini hanya tersedia dalam M105+ Canary, Dev, dan Beta.

Oktober 2022

Perpanjangan ini diberikan agar ekosistem di saluran Stabil memiliki waktu untuk terus menguji dan memvalidasi peningkatan API, sambil memberikan masukan sesuai dengan linimasa publik yang sudah ada.

Keseluruhan linimasa Privacy Sandbox tidak berubah.

API yang disertakan dalam uji coba:

API Catatan
Atribusi Pelaporan Pengembang panduan untuk uji coba origin.
Protected Audience API Pengembang panduan untuk uji coba origin.
Topik Pengembang panduan untuk uji coba origin.
Berpagar Bingkai Lihat panduan Protected Audience API untuk penggunaan uji coba origin.
Dibagikan Penyimpanan Saat ini hanya tersedia dalam M105+ Canary, Dev, dan Beta.

Agustus 2022

  • Ketersediaan uji coba origin meningkatkan hingga 1% pengguna desktop dari Chrome Stabil 104.
  • Update akan menyusul ketika ketersediaannya mencakup pengguna seluler.
  • Saluran pra-stabil (Canary, Beta) tetap berada di 50% pengguna.
  • API tidak tersedia di Chrome iOS.

Mei 2022

Ketersediaan uji coba origin meningkatkan hingga 50% pengguna dari Chrome 102 Beta.

API yang disertakan dalam uji coba:

API Catatan
Atribusi Pelaporan Pengembang panduan untuk uji coba origin.
Protected Audience API Pengembang panduan untuk uji coba origin.
Topik Panduan developer untuk uji coba origin baru. Topik sempat dinonaktifkan dalam uji coba origin karena bug yang stabilitas browser yang terpengaruh.
Berpagar Bingkai Fenced Frames ditambahkan ke uji coba origin. Lihat panduan Protected Audience API untuk penggunaan eksperimen.

April 2022

Uji coba origin dimulai dengan proporsi pengguna terbatas dari Chrome 102 Beta.

API yang disertakan dalam uji coba:

API Catatan
Atribusi Pelaporan Niat Individual to Bereksperimen (I2E). Pelaporan Atribusi juga tersedia sebagai uji coba origin individu.
Protected Audience API Niat Individual to Bereksperimen (I2E). Protected Audience API hanya tersedia di desktop dengan subkumpulan fungsi.
Topik Niat Individual to Bereksperimen (I2E).

Mendaftar dan mengonfigurasi uji coba origin

Untuk mengaktifkan uji coba origin di situs Anda, Anda harus mendaftar dan menyematkan token uji coba origin yang telah ditetapkan (string berbasis waktu untuk akses spesifik uji coba origin). Pelajari lebih lanjut di Memulai asal Chrome uji coba.

Token uji coba origin akan segera diberikan, dan Anda dapat mencabut atau membuatnya kembali kapan saja.

Untuk setiap halaman tempat Anda ingin menggunakan uji coba origin, Anda harus menyertakan token uji coba dengan HTML atau respons halaman tertentu.

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 API joinAdInterestGroup()), token harus diberikan dalam iframe dan cocokkan dengan asal iframe.

Mengonfigurasi lintas situs dengan JavaScript

Jika Anda menggunakan fitur uji coba origin melalui JavaScript lintas situs, seperti pada penyedia JavaScript pihak ketiga yang disertakan di halaman tingkat atas, maka Anda harus:

  • Pilih opsi Pencocokan pihak ketiga saat mendaftar untuk origin Cloud.
  • Kolom Asal Web harus merupakan asal skrip Anda.
  • Memasukkan tag <meta> ke halaman tingkat atas (yaitu, halaman pihak pertama halaman, 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 DevTools > Aplikasi .

Status Token Berhasil dan diaktifkan.
Status Token Success dan diaktifkan.
  1. Scroll ke bawah ke panel Frame.
  2. Pilih frame tempat Anda ingin menetapkan token. Misalnya, teratas bingkai untuk halaman tingkat atas atau iframe tertentu untuk halaman yang disematkan.
  3. Di panel sebelah kanan, scroll ke bawah ke bagian Uji Coba Origin.
  4. Anda akan melihat entri untuk uji coba PrivacySandboxAdsAPIs.
  5. Luaskan entri ini untuk melihat status uji coba origin dan token kata.

Uji coba origin terbatas untuk sebagian pengguna Chrome, dan browser Anda dapat tidak berada dalam grup eksperimen. Akibatnya, Anda mungkin melihat TrialNotAllowed berwarna merah pesan terhadap PrivacySandboxAdsAPIs. Ketika Anda memperluas entri untuk memeriksa Status Token, jika menampilkan pesan Success berwarna hijau, berarti uji coba origin Anda sudah benar. Pengguna yang memenuhi syarat akan melihat pesan yang ditetapkan ke Enabled.

Status Token Success dan tidak diaktifkan.
Status Token Success dan belum diaktifkan.

Jika Anda melihat pesan yang berbeda, lihat Memecahkan masalah asal Chrome uji coba untuk checklist mendetail untuk memvalidasi konfigurasi uji coba origin Anda.

Mendeteksi fitur

Seperti semua fitur web, Anda harus memeriksa browser sebelum mencoba menggunakannya. Anda dapat melakukannya dengan memeriksa adanya 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. Mereka juga harus memiliki fungsi relevan yang diaktifkan di setelan mereka agar memenuhi syarat untuk uji coba:

Setelan browser

Agar memenuhi syarat untuk uji coba, pengguna harus:

  • Menggunakan versi dan saluran Chrome yang menyediakan uji coba origin sedang berjalan.

  • Berada dalam grup eksperimen aktif di Chrome.

Setelan pengguna

Agar memenuhi syarat untuk uji coba, pengguna juga harus:

  • mengaktifkan uji coba Privacy Sandbox melalui Settings > Keamanan dan privasi > Privacy Sandbox, juga dapat diakses melalui chrome://settings/adPrivacy.
  • mengaktifkan cookie pihak ketiga melalui Setelan > Keamanan dan privasi > Cookie dan data situs lainnya 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 dalam mode Samaran.

Meskipun uji coba origin hanya akan ditampilkan sebagai aktif untuk pengguna yang memenuhi syarat, Anda juga dapat gunakan flag developer untuk melakukan pengujian terhadap produksi Anda sendiri situs Anda.

Kontrol partisipasi Anda dalam uji coba origin

Mekanisme uji coba origin tetap sama: Anda mendapatkan uji coba origin token untuk konteks tempat Anda ingin bereksperimen dengan API. Dengan populasi pengujian yang lebih luas, Anda harus memastikan bahwa Anda memantau secara aktif dan mengontrol tingkat traffic tempat Anda memilih untuk mengaktifkan uji coba.

Pendekatan yang baik dalam tugas ini adalah:

  1. Sertakan token uji coba origin secara default di semua konteks tempat Anda ingin eksperimen.
  2. Gunakan deteksi fitur untuk memeriksa API yang aktif.
  3. Jika API aktif (sehingga browser memenuhi syarat untuk eksperimen), pilih apakah akan menggunakannya berdasarkan eksperimen Anda sendiri atau tidak kriteria. Misalnya, jika Anda sudah memiliki infrastruktur pengujian A/B untuk melakukan eksperimen pada persentase traffic, sampling, atau beberapa atribut lainnya, maka pada titik ini Anda dapat memutuskan fitur mana yang akan Anda gunakan secara aktif.

Anda dapat mencegah partisipasi dalam uji coba origin sepenuhnya untuk browser apa pun instance Anda tanpa menyertakan token tersebut dalam respons. Misalnya, jika Anda memiliki memenuhi kuota Anda untuk eksperimen atau perlu mengatasi masalah selama uji coba gratis, maka tidak menyertakan token akan memastikan tidak ada fungsi eksperimental yang tersedia atau aktif di halaman.

Kontrol uji coba origin berdasarkan wilayah geografis

Anda tidak dapat memilih tidak ikut uji coba origin untuk wilayah tertentu. Uji coba origin aktif di halaman yang berisi token, disertakan melalui header HTTP (sisi server) atau tag meta HTML (sisi klien).

Jika dapat menentukan lokasi pengguna, Anda dapat menulis kode untuk menyertakan token uji coba origin berdasarkan informasi lokasi tersebut. Sebagai contoh, Anda dapat mencoba menggunakan alamat IP untuk menentukan lokasi pengguna. Alamat IP dapat dipalsukan, jadi ini bukan solusi yang pasti.

Namun, asal khusus geografis dapat menetapkan izin Izin Kebijakan untuk mengontrol fitur dapat digunakan. Misalnya, us.example.com dan uk.example.com adalah asal geografis tertentu yang dapat dikontrol. Ini bukan berarti bahwa wilayah telah memilih untuk tidak mengikuti uji coba origin.

Dengan Kebijakan Izin, situs menambahkan sedikit cuplikan kode ke halamannya yang memberikan petunjuk ke browser. Saat halaman dimuat, browser 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.

Perpanjang token Anda

Masa berlaku token uji coba origin berakhir enam minggu sejak tanggal penerbitannya (atau pada akhir tertentu jika lebih cepat).

Anda harus memperpanjang dan men-deploy token dalam jendela tersebut untuk penggunaan fitur uji coba origin tanpa gangguan.

Memperpanjang token hanya membutuhkan waktu beberapa menit, dan Anda dapat menerapkan beberapa token uji coba yang sama dalam halaman yang sama. Anda dapat men-deploy token yang diperpanjang sebelum masa berlaku token yang ada habis, 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 mengaktifkan setelan konfigurasi yang sama di atas, lalu:

  • Gunakan versi dan saluran Chrome yang menyediakan fitur-fitur tersebut.
  • Aktifkan semua API privasi iklan di chrome://settings/adPrivacy.

Periksa panduan pengembang untuk ketersediaan API dan fitur tertentu serta penanda tambahan untuk konfigurasi yang lebih mendetail.