Mempelajari spesifikasi Kurasi Real-Time

Google mengirim SegmentRequest berdasarkan permintaan iklan yang cocok dengan inventaris bertarget Anda ke integrasi Kurasi Real-Time. 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 Seleksi Real-time yang dapat membantu Anda membangun integrasi.

SegmentRequest

Atribut	Jenis	Deskripsi
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.

Situs

Atribut	Jenis	Deskripsi
page	string	Hanya didukung untuk partner kurasi kontekstual. URL halaman yang menampilkan tayangan iklan.

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, 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 dan 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 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	EID array	Hanya didukung untuk partner seleksi sinyal aman. Instance ID yang diperluas. Dalam 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	UID array	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.

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 di file geo-table.csv.

SegmentResponse

Atribut	Jenis	Deskripsi
segment	Segment array	Deskripsi untuk segmen.

Segmen

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