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 sedang menjalankan uji coba origin 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.
- Dapatkan masukan tentang potensi peningkatan API di forum publik, misalnya, GitHub.
- Bersiaplah untuk mendukung iklan yang dipersonalisasi melalui API tanpa mengandalkan cookie pihak ketiga.
Authorized Buyers yang tertarik untuk melakukan pengujian harus membaca bagian Orientasi untuk mengetahui detailnya.
Ringkasan alur penayangan
Berikut adalah ringkasan alur penayangan iklan Protected Audience untuk partner Authorized Buyers:
- 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.
- Pengguna akhir mengunjungi halaman pengiklan. Halaman mungkin berisi tag bidder.
- Tag bidder memanggil Protected Audience API
joinAdInterestGroup()
. Panggilan ini meminta browser untuk menambahkan pengguna ke grup minat. - Pengguna akhir mengunjungi halaman web penayang. Browser pengguna meminta tag iklan penayang Google.
- Tag iklan penayang Google membuat permintaan iklan kontekstual ke server Google.
- Google mengirimkan permintaan bid kontekstual kepada bidder yang berpartisipasi. Lihat bagian Perubahan permintaan bid untuk informasi selengkapnya.
- Bidder menampilkan
BidResponse
dengan kolominterest_group_bidding
. Jika bidder tidak menentukaninterest_group_bidding
, Google tidak akan menyertakan asal bidder diinterestGroupBuyers
dalam konfigurasi lelang. Respons bid juga dapat berisiinterest_group_bidding.per_buyer_signals
.per_buyer_signals
akan diteruskan ke fungsi bidding bidder selama lelang dalam browser. Lihat bagian Perubahan respons bid untuk informasi selengkapnya. - 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 ada).
- Respons bid berisi konfigurasi lelang untuk lelang
dalam browser. Hal ini dapat mencakup sinyal kontekstual dari setiap pembeli yang berpartisipasi
(yang dikirim melalui
interest_group_bidding.per_buyer_signals
), informasi pemenang kontekstual, dan setelan untuk kelayakan bid. - Tag penayang Google memanggil Protected Audience API
runAdAuction()
untuk memulai lelang grup minat di perangkat. Google hanya menyertakan pembeli yang sebelumnya telah menampilkaninterest_group_bidding
sebagaiinterestGroupBuyers
dalam konfigurasi lelang. - Google meneruskan setiap
per_buyer_signals
bidder yang memenuhi syarat ke konfigurasi lelang Protected Audience. - Jika grup minat bidder tertentu menentukan
trustedBiddingSignalsUrl
, browser akan membuat permintaan ketrustedBiddingSignalsUrl
setiap grup untuk mengambil sinyal real-time untuk setiap grup. Lihat detailnya di spesifikasi Protected Audience API. - Browser memanggil
generateBid()
bidder untuk setiap grup minat yang memilih ikut serta dan memenuhi syarat untuk berpartisipasi dalam lelang dalam browser. Langkah ini akan menghitung bid dan memilih materi iklan.generateBid()
memiliki akses keper_buyer_signals
yang disediakan oleh bidder dan sinyal bidding tepercaya untuk grup minat tertentu. - Browser memanggil penjual (dalam hal ini, milik Google)
scoreAd()
untuk menetapkan peringkat pada setiap bid di lelang iklan grup minat. Bid diberi peringkat dan difilter berdasarkan perlindungan penayang, kebijakan iklan, dan batasan lainnya. - Browser menjalankan lelang dengan bid grup minat yang memenuhi syarat. Bid kontekstual dengan peringkat teratas berpartisipasi dalam lelang dalam browser.
- Setelah lelang, jika ada pemenang grup minat, browser akan memanggil
reportResult()
penjual danreportWin()
bidder untuk memberi tahu setiap pihak tentang pemenang lelang dalam browser. - Jika iklan grup minat menang, tag penayang Google akan merender iklan di iframe.
Detail alur penayangan
Sebelum penayangan iklan
Peninjauan materi iklan
Materi iklan harus ditinjau dan disetujui oleh Google sebelum dapat ditayangkan dari
lelang Protected Audience di browser. 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 denganrenderUrl
yang digunakan dalam lelang iklan grup minat.- Setiap
renderUrl
hanya dapat mewakili satu pengiklan atau kampanye iklan.renderUrl
yang ditentukan tidak dapat digunakan untuk merender iklan atas nama beberapa pengiklan. SetiaprenderUrl
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 mengajukan bid.
Real-time Bidding API
Bidder dapat menggunakan API Bidding Real-time guna 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 API Bidding Real-time.
Jika Anda menyiapkan pemindaian materi iklan otomatis, Google akan menemukan materi iklan di lelang dalam browser dan otomatis memindainya agar memenuhi syarat untuk lelang berikutnya.
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 dinyatakan 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 mengirim ulang materi iklan setelah 15 hari. Jika Anda mengandalkan pemindaian materi iklan otomatis, proses pemindaian akan otomatis memindai ulang materi iklan.
ID Pelaporan Pembeli
Anda dapat mengelompokkan metrik pelaporan (seperti tayangan iklan) menggunakan dimensi
yang disediakan oleh pembeli (misalnya, ID kampanye atau ID pengiklan). Guna menambahkan
dimensi pembelanjaan grup minat, tentukan buyerAndSellerReportingId
untuk
iklan saat Anda menambahkan perangkat pengguna ke grup minat. Lihat detail
tambahan di 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, auction_environment
.
- Protokol Google RTB:
BidRequest.adslot.auction_environment
- OpenRTB:
BidRequest.imp.ext.auction_environment
Anda dapat menggunakan kolom ini untuk membedakan antara peluang tayangan iklan yang
mendukung lelang grup minat dalam browser Protected Audience dan peluang yang
hanya mendukung lelang bursa sisi server tradisional. Enum
auction_environment
dapat memiliki nilai berikut:
SERVER_SIDE_AUCTION
(JSON OpenRTB:0
): Lelang sisi server tradisionalON_DEVICE_INTEREST_GROUP_AUCTION
(OpenRTB JSON:1
): Permintaan dengan dukungan Protected Audience, dengan lelang kontekstual yang dijalankan di server bursa serta bidding grup minat dan lelang akhir yang berjalan di browser
Menunjukkan ukuran slot iklan Protected Audience
Permintaan bid mencakup kolom berikut untuk memberi Anda ukuran slot iklan Protected Audience:
- Protokol Google RTB:
BidRequest.adslot.interest_group_auction.width
BidRequest.adslot.interest_group_auction.height
- OpenRTB:
BidRequest.imp.ext.interest_group_auction
.width
BidRequest.imp.ext.interest_group_auction
.height
Kolom ini menunjukkan ukuran slot iklan untuk lelang Protected Audience dalam piksel.
Ukuran ini mungkin berbeda dari ukuran untuk permintaan kontekstual (Adslot.width
dan Adslot.height
, atau di OpenRTB: BidRequest.imp.banner.format
).
Permintaan kontekstual mungkin memiliki beberapa ukuran. Iklan pemenang lelang di perangkat diharapkan hanya mengisi satu ukuran slot tetap.
Menunjukkan kemampuan rendering 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.
- Protokol Google RTB:
BidRequest.adslot.interest_group_auction.render_interest_group_ads
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
Meminimalkan ketergantungan pada ID pengguna
Permintaan bid kontekstual dalam cakupan pengujian Protected Audience API dapat
terus menggunakan ID berbasis cookie tradisional jika tersedia dari
browser, seperti kolom google_user_id
(BidRequest.user.id
di OpenRTB) dan
hosted_match_data
(BidRequest.user.buyerid
di OpenRTB). Keberadaan ID tersebut dalam permintaan bid akan terus 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 mungkin menjalankan eksperimen berskala kecil saat ID berbasis cookie disamarkan dari permintaan bid dalam cakupan untuk pengujian Protected Audience API. Tujuannya adalah untuk menilai potensi dampak penghentian penggunaan cookie pihak ketiga.
Pengujian penghentian penggunaan cookie pihak ketiga yang difasilitasi Chrome
Untuk bersiap menghadapi penghentian 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 ini, browser Chrome ditetapkan ke grup eksperimen 3PCD, Mode A atau Mode B. Setiap browser akan diberi label yang konsisten sesuai dengan grup eksperimen 3PCD tertentu yang dapat Anda akses melalui Chrome API dalam browser.
Google akan meneruskan label yang tidak dimodifikasi dari Chrome API pada permintaan bid RTB. Karena irisan traffic yang kecil dari setiap label, Google tidak selalu menyertakan label tersebut dalam konteks yang membatasi privasi.
Berikut adalah kolom tempat Anda dapat melihat label:
- Protokol Google RTB:
BidRequest.device.cookie_deprecation_label
- OpenRTB:
BidRequest.device.ext.cdep
Perubahan respons bid
Menunjukkan partisipasi lelang grup minat
Anda bertanggung jawab untuk menunjukkan secara eksplisit intent Anda untuk berpartisipasi dalam
lelang dalam browser dengan menampilkan objek InterestGroupBidding
dalam
respons bid kontekstual:
- Protokol Google RTB:
BidResponse.interest_group_bidding
- OpenRTB:
BidResponse.ext.igbid
Anda harus memberikan respons bid kontekstual. Respons tidak diperlukan untuk
menyertakan bid kontekstual. Objek InterestGroupBidding
harus berisi
origin
pemilik grup minat, 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()
.
Memperluas sinyal kontekstual pembeli (perBuyerSignals)
Anda dapat menyertakan sinyal pembeli dalam respons bid kontekstual, yang
diterapkan 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:
- Google RTB:
BidResponse.interest_group_bidding.per_buyer_signals
- OpenRTB:
BidResponse.ext.igbid.igbuyer.buyerdata
Menerapkan sinyal rendering kontekstual pembeli
Materi iklan grup minat dapat menggunakan sinyal kontekstual terbatas selama rendering dengan mengirimkan sinyal tersebut melalui respons bid kontekstual dan menerimanya di 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 untuk URL dalam
respons bid kontekstual, yang akan diganti oleh Google dalam 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 protokolnya:
- Google RTB:
BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
- OpenRTB:
BidResponse.ext.igbid.igbuyer.rsig
Maksimal 3 kumpulan 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 rendernya, sehingga mengurangi ukuran transfer data.
Pembeli grup minat akan ditolak untuk berpartisipasi dalam lelang Protected Audience jika sinyalnya tidak aman untuk URL, akhiran makro tidak unik, atau lebih dari 3 kumpulan sinyal disediakan.
Menentukan harga bid maksimum dalam browser
Dalam proposal Protected Audience, komputasi bid dan lelang akhir diharapkan berjalan secara lokal di perangkat. Hal ini dapat menciptakan potensi vektor penyalahgunaan yang dapat memengaruhi integritas hasil lelang akhir, 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 di setiap respons bid kontekstual. Bid maksimum yang diharapkan adalah harga bid maksimum yang diharapkan akan ditampilkan oleh fungsi bidding Anda. Jika bid pemenang yang dilaporkan dari lelang dalam browser melebihi jumlah ini, bid yang menang tidak akan dihitung sebagai peristiwa yang dapat ditagih. Pendekatan ini dapat berubah.
Dalam respons bid, Anda dapat menentukan nilai bid maksimum yang diharapkan di kolom berikut:
- Protokol Google RTB:
BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros
(dinyatakan dalam microCPM) - OpenRTB:
BidResponse.igbid.igbuyer.maxbid
(dinyatakan dalam unit mata uang CPM)
Mengatribusikan tayangan ke beberapa akun
Bidder harus memilih ID penagihan untuk mengatribusikan tayangan bid grup minatnya menggunakan kolom berikut:
- Protokol Google RTB:
BidResponse.interest_group_bidding.interest_group_buyers.billing_id
- OpenRTB:
BidResponse.igbid.igbuyer.billing_id
ID penagihan yang dipilih harus berupa ID penagihan yang memenuhi syarat dari permintaan bid:
- Protokol Google RTB:
BidRequest.adslot.matching_ad_data.billing_id
- OpenRTB:
BidRequest.imp.ext.billing_id
Jika ID penagihan yang dikaitkan dengan tayangan 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 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 masing-masing ID penagihan. Hubungi Account Manager Anda guna 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 Account Manager Anda untuk mengubah anggaran untuk ID penagihan grup minat.
Selama lelang dalam browser
Membuat bid dalam browser
Gunakan generateBid()
untuk membuat bid dalam browser.
Google memberikan parameter berikut:
auctionSignals
: KosongperBuyerSignals
: Objek JavaScript dari sinyal yang sama yang disediakan oleh bidder dalam respons kontekstual
Parameter berikut ditampilkan:
ad
: Google mengabaikan kolom ini.bid
: Bid numerik yang memasuki lelang. Harus dalam unit CPM (bukan mikro).render
: URL yang dirender untuk menampilkan materi iklan jika bid memenangkan lelang. Google harus meninjau dan menyetujui URL ini, atau URL ini akan difilter dari lelang.allowComponentAuction
: Harustrue
. 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 Bidding
di Perangkat spesifikasi Protected Audience untuk
mengetahui penjelasan fungsi generateBid()
.
Mata uang bid
Bid lelang dalam browser ditempatkan dalam unit CPM mata uang bid yang dipilih.
Mata uang bid harus ditunjukkan dalam respons bid kontekstual dan
nilai yang ditampilkan generateBid
, serta harus berupa kode alfa ISO 4217 yang valid, seperti "USD", "EUR", atau "JPY".
Di OpenRTB, gunakan kolom cur
baru di objek InterestGroupBuyer
di ekstensi respons bid Google.
Berikut contohnya:
ext {
igbid {
impid: "1"
igbuyer {
origin: "https://examplebuyerorigin.com"
cur: "EUR"
}
}
}
Di protokol Google RTB, gunakan kolom currency
baru di pesan InterestGroupBuyer
pada 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 pada 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 satu mata uang tersebut 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 Digital Services Act Pasal 26, 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
diperlukan untuk memberikan transparansi pembeli dengan mencatat kolom berikut pada
permintaan bid yang diterima:
BidRequest.dsa.dsa_support
dan BidRequest.dsa.publisher_rendering_support
untuk protokol Google Authorized Buyers dan BidRequest.regs.dsa.required
dan BidRequest.dsa.pubrender
untuk protokol OpenRTB.
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 tepat dan menentukan dengan menetapkan
BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render
untuk protokol Authorized Buyers Google atau
BidResponse.ext.igbid.igbuyer.dsaadrender
untuk protokol OpenRTB. 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
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 Render dan Peristiwa Iklan dalam penjelasan Protected Audience API untuk informasi selengkapnya.
Makro
renderUrl
yang mereferensikan materi iklan Protected Audience API dapat menyertakan
satu atau beberapa placeholder, yang disebut makro. Setelah lelang grup minat
berakhir, tetapi sebelum rendering, makro diganti dengan nilai
yang sesuai. renderUrl
yang digunakan dalam lelang di perangkat dapat menyertakan makro
berikut:
${GDPR}
|
Luaskan 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 dalam GVL IAB di URL.
Mengganti Materi iklan dengan makro ${GDPR_CONSENT_XXXX} hanya akan 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 render yang ditentukan pada respons bid.
Ganti placeholder |
Penghitungan tayangan
Selama pengujian Protected Audience API dengan partner RTB, Google akan menghitung
tayangan saat browser memanggil fungsi reportResult()
dan
kemudian mengambil URL pelaporan Google dalam panggilan ke sendReportTo()
.
Karena peristiwa yang digunakan oleh Google untuk menghitung tayangan di lelang Protected Audience di browser mungkin berbeda dengan peristiwa yang digunakan untuk menghitung tayangan oleh partner pembeli RTB, jumlah tayangan mungkin berbeda.
Salah satu tujuan Google untuk menguji Protected Audience API adalah untuk mengidentifikasi dan mengurangi perbedaan ini.
Atribusi tayangan iklan yang dapat ditagih
Semua pembelanjaan bidder dari lelang Protected Audience dalam browser diatribusikan ke satu akun bidder berdasarkan pemetaan dari asal pemilik grup minat yang dikonfigurasi untuk bidder. Mengatribusikan pembelanjaan ke akun kursi turunan yang berbeda dari bidder tidak didukung.
Batas anggaran harian
Selama pengujian Protected Audience API, setiap akun memiliki batas anggaran harian Protected Audience 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 Protected Audience.
Akun dapat terus berpartisipasi dalam lelang kontekstual sisi server setelah
mencapai batas Protected Audience. Misalnya, akun bidder yang mencapai
batas Protected Audience mungkin menerima permintaan bid dengan auction_environment
= SERVER_SIDE_AUCTION
(OpenRTB: 0
), meskipun permintaan bid 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 oleh bidder dalam respons bid akan menerima satu objek masukan, terlepas dari jumlah bid yang ditempatkan pembeli grup minat dalam lelang Protected Audience. Informasi berikut akan tersedia di objek masukan pembeli grup minat:
- Jenis masukan objek masukan akan menjadi
INTEREST_GROUP_BUYER_FEEDBACK
. - Asal pembeli grup minat.
- Bid minimum untuk menang bagi pembeli grup minat agar dapat memenangkan lelang secara keseluruhan.
- Bid minimum yang akan menang untuk pembeli grup minat agar dapat mengalahkan bid berperingkat tertinggi dari komponen sisi server dari keseluruhan lelang.
- Kode status pembeli grup minat. Kode status yang mungkin ditentukan di 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 proses debug sementara untuk Protected Audience API yang memungkinkan Ad Manager mengirim notifikasi debug server ke server secara real-time yang berisi masukan tentang bid Protected Audience. Notifikasi ini akan menyertakan alasan 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 masukan bid proses debug Protected Audience. URL statis ini akan diambil dari server Google dengan makro pilihan yang diganti setelah lelang Protected Audience selesai. Makro berikut didukung:
%%GOOGLE_QUERY_ID%%
: Makro ini diganti dengan ID Kueri Google (BidRequest.google_query_id
dalam protokol Authorized Buyer, danBidRequest.ext.google_query_id
dalam protokol OpenRTB) yang dikirim pada permintaan bid kontekstual yang diaktifkan Protected Audience.%%INTEREST_GROUP_OWNER%%
: Asal pemilik grup minat.%%BID_CPM%%
: Harga bid dalam CPM yang ditentukan oleh pembeli dalam fungsigenerateBid()
.%%RENDER_URL%%
: URL render materi iklan.%%STATUS%%
: Kode status jika bid ditolak dalamscoreAd()
. Nilainya adalah kode status materi iklan.
Berikut adalah contoh URL statis yang mungkin diberikan oleh 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 Terdiri dari Beberapa Bagian atau TURTLEDOVE tingkat produk (PLTD) didukung untuk partner Google RTB selama pengujian Protected Audience API. Beri tahu Account Manager selama integrasi jika Anda berencana menguji PLTD, karena resource dan konfigurasi tambahan diperlukan.
Orientasi
Berikut cara menguji Protected Audience API:
Langkah
- Isi formulir permintaan untuk bergabung dengan eksperimen Protected Audience API.
- Setelah Anda mengirimkan formulir permintaan, hubungi Account Manager Anda atau ajukan tiket menggunakan Pusat Bantuan Authorized Buyer.
- Setelah akun dikonfigurasi, Google dan partner dapat memverifikasi integrasi melalui langkah-langkah dalam Tahap pengujian.
Peninjauan Materi Iklan
Untuk mengajukan bid dengan iklan tingkat produk (iklan yang terdiri dari beberapa bagian) di lelang Protected Audience API, ikuti persyaratan berikut:
- Sertakan parameter kueri
&pltd=True
direnderUrl
untuk penampung iklan komponen (juga disebutrenderUrl
tingkat atas) untuk membedakanrenderUrls
tingkat teratas selama peninjauan materi iklan. - Tampilkan materi iklan representatif saat penampung iklan komponen diambil untuk peninjauan materi iklan oleh Google. Untuk memahami kapan
rendering iklan representatif 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.
- Implementasikan
generateBid()
danreportWin()
. - Pilih asal pemilik grup minat dan tambahkan ke akun Authorized Buyers.
- Asal pemilik grup minat harus cocok dengan origin tempat
fungsi
generateBid()
dihosting. - Hubungi Account Manager atau ajukan tiket menggunakan Pusat Bantuan Authorized Buyers untuk menyelesaikan langkah ini.
- Asal pemilik grup minat harus cocok dengan origin tempat
fungsi
- Menyiapkan 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 origin pembeli grup minat Anda. Tindakan 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 Account Manager 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 untuk membantu proses debug masalah yang tidak terduga. Lihat notifikasi masukan bid untuk mengetahui detailnya.
Tahap pengujian
Tahap 1: Pengujian manual
Berikut cara memicu lelang Protected Audience secara manual, memastikan iklan dapat dirender, dan mencatat tayangan:
- Gunakan Chrome 101 atau yang lebih baru.
- Aktifkan Privacy Sandbox API dan Fenced Frame menggunakan
chrome://flags/#privacy-sandbox-ads-apis
danchrome://flags/#enable-fenced-frames
. Lihat selengkapnya di Menguji sandbox privasi. - Kirim materi iklan untuk mendapatkan persetujuan menggunakan API Bidding Real-time.
- Gunakan halaman pengiklan yang disediakan bidder untuk menambahkan browser ke grup minat yang dimiliki bidder.
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 tersebut dapat 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.
Pastikan beberapa hal berikut:
- Iklan pemenang yang diharapkan dirender.
- Hasil lelang dikirim sisi server—yang berarti bidder yang menang
menerima ping kembali dari
reportWin()
. - Konsol halaman penayang pengujian mencatat pesan debug untuk setiap bid ke dalam log dengan informasi berikut:
renderUrl
: URL render bid.interestGroupOwner
: Pemilik grup minat bid.accepted
: Kolom ini bernilaitrue
jika bid diterima danfalse
jika bid ditolak olehscoreAd()
.externalBidStatus
: Kode status jika bid ditolak dalamscoreAd()
. 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 mengaktifkan partner untuk tahap pengujian berikutnya.
Google mengalokasikan sedikit traffic live untuk menjalankan lelang Protected Audience. Selanjutnya, Google dan partner tidak perlu lagi memicu lelang Protected Audience 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 memungkinkan partner merender iklan pemenang Protected Audience. Google memiliki sedikit traffic tempat lelang Protected Audience memenuhi syarat untuk dijalankan, dan iklan grup minat pemenang akan 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 perluasan dari protokol inti.
Paralelisasi
Paralelisasi adalah pengoptimalan yang mengurangi latensi lelang menyeluruh dengan
memulai permintaan iklan kontekstual secara paralel dengan permintaan ke
server tepercaya pembeli
yang ditentukan dalam trustedBiddingSignalsUrl
.
Paralelisasi mengurangi latensi, tetapi memengaruhi kelayakan dan dukungan pembeli untuk grup minat 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:
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
mengharuskan
parameter interestGroupBuyers
harus
diteruskan sebagai nilai, sedangkan 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 mana yang berpartisipasi dalam lelang paralel
untuk permintaan tertentu. Sebaliknya, tag penayang Google men-cache,
di browser pengguna, parameter interestGroupBuyers
dari eksekusi
navigator.runAdAuction
sebelumnya di domain yang sama.
Paralelisasi memiliki beberapa pertimbangan penting:
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 yang tersisa dari lelang di perangkat akan diselesaikan dengan cara yang sama seperti alur lelang non-paralel.Karena paralelisasi mengandalkan penyimpanan daftar pembeli grup minat ke cache, Google tidak selalu menjalankan lelang paralel, karena cache paralelisasi mungkin kosong atau sudah tidak berlaku. Jika cache kosong atau habis masa berlakunya, Google akan menjalankan lelang Protected Audience API non-paralel standar dan menggunakan intent pembeli untuk berpartisipasi dalam lelang non-paralel untuk membuat cache pembeli grup minat.
Jika setidaknya satu pembeli untuk bidder mana pun di-cache untuk domain penayang saat ini, Google akan menjalankan lelang paralel, yang akan ditunjukkan dalam permintaan bid:
- Protokol Google RTB:
BidRequest.adslot.interest_group_auction.parallelized
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.parallelized
- Protokol Google RTB:
Setiap asal pembeli grup minat yang terdaftar untuk bidder tertentu yang disertakan dalam lelang paralel akan memiliki entri
ParallelAuctionBuyer
yang sesuai:- Protokol Google RTB:
BidRequest.adslot.interest_group_auction.parallel_auction_buyer
- OpenRTB:
BidRequest.imp.ext.interest_group_auction.pbuyer
- Protokol Google RTB:
Jika lelang paralel dijalankan, tetapi asal pembeli tertentu tidak ada dalam cache, pembeli tersebut tidak dapat ditambahkan ke lelang di perangkat saat ini. Hal ini ditunjukkan oleh permintaan dengan
parallelized=True
yang tidak memiliki entriParallelAuctionBuyer
untuk asal pembeli grup minat tertentu. Namun, bidder yang menunjukkan minat dengan menyertakanInterestGroupBuyer
yang valid dan memenuhi syarat pada respons bid mereka akan menambahkan origin pembeli grup minat yang sesuai ke cache, dan origin tersebut akan memenuhi syarat untuk permintaan yang diparalelkan mendatang dari browser dan domain yang sama. Niat untuk berpartisipasi dalam lelang grup minat dapat ditunjukkan dalam kolom berikut:- Protokol Google RTB:
BidResponse.adslot.interest_group_bidding.interest_group_buyers
- OpenRTB:
BidResponse.ext.igbid.igbuyer
- Protokol Google RTB:
Asal pembeli yang di-cache (yang disertakan dalam parameter
interestGroupBuyers
lelang paralel) yang tidak menunjukkan niat untuk berpartisipasi dalam respons bid oleh bidder dapat menerima panggilan server tepercaya pembeli, tetapi tidak akan berpartisipasi dalam lelang paralel.