Mengonfigurasi Integrasi Bidding Terbuka

Bidding Terbuka memungkinkan bursa dan pembeli lainnya 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 Anda 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 melakukan penskalaan. Setelah Anda keluar dari mode privasi, 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

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

Menangani permintaan bid yang masuk

Bidding Terbuka menggunakan struktur BidRequest yang sama dengan Pembeli Resmi, 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 Authorized 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 khusus 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 dikenai biaya.

Penyelesaian selisih permintaan Google (Beta)

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

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

Menyebarkan google_query_id dalam permintaan bid

Untuk memastikan jumlah tayangan valid cocok di seluruh permintaan Google, google_query_id harus dipropagasi apa adanya dari permintaan Bidding Terbuka ke platform permintaan Google. Ini adalah prasyarat untuk penyelesaian selisih Bidding Terbuka. Panjang google_query_id yang diperkirakan saat ini adalah sekitar 64 byte.

Menyebarkan third_party_buyer_token dalam respons bid

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

Teruskan markup materi iklan Google sebagaimana adanya dalam respons bid

Untuk memastikan bahwa penyelesaian perbedaan berlaku untuk bid dari permintaan Google, bursa harus menyebarkan markup materi iklan Google tanpa wrapper apa pun (tag skrip, iframe, atau wrapper VAST). Karena penyelesaian perbedaan, Google dapat membatalkan dan tidak menagih tayangan iklan Open Bidding 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 lain.

Materi iklan HTML5

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

Google tidak dapat menerapkan penyelesaian selisih jika bursa membungkus materi iklan HTML Google ke dalam tag (script, iframe, atau teknik lainnya) yang selanjutnya memuat atau merender kode HTML Google.

Memenuhi persyaratan teknis

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

<!-- 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 kata demi kata dalam respons bid. Kode HTML yang disediakan Google dapat dirender oleh kode 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 diwajibkan untuk menggunakan salah satu pendekatan berikut untuk mengisi VASTTagURI dalam respons XML VAST:

1. Pertukaran dapat mempertahankan nilai elemen VASTTagURI sebagai bagian dari dokumen XML VAST yang ditampilkan oleh Google di kolom BidResponse.seatbid.bid.adm apa adanya, dengan perluasan makro khusus pertukaran 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 yang diperluas secara normal sesuai kebutuhan.

Jika perlu, bursa dapat menentukan peristiwa VAST dan pelacak error tambahan dalam dokumen XML VAST.

Memenuhi persyaratan teknis

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

<!-- 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 kata demi kata dalam respons bid, dan sebagai gantinya, kode 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?…) saat 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 penawaran diperlakukan dalam lelang. Nilai yang mungkin 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 kecocokan yang dihosting Google, peserta Bidding Terbuka dapat menggunakan salah satu opsi di bawah yang paling sesuai dengan kebutuhan mereka:

• Pencocokan Cookie: Pencocokan yang dimulai pembeli atau bursa Pelajari lebih lanjut.
• Pencocokan Pixel: Pencocokan yang dimulai Google Pelajari lebih lanjut.
• Bantuan Pencocokan Cookie: Pencocokan yang dimulai penayang 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 tercantum dalam Panduan Peering untuk memperkirakan latensi yang akan dimiliki endpoint bidder Anda saat merespons permintaan bid masuk.

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

Ad Exchange besar yang menerima volume permintaan bid yang tinggi harus mempertimbangkan untuk membuat pengaturan peering dengan Google guna mengurangi latensi dan volatilitas latensi. Pelajari peering lebih lanjut.

Makro klik

Sebaiknya Anda menerapkan makro klik. Hal ini akan memungkinkan pelaporan yang mencakup klik dan metrik yang berasal dari klik untuk akun Anda dan untuk penayang yang bekerja sama dengan Anda. Pelajari lebih lanjut.

API

Pelanggan Bidding Terbuka dapat menggunakan REST API Authorized Buyers 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 Manajer Akun Teknis untuk mengonfigurasi akun Anda agar dapat mengakses API ini, dan untuk mengambil ID akun yang diperlukan untuk melakukan panggilan API. Untuk mendapatkan dukungan teknis dalam menggunakan API ini, Anda dapat menghubungi alias dukungan [e-mail].

Referensi lainnya

• Praktik terbaik untuk mengelola koneksi
• Menggunakan makro URL bid
• Mendekripsi 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 dalam panduan Permintaan dan Respons.