Panduan Integrasi dan Pengujian Protected Audience (sebelumnya dikenal sebagai FLEDGE) untuk SSP

Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Audiens yang Dilindungi API, API dalam browser yang memungkinkan pengiklan dan perusahaan teknologi iklan menyeleksi dan menargetkan grup minat (daftar audiens) tanpa mengandalkan cookie pihak ketiga, sekaligus melindungi pengguna dari pelacakan lintas situs. Pengembang kami

SSP dapat menguji Protected Audience API dengan Display & Video 360 dan Google Ads ke:

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

Panduan berikut menjelaskan detail integrasi antara SSP dan kampanye Display & Video 360 dan Google Ads. SSP yang tertarik untuk mengoordinasikan pengujian harus masuk kontak dengan Display & Perwakilan Kemitraan Video 360.

Pendaftaran

SSP harus mendaftar mereka sendiri untuk menggunakan Protected Audience API.

Ringkasan alur penayangan

Diagram berikut menunjukkan alur umum yang menguraikan titik interaksi utama antara Chrome, SSP, Display & Video 360 dan Google Ads.

Opsi integrasi

Opsi 1: Penjual Langsung / Penjual tunggal

Langkah-langkah:

1. Tag iklan SSP mengirimkan permintaan iklan ke server SSP yang menunjukkan bahwa browser mendukung Protected Audience API.
2. Server SSP mengirim permintaan bid OpenRTB kontekstual ke DSP yang menunjukkan bahwa browser mendukung Protected Audience API
3. DSP merespons dengan respons bid OpenRTB yang berisi sinyal untuk lelang di perangkat.
4. Server SSP mengirim respons iklan dengan konfigurasi lelang ke tag iklan SSP.
5. Tag iklan SSP memulai lelang di perangkat dengan memanggil runAdAuction(), meneruskan sinyal dari respons bid openRTB DSP melalui perBuyerSignals.
6. Chrome memanggil server bidding DSP tepercaya Kunci/Nilai untuk mengambil sinyal bidding real-time.
7. Chrome memanggil generateBid() Fungsi JavaScript DSP untuk setiap grup minat yang berpartisipasi.
8. Chrome memanggil server penskoran SSP tepercaya/Nilai Kunci/Nilai untuk mengambil sinyal penskoran real-time.
9. Chrome memanggil scoreAd() SSP JavaScript untuk setiap grup minat yang berpartisipasi.
10. Chrome memanggil reportWin() Fungsi JavaScript DSP untuk melaporkan pemenang ke DSP.
11. Chrome memanggil reportResult() SSP JavaScript berfungsi untuk melaporkan pemenang ke SSP.

Perubahan minimum di sisi SSP

• Tag iklan SSP perlu diperbarui menjadi

  • mendeteksi apakah browser mendukung Protected Audience API
  • kirimkan informasi tersebut sebagai bagian dari permintaan iklan ke server SSP [1]
  • memulai lelang di perangkat dengan memanggil runAdAuction() yang meneruskan sinyal dari respons bid OpenRTB DSP [5] (lihat kolom data pembeli di permintaan bid dan struktur respons di bawah).

• Server SSP perlu

  • menyebarkan informasi tentang dukungan Protected Audience API ke DSP melalui kolom di permintaan bid OpenRTB [2] (lihat bagian tentang bid struktur permintaan dan respons di bawah).
  • menyebarkan sinyal pembeli DSP dalam respons bid OpenRTB ke iklan SSP tag (lihat bagian tentang permintaan bid / struktur respons bid di bawah) [4]

• [Optional] SSP harus menerapkan server SSP Tepercaya untuk mengambil data real time sinyal penskoran untuk mendukung pemeriksaan kualitas iklan, penerapan setelan penayang [8]

• SSP perlu menerapkan JavaScript dengan "scoreAd(...)" dan "reportResult(...)" fungsi [9], [11]

Opsi 2: Multi-penjual

Langkah-langkah:

1. Adaptor SSP mengirim permintaan iklan ke server SSP yang menunjukkan bahwa browser mendukung Protected Audience API.
2. Server SSP mengirim permintaan bid OpenRTB kontekstual ke DSP yang menunjukkan bahwa browser mendukung Protected Audience API,
3. Server DSP merespons dengan respons bid openRTB yang berisi sinyal untuk lelang di perangkat.
4. Server SSP mengirim respons iklan dengan konfigurasi lelang ke tag iklan SSP.
5. Adaptor Prebid SSP menyediakan konfigurasi lelang komponen ke Server Iklan Penayang .
6. Tag Server Iklan Penayang mengirim permintaan iklan ke server Server Iklan Penayang.
7. Tag Server Iklan Penayang memulai lelang di perangkat dengan memanggil runAdAuction(...) Compute Engine API.
8. Chrome memanggil server bidding DSP tepercaya Kunci/Nilai untuk mengambil sinyal bidding real-time.
9. Chrome memanggil generateBid() Fungsi JavaScript DSP untuk setiap grup minat yang berpartisipasi.
10. Chrome memanggil server penskoran SSP tepercaya/Nilai Kunci/Nilai untuk mengambil sinyal penskoran real-time.
11. Chrome memanggil scoreAd() SSP JavaScript untuk setiap grup minat yang berpartisipasi.
12. Chrome memanggil reportWin() Fungsi JavaScript DSP untuk melaporkan pemenang ke DSP.
13. Chrome memanggil reportResult() SSP JavaScript berfungsi untuk melaporkan pemenang ke SSP.

Perubahan minimum di sisi SSP

• Adaptor SSP perlu diupdate ke

  • mendeteksi apakah browser mendukung Protected Audience
  • kirimkan informasi tersebut sebagai bagian dari permintaan iklan ke server SSP [1]
  • menyediakan konfigurasi lelang komponen ke tag iklan Server Iklan Penayang [5].
  • Jika Google Ad Manager adalah server iklan penayang, SSP dapat * Menggunakan Protected Audience prebid modul ini * Panggil tag iklan setConfig() Google Ad Manager API dengan beberapa penjual

• Server SSP perlu

  • menyebarkan informasi tentang dukungan Protected Audience ke DSP melalui kolom di permintaan bid OpenRTB [2] (lihat bagian tentang bid struktur permintaan dan respons di bawah).
  • menyebarkan sinyal pembeli DSP dalam respons bid OpenRTB ke iklan SSP tag (lihat bagian tentang permintaan bid / struktur respons bid di bawah) [4]

• [Optional] SSP harus menerapkan server SSP Tepercaya untuk mengambil data real time sinyal penskoran untuk mendukung pemeriksaan kualitas iklan, penerapan setelan penayang [10]

• SSP perlu mengekspos JavaScript dengan scoreAd() dan reportResult() fungsi [11], [14].

Layanan Bidding dan Lelang

Kami sedang mengevaluasi Bidding & Layanan Lelang (B&A) proposal

Kapan Display & Video 360 siap menguji Protected Audience API dengan B&A, kami akan menghubungi Anda untuk memberikan detail selengkapnya.

Protokol OpenRTB

Permintaan bid

Untuk membedakan antara peluang tayangan iklan yang mendukung fitur Protected Lelang di perangkat Audience API dari yang hanya mendukung lelang bursa sisi server, kolom enum baru yang disebut ae untuk "lelang lingkungan" harus ditambahkan sebagai ekstensi ke objek Imp di OpenRTB permintaan bid untuk menentukan lingkungan lelang yang didukung oleh slot tayangan iklan. Enum ae dapat memiliki nilai berikut:

• 0: Lelang sisi server standar
• 1: Permintaan dengan dukungan Protected Audience API, dengan konteks lelang berjalan di server bursa dan grup minat, serta lelang akhir akan berjalan di browser

{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

Respons bid

Selain bid kontekstual, respons bid juga digunakan untuk meneruskan informasi yang relevan dengan kampanye Display & Partisipasi Video 360 dan Google Ads dalam Lelang grup minat Protected Audience API. Respons bid diperbarui menjadi mendukung lelang grup minat sebagai berikut:

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

Skenario berikut didukung.

• SKENARIO 1: Display & Video 360 dan Google Ads hanya ingin berpartisipasi dalam lelang kontekstual. Dalam skenario ini, kolom igbid tidak ada.

• SKENARIO 2: Display & Video 360 dan Google Ads hanya ingin berpartisipasi di lelang grup minat. Dalam skenario ini, Display & Video 360 dan Google Ads akan menghapus kolom seatbid dalam respons bid dan hanya akan menampilkan informasi igbid. Dengan kata lain, keberadaan isian igbid menunjukkan fakta bahwa kampanye Display & Video 360 dan Google Ads menginginkan grup minatnya untuk berpartisipasi dalam lelang di perangkat.

• SKENARIO 3: Display & Video 360 dan Google Ads ingin berpartisipasi dalam lelang grup minat dan kontekstual. Dalam skenario ini, Display & Video 360 dan Google Ads akan menampilkan kedua kolom seatbid dalam respons bid dan informasi igbid.

Metadata dengan Bid Iklan

Protected Audience API memungkinkan passing arbitrary metadata tentang iklan dari fungsi generateBid().

Layar & Video 360 berencana untuk mengandalkan hal-hal berikut specification untuk metadata iklan: Protected Audience API dan OpenRTB.

Yaitu Display & Video 360 akan menampilkan kolom berikut sebagai bagian dari iklan :

Contoh

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

Pelaporan Peristiwa

Protected Audience API menyediakan Reporting API tingkat peristiwa yang dijelaskan dalam Postingan GitHub: Fenced Frame Ads Reporting. Meskipun namanya menyatakan bahwa Fenced Frame Ads Reporting API tersedia di baik frame dengan fence maupun iframe (lihat detail here).

SSP dapat mendaftarkan URL ke browser dalam fungsi reportResult dengan memanggil registerAdBeacon() Compute Engine API.

Layar & Video 360 akan memanggil reportEvent() API dengan 'component-seller' tujuan dari dalam materi iklan untuk melaporkan tayangan iklan dan peristiwa klik. Itu akan menyebabkan beacon dikirim ke URL terdaftar.

Perhatikan bahwa Display & Video 360 akan memanggil reportEvent() API untuk tayangan iklan dan klik dengan data postingan kosong.

Contoh

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

Label pengujian penghentian penggunaan cookie

Layar & Video 360 akan berpartisipasi dalam Chrome-facilitated testing penghentian penggunaan cookie pihak ketiga. Agar dapat melakukan pengujian, kami meminta partner untuk meneruskan label Chrome pada permintaan bid OpenRTB sesuai dengan specification:

Objek: Device.ext

Dokumen terkait

• Protected Audience API di Developer Chrome
• Eksperimen Pertama di GitHub