Protected Audience API

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.

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

Apa itu Protected Audience API?

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

Protected Audience API adalah eksperimen pertama yang akan diterapkan di Chromium dalam kelompok proposal TURTLEDOVE. Perbedaan antara Protected Audience dan TURTLEDOVE terutama berkaitan dengan pemisahan peran pembeli dan penjual iklan di perangkat. Bagian di bawah ini menjelaskan 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 menampilkan iklan yang relevan bagi pengguna mereka.

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. Jika permintaan berhasil, browser akan mencatat:

  • Nama grup minat: misalnya, 'sepeda kustom'.
  • 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 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 melakukan bidding.

Bid hanya dapat disediakan oleh grup minat tempat browser menjadi anggotanya, 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 akan menghasilkan bid dengan bantuan data real-time yang disediakan oleh layanan Kunci/Nilai Protected Audience mereka. Kemudian, penjual menerima bid ini serta data real-time yang dimiliki penjual dan memberi skor untuk setiap bid. Bid dengan skor tertinggi akan memenangkan lelang.

Iklan pemenang akan ditampilkan dalam frame dengan fence. URL materi iklan ditentukan dalam bid, dan originnya harus cocok dengan URL dalam daftar yang diberikan oleh konfigurasi grup minat.

Penjual dapat melaporkan hasil lelang (reportResult()), dan pembeli dapat melaporkan kemenangannya (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).

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

Protected Audience API bertujuan untuk memindahkan platform web lebih dekat ke kondisi saat browser pengguna di perangkat, bukan pengiklan atau platform teknologi iklan, menyimpan informasi tentang hal yang diminati orang tersebut.

Bagaimana cara mencoba Protected Audience API?

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

  • Protect-audience-demo.web.app menyediakan panduan deployment Protected Audience dasar di seluruh situs pengiklan dan penayang. Video demo Protected Audience menjelaskan cara kerja kode ini dan melihat pratinjau cara menggunakan Chrome DevTools untuk proses debug.

Apa konfigurasi browser 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 ikut menggunakan Protected Audience API menggunakan setelan Privacy Sandbox.

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

Kami akan memperbarui setelan yang tersedia di Chrome seiring progres Protected Audience API, berdasarkan pengujian dan masukan. Ke depannya, 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 akan dihapus saat 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 maupun 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. Jenis pemilik yang berbeda akan membuat jenis grup minat yang berbeda 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.

Tabel di bawah 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-orang yang sebelumnya pernah berinteraksi dengan merek.
Penayang Situs berita Konten Orang yang membaca tentang bersepeda. Penerbit 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 bahkan saat orang-orang tersebut menjelajahi situs lain. Penerbit mungkin dapat mengenakan biaya atas kemampuan menampilkan iklan ke 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-orang yang mereka yakini berminat membeli suatu kategori item. Grup minat ini selanjutnya dapat digunakan untuk mengiklankan produk di situs yang menjual berbagai hal 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. Batasan ini dimaksudkan sebagai pengaman, yang tidak akan tercapai dalam operasi biasa.

Apa yang dimaksud dengan pembeli?

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

Contoh:

Pembeli memiliki tiga pekerjaan:

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

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

Saat pembeli meminta browser pengguna untuk menambahkan grup minat ke grup tempat pembeli tersebut menjadi anggota (dengan memanggil fungsi JavaScript navigator.joinAdInterestGroup()), pembeli akan memberikan:

  • URL untuk kode bidding yang akan digunakan saat penjual menjalankan lelang iklan.
  • Kemungkinan, URL untuk materi iklan bagi grup minat. (URL iklan dapat ditambahkan nanti melalui 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 atas dirinya sendiri untuk menghosting konten iklan di situsnya.
  • Platform sisi suplai (SSP): bekerja sama dengan penayang dan menyediakan layanan lainnya.
  • Skrip pihak ketiga: bertindak untuk penayang, guna memungkinkan partisipasi dalam lelang iklan.

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

  • Terapkan aturan penayang: yang menyatakan pembeli dan bid mana yang memenuhi syarat.
  • 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 diberikan oleh penjual saat memulai lelang iklan dengan memanggil fungsi JavaScript navigator.runAdAuction().

Bagaimana cara kerja lelang iklan Protected Audience API?

Diagram di bawah menguraikan setiap tahap lelang iklan Protected Audience API:

Enam tahap dalam lelang iklan Protected Audience API

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 kepada browser untuk menilai bid, yang menyertakan setiap nilai bid, URL materi iklan, dan data lain yang ditampilkan dari setiap pembeli. Selama lelang, kode bidding dari pembeli dan kode skor bid dari penjual dapat menerima data dari layanan Kunci/Nilai mereka. Setelah iklan dipilih dan ditampilkan (dalam frame dengan fence untuk menjaga privasi), penjual dan pembeli yang menang dapat melaporkan hasil lelang.

  1. Pengguna mengunjungi situs yang menampilkan iklan.
  2. Kode penjual memulai lelang. Penjual menentukan ruang iklan mana yang dijual dan siapa yang dapat mengajukan bid, serta metode untuk menilai bid tersebut.
  3. Kode pembeli yang diundang dijalankan untuk membuat bid, URL untuk materi iklan yang relevan, dan data lainnya. Skrip bidding dapat mengkueri data real-time, seperti anggaran kampanye iklan yang tersisa, dari layanan Kunci/Nilai pembeli.
  4. Kode penjual memberi skor untuk 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 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 dengan fence saat tanda resolveToConfig disetel dalam konfigurasi lelang. Konfigurasi digunakan untuk membuka frame dengan fence ke materi iklan, dan URL materi iklan disembunyikan dari penjual dan penayang. Jika flag 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 dengan fence tersedia mulai M114.
  6. Lelang dilaporkan kepada penjual dan pembeli yang menang.

Mekanisme pelaporan untuk kehilangan pembeli sedang dibahas.

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

Layanan Kunci/Nilai Protected Audience API memungkinkan teknologi iklan membuat kueri untuk 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 milik teknologi iklan, dan layanan berjalan di lingkungan eksekusi tepercaya. Permintaan ke layanan Kunci/Nilai tidak boleh 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 menyediakan 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 lebih lanjut layanan Kunci/Nilai 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 realtime. 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 akan menentukan URL layanan Kunci/Nilai dan menentukan kunci untuk 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.

Guna memastikan bahwa ekosistem memiliki waktu yang cukup untuk melakukan pengujian, kami tidak mengharuskan penggunaan layanan Kunci/Nilai open source atau lingkungan eksekusi tepercaya hingga beberapa saat setelah penghentian cookie pihak ketiga. Kami akan memberikan pemberitahuan penting bagi developer untuk memulai pengujian dan adopsi sebelum transisi ini berlangsung.

Bagaimana data pihak pertama digunakan dalam lelang Protected Audience?

Data pihak pertama adalah data yang dimiliki situs tentang penggunanya. Misalnya, jika pengguna telah menentukan warna favorit mereka 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, 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 menerima data pihak pertama. Jika penayang meneruskan data pihak pertama sebagai auctionSignals, data tersebut akan tersedia untuk pembeli dan penjual. Jika diteruskan sebagai sellerSignals, data hanya akan tersedia untuk penjual, dan saat diteruskan sebagai perBuyerSignals, data tersebut hanya akan tersedia untuk pembeli tertentu. Penayang juga dapat meneruskan data pihak pertama ke lelang komponen. Penayang dan peserta lelang harus menyetujui sebelumnya tentang data pihak pertama apa yang perlu dibagikan dan bagaimana data 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 dasar Protected Audience API. 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