Protos & Data Referensi

Melihat atau mendownload file yang mendukung Protokol RTB.

Protos

File Deskripsi Versi Terakhir Diperbarui
cookie-bulk-upload.proto Gunakan pesan ini untuk mengupload data penargetan pengguna secara massal. v.24 27 Mar 2024
openrtb.proto Google mendukung protokol OpenRTB, menggunakan encoding JSON atau Protobuf. Proto ini diperlukan jika Anda menggunakan OpenRTB/Protobuf. Dokumen ini juga mencakup dokumentasi kolom yang didukung dan pemetaannya ke protokol native Google. 2.6 11 Agustus 2025
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v.192 21 Juli 2025
publisher-settings.proto Kumpulan setelan penayang khusus untuk jaringan bidder real-time. v.14 5 Februari 2024

Proto Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v.200 21 Juli 2025

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 iklan yang dibatasi Digunakan di kolom allowed_restricted_category dari BidRequest dan kolom restricted_category dari BidResponse. Kolom allowed_restricted_category mendeskripsikan kategori yang biasanya dibatasi, tetapi secara eksplisit dinyatakan oleh penayang sebagai diizinkan, misalnya, iklan yang berisi konten terkait alkohol.
Kategori sensitif iklan Digunakan di kolom excluded_sensitive_category dari BidRequest dan kolom category dari BidResponse. Kolom excluded_sensitive_category mendeskripsikan kategori sensitif yang tidak diizinkan oleh penayang, misalnya, jika penayang tidak ingin menghosting iklan yang terkait dengan politik.
Pengiklan Digunakan di kolom advertiser_id SnippetStatusItem. Kolom ini menentukan pengiklan yang diwakili oleh materi iklan yang terkait dengan cuplikan. Daftar ini mencerminkan pengiklan di seluruh bursa dan tidak mencerminkan pengiklan yang diwakili oleh satu pembeli pun.
Merek Daftar merek, yang digunakan di Client Access API.
Atribut materi iklan yang dapat dideklarasikan pembeli Digunakan untuk kolom attribute di BidResponse. Kolom ini menjelaskan atribut yang dapat dideklarasikan pembeli pada materi iklan yang tidak boleh muncul di excluded_attribute dalam 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.
Alasan tidak ada bid Nilai alasan tidak ada 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 dalam resource PretargetingConfig yang diekspos di REST API Pembeli. Kolom ini menjelaskan atribut materi iklan yang diharapkan ada di semua materi iklan yang sesuai dengan satu konfigurasi prapenargetan.
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 dapat menentukan pembatasan terkait apakah penggunaan cookie diizinkan, atau apakah iklan media dan/atau teks diizinkan.
Vertical penayang Digunakan di kolom detected_vertical dari BidRequest. Kolom ini menentukan vertikal (mirip dengan kata kunci) halaman tempat iklan akan ditampilkan. Google membuat kolom ini dengan meng-crawl halaman dan menentukan vertikal yang digunakan.
Vendor Digunakan di kolom allowed_vendor_type dari BidRequest. Kolom ini mencantumkan vendor Media Rich yang diizinkan untuk materi iklan yang ditayangkan, seperti Campaign Monitor dan VoiceFive, sebagaimana ditentukan oleh penayang.

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

Penyedia data Digunakan di kolom SegmentData.id dari BidRequest. Kolom ini berisi informasi tentang entitas yang memberikan Sinyal yang Diberikan Penayang.

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 geo Tabel yang digunakan untuk mendekode kolom geo_criteria_id dari BidRequest. Lihat Penargetan geografis untuk mengetahui informasi selengkapnya.
Penyedia LGPD Daftar penyedia personalisasi iklan yang diizinkan untuk ditayangkan di traffic LGPD, dengan ID, nama yang mudah dibaca, 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 Maps ke nama yang mudah dibaca, 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 yang diteruskan oleh penayang untuk pengguna di negara-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