Ringkasan Protected Audience API

Lelang iklan di perangkat untuk menayangkan iklan pemasaran ulang dan audiens kustom, tanpa pelacakan pihak ketiga lintas situs.

Untuk siapa dokumen ini?

Dokumen ini membahas dasar-dasar Protected Audience API dan menjelaskan beberapa konsep dasarnya, tetapi tidak membahas detail teknisnya.

Lihat glosarium untuk mengetahui istilah yang digunakan dalam dokumentasi Protected Audience. Di akhir dokumen ini, Anda dapat mempelajari cara memberikan dan membagikan masukan.

Apa yang dimaksud dengan Protected Audience API?

Protected Audience API adalah teknologi Privacy Sandbox untuk mendukung kasus penggunaan audiens kustom dan pemasaran ulang, yang didesain agar pihak ketiga tidak dapat melacak perilaku penjelajahan pengguna di seluruh situs.

Protected Audience API memungkinkan lelang di perangkat oleh browser, untuk memilih iklan yang relevan dari situs yang sebelumnya dikunjungi pengguna.

Protected Audience API adalah eksperimen pertama yang diterapkan di Chromium dalam rangkaian proposal TURTLEDOVE. Perbedaan antara Protected Audience dan TURTLEDOVE terutama berkaitan dengan pemisahan peran pembeli dan penjual iklan di perangkat. Bagian berikut menjelaskan cara kerja Protected Audience API.

Protected Audience API dalam satu menit

Untuk ringkasan mendalam tentang Protected Audience API, baca panduan developer Protected Audience API.

Ringkasan setiap tahap siklus proses Protected Audience API
Siklus proses Protected Audience API.

Protected Audience API menggunakan grup minat untuk memungkinkan situs menampilkan iklan yang relevan bagi penggunanya.

Misalnya, saat pengguna mengunjungi situs yang ingin mengiklankan produknya, pemilik grup minat (seperti platform sisi permintaan (DSP)) dapat meminta browser pengguna untuk menambahkan keanggotaan untuk grup minat tersebut. Jika permintaan berhasil, browser akan mencatat:

  • name grup minat: misalnya, 'custom-bikes'.
  • Pemilik grup minat: misalnya, 'https://dsp.example'.
  • Informasi konfigurasi grup minat untuk memungkinkan browser mengakses kode bidding, kode iklan, dan data real-time, jika pemilik grup diundang untuk mengajukan bid dalam lelang iklan.

Kemudian, saat pengguna mengunjungi situs dengan ruang iklan yang tersedia, penjual ruang iklan (penyedia sisi jual (SSP), atau situs itu sendiri) dapat menggunakan Protected Audience untuk menjalankan lelang iklan guna memilih iklan yang paling sesuai untuk ditampilkan kepada pengguna. Penjual memanggil fungsi navigator.runAdAuction(), yang menyediakan daftar pemilik grup minat yang diundang untuk mengajukan bid.

Bid hanya dapat diberikan oleh grup minat yang anggotanya adalah browser, yang pemiliknya telah diundang untuk mengajukan bid.

Kode bidding diambil dari URL yang diberikan dalam konfigurasi grup minat. Kode ini memberikan data tentang grup minat dan informasi dari penjual, beserta data kontekstual tentang halaman dan dari browser.

Setiap grup minat yang memberikan bid dikenal sebagai pembeli.

Saat browser memanggil fungsi untuk menjalankan lelang iklan, kode setiap pembeli membuat bid dengan bantuan data real-time yang disediakan oleh layanan Nilai/Kunci Protected Audience mereka. Kemudian, penjual menerima bid ini serta data real-time milik penjual dan memberi skor pada setiap bid. Bid dengan skor tertinggi akan memenangkan lelang.

Iklan pemenang ditampilkan dalam frame tertutup. URL materi iklan ditentukan dalam bid, dan asal harus cocok dengan salah satu URL dalam daftar yang diberikan oleh konfigurasi grup minat.

Penjual dapat melaporkan hasil lelang (reportResult()), dan pembeli dapat melaporkan kemenangan mereka (reportWin()).

Pelajari laporan lelang Protected Audience.

Mengapa kita memerlukan Protected Audience API?

Memahami minat pengguna dapat memungkinkan iklan yang lebih relevan daripada hanya memilih iklan berdasarkan konten situs (penargetan kontekstual) atau dengan menggunakan informasi yang diberikan oleh pengguna ke situs tempat iklan muncul (penargetan data pihak pertama).

Biasanya, platform iklan mempelajari minat pengguna dengan melacak perilaku mereka di berbagai situs. Browser memerlukan cara untuk mengaktifkan platform iklan agar dapat memilih iklan yang relevan, sehingga penayang konten dapat memperoleh pendapatan iklan tanpa pelacakan lintas situs.

Protected Audience API bertujuan untuk memindahkan platform web ke kondisi saat browser pengguna di perangkatnya—bukan pengiklan atau platform teknologi iklan—memiliki informasi tentang minat orang tersebut.

Bagaimana cara mencoba Protected Audience API?

  • Panduan developer Protected Audience API menjelaskan cara menggunakan API dan cara menguji secara lokal.

  • protected-audience-demo.web.app memberikan penjelasan tentang deployment Protected Audience dasar di seluruh situs pengiklan dan penayang. Video demo Protected Audience menjelaskan cara kerja kode ini dan menampilkan pratinjau cara menggunakan Chrome DevTools untuk men-debug.

Konfigurasi browser apa yang tersedia?

Pengguna dapat menyesuaikan partisipasi mereka untuk uji coba Privacy Sandbox di Chrome dengan mengaktifkan atau menonaktifkan setelan tingkat teratas di chrome://settings/adPrivacy. Selama pengujian awal, pengguna dapat memilih tidak menggunakan Protected Audience API melalui setelan Privacy Sandbox.

Chrome berencana mengizinkan pengguna melihat dan mengelola daftar grup minat tempat mereka dimasukkan di seluruh situs yang telah mereka kunjungi. Seperti teknologi Privacy Sandbox, setelan pengguna dapat berubah seiring dengan masukan dari pengguna, badan pengatur, dan pihak lainnya.

Kami akan memperbarui setelan yang tersedia di Chrome seiring perkembangan Protected Audience API, berdasarkan pengujian dan masukan. Pada masa mendatang, kami akan menawarkan setelan yang lebih terperinci untuk mengelola Protected Audience dan data terkait.

Pemanggil API tidak dapat mengakses keanggotaan grup saat pengguna menjelajah dalam mode Samaran, dan keanggotaan dihapus saat pengguna menghapus data situs mereka.

Dapatkah saya memilih untuk tidak menggunakan Protected Audience API?

Pelajari cara memblokir akses ke Protected Audience API, baik sebagai pemilik situs maupun sebagai pengguna individu.

Konsep utama

Mencari informasi selengkapnya tentang terminologi Protected Audience? Lihat glosarium Privacy Sandbox.

Apa yang dimaksud dengan grup minat?

Grup minat Protected Audience API mewakili sekelompok orang dengan minat yang sama, yang sesuai dengan daftar pemasaran ulang.

Setiap grup minat Protected Audience API memiliki pemilik. Berbagai jenis pemilik akan membuat berbagai jenis grup minat dengan berbagai kasus penggunaan.

Pemilik meminta browser pengguna untuk menambahkan keanggotaan grup minatnya dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup(), memberikan informasi seperti data tentang iklan yang relevan dengan grup minat, dan URL untuk JavaScript yang digunakan dalam bidding. Data grup minat (seperti iklan) dapat diperbarui, dan grup minat dapat diaktifkan hingga 30 hari.

Jenis grup minat

Tabel berikut memberikan contoh berbagai jenis grup minat dan pemilik Protected Audience API.

Pemilik Contoh Minat Contoh Kasus penggunaan
Pengiklan Pembuat sepeda Produk Orang yang melihat halaman produk untuk kategori sepeda tertentu. Pemasaran ulang kepada orang-orang yang sebelumnya berinteraksi dengan merek.
Penerbit Situs berita Konten Orang yang membaca tentang bersepeda. Penayang dapat menggunakan data pihak pertama untuk memungkinkan pengiklan membeli iklan yang relevan bagi pembaca di situs mereka. Grup minat milik penayang dapat memungkinkan penayang melakukan hal yang sama meskipun orang tersebut menjelajahi situs lain. Penayang mungkin dapat mengenakan biaya untuk kemampuan menampilkan iklan kepada segmen audiens tertentu.
Teknologi iklan DSP Kategori produk Orang-orang yang menunjukkan minat pada perlengkapan bersepeda. Perusahaan teknologi iklan dapat membuat dan mengelola grup minat orang yang mereka yakini sedang mencari item dalam kategori tertentu. Grup minat ini kemudian dapat digunakan untuk mengiklankan produk di situs yang menjual barang dalam kategori tersebut (dan yang bekerja sama dengan perusahaan teknologi iklan).

Chrome mengizinkan hingga 1.000 grup minat per pemilik, dan hingga 1.000 pemilik grup minat. Batas ini dimaksudkan sebagai pagar pembatas, bukan untuk dicapai dalam operasi reguler.

Apa yang dimaksud dengan pembeli?

Di Protected Audience API, pembeli adalah pihak yang memiliki grup minat dan mengajukan bid dalam lelang iklan.

Contoh:

Pembeli memiliki tiga tugas:

  • Pilih apakah Anda ingin berpartisipasi dalam lelang.
  • Pilih iklan dan hitung bid.
  • Laporkan hasil lelang.

Tugas ini dilakukan secara terprogram, dalam kode yang disediakan oleh pembeli yang dijalankan selama lelang iklan Protected Audience API.

Saat pembeli meminta browser pengguna untuk menambahkan grup minat ke grup yang dianggotainya (dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup()), pembeli memberikan informasi berikut kepada browser:

  • URL untuk kode bidding, yang akan digunakan saat penjual menjalankan lelang iklan.
  • URL untuk materi iklan untuk grup minat. (URL iklan dapat ditambahkan nanti dengan pembaruan.)
  • Daftar kunci data yang akan dikueri, dan URL layanan Kunci/Nilai pembeli, untuk memungkinkan kode bidding mendapatkan data real-time selama lelang.

Kode pembeli juga dapat menyertakan fungsi reportWin() untuk melaporkan hasil lelang.

Siapa yang menjalankan lelang iklan?

Ada beberapa pihak yang dapat menjalankan lelang untuk menjual ruang iklan.

Contoh:

  • Penayang konten: bertindak untuk dirinya sendiri dalam menghosting konten iklan di situsnya.
  • Platform sisi suplai (SSP): bekerja sama dengan penayang dan menyediakan layanan lainnya.
  • Skrip pihak ketiga: bertindak untuk penayang, untuk mengaktifkan partisipasi dalam lelang iklan.

Dengan Protected Audience API, penjual ruang iklan memiliki tiga tugas:

  • Menerapkan aturan penayang: menyatakan pembeli dan bid mana yang memenuhi syarat.
  • Menjalankan logika lelang: JavaScript dijalankan di worklet untuk menghitung skor keinginan untuk setiap bid.
  • Laporkan hasil lelang.

Tugas ini dilakukan secara terprogram, dalam kode yang disediakan oleh penjual saat memulai lelang iklan dengan memanggil fungsi JavaScript navigator.runAdAuction().

Bagaimana cara kerja lelang iklan Protected Audience API?

Diagram berikut menguraikan setiap tahap lelang iklan Protected Audience API:

Enam tahap dalam lelang iklan Protected Audience API
Tahapan lelang iklan Protected Audience.

Di Protected Audience API, lelang iklan adalah kumpulan program JavaScript kecil yang dijalankan browser di perangkat pengguna untuk memilih iklan. Untuk menjaga privasi, semua kode lelang iklan dari penjual dan pembeli dijalankan di worklet JavaScript terisolasi yang tidak dapat berkomunikasi dengan dunia luar.

Penjual (penayang atau platform sisi suplai) memulai lelang iklan Protected Audience di situs yang menjual ruang iklan (seperti situs berita). Penjual memilih pembeli untuk berpartisipasi dalam lelang, menunjukkan ruang yang dijual, dan memberikan kriteria tambahan untuk iklan. Setiap pembeli adalah pemilik grup minat.

Penjual memberikan kode ke browser untuk memberi skor pada bid, yang mencakup nilai setiap bid, URL materi iklan, dan data lain yang ditampilkan dari setiap pembeli. Selama lelang, kode bidding dari pembeli dan kode pemberian skor bid dari penjual dapat menerima data dari layanan Kunci/Nilai mereka. Setelah iklan dipilih dan ditampilkan (dalam frame tertutup untuk menjaga privasi), penjual dan pembeli pemenang dapat melaporkan hasil lelang.

  1. Pengguna mengunjungi situs yang menampilkan iklan.
  2. Kode penjual memulai lelang. Penjual menentukan ruang iklan yang dijual dan siapa yang dapat mengajukan bid, serta metode untuk memberi skor pada bid tersebut.
  3. Kode pembeli yang diundang dijalankan untuk membuat bid, URL untuk materi iklan yang relevan, dan data lainnya. Skrip bidding dapat membuat kueri untuk data real-time, seperti sisa anggaran kampanye iklan, dari layanan Key/Valuepembeli.
  4. Kode penjual memberi skor pada setiap bid dan memilih pemenang. Logika ini menggunakan nilai bid dan data lainnya untuk menampilkan daya tarik bid dan menolak iklan yang tidak dapat mengalahkan pemenang iklan kontekstual. Penjual dapat menggunakan layanan Kunci/Nilai mereka sendiri untuk data real-time. Sebelum lelang dimulai, penjual menemukan iklan kontekstual terbaik untuk slot iklan yang tersedia.
  5. Iklan pemenang ditampilkan sebagai objek konfigurasi frame tertutup saat tanda resolveToConfig disetel dalam konfigurasi lelang. Konfigurasi digunakan untuk mengarahkan frame tertutup ke materi iklan, dan URL materi iklan disembunyikan dari penjual dan penayang. Jika tanda resolveToConfig disetel ke false atau tidak diteruskan, iklan pemenang akan ditampilkan sebagai URN buram yang dapat digunakan untuk merender iklan dalam iframe. Objek konfigurasi frame tertutup tersedia mulai dari M114.
  6. Lelang dilaporkan kepada penjual dan pembeli yang menang.

Mekanisme pelaporan untuk pembeli yang kalah sedang didiskusikan.

Apa yang dimaksud dengan layanan Nilai/Kunci Protected Audience API?

Layanan Nilai/Kunci Protected Audience API memungkinkan teknologi iklan membuat kueri untuk data real-time saat bid dilakukan oleh pembeli, dan bagi penjual untuk memberi skor pada iklan sambil menjaga privasi. Anda dapat membaca tentang layanan Key/Value Protected Audience API dan layanan lainnya di Layanan Protected Audience API.

Layanan Key/Value di-deploy ke infrastruktur cloud teknologi iklan itu sendiri, dan layanan berjalan di trusted execution environment. Permintaan ke layanan Key/Value tidak dapat menghasilkan logging tingkat peristiwa atau memiliki efek samping lainnya. Layanan Key/Value juga akan mendukung fungsi yang ditentukan pengguna (UDF) yang memungkinkan teknologi iklan menjalankan logika kustomnya sendiri dalam layanan Key/Value.

Pembeli atau penjual memberikan daftar 'kunci' untuk menentukan data yang mereka perlukan dari layanan Kunci/Nilai API Protected Audience. Layanan Key/Value merespons dengan nilai untuk setiap kunci.

Kode layanan Key/Value Protected Audience API kini tersedia di repositori GitHub Privacy Sandbox. Layanan ini dapat digunakan oleh developer Chrome dan Android.

Pelajari lebih lanjut layanan Nilai/Kunci Protected Audience API dari penjelasan API dan penjelasan model kepercayaan.

Bagaimana data real-time dimasukkan ke dalam lelang?

Pembeli atau penjual dalam lelang iklan mungkin memerlukan akses ke data real-time. Misalnya, pembeli mungkin ingin menghitung sisa anggaran dalam kampanye iklan, atau penjual mungkin diwajibkan untuk memeriksa materi iklan terhadap kebijakan penayang.

Untuk memenuhi persyaratan privasi Protected Audience API, data real-time yang diperlukan selama lelang iklan disediakan oleh layanan Key/Value. Saat setiap pembeli memanggil navigator.joinAdInterestGroup(), pembeli menentukan URL layanan Kunci/Nilai dan menentukan kunci yang akan dikueri ke layanan selama lelang. Demikian pula, saat penjual menjalankan lelang iklan dengan memanggil navigator.runAdAuction(), penjual memberikan URL untuk layanan Kunci/Nilainya. Layanan Kunci/Nilai penjual akan dikueri dengan URL render materi iklan.

Untuk pengujian awal, model "Bring Your Own Server" digunakan. Dalam jangka panjang, teknologi iklan harus menggunakan layanan Nilai/Kunci Protected Audience API open source yang berjalan di lingkungan eksekusi tepercaya untuk mengambil data real-time.

Untuk memastikan ekosistem memiliki waktu yang cukup untuk melakukan pengujian, kami tidak akan mewajibkan penggunaan layanan Key/Value open source atau lingkungan eksekusi tepercaya hingga beberapa waktu setelah penghentian penggunaan cookie pihak ketiga. Kami akan memberikan pemberitahuan yang memadai kepada developer untuk mulai menguji dan mengadopsi sebelum transisi ini terjadi.

Bagaimana data pihak pertama digunakan dalam lelang Protected Audience?

Data pihak pertama adalah data yang dimiliki oleh situs tentang penggunanya. Misalnya, jika pengguna telah menentukan warna favoritnya di situs pengiklan atau penayang, warna tersebut dianggap sebagai data pihak pertama.

Dalam lelang Protected Audience, pengiklan dapat menggunakan data pihak pertama mereka untuk menentukan keanggotaan grup minat iklan, dan juga dapat meneruskan data ke grup minat sebagai userBiddingSignals. Data pihak pertama dari pengiklan hanya akan tersedia untuk pembeli selama langkah pembuatan bid, dan tidak tersedia untuk penjual.

Misalnya, jika pengiklan mengetahui warna favorit pengguna, nilai dapat ditetapkan dalam konfigurasi grup minat sebagai userBiddingSignals saat pengguna ditambahkan ke grup minat:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Penayang juga dapat meneruskan data pihak pertama mereka dengan menyetel sinyal dalam konfigurasi lelang saat memulai lelang, dan dapat mengontrol siapa yang menerima data pihak pertama tersebut. Jika penayang meneruskan data pihak pertama sebagai auctionSignals, data tersebut tersedia bagi pembeli dan penjual. Jika data diteruskan sebagai sellerSignals, data hanya tersedia untuk penjual, dan jika diteruskan sebagai perBuyerSignals, data hanya tersedia untuk pembeli tertentu. Penayang juga dapat meneruskan data pihak pertama ke lelang komponen. Penayang dan peserta lelang harus menyetujui terlebih dahulu data pihak pertama yang perlu dibagikan, dan cara data tersebut diformat.

Contoh berikut menjelaskan cara data pihak pertama dapat diteruskan oleh penayang kepada berbagai peserta lelang:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Cari tahu lebih lanjut

Untuk ringkasan mendalam tentang Protected Audience API, baca panduan developer Protected Audience API.

Developer

Jika Anda siap untuk mulai menggunakan Protected Audience API, baca bagian bereksperimen dan berpartisipasi.

Kami telah menulis panduan developer API dan membuat demo Protected Audience API, yang menawarkan penjelasan tentang deployment Protected Audience API dasar. Video demo Protected Audience API menjelaskan cara kerja kode demo, dan menunjukkan cara menggunakan Chrome DevTools untuk proses debug Protected Audience API.

Berinteraksi dan memberikan masukan