Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Protected Audience API

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

Kepada siapa artikel ini?

Artikel ini membahas dasar-dasar Protected Audience API dan menjelaskan beberapa hal mendasar konsep, tetapi tidak membahas banyak hal teknis.

Jika Anda bekerja di bidang periklanan atau teknologi iklan, Anda akan mendapatkan ringkasan tentang cara kerja Protected Audience.
Jika Anda seorang developer atau software engineer, Panduan Developer Protected Audience API menyediakan lebih banyak info detail teknis yang lebih mendalam tentang API. Baca status terbaru kemampuan Protected Audience yang tertunda.

Lihat glosarium untuk istilah yang digunakan dokumentasi Protected Audience. Di akhir artikel ini, Anda dapat mempelajari cara berinteraksi dan memberikan masukan.

Apa itu Protected Audience API?

Protected Audience API adalah Privacy Sandbox untuk melayani 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 situs web yang sebelumnya dikunjungi pengguna.

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

Protected Audience API dalam satu menit

Untuk ringkasan yang lebih 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 agar situs dapat iklan Display yang relevan dengan pengguna mereka.

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

Nama grup minat: misalnya, 'sepeda motor'.
Pemilik grup minat: misalnya, 'https://dsp.example'.
Informasi konfigurasi grup minat untuk mengizinkan browser mengakses kode bidding, kode iklan, dan data real-time, jika pemilik grup diundang mengajukan bid dalam lelang iklan.

Kemudian, saat pengguna mengunjungi situs yang memiliki 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 navigator.runAdAuction() , yang menyediakan daftar pemilik grup minat yang diundang untuk mengajukan bid.

Bid hanya dapat disediakan oleh grup minat yang browsernya merupakan anggota, yang pemiliknya telah diundang untuk mengajukan bid.

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

Setiap grup minat yang mengajukan 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 Kunci/Nilai Protected Audience. Kemudian, penjual menerima bid ini serta data dan skor real-time milik penjual masing-masing maksimum. Bid dengan skor tertinggi akan memenangkan lelang.

Iklan pemenang ditampilkan dalam frame dengan fence. URL materi iklan telah ditentukan dalam bid, dan asal harus cocok dengan yang ada di daftar yang disediakan oleh konfigurasi grup minat.

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

Pelajari laporan lelang Protected Audience.

Mengapa kami memerlukan Protected Audience API?

Memahami minat pengguna dapat memungkinkan iklan yang lebih relevan dibandingkan 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 telah mempelajari minat pengguna dengan melacak perilaku di seluruh situs. Browser memerlukan cara agar platform iklan dapat memilih iklan yang relevan, sehingga penayang konten bisa memperoleh pendapatan iklan tanpa pelacakan.

Protected Audience API bertujuan untuk memindahkan platform web lebih dekat ke status di perangkat mereka—bukan pengiklan atau platform teknologi iklan—memegang informasi tentang apa yang membuat orang itu tertarik.

Bagaimana cara mencoba Protected Audience API?

Panduan developer Protected Audience API menjelaskan cara menggunakan API dan cara mengujinya secara lokal.
protected-audience-demo.web.app menyediakan panduan deployment Protected Audience dasar di seluruh pengiklan dan penayang di situs Anda. Video demo Protected Audience menjelaskan cara kerja kode ini dan melihat pratinjaunya cara menggunakan Chrome DevTools untuk proses debug.

Konfigurasi browser apa yang tersedia?

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

Chrome berencana mengizinkan pengguna melihat dan mengelola daftar grup minat tempat mereka ditambahkan ke seluruh situs yang mereka kunjungi. Seperti halnya Kebijakan Privasi Teknologi sandbox, setelan pengguna dapat berkembang dengan masukan dari pengguna, badan pengatur, dan lainnya.

Kami akan memperbarui setelan yang tersedia di Chrome seiring dengan progres Protected Audience API. berdasarkan pengujian dan masukan. Ke depannya, kami akan menawarkan setelan yang lebih terperinci untuk mengelola Protected Audience dan data yang terkait.

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

Dapatkah saya memilih tidak ikut menggunakan Protected Audience API?

Pelajari cara memblokir akses ke Protected Audience API, baik sebagai pemilik situs atau sebagai pengguna perorangan.

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, sesuai dengan daftar pemasaran ulang.

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

Pemilik meminta browser pengguna untuk menambahkan keanggotaan grup minatnya dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup(), yang 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 pemilik dan grup minat 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 yang pernah berinteraksi dengan brand tersebut.
Penayang	Situs berita	Konten	Orang yang membaca tentang bersepeda.	Penayang dapat menggunakan data pihak pertama untuk memudahkan pengiklan untuk membeli iklan yang relevan bagi pembaca di situs mereka. J grup minat milik penayang dapat memungkinkan penayang melakukan hal yang sama saat orang-orang itu menjelajahi situs lain. Penerbit mungkin dapat biaya untuk kemampuan menampilkan iklan ke segmen tertentu dari audiens Anda.
Teknologi iklan	DSP	Kategori produk	Orang-orang yang menunjukkan minat pada perlengkapan bersepeda.	Perusahaan teknologi iklan dapat membuat dan mengelola grup minat pengguna yang mereka yakini berada di pasar untuk beberapa kategori item. Grup minat ini dapat digunakan untuk mengiklankan produk di situs yang menjual barang-barang dalam kategori tersebut (dan yang bekerja dengan perusahaan teknologi iklan).

Chrome mengizinkan hingga 1.000 grup minat per pemilik, dan hingga 1.000 grup minat pemilik situs. Batasan ini dimaksudkan sebagai pagar pengaman, bukan untuk dimasuki dalam operasi rutin.

Apa yang dimaksud dengan pembeli?

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

Contoh:

Pengiklan: bertindak untuk dirinya sendiri.
Platform sisi permintaan (DSP): bertindak untuk pengiklan.
Pemilik grup minat: bekerja untuk beberapa pengiklan.

Pembeli memiliki tiga tugas:

Pilih apakah ingin berpartisipasi dalam lelang.
Pilih iklan dan hitung bid.
Melaporkan hasil lelang.

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

Bila pembeli meminta browser pengguna untuk menambahkan grup minat ke grup tempatnya menjadi anggota (dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup()) pembeli memberikan:

URL untuk kode bidding, yang akan digunakan saat penjual menjalankan lelang iklan.
Bisa jadi, URL untuk materi iklan bagi grup minat. (URL iklan dapat ditambahkan nanti dengan pembaruan.)
Daftar kunci data yang akan dikueri, dan URL layanan Kunci/Nilai pembeli, untuk mengaktifkan kode bidding guna 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 mungkin menjalankan lelang untuk menjual ruang iklan.

Contoh:

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

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

Terapkan aturan penayang: yang menyatakan pembeli dan bid mana yang valid.
Jalankan logika lelang: JavaScript berjalan di worklet untuk menghitung skor keinginan untuk setiap bid.
Melaporkan hasil lelang.

Tugas ini dilakukan secara terprogram, dalam kode yang disediakan oleh penjual saat memulai iklan lelang 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 — Tahap lelang iklan Protected Audience.

Di Protected Audience API, lelang iklan adalah kumpulan program JavaScript kecil yang dijalankan browser pada perangkat 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 berita situs Anda). Penjual memilih pembeli untuk berpartisipasi dalam lelang, menunjukkan ruang apa yang dijual, dan memberikan kriteria tambahan untuk iklan. Setiap pembeli adalah pemilik grup minat.

Penjual memberi kode kepada browser untuk menilai bid, yang menyertakan nilai setiap bid, materi iklan, dan data lainnya yang ditampilkan dari setiap pembeli. Selama lelang, proses bidding kode dari pembeli dan kode penskoran tawaran dari penjual dapat menerima data dari Layanan Kunci/Nilai. Setelah iklan dipilih dan ditampilkan (dalam frame dengan fence untuk mempertahankan privasi) penjual dan pembeli yang menang dapat melaporkan hasil lelang.

Pengguna mengunjungi situs yang menampilkan iklan.
Kode penjual memulai lelang. Penjual menentukan ruang iklan yang dijual dan siapa yang dapat mengajukan bid, serta metode untuk menilai bid tersebut.
Kode pembeli yang diundang dieksekusi untuk menghasilkan bid, URL untuk iklan yang relevan materi iklan, dan data lainnya. Skrip bidding dapat mengkueri data real-time, seperti sisa anggaran kampanye iklan, dari kolom Kunci/Nilai layanan.
Kode penjual menilai setiap bid dan memilih pemenang. Logika ini menggunakan metode nilai bid dan data lainnya untuk menghasilkan bid yang diinginkan dan menolak iklan yang tidak bisa mengalahkan pemenang iklan kontekstual. Penjual dapat menggunakan Layanan Kunci/Nilai untuk data real-time. Sebelum pembaruan lelang dimulai, penjual menemukan iklan kontekstual terbaik untuk slot iklan.
Iklan pemenang akan ditampilkan sebagai objek konfigurasi frame dengan fence saat tanda resolveToConfig ditetapkan dalam konfigurasi lelang. Konfigurasi digunakan untuk membuka frame dengan fence 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 dengan fence tersedia mulai dari M114.
Lelang dilaporkan kepada penjual dan pembeli yang menang.
Catatan: reportResult() penjual dan reportWin() pembeli dapat menyertakan panggilan ke sendReportTo(). Fitur ini tersedia untuk sementara, hingga pelaporan gabungan tersedia dengan Agregasi Pribadi.

Mekanisme pelaporan jika kehilangan pembeli sedang dalam diskusi.

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

Layanan Kunci/Nilai Protected Audience API memungkinkan teknologi iklan membuat kueri data real-time saat bid dibuat oleh pembeli, dan agar penjual dapat menilai iklan sekaligus menjaga privasi. Anda dapat membaca tentang layanan Kunci/Nilai Protected Audience API dan lainnya di layanan Protected Audience API.

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

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

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

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

Bagaimana data real-time digabungkan ke dalam lelang?

Pembeli atau penjual dalam lelang iklan mungkin memerlukan akses ke layanan otomatis dan data skalabel. Misalnya, pembeli mungkin ingin menghitung sisa anggaran dalam kampanye iklan, atau penjual mungkin diwajibkan untuk memeriksa materi iklan berdasarkan kebijakan penayang.

Untuk memenuhi persyaratan privasi Protected Audience API, data real-time yang diperlukan selama lelang iklan disediakan oleh layanan Kunci/Nilai. 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 Kunci/Nilai 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 memperkirakan tidak akan mewajibkan penggunaan layanan Kunci/Nilai open source atau trusted execution environment sampai beberapa saat setelah cookie pihak ketiga tidak digunakan lagi. Kami akan memberikan pemberitahuan penting bagi developer untuk memulai pengujian dan penerapan sebelum transisi ini dilakukan.

Bagaimana data pihak pertama digunakan dalam lelang Protected Audience?

Data pihak pertama adalah data yang dimiliki oleh situs pada pengguna mereka. 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 menetapkan sinyal dalam konfigurasi lelang saat memulai lelang, dan dapat mengontrol siapa yang akan menerima data pihak pertama. Saat penayang meneruskan data pihak pertama sebagai auctionSignals, data tersebut akan tersedia untuk pembeli dan penjual. Saat diteruskan sebagai sellerSignals, data hanya akan tersedia untuk penjual, dan jika diteruskan sebagai perBuyerSignals, data hanya akan tersedia untuk pembeli yang ditentukan. Penayang juga dapat meneruskan data pihak pertama ke lelang komponen. Penayang dan peserta lelang harus menyepakati data pihak pertama apa yang perlu dibagikan, dan bagaimana data tersebut perlu diformat.

Contoh berikut menjelaskan cara data pihak pertama dapat diteruskan oleh penayang ke 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 selengkapnya

Untuk ringkasan yang lebih mendalam tentang Protected Audience API, baca Panduan developer Protected Audience API.

Developer

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

Kami telah menulis panduan developer API dan membuat demo Protected Audience API, yang menawarkan panduan 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

GitHub: Baca penjelasan, ajukan pertanyaan dan ikuti diskusi.
Pengumuman: Bergabunglah atau lihat pengumuman sebelumnya di milis Protected Audience API.
W3C: Diskusikan kasus penggunaan industri dalam Meningkatkan Bisnis Iklan Web Grup.
Dukungan developer: Ajukan pertanyaan tentang penerapan dan praktik terbaik, atau ikuti diskusi di Repositori Dukungan Developer Privacy Sandbox.
Implementasi saat ini: Untuk pertanyaan tentang implementasi Protected Audience oleh Chrome: laporkan bug Chromium.