Protos & Data Referensi

Lihat atau download file yang mendukung Protokol RTB.

Proto

File Deskripsi Versi Terakhir Diperbarui
cookie-bulk-upload.proto Gunakan pesan ini untuk mengupload data penargetan pengguna secara massal. v19 25 Agustus 2022
openrtb.proto Google mendukung protokol OpenRTB menggunakan encoding JSON atau Protobuf. Proto ini diperlukan jika Anda menggunakan OpenRTB/Protobuf. File ini juga mencakup dokumentasi kolom yang didukung dan pemetaannya ke protokol native Google. 2.6 31 Mei 2023
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v134 1 Juni 2023
publisher-settings.proto Kumpulan setelan penayang yang khusus untuk jaringan bidder real-time. v3 2 Feb 2023
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest menyertakan slot iklan dari satu tayangan. v2.276 1 Juni 2023

Proto Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v137 1 Juni 2023
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest menyertakan slot iklan dari satu tayangan. v2.88 1 Juni 2023

Data referensi

Kamus (Klik untuk mendownload file .txt)
Kategori produk iklan Digunakan di kolom excluded_product_category pada BidRequest. Kolom ini menjelaskan kategori produk dan layanan yang tidak diizinkan oleh penayang, misalnya, jika penayang tidak ingin menghosting iklan yang terkait dengan perbankan online.
Kategori yang dibatasi iklan Digunakan di kolom allowed_restricted_category dari BidRequest dan kolom restricted_category di BidResponse. Kolom allowed_restricted_category menjelaskan kategori yang biasanya dibatasi, tetapi secara eksplisit dinyatakan oleh penayang sebagai diizinkan, misalnya, iklan yang berisi konten terkait minuman beralkohol.
Kategori sensitif iklan Digunakan di kolom excluded_sensitive_category dari BidRequest dan kolom category di BidResponse. Kolom excluded_sensitive_category menjelaskan kategori sensitif yang tidak diizinkan oleh penayang, misalnya, jika penayang tidak ingin menghosting iklan yang terkait dengan politik.
Pengiklan Digunakan di kolom advertiser_id di snippetStatusItem. Kolom ini menentukan pengiklan yang diwakili oleh materi iklan yang terkait dengan cuplikan tersebut. Daftar ini mencerminkan pengiklan di seluruh bursa dan tidak mencerminkan pengiklan yang diwakili oleh satu pembeli.
Agensi Digunakan di kolom agency_id pada BidResponse. Kolom ini digunakan untuk mendeklarasikan agensi yang terkait dengan iklan yang ditampilkan.
Merek Daftar merek, yang digunakan di Client Access API.
Atribut materi iklan yang dapat dikonfirmasi pembeli Digunakan untuk kolom attribute di BidResponse. Kolom ini menjelaskan atribut yang dideklarasikan pembeli pada materi iklan yang tidak boleh muncul dalam excluded_attribute di BidRequest.
Kode status info Kode status yang ditampilkan oleh panggilan metode performancereport.
Label konten Digunakan di kolom detected_content_labels dari BidRequest.
Kode status pencocok cookie Digunakan di kolom cookieMatcherStatusRate laporan performa Protokol RTB. Kode yang tersedia dijelaskan dalam panduan Pencocokan cookie.
Kode status materi iklan

Digunakan di

creative_status_code ditampilkan dalam masukan real-time.
Kode status kecocokan yang dihosting Digunakan di kolom hostedMatchStatusRate laporan performa Protokol RTB.
Tidak ada alasan bid Nilai alasan tanpa bid standar yang akan diberikan di kolom BidResponse.no_bid_reason dalam protokol bid Authorized Buyers.
Atribut materi iklan yang dapat ditargetkan Digunakan di kolom supportedCreativeAttribute di resource PreTargetingConfig yang diekspos di REST API Pembeli. Kolom ini menjelaskan atribut materi iklan yang diharapkan ada di semua materi iklan yang terkait dengan satu konfigurasi pra-penargetan.
Atribut materi iklan yang dapat dikecualikan penayang Digunakan di kolom excluded_attribute pada BidRequest. Kolom ini menjelaskan jenis materi iklan yang tidak diizinkan oleh penayang. Misalnya, parameter ini dapat menentukan batasan apakah penggunaan cookie diizinkan, atau apakah iklan media dan/atau teks diizinkan.
Vertical penayang Digunakan di kolom detected_vertical pada BidRequest. Kolom ini menentukan vertical (mirip dengan kata kunci) halaman tempat iklan akan ditampilkan. Google membuat kolom ini dengan meng-crawl halaman dan menentukan vertical mana yang digunakan.
ID jaringan penjual Digunakan di kolom seller_network_id pada BidRequest. Kolom ini menentukan jaringan penjual yang dimiliki penayang. Konten file ini berada dalam urutan menaik berdasarkan nilai ID jaringan penjual.
Vendor Digunakan di kolom allowed_vendor_type pada BidRequest. Kolom ini mencantumkan vendor Multimedia mana, seperti Campaign Monitor dan VoiceFive, yang diizinkan untuk materi iklan yang ditayangkan, seperti yang ditentukan oleh penayang.

Menyertakan vendor dari file kamus gdn-vendors.txt yang dihentikan.

Tabel referensi (Klik untuk mendownload CSV)
Aplikasi seluler Android Daftar aplikasi seluler Android yang dapat ditargetkan dengan ID aplikasi, ID kategori, dan nama aplikasi yang dapat dibaca manusia.
Tabel geografis Tabel yang digunakan untuk mendekode kolom geo_criteria_id dari BidRequest. Lihat Penargetan-geo untuk informasi selengkapnya.
Penyedia LGPD Daftar penyedia personalisasi iklan diizinkan untuk ditayangkan di traffic LGPD, dengan ID, nama yang dapat dibaca manusia, URL privasi, dan daftar domain yang dapat diatribusikan ke penyedia. Penerapan LGPD ditunjukkan pada permintaan bid tertentu melalui kolom BidRequest.adslot.regs_lgpd dalam protokol bid Authorized Buyers dan kolom BidRequest.regs.ext.lgpd dalam protokol bid OpenRTB.
Operator seluler Daftar operator seluler.
Perangkat seluler Daftar perangkat seluler.
Sistem operasi seluler Daftar sistem operasi seluler.
Penyedia Memetakan ID penyedia personalisasi iklan ke nama yang dapat dibaca manusia, URL kebijakan privasi, dan daftar domain yang dapat diatribusikan ke penyedia. Saat ini, penyedia digunakan di kolom BidRequest.AdSlot.consented_providers_settings untuk protokol AdX dan BidRequest.User.UserExt.consented_providers_settings untuk protokol OpenRTB. Di kolom ini, penyedia yang tercantum memiliki izin pengguna seperti yang diteruskan oleh penayang untuk pengguna di negara dalam Wilayah Ekonomi Eropa.

Setelan penerbit

Minta file publisher-settings.pb.gz dari perwakilan akun Anda.