Mempelajari spesifikasi Kurasi Real-Time

Google mengirimkan SegmentRequest berdasarkan permintaan iklan yang cocok dengan inventaris yang ditargetkan ke integrasi Kurasi Real-time Anda. Objek SegmentRequest memberikan sinyal kontekstual atau sinyal aman yang dapat Anda gunakan untuk mengidentifikasi segmen mana yang berlaku untuk inventaris tertentu dalam SegmentResponse. Kurasi Real-time mendukung objek SegmentRequest dan SegmentResponse yang dikirim dalam format JSON.

Panduan ini adalah referensi untuk protokol Kurasi Real-time yang dapat membantu Anda membangun integrasi.

SegmentRequest

Atribut Jenis Deskripsi
imp Array Imp Hanya didukung untuk partner kurasi kontekstual. Menunjukkan peluang tayangan iklan yang ditawarkan.
site Situs Hanya didukung untuk partner kurasi kontekstual. Deskriptor situs. Kolom site diisi jika konten yang didukung iklan adalah situs, bukan aplikasi non-browser.
app Aplikasi Hanya didukung untuk partner kurasi kontekstual. Deskripsi aplikasi. Kolom app diisi jika konten yang didukung iklan adalah aplikasi non-browser, bukan situs.
pub Penayang Hanya didukung untuk partner kurasi kontekstual. Deskriptor penerbit.
user Pengguna Deskriptor pengguna yang menjelajahi konten penayang yang memulai permintaan segmen.
device Perangkat Hanya didukung untuk partner kurasi kontekstual. Deskriptor perangkat pengguna.
segment_request_id string ID unik yang digunakan untuk mengidentifikasi permintaan segmen secara terpisah dari semua permintaan segmen lainnya.

Tygn.

Atribut Jenis Deskripsi
id string Hanya didukung untuk partner kurasi kontekstual. ID unik untuk tayangan ini dalam konteks permintaan segmen. Nilai dimulai dari 1 dan bertambah hingga n untuk n tayangan.
banner Banner Hanya didukung untuk partner kurasi kontekstual. Kolom ini diisi jika tayangan iklan ditawarkan sebagai peluang iklan banner.
video Video Hanya didukung untuk partner kurasi kontekstual. Kolom ini diisi jika tayangan iklan ditawarkan sebagai peluang iklan video.
ext ImpExt Kolom ini diisi dengan ekstensi untuk objek Imp.

Banner

Atribut Jenis Deskripsi
w int Hanya didukung untuk partner kurasi kontekstual. Lebar dalam piksel mandiri perangkat (DIPS).
h int Hanya didukung untuk partner kurasi kontekstual. Tinggi dalam piksel independen perangkat (DIP).
pos int Hanya didukung untuk partner kurasi kontekstual. Posisi iklan di layar. Untuk mempelajari lebih lanjut kemungkinan posisi penempatan, lihat List: Placement Positions di AdCOM 1.0.

Video

Atribut Jenis Deskripsi
w int Hanya didukung untuk partner kurasi kontekstual. Lebar pemutar video dalam piksel independen perangkat (DIP).
h int Hanya didukung untuk partner kurasi kontekstual. Tinggi pemutar video dalam piksel independen perangkat (DIP).
pos int Hanya didukung untuk partner kurasi kontekstual. Posisi iklan di layar. Untuk mempelajari lebih lanjut kemungkinan posisi penempatan, lihat List: Placement Positions di AdCOM 1.0.

ImpExt

Atribut Jenis Deskripsi
gpid string Hanya didukung untuk partner kurasi kontekstual. Mendeskripsikan ID penempatan Global. ID persisten yang berbeda, yang ditentukan oleh penayang, yang konsisten di seluruh jalur suplai untuk setiap unit iklan di halaman. Lihat artikel ini.

Situs

Atribut Jenis Deskripsi
page string Hanya didukung untuk partner kurasi kontekstual. URL halaman yang menampilkan tayangan iklan.
mobile int Hanya didukung untuk partner kurasi kontekstual. Menunjukkan apakah situs telah diprogram untuk mengoptimalkan tata letak saat dilihat di perangkat seluler, dengan 0 = tidak, 1 = ya.

Aplikasi

Atribut Jenis Deskripsi
bundle string Hanya didukung untuk partner kurasi kontekstual. ID aplikasi khusus platform yang dimaksudkan agar unik untuk aplikasi. Di Android, kolom bundle adalah nama paket atau bundle. Di iOS, ID ini adalah ID numerik.

Penerbit

Atribut Jenis Deskripsi
id string Hanya didukung untuk partner kurasi kontekstual. ID penayang yang ditentukan oleh akhiran kode penayang dari kode properti web. Misalnya, penayang yang memiliki kode properti web ca-pub-123 akan memiliki ID yang ditetapkan ke pub-123.

Pengguna

Atribut Jenis Deskripsi
consent string String izin Transparency and Consent Framework (TCF) v2 IAB yang dienkode base64 aman untuk web yang diambil dari Platform Pengelolaan Izin IAB (CMP) penayang. Kolom consent diisi jika penayang telah melakukan integrasi dengan CMP untuk TCF v2 dan CMP tersebut menunjukkan bahwa GDPR berlaku untuk permintaan iklan dan memberikan string izin yang valid. Lihat Daftar Vendor Global IAB di vendor-list.consensu.org/v2/vendor-list.json untuk mengetahui detail tentang vendor yang tercantum dalam string izin.
eids Array EID Hanya didukung untuk partner seleksi sinyal aman. Instance ID yang diperluas. Di Kurasi, kolom eids adalah data yang disediakan oleh penayang, seperti sinyal aman.

EID

Atribut Jenis Deskripsi
source string Hanya didukung untuk partner seleksi sinyal aman. Sumber atau penyedia teknologi yang bertanggung jawab atas kumpulan data yang disertakan. Dinyatakan sebagai domain level teratas.
uids Array UID Hanya didukung untuk partner seleksi sinyal aman. Array objek UID dari sumber yang diberikan.

UID

Atribut Jenis Deskripsi
id string Hanya didukung untuk partner seleksi sinyal aman. ID. Dalam kurasi, kolom id adalah sinyal aman. Untuk mempelajari lebih lanjut sinyal aman, lihat artikel Membagikan sinyal aman kepada bidder dan partner seleksi di Ad Manager.

Perangkat

Atribut Jenis Deskripsi
geo Geografis Hanya didukung untuk partner kurasi kontekstual. Lokasi perangkat pengguna.
devicetype int Hanya didukung untuk partner kurasi kontekstual. Jenis umum perangkat. Untuk mempelajari lebih lanjut kemungkinan jenis perangkat, lihat List: Device Types di AdCOM 1.0.
os string Hanya didukung untuk partner kurasi kontekstual. Sistem operasi perangkat (misalnya, "iOS").
make string Hanya didukung untuk partner kurasi kontekstual. Merek perangkat (misalnya, "Apple").

Geo

Atribut Jenis Deskripsi
country string Hanya didukung untuk partner kurasi kontekstual. Negara yang menggunakan standar ISO-3166-1 Alpha-3.
region string Hanya didukung untuk partner kurasi kontekstual. Kode wilayah menggunakan standar ISO-3166-2; kode negara bagian 2 huruf jika USA.
metro string Hanya didukung untuk partner kurasi kontekstual. Kode metro Google yang ditemukan dalam file geo-table.csv.
city string Hanya didukung untuk partner kurasi kontekstual. Kota yang menggunakan Kode Perserikatan Bangsa-Bangsa untuk Lokasi Perdagangan & Transportasi.

SegmentResponse

Atribut Jenis Deskripsi
segment Array segmen Deskripsi untuk segmen.

Segmen

Atribut Jenis Deskripsi
segment_id string ID untuk segmen. ID harus cocok dengan curatorDataSegmentId yang ditemukan dalam nama segmen di resource curators.dataSegments Marketplace API.