Mempelajari spesifikasi Kurasi Real-Time
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Google mengirimkan
SegmentRequest
berdasarkan permintaan iklan yang cocok dengan inventaris bertarget Anda ke integrasi Kurasi Real-time Anda. Objek SegmentRequest memberikan sinyal kontekstual atau sinyal audiens 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.
Hanya didukung untuk partner kurasi kontekstual. Deskriptor situs. Kolom site diisi jika konten yang didukung iklan adalah situs, bukan aplikasi non-browser.
Hanya didukung untuk partner kurasi kontekstual. Deskripsi aplikasi. Kolom app diisi jika konten yang didukung iklan adalah aplikasi non-browser, bukan situs.
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 iklan.
Hanya didukung untuk partner kurasi kontekstual. Lebar dalam piksel independen 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 Daftar: Posisi Penempatan 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 Daftar: Posisi Penempatan di AdCOM 1.0.
ImpExt
Atribut
Jenis
Deskripsi
gpid
string
Hanya didukung untuk partner kurasi kontekstual. Menjelaskan 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 disetel ke pub-123.
Pengguna
Atribut
Jenis
Deskripsi
id
string
ID Pengguna Google.
buyeruid
string
Data pencocokan yang dihosting diupload dengan Layanan Pencocokan Cookie. Secara default, ini ditentukan dalam encoding base64 yang aman bagi web tanpa padding. Anda dapat secara opsional mengonfigurasi kolom ini agar diisi tanpa encoding dengan menghubungi pengelola akun Anda.
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 terintegrasi dengan CMP untuk TCF v2 dan CMP tersebut menunjukkan bahwa GDPR berlaku untuk panggilan 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.
Hanya didukung untuk partner kurasi audiens. Instance ID yang diperluas. Dalam Kurasi, kolom eids adalah data yang disediakan penayang, seperti sinyal aman.
EID
Atribut
Jenis
Deskripsi
source
string
Hanya didukung untuk partner kurasi audiens. Sumber atau penyedia teknologi yang bertanggung jawab atas kumpulan data yang disertakan. Dinyatakan sebagai domain level teratas.
Hanya didukung untuk partner kurasi kontekstual. Lokasi perangkat pengguna.
devicetype
int
Hanya didukung untuk partner kurasi kontekstual. Jenis perangkat umum. 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").
ifa
string
ID iklan perangkat yang tidak dienkripsi (tidak di-hash). Dalam protokol Kurasi Real-time Google, ID ini biasanya berupa UUID 36 karakter, dengan ID Android dalam huruf kecil dan IDFA dalam huruf besar. Untuk perangkat Samsung, ini adalah nilai alfanumerik 32 karakter.
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2026-09-23 UTC."],[],[]]
