Protected Audience API (sebelumnya FLEDGE)

Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Protected Audience API—API dalam browser yang memungkinkan pengiklan dan perusahaan teknologi iklan menampilkan iklan bertarget grup minat tanpa mengandalkan cookie pihak ketiga, sekaligus melindungi pengguna dari pelacakan lintas situs.

Chrome menjalankan origin uji coba untuk Protected Audience API. Authorized Buyers memenuhi syarat untuk berpartisipasi dalam pengujian Protected Audience API di inventaris penayang Ad Manager. Bidder dapat mencapai hal berikut dengan menguji Protected Audience API:

  • Lakukan iterasi dan pelajari efektivitas alur Protected Audience API.
  • Hasilkan masukan tentang potensi peningkatan API di forum publik—untuk misalnya, GitHub.
  • Bersiaplah untuk mendukung iklan yang dipersonalisasi melalui API tanpa mengandalkan cookie pihak ketiga.

Authorized Buyers yang berminat untuk melakukan pengujian harus melihat Orientasi untuk detailnya.

Ringkasan alur penayangan

Berikut adalah ringkasan alur penayangan iklan Protected Audience untuk Authorized Buyers partner:

Diagram alir

  1. Bidder bekerja sama dengan pengiklannya untuk mempertahankan grup minat untuk setiap pengiklan. Sering kali, pengiklan akan menambahkan tag bidder ke halaman pengiklan untuk menambahkan browser ke grup minat.
  2. Pengguna akhir mengunjungi halaman pengiklan. Halaman mungkin berisi tag pembeli.
  3. Tag bidder memanggil Protected Audience API joinAdInterestGroup(). Panggilan ini meminta browser untuk menambahkan pengguna ke grup minat.
  4. Pengguna akhir mengunjungi halaman web penayang. Permintaan browser pengguna Tag iklan penayang Google.
  5. Tag iklan penayang Google membuat permintaan iklan kontekstual ke server Google.
  6. Google mengirimkan permintaan bid kontekstual kepada bidder yang berpartisipasi. Lihat Bagian perubahan permintaan bid untuk mengetahui informasi selengkapnya.
  7. Bidder menampilkan respons bid yang menyertakan pesan InterestGroupBidding, yang diperlukan untuk berpartisipasi dalam lelang grup minat. Di beberapa OpenRTB ditetapkan dengan kolom BidResponse.ext.igbid, dan di protokol Google RTB yang tidak digunakan lagi. Kolom BidResponse.interest_group_bidding. Jika bidder tidak menentukan informasi ini, Google tidak akan menyertakan asal bidder di interestGroupBuyers dalam konfigurasi lelang. InterestGroupBidding juga dapat berisi sinyal khusus pembeli opsional yang akan diteruskan ke fungsi bidding bidder selama lelang dalam browser. Di OpenRTB, hal ini ditetapkan dengan Kolom BidResponse.ext.igbid.igbuyer.buyerdata, dan tidak digunakan lagi Protokol Google RTB, yang ditetapkan dengan BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals kolom tersebut. Lihat Bagian perubahan respons bid untuk mengetahui informasi selengkapnya.
  8. Google menjalankan lelang sisi server dan menampilkan respons bid ke browser. Lelang sisi server mempertimbangkan bid sisi server tradisional. Respons bid dapat berisi informasi tentang bid pemenang kontekstual (jika tertentu).
  9. Respons bid berisi konfigurasi lelang untuk browser lelang. Hal ini dapat mencakup sinyal kontekstual dari setiap pembeli yang berpartisipasi (yang dikirim melalui buyerdata OpenRTB atau per_buyer_signals protokol Google RTB yang tidak digunakan lagi sebelumnya), informasi pemenang kontekstual, dan setelan untuk kelayakan bid.
  10. Tag penayang Google memanggil Protected Audience API runAdAuction() untuk memulai lelang grup minat di perangkat. Google hanya menyertakan pembeli yang disertakan sebagai InterestGroupBuyer di InterestGroupBidding selama konfigurasi lelang.
  11. Google meneruskan sinyal khusus pembeli opsional dari setiap bidder yang memenuhi syarat ke konfigurasi lelang Protected Audience.
  12. Jika grup minat bidder tertentu menentukan trustedBiddingSignalsUrl, browser membuat permintaan ke setiap grup trustedBiddingSignalsUrl untuk mengambil sinyal real-time untuk setiap grup. Lihat detailnya di spesifikasi Protected Audience API.
  13. Browser memanggil generateBid() bidder untuk setiap grup minat yang ikut serta dan memenuhi syarat untuk berpartisipasi dalam lelang dalam browser. Ini ini akan menghitung bid dan memilih materi iklan. generateBid() memiliki akses ke sinyal pembeli opsional yang diberikan oleh bidder dan sinyal bidding tepercaya untuk grup minat tertentu.
  14. Browser memanggil scoreAd() penjual (dalam hal ini, Google) untuk menetapkan peringkat ke setiap bid dalam lelang iklan grup minat. Bid diberi peringkat dan difilter berdasarkan perlindungan penayang, kebijakan iklan, dan batasan lainnya.
  15. Browser menjalankan lelang dengan bid grup minat yang memenuhi syarat. Tujuan berpartisipasi dalam lelang dalam browser.
  16. Setelah lelang, jika ada pemenang grup minat, browser akan memanggil reportResult() penjual dan reportWin() bidder untuk memberi tahu setiap pihak tentang pemenang lelang dalam browser.
  17. Jika iklan grup minat menang, tag penayang Google merender iklan dalam iframe.

Detail alur penayangan

Sebelum penayangan iklan

Peninjauan materi iklan

Materi iklan harus ditinjau dan disetujui oleh Google sebelum dapat ditayangkan dari Lelang dalam browser Protected Audience. Anda dapat mengirimkan materi iklan untuk ditinjau melalui Real-time Bidding API atau melalui pemindaian materi iklan otomatis. Materi iklan untuk lelang iklan grup minat dalam browser Protected Audience harus menyertakan renderUrls untuk ditinjau.

Persyaratan untuk renderUrls:

  • renderUrl yang dikirimkan melalui API harus cocok dengan renderUrl yang digunakan dalam lelang iklan grup minat.
  • Setiap renderUrl hanya dapat mewakili satu pengiklan atau iklan kampanye. renderUrl tertentu tidak dapat digunakan untuk merender iklan atas nama beberapa pengiklan. Setiap renderUrl harus dipetakan ke satu materi iklan.
  • renderUrl harus dapat diakses dan diambil oleh offline Google sistem peninjauan materi iklan hingga 7 hari setelah iklan menjadi bid terakhir.
Real-time Bidding API

Bidder dapat menggunakan Bidding Real-time API untuk mengupload materi iklan bidding grup minat.

Pemindaian materi iklan otomatis

Bidder dapat menyiapkan pemindaian materi iklan otomatis untuk materi iklan yang tidak diupload melalui Real-time Bidding API.

Jika Anda menyiapkan pemindaian materi iklan otomatis, Google akan menemukan materi iklan di lelang dalam browser dan memindainya secara otomatis, sehingga materi iklan tersebut memenuhi syarat untuk lelang mendatang.

Berikut cara mengaktifkan pemindaian materi iklan otomatis:

  • Tambahkan semua asal renderUrl materi iklan grup minat ke akun Authorized Buyer.

  • Tambahkan header HTTP kustom berikut ke respons HTTP materi iklan:

    Authorized-Buyers-Creative-ID

    string

    ID materi iklan khusus pembeli. Panjang maksimum ID materi iklan adalah 128 byte.
    Authorized-Buyers-Click-Through-URLs

    string

    Kumpulan URL tujuan yang dideklarasikan untuk materi iklan yang dienkode sesuai dengan RFC2396.

Contoh:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
Akhir masa berlaku materi iklan

Materi iklan disetujui selama 15 hari. Jika Anda mengirim materi iklan menggunakan Bidding API, Anda harus mengirim ulang materi iklan setelah 15 hari. Jika Anda mengandalkan pemindaian materi iklan otomatis, proses pemindaian akan otomatis memindainya kembali.

ID Pelaporan Pembeli

Anda dapat mengelompokkan metrik pelaporan (seperti tayangan iklan) menggunakan dimensi yang disediakan oleh pembeli (misalnya, ID kampanye atau ID pengiklan). Untuk menambahkan dimensi untuk pembelanjaan grup minat, tentukan buyerAndSellerReportingId untuk iklan Anda ketika Anda menambahkan perangkat pengguna ke grup minat. Lihat detail tambahan dalam dokumentasi Protected Audience.

Berikut adalah contoh cara menambahkan buyerAndSellerReportingId ke dalam konfigurasi grup minat:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

buyer_reporting_id akan muncul sebagai dimensi baru di Alat Pelaporan Pembeli Resmi, sebagai dimensi ID Pelaporan Pembeli.

Lelang sisi server

Perubahan permintaan bid

Berikut ini adalah versi awal protokol yang didukung untuk digunakan dalam eksperimen:

Menunjukkan dukungan lelang grup minat

Permintaan bid memiliki kolom baru untuk menunjukkan dukungan bagi lelang grup minat:

  • OpenRTB:
    • BidRequest.imp.ext.ae
    • BidRequest.imp.ext.igbid
  • Protokol Google RTB (tidak digunakan lagi):
    • BidRequest.adslot.supported_auction_environment
    • BidRequest.adslot.interest_group_bidding_allowed

Anda dapat menggunakan kolom ini untuk membedakan berbagai peluang tayangan iklan yang mendukung lelang grup minat dalam browser Protected Audience dan yang hanya mendukung lelang pertukaran sisi server tradisional. Tujuan Enum AuctionEnvironment dapat memiliki nilai berikut:

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0): Lelang yang menentukan iklan yang menang berjalan di server bursa.
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Permintaan dengan Dukungan Protected Audience, yang lelang kontekstualnya berjalan di server bursa dan bidding grup minat, serta lelang akhir berjalan di browser.
  • SERVER_SIDE_INTEREST_GROUP_AUCTION (JSON OpenRTB: 3): Versi kontekstual lelang berjalan di server bursa, dan logika bidding untuk kepentingan bid grup dan logika penskoran untuk menentukan iklan pemenang akhir berjalan di server Bidding dan Lelang.
Menunjukkan ukuran slot iklan Protected Audience

Permintaan bid menyertakan kolom berikut untuk memberi Anda ukuran slot iklan Protected Audience:

  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height
  • Protokol Google RTB (tidak digunakan lagi):
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height

Kolom ini menunjukkan ukuran slot iklan untuk lelang Protected Audience dalam piksel.

Ukuran ini mungkin berbeda dari ukuran dalam permintaan kontekstual, seperti yang terlihat dalam BidRequest.imp.banner.format.w dan OpenRTB BidRequest.imp.banner.format.h kolom atau protokol Google RTB yang tidak digunakan lagi Kolom BidRequest.adslot.width dan BidRequest.adslot.height.

Permintaan kontekstual mungkin memiliki beberapa ukuran. Pemenang lelang di perangkat iklan diharapkan hanya mengisi ukuran slot tetap tunggal.

Menunjukkan kemampuan render iklan Protected Audience

Iklan Protected Audience mungkin dirender atau tidak, bergantung pada tahap integrasi saat ini (lihat eksperimen non-rendering). Kolom render_interest_group_ads pada permintaan bid menunjukkan apakah iklan Protected Audience yang menang akan dirender.

  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
  • Protokol Google RTB (tidak digunakan lagi): BidRequest.adslot.interest_group_auction.render_interest_group_ads
Meminimalkan penggunaan ID pengguna

Permintaan bid kontekstual dalam cakupan untuk pengujian Protected Audience API dapat terus membawa ID berbasis cookie tradisional jika tersedia dari browser, seperti kolom BidRequest.user.id dan BidRequest.user.buyerid, atau BidRequest.google_user_id dan BidRequest.hosted_match_data dalam protokol Google RTB yang tidak digunakan lagi. Kehadiran ID tersebut dalam permintaan bid tunduk pada kebijakan privasi yang ada. Sebaiknya Anda tidak mengandalkan ID berbasis cookie untuk tujuan penargetan dan bidding selama pengujian untuk lebih mempersiapkan pembelian yang efisien saat cookie pihak ketiga tidak lagi tersedia.

Google juga dapat menjalankan eksperimen skala kecil dengan identitas berbasis cookie yang disamarkan dari permintaan bid dalam cakupan untuk pengujian Protected Audience API. Laporan ini untuk menilai potensi dampak penghentian penggunaan cookie pihak ketiga.

Untuk mempersiapkan penghentian penggunaan cookie pihak ketiga (3PCD) pada tahun 2024, Chrome kini menawarkan pengujian yang difasilitasi Chrome.

Situs dan vendor dapat menggunakan pengujian yang difasilitasi Chrome untuk menguji sistem mereka berdasarkan 3PCD. Dalam pengujian itu, {i>browser<i} Chrome dimasukkan ke dalam grup eksperimen 3PCD, Mode A atau Mode B. Setiap browser diberi label konsisten yang sesuai dengan grup eksperimen 3PCD tertentu yang dapat Anda akses melalui Chrome API dalam browser.

Google meneruskan label yang tidak diubah dari Chrome API pada bid RTB permintaan. Karena potongan traffic yang kecil dari setiap label, Google tidak selalu menyertakan label dalam konteks yang dibatasi privasi.

Berikut adalah kolom tempat Anda dapat melihat label:

  • OpenRTB: BidRequest.device.ext.cdep
  • Protokol Google RTB (tidak digunakan lagi): BidRequest.device.cookie_deprecation_label

Perubahan respons bid

Menunjukkan partisipasi lelang grup minat

Anda bertanggung jawab untuk secara eksplisit menunjukkan niat Anda untuk berpartisipasi dalam lelang dalam browser dengan menampilkan objek InterestGroupBidding dalam respons bid kontekstual:

  • OpenRTB: BidResponse.ext.igbid
  • Protokol Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding

Anda harus memberikan respons bid kontekstual. Responsnya tidak diperlukan untuk menyertakan bid kontekstual. Objek InterestGroupBidding harus berisi origin untuk setiap InterestGroupBuyer, yang harus cocok dengan salah satu origin yang dikonfigurasi oleh bidder untuk akunnya. origin ditambahkan ke lelang interestGroupBuyers konfigurasi Anda saat Tag Google Publisher memanggil runAdAuction().

Menerapkan sinyal kontekstual pembeli

Anda dapat menyertakan sinyal pembeli dalam respons bid kontekstual, yang didistribusikan Google sebagai objek JSON ke fungsi bidding di perangkat melalui argumen perBuyerSignals. Hal ini dapat disertakan dalam respons bid dengan kolom berikut, bergantung pada protokol:

  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
  • Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding.per_buyer_signals
Menerapkan sinyal rendering kontekstual pembeli

Materi iklan grup minat dapat menggunakan sinyal kontekstual terbatas selama rendering dengan mengirim sinyal tersebut melalui respons bid kontekstual dan menerimanya pada permintaan URL render menggunakan perluasan makro. Misalnya, sinyal rendering dapat digunakan untuk menyesuaikan tampilan dan nuansa materi iklan guna meningkatkan performa dalam konteks slot iklan atau halaman penayang tertentu.

Anda dapat menyertakan sinyal rendering pembeli yang diserialisasi sebagai string aman URL dalam respons bid kontekstual, yang akan diganti oleh Google di URL render grup minat pemenang dengan membuat makro ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}.

Sinyal rendering dapat ditentukan dalam respons bid dengan kolom berikut, bergantung pada protokol:

  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
  • Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

Maksimal 3 set sinyal rendering dengan akhiran makro yang berbeda dapat disertakan dalam respons bid untuk membedakan sinyal yang berbeda. Misalnya, akhiran dapat digunakan untuk mencocokkan kumpulan sinyal tertentu yang hanya berlaku untuk materi iklan dengan makro yang sesuai di URL rendernya, sehingga mengurangi ukuran transfer data.

Pembeli grup minat akan ditolak untuk berpartisipasi dalam lelang Audiens Terlindungi jika sinyal tidak aman untuk URL, akhiran makro tidak unik, atau lebih dari 3 kumpulan sinyal diberikan.

Menentukan harga bid maksimum dalam browser

Di halaman Protected Audience proposal, komputasi bid dan lelang akhir diharapkan berjalan secara lokal di perangkat. Hal ini dapat menciptakan vektor penyalahgunaan yang dapat memengaruhi integritas lelang akhir hasil yang optimal, seperti harga bid pemenang.

Sebagai mitigasi yang didukung selama pengujian Protected Audience API oleh Google untuk partner RTB, Anda dapat menentukan nilai bid maksimum yang diharapkan dalam respons bid kontekstual. Bid maksimum yang diharapkan adalah harga bid maksimum yang fungsi bidding Anda diharapkan akan ditampilkan. Jika bid pemenang yang dilaporkan dari lelang dalam browser melebihi jumlah ini, bid pemenang tidak akan dihitung sebagai peristiwa yang dapat ditagih. Pendekatan ini dapat berubah sewaktu-waktu.

Dalam respons bid, Anda dapat menentukan nilai bid maksimum yang diharapkan di kolom berikut:

  • OpenRTB: BidResponse.igbid.igbuyer.maxbid(dinyatakan dalam unit mata uang CPM)
  • Protokol Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (dinyatakan dalam microCPM)
Mengatribusikan tayangan ke beberapa akun

Bidder harus memilih ID penagihan untuk mengatribusikan tayangan bid grup minat mereka menggunakan kolom berikut:

  • OpenRTB: BidResponse.igbid.igbuyer.billing_id
  • Protokol Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding.interest_group_buyers.billing_id

ID penagihan yang dipilih harus merupakan ID penagihan yang memenuhi syarat dari permintaan bid:

  • OpenRTB: BidRequest.imp.ext.billing_id
  • Protokol Google RTB (tidak digunakan lagi): BidRequest.adslot.matching_ad_data.billing_id

Jika ID penagihan untuk mengatribusikan tayangan bidding grup minat tidak disediakan, bidder tidak akan berpartisipasi dalam lelang Protected Audience.

Akun turunan dapat memiliki maksimal dua ID penagihan. Pembeli dapat menggunakan satu ID penagihan untuk pembelanjaan kontekstual dan satu lagi untuk pembelanjaan grup minat. Hubungi Account Manager Anda jika ingin mengonfigurasi dua ID penagihan untuk akun anak.

Anda dapat menetapkan anggaran harian untuk setiap ID penagihan. Hubungi pengelola akun Anda untuk menetapkan anggaran harian untuk ID penagihan akun turunan.

ID penagihan untuk semua akun turunan dengan anggaran yang tersedia dan memenuhi syarat untuk mengajukan bid pada tayangan akan muncul di permintaan bid untuk pemilihan atribusi pembelanjaan. Hubungi pengelola akun Anda untuk mengubah anggaran ID penagihan grup minat.

Selama lelang dalam browser

Membuat bid dalam browser

Gunakan generateBid() untuk membuat bid dalam browser.

Google menyediakan parameter berikut:

  • auctionSignals: Kosong
  • perBuyerSignals: Objek JavaScript dari sinyal yang sama yang diberikan oleh bidder dalam respons kontekstual

Parameter berikut ditampilkan:

  • ad: Google mengabaikan kolom ini.
  • bid: Bid numerik yang memasuki lelang. Harus dalam satuan CPM (bukan mikro).
  • render: URL yang dirender untuk menampilkan materi iklan jika bid memenangkan lelang. Google harus meninjau dan menyetujui URL ini, atau URL tersebut akan difilter dari lelang.
  • allowComponentAuction: Harus true. Google saat ini mendukung pengujian lelang multi-penjual.

Berikut contohnya:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

Lihat bagian Pembidaan di Perangkat spesifikasi Protected Audience untuk mengetahui penjelasan fungsi generateBid().

Mata uang bid

Bid lelang dalam browser ditempatkan dalam unit CPM dari mata uang bid yang dipilih.

Mata uang bid harus ditunjukkan dalam respons bid kontekstual dan dalam nilai hasil generateBid dan harus berupa kode alfa ISO 4217 yang valid, seperti sebagai "USD", "EUR", atau "JPY".

Di OpenRTB, gunakan kolom cur baru di objek InterestGroupBuyer dalam ekstensi respons bid Google.

Berikut contohnya:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

Dalam protokol Google RTB, gunakan kolom currency baru dalam pesan InterestGroupBuyer dalam respons bid.

Berikut contohnya:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

Fungsi generateBid bidder harus menampilkan bid dalam mata uang yang sama seperti yang ditunjukkan dalam respons bid kontekstual. Isi properti bidCurrency baru di nilai yang ditampilkan generateBid:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

Jika mata uang dari respons bid kontekstual berbeda dengan mata uang yang ditampilkan oleh generateBid, atau jika salah satunya menampilkan mata uang yang tidak valid, bid akan difilter sebelum lelang.

Pemeriksaan kualitas iklan

Kebijakan materi iklan dan penerapan kontrol penayang mungkin lebih ketat untuk Bid grup minat dalam browser selama pengujian Protected Audience API untuk RTB partner.

Dukungan Digital Services Act

Berdasarkan Digital Services Act Pasal 26, penayang dapat mewajibkan pembeli untuk melakukan pengungkapan transparansi dalam iklan. Jika kontrol "Minta pembeli untuk hanya menampilkan iklan dengan informasi transparansi DSA di situs atau aplikasi saya di EEA" diaktifkan oleh penayang, pembeli grup minat dapat menentukan peluang mana yang akan diperlukan untuk merender transparansi pembeli dengan mencatat nilai BidRequest.regs.dsa.required dan BidRequest.dsa.pubrender dalam permintaan bid (masing-masing BidRequest.dsa.dsa_support dan BidRequest.dsa.publisher_rendering_support dalam protokol RTB Google yang tidak digunakan lagi).

Saat bidder yang ingin berpartisipasi dalam lelang Protected Audience API menerima sinyal dalam permintaan bid bahwa transparansi DSA harus ditampilkan untuk iklan yang ditayangkan melalui Protected Audience API, mereka harus menilai apakah mereka dapat menampilkan informasi yang diperlukan dengan semestinya dan menentukan dengan menetapkan BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render dalam protokol Google RTB yang tidak digunakan lagi). Jika tidak, pembeli tidak akan disertakan dalam lelang Protected Audience API.

Untuk informasi selengkapnya tentang Transparansi Iklan Digital Services Act, lihat Artikel Pusat Bantuan: Mendukung Digital Services Act.

Pemfilteran bid

Google memberlakukan penayang kontrol dan iklan kebijakan selama lelang di perangkat.

Setelah lelang dalam browser

Laporkan hasil lelang kepada pembeli: reportWin()

Google tidak mengisi argumen berikut:

  • auctionSignals
  • sellerSignals

Gunakan reportWin() untuk melaporkan hasil lelang kepada pembeli.

Lihat bagian Pelaporan Pembeli tentang Peristiwa Render dan Iklan dalam penjelasan Protected Audience API untuk mengetahui informasi selengkapnya.

Makro

renderUrl yang mereferensikan materi iklan Protected Audience API dapat menyertakan satu atau beberapa placeholder, yang disebut makro. Setelah lelang grup minat selesai, tetapi sebelum rendering, makro akan diganti dengan nilai yang sesuai. renderUrl yang digunakan dalam lelang di perangkat dapat mencakup hal berikut makro:

${GDPR} Diluaskan ke 0 jika GDPR tidak berlaku atau 1 jika GDPR berlaku. Lihat dokumentasi.
${GDPR_CONSENT_XXXX} Diperluas ke string Transparansi & Izin (TC) yang terkait dengan permintaan. Jika string Transparansi & Izin (TC) kosong atau tidak valid, makro ini tidak akan diperluas.

Gunakan makro ini untuk meneruskan string TC ke vendor yang terdaftar di GVL IAB dalam URL. Ganti XXXX dengan ID GVL IAB dari vendor yang terdaftar di GVL IAB. Jika string TC kosong atau tidak valid, makro ini tidak akan diperluas.

Materi iklan dengan makro ${GDPR_CONSENT_XXXX} dapat diblokir jika vendor terdaftar GVL IAB yang terkait dengan ID GVL IAB yang Anda sisipkan tidak memiliki izin pengguna.

Makro ${GDPR_CONSENT_XXXX} hanya boleh muncul satu kali dalam renderUrl.
${ADDL_CONSENT} Diluaskan ke halaman Tambahan String izin (AC) yang terkait dengan permintaan.
${AD_WIDTH}, ${AD_HEIGHT) Makro ini menyisipkan lebar dan tinggi slot iklan.
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

Makro yang berisi sinyal pembeli waktu render yang ditentukan pada respons bid.

Ganti placeholder buyer.origin.example dengan asal pembeli grup minat, yang harus sesuai dengan interest_group_buyers.origin dalam respons bid. Anda mungkin menyertakan _OPTIONAL_SUFFIX untuk menyediakan hingga tiga merender nilai sinyal.

Penghitungan tayangan

Selama pengujian Protected Audience API dengan partner RTB, Google akan menghitung tayangan saat browser memanggil fungsi reportResult()-nya dan selanjutnya mengambil URL pelaporan Google dalam panggilan ke sendReportTo().

Karena peristiwa yang digunakan oleh Google untuk menghitung tayangan iklan di Protected Audience lelang dalam browser mungkin berbeda dengan peristiwa yang digunakan untuk penghitungan tayangan oleh partner pembeli RTB, jumlah tayangan iklan mungkin berbeda.

Salah satu sasaran Google untuk menguji Protected Audience API adalah mengidentifikasi dan mengurangi perbedaan ini.

Atribusi tayangan yang dapat ditagih

Semua pembelanjaan bidder dari lelang dalam browser Protected Audience diatribusikan ke satu akun bidder berdasarkan pemetaan dari origin pemilik grup yang dikonfigurasi untuk bidder. Mengatribusikan pembelanjaan ke berbagai akun slot turunan dari bidder tidak didukung.

Batas anggaran harian

Selama pengujian Protected Audience API, setiap akun memiliki batas anggaran harian belanja Protected Audience level akun. Batas anggaran harian membatasi risiko di lingkungan lelang dalam browser. Setelah batas anggaran harian tercapai, tidak lagi menerima permintaan bid yang memenuhi syarat Protected Audience.

Akun tersebut dapat terus berpartisipasi dalam lelang kontekstual sisi server setelah mencapai batas Protected Audience. Misalnya, akun bidder yang menjangkau batas Protected Audience mungkin menerima permintaan bid dengan auction_environment = SERVER_SIDE_AUCTION (OpenRTB JSON: 0), meskipun permintaan bid tersebut valid untuk lelang Protected Audience.

Masukan real-time dan bid minimum untuk menang

Bidder yang memilih ikut serta untuk menerima masukan real-time akan menerima umpan balik untuk pembeli grup minat yang diminta untuk disertakan dalam lelang Protected Audience di perangkat. Setiap pembeli grup minat yang menjadi bidder menentukan respons bid akan menerima satu objek masukan, terlepas dari caranya banyak bid yang diajukan oleh pembeli grup minat dalam lelang Protected Audience. Tujuan informasi berikut akan tersedia pada masukan pembeli grup minat :

  • Jenis masukan dari objek masukan akan INTEREST_GROUP_BUYER_FEEDBACK.
  • Asal pembeli grup minat.
  • Bid minimum untuk menang bagi pembeli grup minat agar dapat memenangkan lelang secara keseluruhan.
  • Bid minimum untuk menang bagi pembeli grup minat agar dapat mengalahkan bid dengan peringkat tertinggi dari komponen sisi server di keseluruhan lelang.
  • Kode status pembeli grup minat. Kemungkinan kode status didefinisikan dalam interest-group-buyer-status-codes.txt.

Lihat dokumentasi protokol untuk RTB Authorized Buyers dan Ekstensi OpenRTB untuk mengetahui nama kolom tertentu.

Notifikasi masukan bid

Chrome menyediakan proses debug sementara API untuk Protected Audience API yang memungkinkan Ad Manager mengirim data secara real-time notifikasi debug server-ke-server yang berisi masukan pada server Bid audiens. Pemberitahuan ini akan menyertakan alasan bid mungkin ditetapkan difilter di lelang dalam browser Protected Audience di samping informasi tentang bid yang dijelaskan di bawah.

Bidder dapat menghubungi Account Manager mereka untuk mengonfigurasi URL statis yang akan digunakan untuk mengirimkan notifikasi masukan bid proses debug Protected Audience. Ini URL statis akan diambil dari server Google dengan makro yang dipilih diganti setelah lelang Protected Audience selesai. Makro berikut adalah didukung:

  • %%GOOGLE_QUERY_ID%%: Makro ini diganti dengan ID Kueri Google yang dikirim pada permintaan bid kontekstual yang mengaktifkan Protected Audience. Di beberapa dalam protokol OpenRTB, BidRequest.ext.google_query_id, sedangkan Google RTB yang tidak digunakan lagi menggunakan BidRequest.google_query_id.
  • %%INTEREST_GROUP_OWNER%%: Asal pemilik grup minat.
  • %%BID_CPM%%: Harga bid dalam CPM yang ditentukan oleh pembeli dalam fungsi generateBid().
  • %%RENDER_URL%%: URL render materi iklan.
  • %%STATUS%%: Kode status jika bid ditolak dalam waktu scoreAd(). Nilainya adalah kode status materi iklan.

Berikut adalah contoh URL statis yang dapat diberikan bidder kepada pengelola akunnya:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

Notifikasi masukan bid adalah fitur sementara yang bergantung pada ForDebuggingOnly API sementara Chrome.

TURTLEDOVE tingkat produk

Iklan yang Terdiri dari Beberapa Bagian atau TURTLEDOVE tingkat Produk (PLTD) didukung untuk partner Google RTB selama pengujian Protected Audience API. Beri tahu Account Manager Anda selama integrasi jika Anda berencana untuk melakukan pengujian PLTD, karena resource dan konfigurasi tambahan diperlukan.

Orientasi

Berikut cara menguji Protected Audience API:

Langkah

  1. Isi formulir permintaan untuk bergabung dalam eksperimen Protected Audience API.
  2. Setelah Anda mengirimkan formulir permintaan, hubungi pengelola akun Anda atau ajukan tiket menggunakan Pusat Bantuan Pembeli Resmi.
  3. Setelah akun dikonfigurasi, Google dan partner dapat memverifikasi integrasi melalui langkah-langkah di Tahap pengujian.

Peninjauan Materi Iklan

Untuk mengajukan bid dengan iklan tingkat produk (iklan yang terdiri dari beberapa bagian) dalam lelang Protected Audience API, ikuti persyaratan berikut:

  • Sertakan parameter kueri &pltd=True dalam renderUrl untuk penampung iklan komponen (disebut juga renderUrl tingkat teratas) untuk membedakan renderUrls tingkat teratas selama peninjauan materi iklan.
  • Merender materi iklan yang representatif jika penampung iklan komponen diambil untuk peninjauan materi iklan oleh Google. Untuk memahami kapan seorang rendering iklan yang representatif harus dikembalikan, Anda dapat melihat Parameter kueri validation=True ditetapkan oleh sistem peninjauan materi iklan Google.

Checklist integrasi

  • Menyiapkan endpoint permintaan bid yang akan mengisi Protected Audience API pada respons bid kontekstual—misalnya, interest_group_bidding.
  • Terapkan pemberian tag pada halaman pengiklan untuk bergabung dengan browser pengguna untuk grup minat.
  • Terapkan generateBid() dan reportWin().
  • Pilih asal pemilik grup minat dan tambahkan ke akun Authorized Buyer.
    • Asal pemilik grup minat harus cocok dengan asal tempat fungsi generateBid() dihosting.
    • Hubungi Account Manager atau ajukan tiket menggunakan tiket Pusat Bantuan Pembeli untuk menyelesaikan langkah ini.
  • Siapkan Pra-penargetan untuk inventaris yang relevan dengan pengujian Protected Audience API.
  • Kirim materi iklan untuk ditinjau dan disetujui melalui Creatives API.
  • (Opsional) Siapkan endpoint sinyal bidding tepercaya.
  • (Opsional) Siapkan halaman pengiklan pengujian yang memungkinkan engineer Google menambahkan browser mereka ke grup minat yang dimiliki oleh asal pembeli grup minat Anda. Hal ini memungkinkan kami memicu lelang Protected Audience secara manual.
  • (Opsional) Aktifkan masukan real-time di akun Anda untuk menerima masukan terkait pembeli grup minat meminta untuk disertakan dalam Protected Audience lelang.
  • (Opsional) Hubungi Account Manager Anda untuk mengonfigurasi URL statis untuk menerima notifikasi server ke server yang memberikan bid Protected Audience masukan untuk status bid dari Protected Audience di perangkat untuk membantu proses debug masalah tak terduga. Lihat masukan bid notifikasi untuk mengetahui detailnya.

Tahap pengujian

Tahap 1: Pengujian manual

Berikut cara memicu lelang Protected Audience secara manual, memastikan iklan dapat dirender, dan mencatat tayangan:

  1. Gunakan Chrome 101 atau yang lebih baru.
  2. Aktifkan Privacy Sandbox API dan Fenced Frame menggunakan chrome://flags/#privacy-sandbox-ads-apis dan chrome://flags/#enable-fenced-frames. Lihat selengkapnya di Menguji privasi ini.
  3. Mengirim materi iklan untuk mendapatkan persetujuan menggunakan Bidding Real-time Google Cloud API.
  4. Gunakan halaman pengiklan yang disediakan bidder untuk menambahkan browser ke grup minat milik bidder.

  5. Gunakan halaman penayang pengujian yang disediakan Google berikut untuk memicu Lelang audiens:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    Grup minat dalam browser harus mengajukan bid yang cukup tinggi untuk memenangkan lelang, karena mungkin bersaing dengan bid sisi server konvensional. Google juga menyediakan halaman penayang pengujian khusus untuk setiap partner, yang hanya akan menampilkan dapat berpartisipasi dalam lelang. Mungkin akan lebih mudah untuk menang lelang dalam browser di halaman khusus partner.

  6. Pastikan hal berikut:

    1. Iklan pemenang yang diharapkan akan dirender.
    2. Hasil lelang dikirim di sisi server—artinya bidder yang menang menerima ping balik dari reportWin().
    3. Konsol halaman penayang pengujian mencatat pesan debug untuk setiap bid dengan informasi berikut:
      • renderUrl: URL render bid.
      • interestGroupOwner: Pemilik grup minat bid.
      • accepted: Kolom ini adalah true jika bid diterima dan false jika bid ditolak oleh scoreAd().
      • externalBidStatus: Kode status jika bid ditolak dalam waktu scoreAd(). Nilai adalah status materi iklan kode tersebut.

Tahap 2: (Opsional) Eksperimen non-rendering

Setelah Google dan partner memverifikasi secara manual bahwa partner dapat berpartisipasi dalam lelang Protected Audience, Google akan mengaktifkan partner untuk tahap pengujian berikutnya.

Google mengalokasikan sejumlah kecil traffic live untuk menjalankan Protected Audience dalam lelang. Kemudian, Google dan partner tidak perlu lagi memicu lelang Protected Audience. Hasil lelang Protected Audience tidak dirender. Hal ini memungkinkan kita menguji integrasi dalam skala besar.

Hubungi Account Manager Anda atau ajukan tiket melalui Authorized Buyers Pusat Bantuan jika Anda sudah siap. Google akan mengaktifkan akun untuk tahap ini.

Tahap 3: Eksperimen Rendering

Setelah Google dan partner memverifikasi lelang Protected Audience dalam skala besar tanpa rendering, Google dapat mengaktifkan partner untuk merender iklan pemenang Protected Audience. Google memiliki sedikit traffic tempat lelang Protected Audience memenuhi syarat untuk dijalankan, dan iklan grup minat pemenang dirender. Bidder yang berpartisipasi bid dalam browser bersaing dengan maksimum.

Hubungi Account Manager Anda atau ajukan tiket melalui Pusat Bantuan Pembeli Resmi jika Anda sudah siap. Google akan mengaktifkan akun untuk tahap ini.

Fitur Tambahan

Fitur berikut adalah ekstensi dari protokol inti.

Paralelisasi

Paralelisasi adalah pengoptimalan yang mengurangi latensi lelang end-to-end sebesar memulai permintaan iklan kontekstual bersamaan dengan permintaan ke server tepercaya pembeli yang ditentukan dalam trustedBiddingSignalsUrl.

Paralelisasi mengurangi latensi, tetapi memengaruhi kelayakan pembeli grup minat dan dukungan untuk eksperimen terkoordinasi. Paralelisasi berlaku untuk semua bidder yang berpartisipasi dalam lelang grup minat di perangkat. Bidder tidak perlu mengambil tindakan untuk berpartisipasi dalam lelang paralel tetapi harus memahami bagaimana paralelisasi dapat memengaruhi kelayakannya dalam lelang di perangkat. ID grup eksperimen untuk eksperimen terkoordinasi belum didukung dalam lelang paralel.

Ringkasan alur penayangan

Berikut adalah ringkasan alur lelang paralel: Diagram alur

Kelayakan pembeli grup minat di perangkat

Untuk lelang paralel, panggilan navigator.runAdAuction terjadi sebelum respons iklan kontekstual ditampilkan. Untuk memulai program tepercaya pembeli panggilan server, navigator.runAdAuction mengharuskan Parameter interestGroupBuyers harus diteruskan sebagai nilai, sedangkan parameter lelang yang tersisa menerima JavaScript Promise yang dapat diselesaikan setelah respons iklan kontekstual. Karena interestGroupBuyers diteruskan sebelum respons iklan kontekstual, respons iklan kontekstual (termasuk respons bid) tidak dapat digunakan untuk memilih pembeli yang berpartisipasi dalam lelang paralel untuk permintaan tertentu. Sebagai gantinya, tag penayang Google menyimpan cache, di browser pengguna, parameter interestGroupBuyers dari navigator.runAdAuction dieksekusi pada domain yang sama.

Paralelisasi memiliki beberapa pertimbangan penting:

  1. Sinyal lelang yang tidak diperlukan untuk permintaan server tepercaya pembeli, seperti perBuyerSignals, dapat terus ditentukan dalam respons bid RTB dengan cara yang sama seperti untuk lelang yang tidak diparalelkan. Setelah Promise untuk sinyal ini diselesaikan, langkah selanjutnya dari lelang di perangkat akan selesai dengan cara yang sama seperti lelang di perangkat non-paralel alur lelang.

  2. Karena paralelisasi bergantung pada penyimpanan cache daftar pembeli grup minat, Google tidak selalu menjalankan lelang paralel, karena cache paralelisasi mungkin kosong atau sudah tidak berlaku. Jika cache kosong atau kedaluwarsa, Google menjalankan lelang Protected Audience API non-paralel standar dan menggunakan niat pembeli untuk berpartisipasi dalam lelang non-paralel untuk membuat {i>cache<i} pembeli grup minat.

  3. Jika setidaknya satu pembeli untuk bidder mana pun di-cache untuk penayang saat ini domain tambahan, Google akan menjalankan lelang, yang akan ditunjukkan pada permintaan bid:

    • Protokol Google RTB: BidRequest.adslot.interest_group_auction.parallelized
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized

  4. Setiap asal pembeli grup minat terdaftar untuk bidder tertentu yang yang disertakan dalam lelang paralel akan memiliki Entri ParallelAuctionBuyer:

    • Protokol Google RTB: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer

  5. Jika lelang paralel dijalankan, tetapi origin pembeli tertentu tidak ada di cache, pembeli tersebut tidak dapat ditambahkan ke lelang di perangkat saat ini. Hal ini ditunjukkan oleh permintaan dengan parallelized=True yang tidak memiliki entri ParallelAuctionBuyer untuk asal pembeli grup minat tertentu. Namun, bidder yang menunjukkan minat dengan menyertakan bid yang valid dan memenuhi syarat InterestGroupBuyer pada respons bid-nya akan memiliki pembeli grup minat yang sesuai origin yang ditambahkan ke cache, dan origin tersebut akan memenuhi syarat permintaan yang diparalelkan berikutnya dari browser dan domain yang sama. Niat untuk berpartisipasi dalam lelang grup minat dapat ditunjukkan di kolom berikut:

    • Protokol Google RTB: BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • OpenRTB: BidResponse.ext.igbid.igbuyer

  6. Origin pembeli yang di-cache (yang disertakan dalam parameter interestGroupBuyers lelang paralel) yang tidak menunjukkan intent peserta lelang bid oleh bidder dapat menerima panggilan server tepercaya pembeli tetapi tidak akan berpartisipasi dalam lelang paralel.