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, konfigurasi integrasi bidding real-time yang disesuaikan untuk kasus penggunaan Bidding Terbuka Anda, dan kirim endpoint bidding ke Account Manager Google Anda untuk diuji guna memverifikasi bahwa integrasi berfungsi dengan benar. Proses ini hanya dilakukan satu kali.

Membatasi integrasi Anda ke penayang tertentu

Integrasi Bidding Terbuka Anda dapat tetap berada 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 sampai siap melakukan penskalaan. Setelah Anda keluar dari mode pribadi, akun Anda akan terlihat oleh semua penayang.

Protokol dan encoding yang didukung

Bidding Terbuka menggunakan protokol RTB bidding real-time OpenRTB dan Authorized Buyers eksklusif. Pelajari lebih lanjut.

Penerapan Google OpenRTB

Penerapan OpenRTB Google tidak mendukung semua fitur yang ditemukan dalam spesifikasi OpenRTB, dan menambahkan ekstensi untuk fungsi khusus Authorized Buyers dan Bidding Terbuka. Untuk mempelajari lebih lanjut penerapan OpenRTB Google, dan kaitannya dengan protokol Bidding Real-time Authorized Buyers milik eksklusif, lihat Panduan OpenRTB.

Menangani permintaan bid yang masuk

Bidding Terbuka menggunakan struktur BidRequest yang sama dengan Authorized Buyers, 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.

Respons 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 respons.

Catatan: Permintaan bid yang dikirim ke peserta Bidding Terbuka akan menerima respons dalam 300 hingga 1.000 milidetik, bergantung pada format inventaris. Agar dapat menentukan persyaratan khusus untuk permintaan tertentu, periksa kolom BidRequest.tmax.

Bergantung pada format iklan pilihan yang ingin Anda gunakan untuk melakukan bidding, struktur respons dapat berbeda secara signifikan. Tinjau panduan berikut untuk membantu Anda mengonfigurasi aplikasi bidder agar merespons 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 impression_tracking_url opsional untuk mengambil data tingkat tayangan saat Google mencatat peristiwa yang dapat ditagih kepada Anda. Untuk OpenRTB, hal ini ditampilkan sebagai BidResponse.seatbid[].bid[].ext.impression_tracking_url, dan sebagai BidResponse.ad[].impression_tracking_url dalam protokol Google.

Resolusi perbedaan permintaan Google (Beta)

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

Dengan mengidentifikasi secara akurat tayangan DV360 yang ditayangkan oleh Bidding Terbuka, 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 valid cocok di seluruh permintaan Google, google_query_id harus disebarkan sebagaimana adanya dari permintaan Bidding Terbuka ke platform permintaan Google. Hal ini adalah prasyarat untuk penyelesaian perbedaan Bidding Terbuka. Panjang yang diharapkan saat ini dari google_query_id adalah sekitar 64 byte.

Menerapkan third_party_buyer_token dalam respons bid

Jika platform permintaan Google memenangkan lelang internal bursa, kolom third_party_buyer_token harus disebarkan sebagaimana adanya dalam respons bid 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 saat ini diperkirakan 150 byte.

Meneruskan markup materi iklan Google sebagaimana adanya dalam respons bid

Untuk memastikan bahwa penyelesaian perbedaan berlaku untuk bid dari permintaan Google, bursa diwajibkan untuk menyebarkan markup materi iklan Google tanpa wrapper apa pun (tag skrip, iframe, atau kode wrapper VAST). Karena adanya perbedaan, Google dapat membatalkan validasi dan tidak mengirimkan invoice untuk 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 diajukan atas nama permintaan Google, dan bukan pembeli lain.

Materi iklan HTML5

Bursa diwajibkan untuk mengirimkan markup HTML Google sebagaimana 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 penyelesaian 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 kata demi kata, diawali dan ditambahkan 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 disediakan oleh bursa dan tidak muncul kata demi kata 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 adm sebagaimana adanya, dengan perluasan makro khusus bursa yang biasanya berlaku.
2. DV360 dapat mengisi kolom nurl dengan URL dokumen VAST dalam respons bid ke bursa. Kemudian, bursa dapat meneruskan nilai nurl yang akan direspons oleh Google (DV360) dalam tag VASTTagURI, dengan makro khusus bursa yang diperluas secara normal sesuai kebutuhan.

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

Memenuhi persyaratan teknis

Dalam contoh ini, URI VAST materi iklan Google (DV360) dari respons bid diteruskan kata demi kata, dengan bursa menambahkan peristiwa VAST dan pelacak error 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 VAST atau URI materi iklan yang ditampilkan oleh Google tidak muncul kata demi kata dalam respons bid, dan sebagai gantinya, wrapper VAST khusus bursa digunakan. Kode VAST yang disediakan Google dapat dimuat oleh wrapper VAST yang disediakan oleh 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
Protokol OpenRTB: BidResponse.seatbid[].bid[].dealid Protokol Google: BidResponse.ad[].adslot[].exchange_deal_id	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.
Protokol OpenRTB: BidResponse.seatbid[].bid[].ext.exchange_deal_type Protokol Google: BidResponse.ad[].adslot[].exchange_deal_type	Enum yang menentukan jenis transaksi. Informasi ini dilaporkan kepada penayang dan memengaruhi cara transaksi 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.

Contoh di bawah menggunakan kolom OpenRTB untuk PD/PA (dealid, exchange_deal_type); jika menggunakan protokol Authorized Buyers, kolom respons bid untuk PD/PA akan menjadi exchange_deal_id dan exchange_deal_type.

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, peserta Bidding Terbuka dapat menggunakan salah satu opsi di bawah ini yang paling sesuai dengan kebutuhan mereka:

• Pencocokan Cookie: Pencocokan yang dimulai oleh pembeli atau bursa Pelajari lebih lanjut.
• Pencocokan Piksel: Pencocokan yang dimulai Google Pelajari lebih lanjut.
• Bantuan Pencocokan Cookie: Pencocokan yang dimulai Exchange dengan bidder mereka Pelajari lebih lanjut.

Catatan: Saat ini, peserta Bidding Terbuka tidak dapat membuat, mengisi, atau menargetkan daftar pengguna.

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.

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

Bursa besar yang menerima volume permintaan bid yang tinggi harus mempertimbangkan untuk menyepakati kesepakatan peering dengan Google untuk mengurangi latensi dan ketidakstabilan latensi. Pelajari peering lebih lanjut.

Makro klik

Sebaiknya Anda menerapkan 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 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 guna mengonfigurasi akun untuk 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
• Mendekripsi konfirmasi harga jika Anda menggunakan makro WINNING_PRICE
• Rekomendasi dan praktik terbaik pengujian

Contoh permintaan dan respons bid

Contoh permintaan bid dan respons untuk semua protokol yang didukung dapat ditemukan dalam panduan Request dan Respons.