Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Protected Audience API
bookmark_border Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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

Untuk siapa artikel ini?

Artikel ini membahas dasar-dasar Protected Audience API dan menjelaskan beberapa konsep yang mendasarinya, tetapi tidak membahas banyak detail teknis.

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

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

Apa yang dimaksud dengan Protected Audience API?

Protected Audience API adalah teknologi Privacy Sandbox untuk menayangkan kasus penggunaan pemasaran ulang dan audiens kustom, yang dirancang 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 telah dikunjungi pengguna.

Protected Audience API adalah eksperimen pertama yang akan diimplementasikan di Chromium dalam proposal keluarga 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 Protected Audience API yang lebih mendalam, 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:

Nama grup minat: misalnya, 'sepeda kustom'.
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 melakukan bidding 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 memberikan daftar pemilik grup minat yang diundang untuk mengajukan bid.

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

Kode bidding diambil dari URL yang disediakan 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 akan menghasilkan bid dengan bantuan data real-time yang disediakan oleh layanan Nilai Kunci Protected Audience. Kemudian, penjual menerima bid ini serta data real-time milik penjual dan menilai setiap bid. Bid dengan skor tertinggi akan memenangkan lelang.

Iklan pemenang ditampilkan dalam bingkai berpagar. URL materi iklan ditentukan dalam bid, dan asalnya 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 menghasilkan iklan yang lebih relevan daripada hanya memilih iklan berdasarkan konten situs (penargetan kontekstual) atau menggunakan informasi yang diberikan oleh pengguna ke situs tempat iklan muncul (penargetan data pihak pertama).

Secara tradisional, platform iklan telah mempelajari minat pengguna dengan melacak perilaku mereka di seluruh situs. Browser memerlukan cara untuk memungkinkan platform iklan memilih iklan yang relevan, sehingga penayang konten dapat memperoleh pendapatan iklan tanpa pelacakan lintas situs.

Protected Audience API bertujuan untuk memindahkan platform web ke status tempat browser pengguna di perangkat mereka—bukan pengiklan atau platform teknologi iklan—menyimpan 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 panduan deployment Protected Audience dasar di seluruh situs pengiklan dan penayang. Video demo Protected Audience menjelaskan cara kerja kode ini dan pratinjau 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 setelan tingkat teratas di chrome://settings/adPrivacy. Selama pengujian awal, pengguna dapat memilih untuk tidak menggunakan Protected Audience API menggunakan setelan Privacy Sandbox.

Chrome berencana mengizinkan pengguna melihat dan mengelola daftar grup minat tempat mereka dimasukkan di seluruh situs yang telah mereka kunjungi. Seperti halnya teknologi Privacy Sandbox, setelan pengguna dapat berkembang dengan masukan dari pengguna, regulator, dan lainnya.

Kami akan memperbarui setelan yang tersedia di Chrome seiring perkembangan Protected Audience API, berdasarkan pengujian dan masukan. Di 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 menjelajahi dalam mode Samaran, dan keanggotaan akan dihapus saat pengguna menghapus data situs mereka.

Dapatkah saya memilih tidak menggunakan Protected Audience API?

Pelajari cara memblokir akses ke Protected Audience API, baik sebagai pemilik situs maupun 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, yang 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 minat mereka 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 pernah 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-orang tersebut menjelajahi situs lain. Penayang mungkin dapat mengenakan biaya untuk kemampuan menampilkan iklan ke segmen tertentu audiens mereka.
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 beberapa kategori item. 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, tidak boleh tercapai 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:

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 Anda ingin berpartisipasi dalam lelang.
Memilih iklan dan menghitung bid.
Melaporkan 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 menjadi anggotanya (dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup()), pembeli akan memberikan:

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

Contoh:

Penerbit konten: bertindak untuk dirinya sendiri guna menghosting konten iklan di situsnya.
Platform sisi suplai (SSP): bekerja sama dengan penayang dan menyediakan layanan lainnya.
Skrip pihak ketiga: bertindak untuk penayang, untuk memungkinkan 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 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 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 — Tahap 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 dalam worklet JavaScript terisolasi yang tidak dapat berkomunikasi dengan dunia luar.

Penjual (penayang atau platform sisi pasokan) 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 menilai bid, yang mencakup setiap nilai bid, URL materi iklan, dan data lain yang ditampilkan dari setiap pembeli. Selama lelang, kode bidding dari pembeli dan kode penskoran bid dari penjual dapat menerima data dari layanan Kunci/Nilai mereka. Setelah iklan dipilih dan ditampilkan (dalam bingkai berpagar untuk menjaga privasi), penjual dan pembeli pemenang dapat melaporkan hasil lelang.

Pengguna mengunjungi situs yang menampilkan iklan.
Kode penjual memulai lelang. Penjual menentukan ruang iklan mana yang dijual dan siapa yang dapat mengajukan bid, serta metode untuk menilai bid tersebut.
Kode pembeli yang diundang akan dijalankan untuk menghasilkan 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 nilai kunci pembeli.
Kode penjual memberi skor pada setiap bid dan memilih pemenang. Logika ini menggunakan nilai bid dan data lainnya untuk menampilkan keinginan 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 akan menemukan iklan kontekstual terbaik untuk slot iklan yang tersedia.
Iklan pemenang ditampilkan sebagai objek konfigurasi bingkai berpagar saat tanda resolveToConfig ditetapkan di konfigurasi lelang. Konfigurasi digunakan untuk menavigasi bingkai berpagar ke materi iklan, dan URL materi iklan disembunyikan dari penjual dan penayang. Jika tanda resolveToConfig ditetapkan ke false atau tidak diteruskan, iklan pemenang akan ditampilkan sebagai URN buram yang dapat digunakan untuk merender iklan dalam iframe. Objek konfigurasi frame berpagar tersedia mulai dari M114.
Lelang dilaporkan kepada penjual dan pembeli yang menang.
Catatan: reportResult() penjual dan reportWin() pembeli dapat menyertakan panggilan ke sendReportTo(). Laporan ini tersedia untuk sementara, hingga pelaporan gabungan tersedia dengan Agregasi Pribadi.

Mekanisme pelaporan untuk pembeli yang kalah sedang dibahas.

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 dibuat oleh pembeli, dan memungkinkan penjual memberi skor 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 sendiri, dan layanan tersebut berjalan di trusted execution environment. 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 kustom mereka sendiri dalam layanan Kunci/Nilai.

Pembeli atau penjual memberikan daftar 'kunci' untuk menentukan data yang mereka perlukan 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 lebih lanjut layanan Kunci/Nilai Protected Audience API 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 data real-time. Misalnya, pembeli mungkin ingin menghitung anggaran yang tersisa 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 Nilai Kunci. 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 akan memberikan URL untuk layanan Kunci/Nilainya. Layanan Kunci/Nilai penjual akan dikueri dengan URL render materi iklan.

Untuk pengujian awal, model "Bawa Server Anda Sendiri" digunakan. Dalam jangka panjang, teknologi iklan harus menggunakan layanan Kunci/Nilai Protected Audience API open source yang berjalan di trusted execution environment untuk mengambil data real-time.

Untuk memastikan ekosistem memiliki waktu yang cukup untuk pengujian, kami tidak akan mewajibkan penggunaan layanan Key/Value open source atau trusted execution environment hingga beberapa waktu setelah penghentian penggunaan cookie pihak ketiga. Kami akan memberikan pemberitahuan yang cukup kepada developer untuk memulai pengujian dan penerapan 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 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, nilainya dapat ditetapkan di 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 dengan menetapkan sinyal di konfigurasi lelang saat memulai lelang, dan dapat mengontrol siapa yang menerima data pihak pertama. Jika penayang meneruskan data pihak pertama sebagai auctionSignals, data tersebut akan tersedia bagi pembeli dan penjual. Jika diteruskan sebagai sellerSignals, data hanya tersedia untuk penjual, dan jika diteruskan sebagai perBuyerSignals, data hanya tersedia untuk pembeli yang ditentukan. Penayang juga dapat meneruskan data pihak pertama ke lelang komponen. Penayang dan peserta lelang harus menyetujui data pihak pertama yang perlu dibagikan, dan cara data tersebut harus 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