Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi bidang ORTB
<a name="yield-optimization-ortb-reference"></a>

Halaman ini adalah referensi lengkap untuk setiap bidang dalam permintaan tawaran OpenRTB. Bidang dikategorikan berdasarkan cara MediaTailor menanganinya dan apakah APS memerlukan atau merekomendasikannya untuk pengisian iklan yang optimal.

Untuk spesifikasi OpenRTB 2.6 lengkap, lihat spesifikasi [ IAB OpenRTB 2.6. ](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)

## Kategori bidang
<a name="yield-optimization-ortb-reference-categories"></a>


| Kategori | Arti | Tindakan Anda | 
| --- | --- | --- | 
| Wajib  | Harus ada di template Anda. MediaTailor melempar kesalahan jika hilang. | Anda harus menyediakan ini. | 
| Hardcode oleh EMT  | MediaTailor selalu atur ini menggunakan nilai dari konfigurasi konsol Anda atau konteks yang tersedia saat ini. Nilai template Anda diganti. | Jangan mengatur ini di template Anda. | 
| APS Direkomendasikan  | Tidak sepenuhnya diwajibkan oleh MediaTailor, tetapi APS merekomendasikan ini untuk pengisian dan penargetan iklan yang lebih baik. Bidang yang disarankan yang hilang dapat mengakibatkan tingkat pengisian yang lebih rendah atau tanggapan tanpa tawaran. | Sangat direkomendasikan. | 
| Opsional  | Termasuk dalam permintaan tawaran hanya jika Anda memberikannya. Tidak ada nilai default. | Berikan jika relevan dengan kasus penggunaan Anda. | 

## ``objek aplikasi
<a name="yield-optimization-ortb-reference-app"></a>


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| app | Wajib  | Ob app jek harus ada di template Anda. | 
| app.bundle | Wajib  | ID bundel aplikasi Anda (misalnya,G15147002586). Tidak boleh kosong. | 
| app.storeurl | Wajib  | URL toko aplikasi (misalnya,https://apps.apple.com/us/app/yourapp/id123). | 
| app.publisher.id | Hardcode oleh EMT  | Selalu atur PublisherId ke konfigurasi konsol Anda. | 
| app.content | Wajib (objek)  | MediaTailor mengirimkan Content objek kosong jika Anda menghilangkan ini. Berikan metadata konten untuk penargetan yang lebih baik. | 
| app.name | APS Direkomendasikan | Nama aplikasi untuk identifikasi. | 
| app.id | APS Direkomendasikan | Pengidentifikasi aplikasi Anda di APS. | 
| app.domain | APS Direkomendasikan | Domain aplikasi. | 
| app.content.genre | APS Direkomendasikan | Genre konten (misalnya,"Sport","News"). | 
| app.content.contentrating | APS Direkomendasikan | Peringkat konten (misalnya,"TV-G","TV-14"). | 
| app.content.language | APS Direkomendasikan | Bahasa konten (ISO-639-1). | 
| app.content.id | APS Direkomendasikan | Pengidentifikasi konten. | 
| app.content.title | APS Direkomendasikan | Judul konten. | 
| app.content.episode | APS Direkomendasikan | Nomor episode. | 
| app.content.len | APS Direkomendasikan | Panjang konten dalam hitungan detik. | 
| app.cat | Opsional | Kategori konten (taksonomi IAB). | 
| app.sectioncat | Opsional | Kategori bagian. | 
| app.pagecat | Opsional | Kategori halaman. | 
| app.ver | Opsional | Versi aplikasi. | 
| app.privacypolicy | Opsional | 1 = memiliki kebijakan privasi. | 
| app.paid | Opsional | 1 = aplikasi berbayar. | 
| app.keywords | Opsional | Comma-separated kata kunci. | 
| app.kwarray | Opsional | Kata kunci sebagai array. | 
| app.inventorypartnerdomain | Opsional | Domain mitra inventaris. | 
| app.ext | Opsional | Objek ekstensi (pass-through). | 

## ``objek perangkat
<a name="yield-optimization-ortb-reference-device"></a>


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| device | Wajib  | Ob device jek harus ada di template Anda. | 
| device.ua | Wajib  | String agen pengguna. Tidak boleh kosong. Gunakan {{session.user\_agent}}. | 
| device.ip | Wajib  | Alamat IPv4. Tidak boleh kosong. Gunakan {{session.client\_ip}}. | 
| device.lmt | Opsional (default: 0) | Bendera Batasi Pelacakan Iklan. 0= pelacakan diizinkan, 1 = pelacakan terbatas. Jika tidak disediakan dalam template Anda, defaultnya adalah. 0 | 
| device.devicetype | Hardcode oleh EMT (default: 3)  | MediaTailor set 3 (TV yang terhubung) jika tidak disediakan. Nilai Anda digunakan jika ada. | 
| device.make | APS Direkomendasikan | Produsen perangkat (misalnya,"Samsung","Apple"). | 
| device.model | APS Direkomendasikan | Model perangkat (misalnya,"Tizen TV","iPhone"). | 
| device.os | APS Direkomendasikan | Sistem operasi (misalnya,"Tizen","iOS"). | 
| device.osv | APS Direkomendasikan | Versi OS. | 
| device.h | APS Direkomendasikan | Tinggi layar dalam piksel. | 
| device.w | APS Direkomendasikan | Lebar layar dalam piksel. | 
| device.language | APS Direkomendasikan | Bahasa perangkat (ISO-639-1). | 
| device.ifa | APS Direkomendasikan | ID iklan perangkat. Tidak semua perangkat memilikinya (misalnya, browser web). | 
| device.dnt | APS Direkomendasikan | Bendera Jangan Lacak. | 
| device.geo | Opsional | Objek Geo dengancountry,lat,lon. | 
| device.sua | Opsional | Agen Pengguna Terstruktur (UA-CH). | 
| device.ipv6 | Opsional | Alamat IPv6. | 
| device.hwv | Opsional | Versi perangkat keras. | 
| device.connectiontype | Opsional | Jenis koneksi (WiFi, seluler, dan sebagainya). | 
| device.carrier | Opsional | Nama operator. | 
| device.mccmnc | Opsional |  country/network Kode seluler. | 
| device.ext | Opsional | Objek ekstensi (pass-through). | 

## `objek imp` (tayangan)
<a name="yield-optimization-ortb-reference-imp"></a>

Template Anda harus berisi persis ** satu ** `imp` objek dalam array.


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| imp[0].video | Wajib  | Ob video jek harus ada. | 
| imp[0].video.mimes | Wajib  | Jenis MIME yang didukung (misalnya,["video/mp4"]). | 
| imp[0].video.protocols | Opsional  | Protokol VAST yang didukung. Jika dihilangkan, gunakan fall MediaTailor back hardcode. [1, 2, 3, 4, 5, 6, 7, 8] Lihat referensi enum protokol di bawah ini. | 
| imp[0].video.minduration | Hardcode oleh EMT  | Atur ke Anda MinimumUnfilledDuration dari konsol. | 
| imp[0].video.maxduration | Hardcode oleh EMT  | Setel ke durasi aktual yang belum terisi (detik). | 
| imp[0].video.maxseq | Hardcode oleh EMT  | Dihitung:floor(unfilled\_duration / 6). APS merekomendasikan salah maxseq satu atau poddur untuk mengembalikan beberapa iklan. | 
| imp[0].video.poddur | Hardcode oleh EMT  | Setel ke durasi yang tidak terisi (detik). | 
| imp[0].video.startdelay | Opsional | Mulai penundaan. 0= pre-roll, -1 = mid-roll generik, -2 = post-roll, = offset mid-roll > 0 dalam hitungan detik. Gunakan -1 untuk istirahat tengah putar langsung. Fallback berkode keras:. 6 | 
| imp[0].video.w | APS Direkomendasikan | Lebar video dalam piksel. | 
| imp[0].video.h | APS Direkomendasikan | Tinggi video dalam piksel. | 
| imp[0].video.plcmt | APS Direkomendasikan | Jenis penempatan (1 = in-stream). | 
| imp[0].video.podid | APS Direkomendasikan | Pengidentifikasi pod. | 
| imp[0].video.slotinpod | APS Direkomendasikan | Posisi slot di pod. | 
| imp[0].video.ext.slotId | Opsional (default:"default\_slot\_id") | ID slot APS Anda dari konsol APS. Default berfungsi tetapi memberikan ID slot Anda yang sebenarnya memungkinkan APS menerapkan penargetan khusus slot dan harga lantai. | 
| imp[0].bidfloor | Opsional (default: 1.0) | Harga penawaran minimum dalam CPM. | 
| imp[0].secure | Opsional (default: 1) | 1 = membutuhkan URL kreatif HTTPS. | 
| imp[0].id | Opsional | ID tayangan. Auto-generated jika tidak disediakan. | 
| imp[0].tagid | Opsional | Tag/placement ID. | 
| imp[0].bidfloorcur | Opsional | Mata uang dasar tawaran (USD default). | 
| imp[0].ssai | Opsional | Indikator SSAI. | 
| imp[0].exp | Opsional | Waktu kedaluwarsa untuk kesan. | 
| imp[0].rqddurs | Opsional | Array durasi yang diminta. | 
| imp[0].mincpmpersec | Opsional | Minimum CPM per detik. | 
| imp[0].pmp | Opsional | Objek pasar pribadi. | 
| imp[0].ext | Opsional | Objek ekstensi (pass-through). | 

### Referensi protokol
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| Nilai | Protokol | 
| --- | --- | 
| 1 | LUAS 1.0 | 
| 2 | LUAS 2.0 | 
| 3 | LUAS 3.0 | 
| 4 | Pembungkus VAST 1.0 | 
| 5 | Pembungkus VAST 2.0 | 
| 6 | Pembungkus VAST 3.0 | 
| 7 | LUAS 4.0 | 
| 8 | Pembungkus VAST 4.0 | 
| 9\+ | DI KEMUDIAN HARI | 

## Top-level bidang
<a name="yield-optimization-ortb-reference-top-level"></a>


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| id | Hardcode oleh EMT  | Auto-generated: {sessionId}\_{availId} format (misalnya,abc123-def456\_78901). Berguna untuk menghubungkan permintaan tawaran dengan log sesi. | 
| cur | Opsional (default:["USD"]) | Mata uang yang diizinkan. | 
| ext.integrationType | Hardcode oleh EMT  | Selalu diatur ke"EMT". | 
| bcat | Opsional | Kategori iklan yang diblokir (taksonomi IAB). Nilai template Anda dikirim apa adanya ke APS. | 
| badv | Opsional | Domain pengiklan yang diblokir. | 
| bapp | Opsional | ID bundel aplikasi yang diblokir. | 
| test | Opsional | Bendera mode uji. | 
| at | Opsional | Jenis lelang. | 
| tmax | Opsional | Waktu maksimum (ms) untuk menunggu respon tawaran. | 
| wseat | Opsional | Kursi pembeli yang diizinkan. | 
| bseat | Opsional | Kursi pembeli yang diblokir. | 
| wlang | Opsional | Bahasa kreatif yang diizinkan. | 
| source | Opsional | Objek sumber untuk rantai pasokan. | 
| ext | Opsional | Bidang ekstensi kustom Anda digabungkan dengan EMT. integrationType | 

## ``objek pengguna
<a name="yield-optimization-ortb-reference-user"></a>


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| user | APS Direkomendasikan (UE) | Diperlukan untuk lalu lintas UE dengan persetujuan GDPR. | 
| user.consent | APS Direkomendasikan (UE) | String persetujuan GDPR (TCF). | 
| user.id | Opsional | ID Pengguna. | 
| user.buyeruid | Opsional | Buyer-specific ID pengguna. | 
| user.eids | Opsional | Pengidentifikasi yang diper LiveRamp luas (, UID2, dan sebagainya). | 
| user.data | Opsional | Segmen data pengguna. | 
| user.ext | Opsional | Objek ekstensi. | 

## `objek regs`
<a name="yield-optimization-ortb-reference-regs"></a>


| Bidang | Kategori | Catatan | 
| --- | --- | --- | 
| regs | APS Direkomendasikan | Termasuk untuk kepatuhan terhadap peraturan. | 
| regs.coppa | APS Direkomendasikan (AS) | Bendera COPPA (1 = diarahkan anak). | 
| regs.us\_privacy | APS Direkomendasikan (AS) | String Privasi AS/CCPA. | 
| regs.gdpr | APS Direkomendasikan (UE) | GDPR berlaku (1 = ya). | 
| regs.gpp | APS Direkomendasikan | String Platform Privasi Global. Lebih disukai daripada us\_privacy pemirsa AS, menghasilkan tingkat pengisian yang lebih baik. Lihat [Praktik terbaik](yield-optimization-best-practices.md). | 
| regs.gpp\_sid | APS Direkomendasikan | ID bagian GPP (misalnya, [7] untuk Nasional AS). Diper gpp lukan saat hadir. | 
| regs.ext | Opsional | Objek ekstensi. | 

## Langkah selanjutnya
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ Untuk templat copy-paste, lihat. [Contoh templat](yield-optimization-examples.md)
+ Untuk rekomendasi tentang memaksimalkan tingkat pengisian, lihat[Praktik terbaik](yield-optimization-best-practices.md).