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 yang ditargetkan ke grup minat tanpa mengandalkan cookie pihak ketiga, sekaligus melindungi pengguna dari pelacakan lintas situs.

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

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

Authorized Buyer yang berminat untuk melakukan pengujian harus melihat bagian Onboarding untuk mengetahui detailnya.

Ringkasan alur penayangan

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

Diagram alur

  1. Bidder bekerja sama dengan pengiklannya untuk mempertahankan grup minat bagi 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 bidder.
  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. Browser pengguna meminta 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 OpenRTB, hal ini ditentukan dengan kolom BidResponse.ext.igbid, dan di protokol Google RTB yang tidak digunakan lagi, hal ini ditentukan dengan kolom BidResponse.interest_group_bidding. Jika bidder tidak menentukan informasi ini, Google tidak menyertakan asal bidder dalam interestGroupBuyers di konfigurasi lelang. InterestGroupBidding juga dapat berisi sinyal opsional khusus pembeli yang akan diteruskan ke fungsi bidding bidder selama lelang dalam browser. Di OpenRTB, hal ini ditentukan dengan kolom BidResponse.ext.igbid.igbuyer.buyerdata, dan di protokol RTB Google yang tidak digunakan lagi, hal ini ditentukan dengan kolom BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals. 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 yang menang secara kontekstual (jika ada).
  9. Respons bid berisi konfigurasi lelang untuk lelang dalam browser. 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 dalam InterestGroupBidding selama konfigurasi lelang.
  11. Google meneruskan sinyal spesifik per pembeli opsional setiap bidder yang memenuhi syarat ke konfigurasi lelang Protected Audience.
  12. Jika grup minat bidder tertentu menentukan trustedBiddingSignalsUrl, browser akan membuat permintaan ke setiap trustedBiddingSignalsUrl grup untuk mengambil sinyal real-time untuk setiap grup. Lihat detail dalam spesifikasi Protected Audience API.
  13. Browser memanggil generateBid() bidder untuk setiap grup minat yang memilih ikut serta dan memenuhi syarat untuk berpartisipasi dalam lelang di browser. Langkah ini menghitung bid dan memilih materi iklan. generateBid() memiliki akses ke sinyal pembeli opsional yang disediakan oleh bidder dan sinyal bidding tepercaya untuk grup minat tertentu.
  14. Browser memanggil scoreAd() penjual (dalam hal ini, Google) untuk menetapkan peringkat pada 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. Bid kontekstual yang berperingkat teratas 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 akan 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 kampanye iklan. 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 sistem peninjauan materi iklan offline Google hingga 7 hari setelah iklan terakhir kali dibidik.
Real-time Bidding API

Bidder dapat menggunakan API Bidding Real-time untuk mengupload materi iklan untuk 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 origin 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>
Masa berlaku materi iklan

Materi iklan disetujui selama 15 hari. Jika mengirimkan materi iklan dengan Real-time Bidding API, Anda harus mengirimkan ulang materi iklan setelah 15 hari. Jika Anda mengandalkan pemindaian materi iklan otomatis, proses pemindaian akan otomatis memindai ulang materi iklan tersebut.

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 pembelanjaan grup minat, tentukan buyerAndSellerReportingId untuk iklan Anda saat 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 adalah versi awal protokol yang didukung untuk digunakan dalam eksperimen:

Menunjukkan dukungan lelang grup minat

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

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

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

  • SERVER_SIDE_AUCTION (JSON OpenRTB: 0): Lelang yang menentukan iklan pemenang berjalan di server bursa.
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Permintaan dengan dukungan Protected Audience, yang mana lelang kontekstual berjalan di server bursa dan bidding grup minat serta lelang akhir berjalan di browser.
  • SERVER_SIDE_INTEREST_GROUP_AUCTION (JSON OpenRTB: 3): Lelang kontekstual berjalan di server bursa, dan logika bidding untuk bid grup minat serta logika pemberian skor untuk menentukan iklan pemenang akhir dijalankan di server Bidding dan Lelang.
Menunjukkan ukuran slot iklan Protected Audience

Permintaan bid mencakup 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 RTB Google (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 dengan ukuran dalam permintaan kontekstual, seperti yang terlihat di kolom BidRequest.imp.banner.format.w dan BidRequest.imp.banner.format.h OpenRTB atau kolom BidRequest.adslot.width dan BidRequest.adslot.height protokol Google RTB yang tidak digunakan lagi.

Permintaan kontekstual mungkin memiliki beberapa ukuran. Iklan yang memenangkan lelang di perangkat diharapkan mengisi hanya satu ukuran slot tetap.

Menunjukkan kemampuan rendering iklan Protected Audience

Iklan Protected Audience mungkin ditampilkan atau tidak, bergantung pada tahap integrasi saat ini (lihat eksperimen tidak ditampilkan). 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 RTB Google (tidak digunakan lagi): BidRequest.adslot.interest_group_auction.render_interest_group_ads
Meminimalkan penggunaan ID pengguna

Permintaan bid kontekstual dalam cakupan 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. Keberadaan 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 agar lebih siap untuk pembelian yang efisien saat cookie pihak ketiga tidak lagi tersedia.

Google juga dapat menjalankan eksperimen skala kecil yang menghapus ID berbasis cookie dari permintaan bid dalam cakupan pengujian Protected Audience API. Hal ini dilakukan 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 dalam 3PCD. Dalam pengujian, browser Chrome ditetapkan ke grup eksperimen 3PCD, baik Mode A maupun Mode B. Setiap browser diberi label yang konsisten yang sesuai dengan grup eksperimen 3PCD tertentu yang dapat Anda akses melalui Chrome API dalam browser.

Google meneruskan label tidak dimodifikasi dari Chrome API pada permintaan bid RTB. Karena irisan traffic kecil dari setiap label, Google tidak selalu menyertakan label dalam konteks yang dibatasi privasinya.

Berikut adalah kolom tempat Anda dapat melihat label:

  • OpenRTB: BidRequest.device.ext.cdep
  • Protokol RTB Google (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. Respons tidak perlu mencakup bid kontekstual. Objek InterestGroupBidding harus berisi origin untuk setiap InterestGroupBuyer, yang harus cocok dengan salah satu asal yang dikonfigurasi oleh bidder untuk akunnya. origin ditambahkan ke interestGroupBuyers konfigurasi lelang saat Tag Google Publisher memanggil runAdAuction().

Menyebarkan sinyal kontekstual pembeli

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

  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
  • Google RTB (tidak digunakan lagi): BidResponse.interest_group_bidding.per_buyer_signals
Meneruskan 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 ekspansi 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 yang aman untuk URL dalam respons bid kontekstual, yang akan diganti oleh Google di URL rendering grup minat yang menang dengan membuat makro ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}.

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

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

Hingga 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 serangkaian sinyal tertentu yang hanya berlaku untuk materi iklan dengan makro yang sesuai di URL render-nya, sehingga mengurangi ukuran transfer data.

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

Tentukan harga bid maksimum dalam browser

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

Sebagai mitigasi yang didukung selama pengujian Protected Audience API oleh Google untuk partner RTB-nya, Anda dapat menentukan nilai bid maksimum yang diharapkan di setiap respons bid kontekstual. Bid maksimum yang diharapkan adalah harga bid maksimum yang diharapkan akan ditampilkan oleh fungsi bidding Anda. Jika bid yang menang yang dilaporkan dari lelang dalam browser melebihi jumlah ini, bid yang menang tidak 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 iklan ke beberapa akun

Bidder harus memilih ID penagihan untuk mengatribusikan tayangan iklan grup minat bid 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 berupa 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 iklan bidding grup minat tidak diberikan, bidder tidak akan berpartisipasi dalam lelang Protected Audience.

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

Anda dapat menetapkan anggaran harian untuk setiap ID penagihan. Hubungi Account Manager Anda untuk menetapkan anggaran harian bagi ID penagihan akun turunan.

ID penagihan untuk semua akun turunan dengan anggaran yang tersedia dan memenuhi syarat untuk mengajukan bid pada tayangan iklan 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 di 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 spesifikasi Protected Audience Bidding di Perangkat untuk mengetahui penjelasan fungsi generateBid().

Mata uang bid

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

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

Di OpenRTB, gunakan kolom cur baru dalam objek InterestGroupBuyer di 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 dalam 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

Penerapan kebijakan materi iklan dan kontrol penayang mungkin lebih ketat untuk bid grup minat dalam browser selama pengujian Protected Audience API untuk partner RTB.

Dukungan Digital Services Act

Berdasarkan Pasal 26 Digital Services Act, penayang dapat mewajibkan pembeli untuk merender 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 mewajibkan mereka 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 informasi transparansi DSA harus ditampilkan untuk iklan yang ditayangkan melalui Protected Audience API, ia harus mengevaluasi apakah ia dapat menampilkan informasi yang diperlukan dengan semestinya dan menentukannya dengan menetapkan BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render dalam protokol RTB Google yang tidak digunakan lagi). Jika tidak, pembeli tidak akan disertakan dalam lelang Protected Audience API.

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

Pemfilteran bid

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

Setelah lelang dalam browser

Melaporkan 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 Perenderan dan Peristiwa 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 diganti dengan nilai yang sesuai. renderUrl yang digunakan dalam lelang di perangkat dapat mencakup makro berikut:

${GDPR} Diperluas menjadi 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} Diperluas ke string Izin Tambahan (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 rendering 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 dapat menyertakan _OPTIONAL_SUFFIX untuk memberikan hingga tiga nilai sinyal rendering yang berbeda.

Penghitungan tayangan iklan

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

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

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

Atribusi tayangan yang dapat ditagih

Semua pembelanjaan bidder dari lelang dalam browser Protected Audience dikaitkan dengan satu akun bidder berdasarkan pemetaan dari origin pemilik grup minat yang dikonfigurasi untuk bidder. Pengaitan pembelanjaan ke berbagai akun turunan bidder tidak didukung.

Batas anggaran harian

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

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

Masukan real-time dan bid minimum untuk menang

Bidder yang memilih untuk menerima masukan real-time akan menerima masukan untuk pembeli grup minat yang diminta untuk disertakan dalam lelang Protected Audience di perangkat. Setiap pembeli grup minat yang ditentukan bidder pada respons bid akan menerima satu objek masukan, terlepas dari jumlah bid yang diajukan pembeli grup minat dalam lelang Protected Audience. Informasi berikut akan tersedia di objek masukan pembeli grup minat:

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

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

Notifikasi masukan bid

Chrome menyediakan API penelusuran bug sementara untuk Protected Audience API yang memungkinkan Ad Manager mengirim notifikasi penelusuran bug server-ke-server real-time yang berisi masukan tentang bid Protected Audience. Notifikasi ini akan menyertakan alasan mengapa bid mungkin telah difilter dalam lelang dalam browser Protected Audience selain informasi lain tentang bid yang dijelaskan di bawah.

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

  • %%GOOGLE_QUERY_ID%%: Makro ini diganti dengan ID Kueri Google yang dikirim pada permintaan bid kontekstual yang diaktifkan Protected Audience. Dalam protokol OpenRTB, hal ini ditentukan dengan BidRequest.ext.google_query_id, sedangkan protokol 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 scoreAd(). Nilainya adalah kode status materi iklan.

Berikut contoh URL statis yang mungkin 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 API ForDebuggingOnly sementara Chrome.

TURTLEDOVE tingkat produk

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

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 Authorized Buyer.
  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 di renderUrl untuk penampung iklan komponen (juga disebut renderUrl tingkat atas) untuk membedakan renderUrls tingkat atas selama peninjauan materi iklan.
  • Merender materi iklan representatif saat penampung iklan komponen diambil untuk peninjauan materi iklan oleh Google. Untuk memahami kapan rendering iklan perwakilan harus ditampilkan, Anda dapat melihat parameter kueri validation=True yang ditetapkan oleh sistem peninjauan materi iklan Google.

Checklist integrasi

  • Siapkan endpoint permintaan bid yang akan mengisi kolom terkait Protected Audience API pada respons bid kontekstual—misalnya, interest_group_bidding.
  • Terapkan pemberian tag di halaman pengiklan untuk menggabungkan browser pengguna ke 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 pengelola akun atau ajukan tiket menggunakan Pusat Bantuan Pembeli yang Sah untuk menyelesaikan langkah ini.
  • Siapkan Prapenargetan 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 uji 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 bagi pembeli grup minat yang diminta untuk disertakan dalam lelang Protected Audience.
  • (Opsional) Hubungi pengelola akun Anda untuk mengonfigurasi URL statis guna menerima notifikasi server-ke-server yang memberikan masukan bid Protected Audience untuk status bid dari lelang Protected Audience di perangkat guna membantu men-debug masalah yang tidak terduga. Lihat notifikasi masukan bid untuk mengetahui detailnya.

Tahapan pengujian

Tahap 1: Pengujian manual

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

  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 Privacy Sandbox.
  3. Kirimkan materi iklan untuk mendapatkan persetujuan menggunakan Real-time Bidding API.
  4. Gunakan halaman pengiklan yang disediakan bidder untuk menambahkan browser ke grup minat yang dimiliki bidder.

  5. Gunakan halaman penayang pengujian yang disediakan Google berikut untuk memicu lelang Protected Audience:

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

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

  6. Pastikan hal berikut:

    1. Iklan pemenang yang diharapkan dirender.
    2. Hasil lelang dikirimkan di sisi server—artinya bidder yang menang menerima ping kembali 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 scoreAd(). Nilainya adalah kode status materi iklan.

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 lelang Protected Audience. Kemudian, Google dan partner tidak perlu lagi memicu lelang Audiens Dilindungi secara manual. Hasil lelang Protected Audience tidak dirender. Hal ini memungkinkan kami menguji integrasi dalam skala besar.

Hubungi Account Manager Anda atau ajukan tiket melalui Pusat Bantuan Authorized Buyer 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 mengizinkan partner untuk merender iklan pemenang Protected Audience. Google memiliki sejumlah kecil traffic tempat lelang Protected Audience memenuhi syarat untuk dijalankan, dan iklan grup minat yang menang dirender. Bid dalam browser dari bidder yang berpartisipasi bersaing dengan bid tradisional.

Hubungi Account Manager Anda atau ajukan tiket melalui Pusat Bantuan Authorized Buyer 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 dengan memulai permintaan iklan kontekstual secara paralel 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 melakukan tindakan untuk berpartisipasi dalam lelang paralel, tetapi harus memahami cara paralelisme dapat memengaruhi kelayakan mereka dalam lelang di perangkat. ID grup eksperimen untuk eksperimen terkoordinasi belum didukung dalam lelang paralel.

Ringkasan alur penayangan

Berikut 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 panggilan server tepercaya pembeli, navigator.runAdAuction memerlukan parameter interestGroupBuyers yang harus diteruskan sebagai nilai, sementara parameter lelang lainnya menerima Promise Javascript 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 dalam cache, di browser pengguna, parameter interestGroupBuyers dari eksekusi navigator.runAdAuction sebelumnya di 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-langkah lelang di perangkat yang tersisa akan selesai dengan cara yang sama seperti alur lelang non-paralel.

  2. Karena paralelisme mengandalkan penyimpanan dalam cache daftar pembeli grup minat, Google tidak selalu menjalankan lelang paralel, karena cache paralelisme mungkin kosong atau sudah berakhir. Jika cache kosong atau telah habis masa berlakunya, Google menjalankan lelang Protected Audience API non-paralel standar dan menggunakan niat pembeli untuk berpartisipasi dalam lelang non-paralel guna membuat cache pembeli grup minat.

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

    • Protokol RTB Google: 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 disertakan dalam lelang paralel akan memiliki entri ParallelAuctionBuyer yang sesuai:

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

  5. Jika lelang paralel dijalankan, tetapi asal pembeli tertentu tidak ada dalam cache, maka 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 InterestGroupBuyer(s) yang valid dan memenuhi syarat pada respons bid mereka akan membuat asal pembeli grup minat yang sesuai ditambahkan ke cache, dan asal tersebut akan memenuhi syarat untuk permintaan paralel di masa mendatang dari browser dan domain yang sama. Niat untuk berpartisipasi dalam lelang grup minat dapat ditunjukkan di kolom berikut:

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

  6. Asal pembeli yang di-cache (yang disertakan dalam parameter interestGroupBuyers lelang paralel) yang tidak menunjukkan niat untuk berpartisipasi dalam respons bid mereka oleh bidder dapat menerima panggilan server tepercaya pembeli tetapi tidak akan berpartisipasi dalam lelang paralel.