Protos & Data Referensi

Lihat atau unduh file yang mendukung Protokol RTB.

Proto

File Deskripsi Versi Terakhir Diperbarui
cookie-bulk-upload.proto Gunakan pesan ini untuk mengupload massal data penargetan pengguna. v.24 27 Maret 2024
openrtb.proto Google mendukung protokol OpenRTB, menggunakan encoding JSON atau Protobuf. Protokol ini diperlukan jika Anda menggunakan OpenRTB/Protobuf. Halaman ini juga menyertakan dokumentasi kolom yang didukung dan pemetaannya ke protokol native Google. 2.6 23 Maret 2024
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.171 17 April 2024
publisher-settings.proto Kumpulan setelan penayang khusus untuk jaringan bidder real-time. v.13 5 Feb 2024
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest berisi slot iklan dari satu tayangan. v.324 17 April 2024

Protos Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.174 17 April 2024
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest berisi slot iklan dari satu tayangan. v.331 17 April 2024

Data referensi

Kamus (Klik untuk mendownload file .txt)

Kategori produk iklan Digunakan di kolom excluded_product_category dari 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 dari BidResponse. Kolom allowed_restricted_category menjelaskan kategori yang biasanya dibatasi, tetapi dideklarasikan secara eksplisit 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 dari 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 dari SnippetStatusItem. Kolom ini menentukan pengiklan yang diwakili oleh materi iklan yang terkait dengan cuplikan. Daftar ini mencerminkan pengiklan di bursa dan tidak mencerminkan pengiklan yang diwakili oleh satu pembeli mana pun.
Merek Daftar merek, yang digunakan dalam Client Access API.
Atribut materi iklan yang dapat dinyatakan pembeli Digunakan untuk kolom attribute di BidResponse. Kolom ini menjelaskan atribut yang dapat dinyatakan pembeli pada materi iklan yang tidak boleh muncul di 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 sebelumnya Digunakan di kolom supportedCreativeAttribute di resource PretargetingConfig yang ditampilkan di Buyer REST API. Kolom ini menjelaskan atribut materi iklan yang diharapkan akan ada di semua materi iklan yang sesuai dengan satu konfigurasi pra-penargetan.
Atribut materi iklan yang dapat dikecualikan penayang Digunakan di kolom excluded_attribute dari BidRequest. Kolom ini menjelaskan jenis materi iklan yang tidak diizinkan oleh penayang. Misalnya, mereka mungkin menentukan batasan tentang apakah penggunaan cookie diizinkan, atau apakah iklan media dan/atau teks diizinkan.
Vertical penayang Digunakan di kolom detected_vertical dari 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 dari BidRequest. Kolom ini menentukan jaringan penjual yang memiliki penayang. Konten file ini berada dalam urutan menaik berdasarkan nilai ID jaringan penjual.
Vendor Digunakan di kolom allowed_vendor_type dari BidRequest. Kolom ini mencantumkan vendor Multimedia, seperti Campaign Monitor dan VoiceFive, yang diizinkan untuk materi iklan ditayangkan, seperti yang ditentukan oleh penayang.

Termasuk 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 yang diizinkan untuk ditayangkan pada traffic LGPD, beserta ID-nya, nama yang dapat dibaca manusia, URL privasi, dan daftar domain yang dapat diatribusikan ke penyedia tersebut. Penegakan LGPD ditunjukkan pada permintaan bid tertentu melalui kolom BidRequest.adslot.regs_lgpd di protokol bid Authorized Buyers dan kolom BidRequest.regs.ext.lgpd di protokol bid OpenRTB.
Operator seluler Daftar operator seluler.
Perangkat seluler Daftar perangkat seluler.
Sistem operasi seluler Daftar sistem operasi seluler.
Penyedia ID penyedia personalisasi iklan Maps dengan 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. Pada kolom ini, penyedia yang tercantum memiliki izin pengguna sebagaimana yang diteruskan oleh penayang untuk pengguna di negara dalam Wilayah Ekonomi Eropa.

Setelan penerbit

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

Topik kebijakan peninjauan materi iklan

Anda dapat menggunakan topik kebijakan dalam file ini untuk memfilter materi iklan selama peninjauan di Real-time Bidding API

Download topik kebijakan sebagai file CSV.

Terakhir diperbarui: 18 April 2022