Protos & Data Referensi

Melihat atau mendownload 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. v.24 27 Mar 2024
openrtb.proto Google mendukung protokol OpenRTB, baik menggunakan JSON maupun Protobuf encoding. Protokol ini diperlukan jika Anda menggunakan OpenRTB/Protobuf. Anda juga menyertakan dokumentasi kolom yang didukung dan pemetaannya ke dan berperforma tinggi karena merupakan protokol native. 2.6 1 Agustus 2024
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v.177 6 Agustus 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 tayangan tunggal. v.330 6 Agustus 2024

Protos Beta Terbuka

File Deskripsi Versi Terakhir Diperbarui
openrtb-adx.proto Protokol OpenRTB Google mencakup beberapa ekstensi, yang disediakan dalam proto terpisah. v.182 6 Agustus 2024
realtime-bidding.proto Protokol RTB Authorized Buyers Google. Ini adalah pesan yang digunakan Google untuk meminta bid. BidRequest berisi slot iklan dari tayangan tunggal. v.340 6 Agustus 2024

Data referensi

Kamus (Klik untuk mendownload file .txt)

Kategori produk iklan Digunakan di kolom excluded_product_category pada BidRequest. Bidang ini menjelaskan kategori produk dan layanan yang tidak diizinkan oleh penerbit, misalnya, jika penerbit tidak ingin menghosting iklan yang terkait dengan perbankan online.
Kategori yang dibatasi iklan Digunakan di kolom allowed_restricted_category pada BidRequest dan kolom restricted_category pada BidResponse. allowed_restricted_category menjelaskan kategori yang biasanya dibatasi, namun secara eksplisit dideklarasikan oleh penayang sebagai diizinkan, misalnya, iklan yang berisi konten yang terkait dengan alkohol.
Kategori sensitif iklan Digunakan di kolom excluded_sensitive_category pada BidRequest dan kolom category pada BidResponse. 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 dari SnippetStatusItem. Ini menentukan pengiklan yang diwakili oleh materi iklan yang terkait cuplikan kode. Daftar ini mencerminkan pengiklan di seluruh bursa dan melakukan tidak mencerminkan pengiklan yang diwakili oleh satu pembeli mana 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 harus tidak muncul di excluded_attribute pada BidRequest.
Kode status info Kode status yang ditampilkan oleh metode performancereport panggilan telepon.
Label konten Digunakan di kolom detected_content_labels pada BidRequest.
Kode status pencocok cookie Digunakan di kolom cookieMatcherStatusRate pada Protokol RTB laporan performa. Kode yang tersedia dijelaskan di bagian Pencocokan Cookie kami.
Kode status materi iklan

Digunakan di

creative_status_code dikembalikan secara real-time masukan.
Kode status pencocokan yang dihosting Digunakan di kolom hostedMatchStatusRate pada Protokol RTB laporan performa.
Tidak ada alasan bid Nilai alasan tanpa bid standar harus diberikan di kolom BidResponse.no_bid_reason pada Protokol bid Authorized Buyers.
Atribut materi iklan yang dapat ditargetkan Digunakan di kolom supportedCreativeAttribute di 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 penayang Digunakan di kolom excluded_attribute pada BidRequest. Kolom ini menjelaskan jenis materi iklan yang tidak diizinkan oleh penayang. Misalnya, mereka mungkin menentukan batasan apakah penggunaan cookie diizinkan, atau apakah media dan/atau teks iklan diizinkan.
Vertical penayang Digunakan di kolom detected_vertical pada BidRequest. Bidang ini menentukan vertikal (mirip dengan kata kunci) pada halaman tempat iklan akan ditampilkan. Google membuat dengan meng-crawl halaman dan menentukan vertical mana yang digunakan.
Vendor Digunakan di kolom allowed_vendor_type pada BidRequest. Kolom ini mencantumkan vendor Multimedia, seperti Campaign Monitor dan VoiceFive, diizinkan untuk materi iklan yang ditayangkan, seperti yang ditentukan oleh penerbit.

Termasuk vendor dari File kamus gdn-vendors.txt.

Penyedia data Digunakan di kolom SegmentData.id pada 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 beserta ID aplikasi, ID kategori, dan nama aplikasi yang dapat dibaca manusia.
Tabel geografis Tabel yang digunakan untuk mendekode kolom geo_criteria_id pada BidRequest. Lihat Penargetan geografis untuk mengetahui informasi selengkapnya tidak akurat atau tidak sesuai.
Penyedia LGPD Daftar penyedia personalisasi iklan yang diizinkan untuk ditayangkan di traffic LGPD, beserta ID-nya, nama yang dapat dibaca manusia, URL privasi, dan daftar domain yang dapat diatribusikan ke penyedia. Penegakan LGPD ditunjukkan pada permintaan bid tertentu melalui BidRequest.adslot.regs_lgpd di protokol bid Authorized Buyers dan 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 Memetakan ID penyedia personalisasi iklan ke nama yang dapat dibaca manusia, URL kebijakan, dan daftar domain yang dapat diatribusikan ke penyedia. Saat ini, penyedia digunakan dalam Kolom BidRequest.AdSlot.consented_providers_settings untuk AdX protokol dan BidRequest.User.UserExt.consented_providers_settings untuk OpenRTB dan berperforma tinggi karena merupakan protokol biner. Di kolom ini, penyedia yang tercantum memiliki izin pengguna seperti yang diteruskan oleh penayang untuk pengguna di negara dalam Wilayah Ekonomi Eropa.

Setelan penerbit

Meminta file publisher-settings.pb.gz dari akun Anda representatif.

Topik kebijakan peninjauan materi iklan

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

Unduh topik kebijakan sebagai file CSV.

Terakhir diperbarui: 18 April 2022