Google menyediakan daftar setelan penayang gabungan dengan menguploadnya ke bucket Google Cloud Storage khusus akun (dalam project yang dimiliki oleh Google). Anda dapat mendownloadnya untuk digunakan untuk penargetan yang tidak dapat dilakukan pada waktu bidding. Hubungi Account Manager teknis untuk mengaktifkan fitur ini bagi akun Anda.
File yang berisi setelan penayang dapat didownload secara terprogram menggunakan Cloud Storage API, secara manual melalui Google Developers Console UI, atau dengan menggunakan perintah gsutil Lihat dokumentasi Google Cloud Storage untuk mengetahui detail selengkapnya tentang cara mengakses data yang disimpan di Google Cloud Storage.
File dikompresi dengan gzip sesuai dengan RFC 1952. Untuk mengekstrak file dari
command line, jalankan gzip -d <filename>
. Untuk mengekstrak
file secara terprogram, Anda dapat menggunakan zlib atau library kompresi serupa yang
mendukung format gzip. Hasilnya adalah buffering protokol serial, mirip dengan payload permintaan POST dalam BidRequest
, yang dapat diurai dengan cuplikan berikut:
string compressed = /* the payload from the GET request */; string uncompressed = gunzip(compressed); PublisherSettingsList publisher_settings; if (publisher_settings.ParseFromString(uncompressed)) { // Process the publisher settings. }
Definisi buffering protokol untuk PublisherSettingsList
dapat
didownload dari halaman data
referensi. Anda juga dapat meminta file
publisher-settings.pb.gz
terkompresi dari perwakilan akun Anda. Class ini
berisi definisi buffering protokol serta contoh file
setelan penayang.
Urutan PublisherSettingsList
dapat berubah kapan saja.
Tidak ada jaminan urutan atau pengurutan tertentu. Setiap entri dalam daftar setelan penayang berisi ID, dan beberapa setelan yang berlaku untuk BidRequests
yang diberi tag dengan ID tersebut. Anda dapat menambahkan fitur ke
sistem bidding untuk memeriksa daftar setelan penayang baru secara berkala.
Saat Google menerima tayangan yang memenuhi syarat untuk bidding real-time,
Google menyertakan ID dalam permintaan bid yang sesuai dengan entri dalam
daftar setelan penayang. Sistem bidding Anda dapat menggunakan setelan penayang untuk memfilter iklan kandidat untuk tayangan tersebut. Agar memenuhi syarat untuk tayangan
tertentu, iklan kandidat harus mematuhi semua entri setelan penayang
yang ID-nya dikirim dalam permintaan.
Perhatikan bahwa setelan penayang yang tidak ada pada file ini disebabkan oleh ID yang tidak memblokir URL yang terkait dengannya.
File setelan penayang dibagi menjadi beberapa file yang lebih kecil untuk mengurangi
jumlah data yang harus didownload dalam satu transaksi. File ini dibagi menjadi sekitar 5 MB potongan dan nama sebagai publisher-settings.0.pb.gz
sampai publisher-settings.n.pb.gz
(dengan n adalah jumlah file minus satu.) Hubungi perwakilan akun Anda untuk mendapatkan file ini.