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 Maret 2024
openrtb.proto Google mendukung protokol OpenRTB, menggunakan encoding JSON atau Protobuf encoding. Proto ini diperlukan jika Anda menggunakan OpenRTB/Protobuf. Proto ini juga menyertakan dokumentasi kolom yang didukung dan pemetaannya ke protokol native Google. 2.6 2 Juni 2026
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.208 9 Juni 2026
publisher-settings.proto Kumpulan setelan penayang yang khusus untuk jaringan bidder real-time. v.14 5 Februari 2024

Protos Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.217 16 Juni 2026

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 menjelaskan kategori yang biasanya dibatasi, tetapi secara eksplisit dideklarasikan oleh penayang sebagai diizinkan, misalnya, iklan yang berisi konten terkait alkohol.
Kategori iklan yang sensitif 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 seluruh platform dan tidak mencerminkan pengiklan yang diwakili oleh satu pembeli.
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 di BidRequest.
Kode status callout Kode status yang ditampilkan oleh performancereport metode panggilan.
Label konten Digunakan di kolom detected_content_labels dari BidRequest.
Kode status pencocok cookie Digunakan di kolom cookieMatcherStatusRate dari laporan performa Protokol RTB. Kode yang tersedia dijelaskan dalam Panduan pencocokan cookie.
Kode status materi iklan

Digunakan di

creative_status_code yang ditampilkan dalam masukan real-time.
Kode status pencocokan yang dihosting Digunakan di kolom hostedMatchStatusRate dari 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 dipra-targetkan Digunakan di kolom supportedCreativeAttribute dalam resource PretargetingConfig yang ditampilkan di Buyer REST API. Kolom ini menjelaskan atribut materi iklan yang diharapkan 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, penayang dapat menentukan batasan apakah penggunaan cookie diizinkan, atau apakah iklan media dan/atau teks diizinkan.
Vendor Digunakan di kolom allowed_vendor_type dari BidRequest. Kolom ini mencantumkan vendor Media Kreatif, seperti Campaign Monitor dan VoiceFive, yang diizinkan untuk materi iklan yang ditayangkan, seperti yang ditentukan oleh penayang.

Mencakup vendor dari file kamus yang tidak digunakan lagi gdn-vendors.txt.
Penyedia data Digunakan di kolom SegmentData.id dari BidRequest. Kolom ini berisi informasi tentang entitas yang menyediakan 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 geografis 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 menayangkan iklan di traffic LGPD, dengan ID, nama yang dapat dibaca manusia, URL privasi, dan daftar domain yang dapat dikaitkan dengan 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 dapat dibaca manusia, URL kebijakan privasi, dan daftar domain yang dapat dikaitkan dengan penyedia. Saat ini, penyedia digunakan di BidRequest.AdSlot.consented_providers_settings kolom 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-negara dalam Wilayah Ekonomi Eropa.

Setelan penayang

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 API bidding real-time

Unduh topik kebijakan sebagai file CSV.

Terakhir diperbarui: 18 April 2022