Mengonfigurasi Integrasi Bidding Terbuka

Bidding Terbuka memungkinkan bursa dan pembeli lain memanfaatkan infrastruktur bidding real-time Google untuk mengajukan bid pada inventaris Google Ad Manager dan AdMob.

Untuk berpartisipasi dalam Bidding Terbuka, konfigurasikan integrasi bidding real-time yang disesuaikan untuk kasus penggunaan Bidding Terbuka Anda, dan kirim endpoint bidder ke Account Manager Google Anda untuk pengujian guna memverifikasi bahwa integrasi berfungsi dengan benar. Proses ini hanya dilakukan satu kali.

Membatasi integrasi Anda untuk penerbit tertentu

Integrasi Bidding Terbuka dapat tetap dalam "mode pribadi" hingga Anda siap menerima permintaan dari penayang mana pun. Saat dalam mode pribadi, Anda dapat bekerja sama dengan tim akun untuk terhubung dengan penayang tertentu dan tetap dalam status ini hingga Anda siap untuk melakukan penskalaan. Setelah Anda keluar dari mode pribadi, akun Anda akan terlihat oleh semua penayang.

Protokol dan encoding yang didukung

Anda dapat menggunakan OpenRTB dalam format JSON atau Protobuf. Pelajari lebih lanjut.

Penerapan OpenRTB Google

Penerapan OpenRTB Google tidak mendukung semua fitur yang ditemukan dalam spesifikasi OpenRTB, dan menambahkan ekstensi untuk Authorized Buyers dan fungsi khusus Bidding Terbuka. Untuk mempelajari lebih lanjut, lihat Panduan OpenRTB.

Menangani permintaan bid yang masuk

Bidding Terbuka menggunakan struktur BidRequest yang sama dengan Authorized Buyers, tetapi beberapa kolom dikirim secara eksklusif kepada peserta Bidding Terbuka. Lihat Panduan Permintaan untuk mempelajari lebih lanjut kolom khusus Bidding Terbuka yang dikirim dalam permintaan bid.

Merespons dengan Bid

Bidding Terbuka juga menggunakan struktur BidResponse yang mirip dengan Authorised Buyers, dengan beberapa kolom eksklusif yang dikirim ke peserta Bidding Terbuka. Lihat Panduan Respons untuk mempelajari lebih lanjut kolom khusus Bidding Terbuka yang dapat Anda gunakan untuk merespons.

Catatan: Permintaan bid yang dikirim ke peserta Bidding Terbuka harus menerima respons dalam waktu 300 hingga 1.000 md, bergantung pada format inventaris. Untuk menentukan persyaratan spesifik untuk permintaan tertentu, periksa kolom BidRequest.tmax.

Bergantung pada format iklan pilihan yang ingin Anda gunakan untuk mengajukan bid, struktur respons dapat berbeda secara signifikan. Tinjau panduan berikut untuk membantu Anda mengonfigurasi aplikasi bidder agar merespons dengan bid untuk format iklan umum:

• Iklan interstisial
• Iklan video
• Iklan Video OpenRTB
• Iklan native
• Iklan Video Native
• Iklan SDK Pembeli

Melacak tayangan untuk mengurangi perbedaan

Sebaiknya gunakan kolom BidResponse.seatbid.bid.ext.impression_tracking_url opsional untuk mengambil data tingkat tayangan tentang kapan Google mencatat peristiwa yang dapat ditagih yang akan ditagih kepada Anda.

Resolusi selisih permintaan Google (Beta)

Fitur ini bertujuan untuk memastikan bahwa jumlah tayangan iklan yang ditagih oleh bursa sesuai dengan jumlah tayangan iklan yang dibayar oleh Google Display & Video 360 (DV360).

Dengan mengidentifikasi tayangan DV360 yang ditayangkan oleh Bidding Terbuka secara akurat, Google dapat menyesuaikan spam iklan dan perbedaan peristiwa yang dapat ditagih untuk memastikan Anda tidak ditagih untuk tayangan yang tidak dibayar.

Memperluas google_query_id dalam permintaan bid

Untuk memastikan bahwa jumlah tayangan yang valid cocok di seluruh permintaan Google, google_query_id harus disebarkan apa adanya dari permintaan Bidding Terbuka ke platform permintaan Google. Hal ini merupakan prasyarat untuk resolusi selisih Bidding Terbuka. Perkiraan panjang google_query_id saat ini adalah sekitar 64 byte.

Memperluas third_party_buyer_token dalam respons bid

Jika platform permintaan Google memenangkan lelang internal bursa, kolom third_party_buyer_token harus disebarkan apa adanya dalam respons bid kembali melalui tayangan Bidding Terbuka. Hal ini memungkinkan platform penayang Google menetapkan bahwa bid pemenang dari partner Bidding Terbuka adalah bid atas nama permintaan Google untuk peluang tayangan yang sama. Panjang maksimum kolom ini saat ini diperkirakan 150 byte.

Teruskan markup materi iklan Google apa adanya dalam respons bid

Untuk memastikan bahwa resolusi perbedaan berlaku untuk bid dari permintaan Google, bursa diwajibkan untuk menyebarkan markup materi iklan Google tanpa wrapper apa pun (tag skrip, iframe, atau wrapper VAST). Karena resolusi perbedaan, Google dapat membatalkan validasi dan tidak menagih tayangan Bidding Terbuka yang tidak dihitung oleh platform permintaan Google. Google akan memeriksa markup materi iklan secara berkala untuk mengonfirmasi bahwa bid dengan third_party_buyer_token dikirimkan atas nama permintaan Google, dan bukan pembeli lainnya.

Materi iklan HTML5

Bursa diwajibkan untuk mengirimkan markup HTML Google apa adanya, dengan ekspansi makro khusus bursa yang biasanya berlaku, dan, secara opsional, piksel atau skrip pelacak tambahan yang biasanya ditambahkan oleh bursa.

Google tidak dapat menerapkan resolusi perbedaan jika bursa menggabungkan materi iklan HTML Google ke dalam tag (script, iframe, atau teknik lainnya) yang kemudian memuat atau merender kode HTML Google.

Memenuhi persyaratan teknis

Dalam contoh ini, kode HTML materi iklan Google (DV360) dari respons bid diteruskan secara verbatim, ditambahkan di awal dan di akhir dengan kode HTML khusus bursa.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

Tidak memenuhi persyaratan teknis

Dalam contoh ini, kode HTML materi iklan yang ditampilkan oleh Google di-obfuscate dalam respons bid yang diberikan oleh bursa dan tidak muncul secara verbatim dalam respons bid. Kode HTML yang disediakan Google dapat dirender oleh wrapper yang disediakan bursa di browser.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

Materi iklan video VAST

Agar memenuhi syarat untuk penyelesaian perbedaan, bursa harus menggunakan salah satu pendekatan berikut untuk mengisi VASTTagURI dalam respons XML VAST:

1. Bursa dapat mempertahankan nilai elemen VASTTagURI sebagai bagian dari dokumen XML VAST yang ditampilkan oleh Google di kolom BidResponse.seatbid.bid.adm sebagaimana adanya, dengan ekspansi makro khusus bursa yang biasanya berlaku.
2. DV360 dapat mengisi kolom BidResponse.seatbid.bid.adm.nurl dengan URL dokumen VAST dalam respons bid ke bursa. Kemudian, bursa dapat meneruskan nilai tersebut dengan tag VASTTagURI, dengan makro khusus bursa diperluas secara normal sesuai kebutuhan.

Bursa dapat menentukan pelacak peristiwa dan error VAST tambahan dalam dokumen XML VAST jika diperlukan.

Memenuhi persyaratan teknis

Dalam contoh ini, URI VAST materi iklan Google (DV360) dari respons bid diteruskan secara verbatim, dengan bursa menambahkan pelacak error dan peristiwa VAST tertentu.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

Tidak memenuhi persyaratan teknis

Dalam contoh ini, kode atau URI VAST materi iklan yang ditampilkan oleh Google tidak muncul secara verbatim dalam respons bid, dan sebagai gantinya, pembungkus VAST khusus bursa digunakan. Kode VAST yang disediakan Google dapat dimuat oleh wrapper VAST yang disediakan bursa (seperti yang ditentukan dalam elemen VASTAdTagURI, https://video.exchange.example.com/creative?…) setelah SDK memuat iklan.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

Promo

Bursa yang berpartisipasi dalam Bidding Terbuka dapat menggunakan Transaksi Pilihan (PD), Lelang Pribadi (PA) dengan Bidding Terbuka. ID dan jenis transaksi harus ditentukan sebagai berikut:

Kolom	Deskripsi
BidResponse.seatbid.bid.dealid	ID transaksi dari namespace bursa yang terkait dengan bid dan dilaporkan kepada penayang. Ini adalah teks UTF8 arbitrer dan tidak boleh lebih dari 64 byte.
BidResponse.seatbid.bid.ext.exchange_deal_type	Enum yang menentukan jenis transaksi. Hal ini dilaporkan kepada penayang dan memengaruhi cara perlakuan kesepakatan dalam lelang. Kemungkinan nilainya adalah: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Berikut adalah contoh respons bid untuk PD/PA.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Pencocokan cookie

Untuk mengisi tabel pencocokan yang dihosting Google, partisipan Bidding Terbuka dapat menggunakan salah satu opsi di bawah yang paling sesuai dengan kebutuhan mereka:

• Pencocokan Cookie: Pencocokan yang diinisiasi pembeli atau bursa Pelajari lebih lanjut.
• Pencocokan Pixel: Pencocokan yang dimulai Google Pelajari lebih lanjut.
• Cookie Match Assist: Pencocokan yang dimulai bursa dengan bidder mereka Pelajari lebih lanjut.

Catatan: Peserta Bidding Terbuka saat ini tidak dapat membuat, mengisi, atau menargetkan daftar pengguna.

Mengelola latensi

Anda harus menggunakan lokasi perdagangan yang ditemukan di Panduan Peering untuk memperkirakan latensi yang akan dimiliki endpoint bidder saat merespons permintaan bid yang masuk.

Inventaris biasanya dikirim melalui lokasi perdagangan terdekat, tetapi hal ini tidak dijamin. Satu-satunya cara untuk menjamin akses ke semua tayangan adalah dengan memiliki endpoint bidder di semua lokasi perdagangan.

Bursa besar yang menerima permintaan bid dalam volume tinggi harus mempertimbangkan untuk membuat perjanjian peering dengan Google guna mengurangi latensi dan volatilitas latensi. Pelajari peering lebih lanjut.

Makro klik

Sebaiknya terapkan makro klik. Hal ini akan memungkinkan pelaporan yang menyertakan klik dan metrik turunan klik untuk akun Anda dan untuk penayang yang bekerja sama dengan Anda. Pelajari lebih lanjut.

API

Pelanggan Bidding Terbuka dapat menggunakan Authorized Buyers REST API untuk mengakses data yang mungkin berguna untuk tujuan pemecahan masalah. Saat ini, hanya resource API berikut yang dapat diakses:

• Laporan Performa v1.4
• Pemecahan Masalah RTB v2beta1

Anda dapat menghubungi Technical Account Manager untuk mengonfigurasi akun Anda agar dapat mengakses API ini, dan untuk mengambil ID akun yang diperlukan untuk melakukan panggilan API. Untuk dukungan teknis dalam menggunakan API ini, Anda dapat menghubungi alias dukungan [e-mail].

Referensi lainnya

• Praktik terbaik untuk mengelola koneksi
• Menggunakan makro URL bid
• Mendekode konfirmasi harga jika Anda menggunakan makro WINNING_PRICE
• Rekomendasi dan praktik terbaik pengujian

Contoh permintaan dan respons bid

Contoh permintaan dan respons bid untuk semua protokol yang didukung dapat ditemukan di panduan Permintaan dan Respons.