Protected Audience API (sebelumnya FLEDGE)

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

Chrome 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:

Diagram alir

  1. Bidder bekerja sama dengan pengiklannya untuk mempertahankan grup minat untuk setiap pengiklan. Sering kali, pengiklan akan menambahkan tag bidder ke halaman pengiklan untuk menambahkan browser ke grup minat.
  2. Pengguna akhir mengunjungi halaman pengiklan. Halaman mungkin berisi tag 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 informasi selengkapnya.
  7. Bidder menampilkan BidResponse dengan kolom interest_group_bidding. Jika bidder tidak menentukan interest_group_bidding, Google tidak akan menyertakan asal bidder di interestGroupBuyers dalam konfigurasi lelang. 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 bagian 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 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 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 menampilkan interest_group_bidding sebagai interestGroupBuyers dalam konfigurasi lelang.
  11. Google meneruskan setiap per_buyer_signals bidder yang memenuhi syarat ke konfigurasi lelang Protected Audience.
  12. Jika grup minat bidder tertentu menentukan trustedBiddingSignalsUrl, browser akan membuat permintaan ke trustedBiddingSignalsUrl setiap grup untuk mengambil sinyal real-time untuk setiap grup. Lihat detailnya di spesifikasi Protected Audience API.
  13. Browser memanggil generateBid() bidder untuk setiap grup minat yang memilih ikut serta dan memenuhi syarat untuk berpartisipasi dalam lelang dalam browser. Langkah ini akan menghitung bid dan memilih materi iklan. generateBid() memiliki akses ke per_buyer_signals yang disediakan oleh bidder dan sinyal bidding tepercaya untuk grup minat tertentu.
  14. 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.
  15. Browser menjalankan lelang dengan bid grup minat yang memenuhi syarat. Bid kontekstual dengan peringkat 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 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 dengan renderUrl 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. 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 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 tradisional
  • ON_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.widthdan 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.

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
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: Kosong
  • perBuyerSignals: 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: 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 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.dsaadrenderuntuk 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 XXXX dengan ID GVL IAB dari vendor yang terdaftar dalam 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 yang terdaftar dalam GVL IAB yang terkait dengan ID GVL IAB yang Anda sisipkan tidak memiliki izin pengguna.

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.

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, dan BidRequest.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 fungsi generateBid().
  • %%RENDER_URL%%: URL render materi iklan.
  • %%STATUS%%: Kode status jika bid ditolak dalam scoreAd(). 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.

Peristiwa klik

Bidder dapat melaporkan peristiwa klik pada iklan Protected Audience ke Google menggunakan Fenced Frame Reporting API. Bidder harus menggunakan jenis peristiwa click untuk memberi tahu Google tentang klik. Berikut contohnya:

window.fence.reportEvent({
    'eventType': 'click',
    // Google does not require bidders to send data to Google in 'eventData'.
    // However, 'eventData' must be a non-null value, such as an empty string.
    'eventData': '',
    'destinations': ['direct-seller']
});

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

  1. Isi formulir permintaan untuk bergabung dengan eksperimen Protected Audience API.
  2. Setelah Anda mengirimkan formulir permintaan, hubungi Account Manager Anda atau ajukan tiket menggunakan Pusat Bantuan Authorized Buyer.
  3. 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 di renderUrl untuk penampung iklan komponen (juga disebut renderUrl tingkat atas) untuk membedakan renderUrls 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() dan reportWin().
  • 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.
  • 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:

  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 sandbox privasi.
  3. Kirim materi iklan untuk mendapatkan persetujuan menggunakan API Bidding Real-time.
  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 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.

  6. Pastikan beberapa hal berikut:

    1. Iklan pemenang yang diharapkan dirender.
    2. Hasil lelang dikirim sisi server—yang berarti bidder yang menang menerima ping kembali dari reportWin().
    3. 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 bernilai 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 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.