Mengonfigurasi Integrasi Bidding Terbuka

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

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

Membatasi integrasi Anda untuk penayang tertentu

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

Protokol dan encoding yang didukung

Sebaiknya gunakan implementasi OpenRTB Google. Protokol Google RTB tidak digunakan lagi. Pelajari lebih lanjut.

Implementasi Google OpenRTB

Implementasi OpenRTB Google tidak mendukung semua fitur yang ditemukan dalam Spesifikasi OpenRTB, dan menambahkan ekstensi untuk Authorized Buyers dan Fungsi khusus bidding. Untuk mempelajari lebih lanjut OpenRTB Google penerapan, dan hubungannya dengan Authorized Buyers eksklusif Protokol Bidding Real-time, lihat Panduan OpenRTB.

Menangani permintaan bid yang masuk

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

Tanggapi dengan Bid

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

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

Melacak tayangan untuk mengurangi perbedaan

Sangat disarankan agar Anda menggunakan impression_tracking_url opsional kolom untuk mengambil data tingkat tayangan tentang kapan Google mencatat tagihan peristiwa yang akan dikenakan biaya. Untuk OpenRTB, ini diekspos sebagai BidResponse.seatbid[].bid[].ext.impression_tracking_url, dan sebagai BidResponse.ad[].impression_tracking_url dalam dan berperforma tinggi karena merupakan protokol biner.

Penyelesaian perbedaan permintaan Google (Beta)

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

Dengan mengidentifikasi secara akurat tayangan 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 yang tidak Anda bayar.

Menerapkan google_query_id dalam permintaan bid

Untuk memastikan bahwa jumlah tayangan iklan valid di seluruh permintaan Google, google_query_id harus disebarkan sebagaimana adanya dari Permintaan Bidding Terbuka ke platform permintaan Google. Langkah ini adalah prasyarat untuk Penyelesaian perbedaan Bidding Terbuka. Perkiraan panjang google_query_id sekitar 64 byte.

Menerapkan third_party_buyer_token dalam respons bid

Jika platform permintaan Google memenangkan reward internal bursa lelang, kolom third_party_buyer_token harus disebarkan sebagaimana adanya di respons bid kembali melalui tayangan iklan Bidding Terbuka. Hal ini memungkinkan Platform penayang Google untuk menetapkan bahwa bid pemenang dari Partner bidding adalah bid atas nama permintaan Google untuk tayangan yang sama peluang. Panjang maksimum saat ini untuk kolom ini diperkirakan 150 {i>byte.<i}

Teruskan markup materi iklan Google sebagaimana adanya dalam respons bid

Untuk memastikan bahwa penyelesaian perbedaan berlaku untuk bid dari Permintaan Google, bursa diperlukan untuk menyebarkan markup materi iklan Google tanpa kode wrapper (tag skrip, iframe, atau wrapper VAST). Karena penyelesaian perbedaan, Google dapat membatalkan dan tidak membuat invoice untuk Tayangan bidding yang tidak dihitung oleh platform permintaan Google. Kebijakan Privasi akan memeriksa markup materi iklan secara berkala untuk mengonfirmasi bahwa bid dengan third_party_buyer_token dikirim atas nama permintaan Google, dan bukan pembeli lainnya.

Materi iklan HTML5

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

Google tidak dapat menerapkan penyelesaian perbedaan jika bursa menggabungkan Google Materi iklan HTML ke dalam tag (script, iframe, atau yang kemudian memuat atau merender kode HTML Google.

Dalam contoh ini, kode HTML materi iklan Google (DV360) dari respons bid diteruskan kata demi kata, ditambahkan, dan ditambahkan dengan HTML khusus bursa pada kode sumber.

<!-- 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 -->

Dalam contoh ini, kode HTML yang ditampilkan oleh Google materi iklan di-obfuscate dalam respons bid yang diberikan oleh bursa dan tidak tampak sama sekali respons bid. Kode HTML yang disediakan Google mungkin 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, penukaran diperlukan untuk gunakan salah satu pendekatan berikut untuk mengisi VASTTagURI di Respons XML VAST:

  1. Pertukaran dapat mempertahankan nilai elemen VASTTagURI sebagai bagian dari dokumen XML VAST yang ditampilkan oleh Google di kolom adm sebagaimana adanya, dengan perluasan makro khusus bursa yang biasanya berlaku.
  2. DV360 dapat mengisi kolom nurl dengan URL dokumen VAST di respons bid pada bursa. Pertukaran kemudian dapat meneruskan nilai nurl yang direspons Google (DV360) dalam VASTTagURI dengan makro khusus bursa diperluas secara normal sesuai kebutuhan.

Bursa dapat menentukan peristiwa VAST tambahan dan pelacak error dalam VAST Dokumen XML jika perlu.

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

<!-- 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 -->

Dalam contoh ini, kode VAST atau URI materi iklan yang ditampilkan oleh Google tidak muncul kata demi kata dalam respons bid, dan sebagai gantinya, digunakan kode wrapper VAST khusus bursa. Kode VAST yang disediakan Google dapat dimuat oleh wrapper VAST yang disediakan bursa (seperti yang ditentukan dalam VASTAdTagURI elemen, https://video.exchange.example.com/creative?…) pada 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
Protokol OpenRTB:
BidResponse.seatbid[].bid[].dealid

Protokol Google:
BidResponse.ad[].adslot[].exchange_deal_id		 ID transaksi dari namespace bursa terkait dengan bid dan dilaporkan kepada penayang. Ini adalah teks UTF8 arbitrer dan tidak boleh lebih dari 64 byte.
Protokol OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Protokol Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Enum yang menentukan jenis transaksi. Hal ini dilaporkan kepada penayang dan memengaruhi cara transaksi yang diperlakukan dalam lelang. Kemungkinan nilainya adalah:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Berikut adalah contoh respons bid OpenRTB 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"
    }
  }
}

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

Mengelola latensi

Sebaiknya gunakan lokasi perdagangan yang ada di Panduan Peering untuk memperkirakan latensi yang akan dimiliki endpoint bidder Anda saat merespons permintaan bid yang masuk.

Bursa besar yang menerima permintaan bid dalam jumlah besar harus mempertimbangkan menandatangani perjanjian peering dengan Google untuk mengurangi latensi dan latensi ketidakstabilan. Pelajari peering lebih lanjut.

Makro klik

Sebaiknya terapkan makro klik. Hal ini akan memungkinkan pelaporan yang mencakup klik dan metrik yang berasal dari klik untuk akun Anda dan penerbit 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. Hanya resource API berikut saat ini dapat diakses:

Anda dapat menghubungi Manajer Akun Teknis untuk mengonfigurasi akun Anda untuk mengakses API ini, dan mengambil ID akun yang diperlukan untuk membuat API panggilan telepon. Untuk dukungan teknis dalam menggunakan API ini, Anda dapat menghubungi alias dukungan adxbuyerapi-support@google.com.

Referensi lainnya

Contoh permintaan dan respons bid

Permintaan bid dan contoh respons untuk semua protokol yang didukung dapat ditemukan di Permintaan dan Respons kami.