Google membuat daftar setelan penayang gabungan tersedia dengan menguploadnya ke bucket Google Cloud Storage khusus akun (pada project yang milik Google). Anda dapat mendownloadnya untuk digunakan untuk penargetan yang tidak dapat dilakukan pada waktu bidding. Hubungi manajer akun teknis Anda untuk mengaktifkan fitur ini untuk akun Anda.
File yang berisi setelan penayang dapat didownload secara terprogram menggunakan paket Cloud Storage API, secara manual melalui Google Developers Console, atau dengan menggunakan alat command line gsutil. Lihat kursus Google Cloud Dokumentasi Storage untuk detail selengkapnya tentang mengakses data yang disimpan di Google Cloud Storage.
File akan dikompresi dengan gzip sesuai dengan RFC 1952. Untuk mengekstrak file dari
command line, jalankan gzip -d <filename>
. Untuk mengekstrak
secara terprogram, Anda dapat menggunakan zlib atau pustaka kompresi serupa yang
mendukung format gzip. Hasilnya adalah {i>buffer<i} protokol
serial, mirip dengan
payload permintaan POST di BidRequest
, yang dapat berupa
diuraikan 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
diunduh dari data referensi
halaman. Anda juga dapat meminta fitur
publisher-settings.pb.gz
dari perwakilan akun Anda. Ini
berisi definisi buffering protokol serta contoh penayang
setelan.
Urutan PublisherSettingsList
dapat berubah kapan saja.
Tidak ada jaminan atau urutan tertentu. Setiap entri di penerbit
berisi ID, dan beberapa setelan yang berlaku untuk
BidRequests
diberi tag dengan ID tersebut. Anda dapat menambahkan
fitur ke
sistem bidding Anda untuk memeriksa daftar setelan penayang baru secara berkala.
Saat Google menerima tayangan iklan yang memenuhi syarat untuk bidding real-time,
Google menyertakan ID dalam permintaan bid yang sesuai dengan entri dalam
daftar setelan penerbit. Sistem bidding Anda dapat menggunakan setelan penayang
untuk memfilter iklan
kandidat untuk tayangan tersebut. Agar memenuhi syarat untuk
iklan kandidat harus mematuhi semua entri setelan penayang
yang ID-nya dikirim dalam permintaan.
Perhatikan bahwa setelan penayang yang hilang dari file tersebut karena ID tidak memiliki URL yang diblokir yang terkait dengannya.
File setelan penerbit dibagi menjadi
beberapa file yang lebih kecil untuk mengurangi
jumlah data yang harus didownload dalam satu transaksi. File
dipecah menjadi potongan
dan nama sekitar 5 MB sebagai
publisher-settings.0.pb.gz
sampai
publisher-settings.n.pb.gz
(dengan n adalah jumlah
{i>file<i} dikurangi satu.) Hubungi perwakilan akun Anda untuk mendapatkannya
.