Protected Audience API (sebelumnya FLEDGE)

Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Audiens yang Dilindungi 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.

Chrome menjalankan origin uji coba untuk Protected Audience API. Authorized Buyers memenuhi syarat untuk berpartisipasi dalam pengujian Protected Audience API pada 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 informasi .
  3. Tag bidder memanggil Protected Audience API joinAdInterestGroup(). Panggilan ini meminta browser 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 informasi selengkapnya.
  7. Bidder menampilkan BidResponse dengan kolom interest_group_bidding. Jika bidder tidak menentukan interest_group_bidding, Google tidak sertakan asal bidder di interestGroupBuyers dalam lelang konfigurasi Anda. Respons bid juga dapat berisi interest_group_bidding.per_buyer_signals. per_buyer_signals akan diteruskan ke fungsi bidding bidder selama lelang dalam browser. Lihat Perubahan respons bid untuk 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 interest_group_bidding.per_buyer_signals), 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 sebelumnya telah mengembalikan interest_group_bidding sebagai interestGroupBuyers dalam konfigurasi lelang.
  11. Google meneruskan per_buyer_signals dari setiap bidder yang memenuhi syarat ke Protected Konfigurasi lelang audiens.
  12. Jika grup minat bidder tertentu menentukan trustedBiddingSignalsUrl, browser membuat permintaan ke setiap grup trustedBiddingSignalsUrl untuk mengambil sinyal real-time untuk setiap grup. Lihat detail dalam Protected Audience API spesifikasi.
  13. Browser memanggil generateBid() bidder untuk setiap grup minat yang memilih ikut serta dan memenuhi syarat untuk berpartisipasi dalam lelang dalam browser. Ini ini akan menghitung bid dan memilih materi iklan. generateBid() memiliki akses ke per_buyer_signals yang diberikan oleh bidder dan bidding tepercaya grup minat tertentu.
  14. Browser memanggil scoreAd() penjual (dalam kasus ini, milik Google) untuk menetapkan peringkat untuk setiap bid dalam lelang iklan grup minat. Bid diberi peringkat dan difilter berdasarkan perlindungan penayang, kebijakan iklan, dan batasan data.
  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 masing-masing pihak ketiga 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 mengirim materi iklan untuk ditinjau melalui API Bidding Real-time 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 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 memenuhi syarat untuk lelang yang akan datang.

Berikut ini 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 spesifik per 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 ke 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 secara otomatis memindai ulang materi iklan.

ID Pelaporan Pembeli

Anda dapat mengelompokkan metrik pelaporan (seperti tayangan) menggunakan dimensi 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 tambahan detail di Protected Audience dokumentasi tambahan.

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 kolom Alat Pelaporan Pembeli, 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, auction_environment.

  • Protokol Google RTB: BidRequest.adslot.auction_environment
  • OpenRTB: BidRequest.imp.ext.auction_environment

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 auction_environment dapat memiliki nilai berikut:

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0): Lelang sisi server tradisional
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Permintaan dengan Dukungan Protected Audience, yang lelang kontekstualnya berjalan di server bursa dan bidding grup minat, dan lelang akhir akan berjalan di browser
Menunjukkan ukuran slot iklan Protected Audience

Permintaan bid mencakup kolom berikut untuk memberi Anda izin Ukuran slot iklan audiens:

  • 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.widthdanAdslot.height, atau di OpenRTB: BidRequest.imp.banner.format).

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 dapat atau tidak dapat dirender bergantung pada tahap integrasi (lihat non-rendering eksperimen). 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 untuk pengujian Protected Audience API dapat tetap menggunakan ID berbasis cookie tradisional jika tersedia dari browser, seperti google_user_id (BidRequest.user.id di OpenRTB) dan Kolom hosted_match_data (BidRequest.user.buyerid di OpenRTB). Kehadiran ID tersebut dalam permintaan bid akan tetap tunduk kepada kebijakan privasi kami. Sebaiknya Anda tidak mengandalkan ID berbasis cookie untuk penargetan dan bidding selama pengujian untuk lebih mempersiapkan membeli saat cookie pihak ketiga tidak lagi tersedia.

Google mungkin juga menjalankan eksperimen skala kecil dengan ID berbasis cookie disamarkan dari permintaan bid dalam cakupan untuk pengujian Protected Audience API. Ini adalah menilai potensi dampak penghentian cookie pihak ketiga.

Untuk mempersiapkan diri 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 itu, {i>browser<i} Chrome ditetapkan ke grup eksperimen 3PCD, Mode A atau 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 yang tidak diubah dari Chrome API pada bid RTB permintaan. Karena irisan lalu lintas yang kecil dari label individu, Google tidak selalu menyertakan label dalam konteks yang dibatasi 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 niat Anda secara eksplisit dalam berpartisipasi dalam lelang dalam browser dengan menampilkan objek InterestGroupBidding di respons bid kontekstual:

  • Protokol Google RTB: BidResponse.interest_group_bidding
  • OpenRTB: BidResponse.ext.igbid

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

Menerapkan sinyal kontekstual pembeli (perBuyerSignals)

Anda dapat menyertakan sinyal pembeli dalam respons bid kontekstual, yang akan menyebar sebagai objek JSON ke fungsi bidding di perangkat miliknya melalui Argumen perBuyerSignals. Hal ini dapat disertakan dalam respons bid dengan isian berikut ini tergantung 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 oleh mengirimkan sinyal tersebut melalui respons bid kontekstual dan menerimanya pada permintaan URL render menggunakan perluasan makro. Misalnya, rendering dapat digunakan untuk menyesuaikan tampilan dan nuansa materi iklan untuk meningkatkan performa dalam konteks slot iklan atau halaman penayang tertentu.

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

Sinyal rendering dapat ditentukan dalam respons bid dengan hal berikut isian, tergantung pada protokolnya:

  • Google RTB: BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig

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 terkait di URL rendernya, sehingga mengurangi transfer data ukuran.

Pembeli grup minat akan ditolak untuk berpartisipasi dalam Lelang audiens jika sinyalnya tidak aman untuk URL, akhiran makro tidak unik, atau lebih dari 3 set sinyal disediakan.

Menentukan harga bid dalam browser maksimum

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 tawaran pemenang dilaporkan dari lelang dalam browser melebihi jumlah ini, bid yang menang 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:

  • 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 minat mereka tayangan iklan grup 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 merupakan 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 akan diatribusikan ke 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 salah satu ID penagihan untuk pembelanjaan kontekstual dan ID penagihan lainnya 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 Account Manager untuk menetapkan anggaran harian untuk ID penagihan akun turunan.

ID penagihan untuk semua akun turunan dengan anggaran yang tersedia yang memenuhi syarat untuk mengajukan bid tayangan muncul pada permintaan bid untuk pilihan atribusi pembelanjaan. Menghubungi ke pengelola akun Anda untuk mengubah anggaran bagi 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 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. Jika tidak, URL ini akan difilter dari lelang.
  • allowComponentAuction: Harus true. Google saat ini mendukung pengujian untuk lelang multi-penjual.

Berikut contohnya:

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

Lihat spesifikasi Protected Audience Di Perangkat Bidding untuk 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 pada 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 di InterestGroupBuyer dalam respons bid.

Berikut contohnya:

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

Bidder Fungsi generateBid harus menampilkan bid dalam mata uang yang sama dengan 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 ditampilkan oleh generateBid, atau jika salah satunya menampilkan mata uang yang tidak valid, 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. Saat "Minta pembeli hanya menampilkan iklan dengan DSA informasi transparansi di situs atau aplikasi saya di EEA" kontrol diaktifkan oleh penayang, pembeli grup minat dapat menentukan peluang mana yang akan yang diperlukan untuk merender transparansi pembeli dengan memperhatikan 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, iklan tersebut harus menilai apakah mereka dapat menampilkan informasi yang diperlukan dengan tepat dan menentukan BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render untuk protokol Google Authorized Buyers atau BidResponse.ext.igbid.igbuyer.dsaadrenderuntuk protokol OpenRTB. 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 Pelaporan Pembeli tentang Render dan Iklan Acara dalam penjelasan Protected Audience API untuk mengetahui informasi selengkapnya.

Makro

renderUrl yang mereferensikan materi iklan Protected Audience API dapat menyertakan satu atau lebih {i>placeholder<i}, yang disebut makro. Setelah lelang grup minat selesai, tetapi sebelum rendering, makro diganti dengan sel masing-masing. 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} Meluaskan ke Transparansi & String izin (TC) yang terkait dengan permintaan. Jika tingkat transparansi & String izin (TC) kosong atau tidak valid, makro ini tidak diperluas.

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

Materi iklan dengan makro ${GDPR_CONSENT_XXXX} dapat menjadi diblokir jika vendor yang terdaftar dalam GVL IAB terkait dengan ID GVL IAB yang Anda yang dimasukkan 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 dari 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() dan kemudian 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 dalam menguji Protected Audience API adalah mengidentifikasi dan mengurangi perbedaan tersebut.

Atribusi tayangan iklan 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 tingkat akun Batas anggaran harian pembelanjaan Protected Audience. 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: 0), meskipun permintaan bid tersebut memenuhi syarat 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 banyak bidding yang diajukan pembeli grup minat dalam lelang Protected Audience. Tujuan informasi berikut akan tersedia di 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. Kode status yang mungkin adalah didefinisikan 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 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 mengirim notifikasi masukan 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 (BidRequest.google_query_id dalam protokol Authorized Buyer, dan BidRequest.ext.google_query_id dalam protokol OpenRTB) yang dikirim pada Permintaan bid kontekstual yang mengaktifkan Protected Audience.
  • %%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(). Nilai adalah status materi iklan kode tersebut.

Berikut contoh URL statis yang mungkin diberikan bidder kepada Account Manager-nya:

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.

TURTLEDOVE tingkat produk

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

Orientasi

Berikut ini cara menguji Protected Audience API:

Langkah

  1. Isi formulir permintaan untuk bergabung dengan eksperimen Protected Audience API.
  2. Setelah mengirimkan formulir permintaan, hubungi Account Manager atau file Anda tiket menggunakan Bantuan Authorized Buyer Google.
  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.
  • Implementasikan generateBid() dan reportWin().
  • Pilih asal pemilik grup minat dan tambahkan ke Authorized Buyer menggunakan akun layanan.
    • 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.
  • Menyiapkan Pra-penargetan untuk inventaris yang relevan dengan Protected Audience API pengujian.
  • Kirim materi iklan untuk ditinjau dan disetujui melalui Materi iklan Google Cloud Platform.
  • (Opsional) Siapkan endpoint sinyal bidding tepercaya.
  • (Opsional) Siapkan halaman pengiklan uji coba yang memungkinkan engineer Google menambahkan browser mereka ke grup minat yang dimiliki oleh pembeli grup minat Anda tempat asal. Tindakan ini memungkinkan kita 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 Platform.
  4. Gunakan halaman pengiklan yang disediakan bidder untuk menambahkan browser ke milik bidder grup minat tertentu.

  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. Verifikasi 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 dari bid.
      • accepted: Kolom ini bernilai 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 untuk berpartisipasi dalam lelang Protected Audience, Google memungkinkan partner 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 kami menguji integrasi dalam skala besar.

Hubungi Account Manager Anda atau ajukan tiket melalui Authorized Buyer 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 memungkinkan partner untuk merender Iklan pemenang audiens. Google memiliki sejumlah kecil traffic di mana Lelang audiens memenuhi syarat untuk dijalankan, dan iklan grup minat yang menang dirender. Bidder yang berpartisipasi bid dalam browser bersaing dengan maksimum.

Hubungi Account Manager Anda atau ajukan tiket melalui Authorized Buyer Pusat Bantuan 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 grup minat kelayakan dan dukungan pembeli 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 alir

Kelayakan pembeli grup minat di perangkat

Untuk lelang paralel, panggilan navigator.runAdAuction terjadi sebelum respons iklan kontekstual ditampilkan. Untuk memulai proses kepercayaan 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. Sejak 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. Sebagai gantinya, tag penayang Google menyimpan cache, di browser pengguna, parameter interestGroupBuyers dari navigator.runAdAuction dieksekusi 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 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 minimal satu pembeli untuk bidder mana pun di-cache untuk penayang saat ini domain, 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 asal pembeli tertentu tidak ada di cache, maka pembeli tersebut tidak dapat ditambahkan ke cache di perangkat saat ini lelang. Hal ini ditunjukkan oleh permintaan dengan parallelized=True yang tidak memiliki ParallelAuctionBuyer entri 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 untuk permintaan yang diparalelkan berikutnya dari browser dan domain yang sama. Rencana 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

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