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. Panduan ini juga menyertakan dokumentasi kolom yang didukung dan pemetaan ke protokol native Google. 2.6 18 November 2024
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.180 1 Nov 2024
publisher-settings.proto Kumpulan setelan penayang yang khusus untuk jaringan bidder real-time. v.13 05 Februari 2024
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest menyertakan slot iklan dari satu tayangan iklan. v.331 1 Nov 2024

Proto Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google menyertakan beberapa ekstensi, yang disediakan dalam proto terpisah. v.186 1 Nov 2024
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest menyertakan slot iklan dari satu tayangan iklan. v.342 31 Oktober 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 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 dengan isu 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 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.
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 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 mengajukan 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 ditampilkan di REST API Pembeli. 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 oleh penayang Digunakan di kolom excluded_attribute dari BidRequest. Kolom ini menjelaskan jenis materi iklan yang tidak diizinkan oleh penayang. Misalnya, kebijakan tersebut dapat 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 vertikal (mirip dengan kata kunci) halaman tempat iklan akan ditampilkan. Google membuat kolom ini dengan meng-crawl halaman dan menentukan vertikal mana yang digunakan.
Vendor Digunakan di kolom allowed_vendor_type dari BidRequest. Kolom ini mencantumkan vendor Rich Media, seperti Campaign Monitor dan VoiceFive, yang diizinkan untuk materi iklan yang ditayangkan, seperti yang ditentukan oleh penayang.

Mencakup vendor dari file kamus gdn-vendors.txt yang tidak digunakan lagi.

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 geografis Tabel yang digunakan untuk mendekode kolom geo_criteria_id dari BidRequest. Lihat Geotargeting untuk informasi selengkapnya.
Penyedia LGPD Daftar penyedia personalisasi iklan yang 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-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