Notifikasi

Hanya tersedia di Google Ad Manager 360.

Elemen feed MRSS untuk Solusi Video

Tabel berikut mencantumkan semua kolom yang dikenali Solusi Video (dan dalam beberapa kasus, diminta) dalam feed XML Anda. Hanya elemen ini yang dikenali.

Langsung ke elemen spesifik dalam daftar

Elemen wajib
<atom:link>
<item>
<dfpvideo:contentId>
<dfpvideo:lastModifiedDate>
<dfpvideo:version>
<title>

Elemen yang opsional dan direkomendasikan
<dfpvideo:cuepoints>
<dfpvideo:keyvalues>
<dfpvideo:thirdPartyContentId>		 <media:content>
<media:status>
<media:thumbnail>		 <pubDate>
<tms:tmsId>
<tms:tmsSeriesId>

Elemen Penyisipan Iklan Dinamis

Elemen ini khusus digunakan untuk Penyisipan Iklan Dinamis, dan harus digunakan bersama dengan elemen di atas.

<dfpvideo:ingestUrl>
<dfpvideo:lastMediaModifiedDate>
<dfpvideo:closedCaptionUrl>
<dfpvideo:fw_caid>

Lihat contoh elemen dalam konteks di contoh feed.

ID konten sekarang peka huruf besar/kecil. ID konten dengan huruf besar dan kecil dianggap berbeda dari ID yang sama yang hanya berisi huruf kecil. Hal ini tecermin dalam laporan Ad Manager Anda.

Elemen wajib

<atom:link> <channel> Wajib
Deskripsi
Mengidentifikasi informasi halaman feed. Ad Manager membaca elemen ini untuk dua atribut: rel dan href.
  • rel menunjukkan cara URL dalam atribut href dikaitkan dengan kumpulan hasil feed.
    • rel='next': Menunjukkan bahwa URL href mengarahkan ke halaman kumpulan hasil feed berikutnya. Jika feed berisi tag <atom:link> dengan rel='next', hal ini menunjukkan bahwa ada halaman hasil yang lain. Jika tidak, halaman saat ini adalah halaman terakhir dalam kumpulan hasil.
  • href menentukan URL yang mengidentifikasi resource dalam tag <atom:link>.
Contoh

<atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/

Catatan penting:

  • Jika Ad Manager membuat sumber konten terlebih dahulu, Ad Manager mengharapkan bahwa kumpulan URL feed menampilkan kumpulan hasil feed yang pertama. Kumpulan hasil yang berisi 100 item (per halaman) direkomendasikan.
  • Jika elemen <atom:link> tidak disertakan dalam halaman feed, Ad Manager menganggap halaman tersebut sebagai halaman terakhir feed.

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<item> <channel> Wajib
Deskripsi
Mengidentifikasi video tunggal dalam feed. Feed video Ad Manager dapat berisi satu atau beberapa entri <item>. Setiap entri tersebut wajib berisi 3 elemen untuk penyerapan metadata yang sesuai:

<dfpvideo:contentId>, <dfpvideo:lastModifiedDate>, dan<title>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:contentId> <item> Wajib
Deskripsi
Disimpan sebagai ID konten CMS di Ad Manager, ID ini adalah parameter permintaan penting, yang dibentuk sebagai bagian permintaan iklan untuk mengidentifikasi iklan mana yang dapat ditayangkan oleh Ad Manager pada video yang sesuai.
 
Nilai ID konten harus berupa string dan peka huruf besar/kecil. Nilai ini dapat digunakan untuk parameter vid di permintaan iklan video.
Contoh
<dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:lastModifiedDate> <item> Wajib
Deskripsi

Menunjukkan waktu aspek video atau metadatanya terakhir kali diubah.

Agar Ad Manager dapat menyerap konten yang diubah, lastModifiedDate harus ditentukan dan feed harus diurutkan sehingga konten yang paling terakhir diubah ditempatkan di bagian teratas.

Semua stempel waktu harus mematuhi spesifikasi RFC 822 atau mengikuti format ISO 8601. Jika zona waktu tidak disertakan dalam string stempel waktu, zona waktunya disetel ke default menjadi Waktu Standar Pasifik (PST).

Contoh
<dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate>

<dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST
</dfpvideo:lastModifiedDate>
Lihat contoh setiap format tanggal
Contoh
RFC 822
  • Fri, 15 Jan 2021 08:00:00 EST
  • Fri, 15 Jan 2021 13:00:00 GMT
  • Fri, 15 Jan 2021 15:00:00 +0200

ISO 8601

  • 2021-01-15T12:00:00Z
  • 2021-01-15T08:00:00+01:00

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:version> <channel> Wajib
Deskripsi
Menunjukkan versi spesifikasi MRSS saat ini yang digunakan oleh feed ini. Nilai harus diisi dengan bilangan bulat, dan disetel sekali per feed.
Satu-satunya nilai yang valid saat ini untuk kolom ini adalah 2.
Contoh
<dfpvideo:version>2</dfpvideo:version>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<title> <item> Wajib
Deskripsi

Nama entri video.

Contoh
<title>My video</title>

kembali ke atas

Elemen yang opsional dan direkomendasikan

Elemen Elemen turunan dari Persyaratan
<dfpvideo:cuepoints> <item> Bervariasi *
Deskripsi

* Wajib diisi jika video berisi jeda iklan mid-roll.

Mengidentifikasi titik tanda dalam detik, yang dipisahkan dengan koma. Titik tanda adalah penempatan waktu saat iklan disisipkan dalam video.

Pecahan detik dapat ditulis hingga maksimum 3 digit (misalnya, 55.532 detik). Digit setelah digit ke-3 akan terpotong.

Ada batas maksimum 1.000 titik tanda dalam video. Setelah video mencapai batas ini, kami akan memotong semua titik tanda.

Contoh
<dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:keyvalues> <item> Opsional
Deskripsi
Mengidentifikasi metadata kustom untuk video. Elemen ini memiliki atribut berikut: key, value, dan type (yang terbatas untuk jenis data string).
 
Nilai kunci yang diserap melalui feed MRSS tunduk pada persyaratan format yang sama seperti nilai kunci yang ditentukan dalam antarmuka Ad Manager. Pastikan nilai kunci Anda sesuai dengan persyaratan format ini.
Contoh
<dfpvideo:keyvalues key="episode" value="5" type="string"/>
<dfpvideo:keyvalues key="season" value="2" type="string"/>
<dfpvideo:keyvalues key="title" value="Example Title" type="string"/>
<dfpvideo:keyvalues key="recommended count" value="5" type="string"/>
<dfpvideo:keyvalues key="description" value="A lot of text here" type="string"/>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:thirdPartyContentId> <item> Opsional
Deskripsi
Fitur ini harus diaktifkan sebelum digunakan. Untuk menggunakannya, hubungi Account Manager Anda.

Elemen ini digunakan jika Anda memiliki feed MRSS kustom yang berisi video YouTube. Tidak boleh ada dua konten MRSS di jaringan Anda yang menetapkan video YouTube yang sama.

Hanya ada satu atribut wajib untuk elemen ini:

  • Atribut "id": Atribut ini harus merujuk ke contentId di sumber konten YouTube.
Contoh
<dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<media:content> <item> Direkomendasikan
Deskripsi

Elemen ini memiliki atribut yang memberikan informasi metadata yang berguna, seperti durasi dan URL sumber. Ini adalah subelemen opsional dari <item>.

Ad Manager dapat membaca atribut elemen <media:content> berikut:

  • Atribut "duration": Ad Manager hanya mengenali satu entri durasi per <item>. Jika ada beberapa durasi yang ditentukan, durasi akan dipilih dari entri secara acak sehingga mungkin tidak sesuai dengan perkiraan Anda.

    Nilai durasi harus dalam hitungan detik (bilangan bulat, bukan desimal).

    Atribut duration diperlukan untuk menayangkan iklan mid-roll.
  • Atribut "url": URL langsung dari resource video, yang hanya digunakan untuk menampilkan link pada detail konten dalam antarmuka Ad Manager.
Contoh
<media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<media:status> <media:content> atau
<item> 		Opsional
Deskripsi
Menentukan apakah video ditandai sebagai aktif, tidak aktif, atau diarsipkan di Ad Manager. Jika elemen ini tidak disertakan, status defaultnya adalah aktif. Nilainya tidak peka huruf besar/kecil dan dapat mencakup status berikut:
  • aktif (ditandai "Aktif" di Ad Manager)
  • dihapus (ditandai "Diarsipkan" di Ad Manager; video baru yang "dihapus" tidak akan diserap)
  • diblokir (ditandai "Tidak Aktif" di Ad Manager)
Jika pengguna mengubah status video dalam Ad Manager, perubahan status apa pun berikutnya dari feed akan diabaikan. Pengguna dapat menghapus penggantian dengan mengklik Gunakan setelan sumber di antarmuka Ad Manager. Setelah itu, Ad Manager akan melanjutkan penggunaan pembaruan status dari feed.
Penayang dan partner CMS dapat mencegah konten yang sudah diupload tetapi tidak aktif/tidak digunakan lagi agar tidak dikondisikan ulang oleh Ad Manager dengan melakukan salah satu tindakan berikut:
  • (Direkomendasikan) Mendukung <media:status state="deleted"/> di feed MRSS.
  • Mempertahankan konten di feed, tetapi menghapus semua elemen terkait Penyisipan Iklan Dinamis dari konten agar konten tersebut tidak memenuhi syarat untuk penyerapan VOD. Buka bagian elemen Penyisipan Iklan Dinamis untuk mengetahui elemen tertentu yang perlu dihapus.

Status penayangan saat menayangkan melalui Penyisipan Iklan Dinamis

Status penayangan untuk Penyisipan Iklan Dinamis ditentukan dengan mempertimbangkan status sumber dan status kontennya sendiri. Berikut adalah perilaku yang dapat diharapkan saat kedua nilai dipertimbangkan:

Status sumber konten Status konten           Status penayangan             
Aktif Aktif Konten ditayangkan
Aktif Tidak aktif Konten ditayangkan
Aktif Diarsipkan Konten tidak ditayangkan (error 404)
Tidak aktif Aktif Konten tidak ditayangkan (error 404)
Tidak aktif Tidak aktif Konten tidak ditayangkan (error 404)
Tidak aktif Diarsipkan Konten tidak ditayangkan (error 404)
Diarsipkan Aktif Konten tidak ditayangkan (error 404)
Diarsipkan Tidak aktif Konten tidak ditayangkan (error 404)
Diarsipkan Diarsipkan Konten tidak ditayangkan (error 404)
 
  • Aktif: Memenuhi syarat untuk menayangkan iklan.
  • Tidak aktif: Tidak memenuhi syarat untuk menayangkan iklan. 
  • Diarsipkan: Tidak memenuhi syarat untuk menayangkan iklan yang menargetkan konten, tetapi tetap dapat menayangkan iklan run of network.

Jika status sumber konten ditandai sebagai tidak aktif atau diarsipkan, atau status konten ditandai sebagai diarsipkan, konten tidak akan ditayangkan melalui Penyisipan Iklan Dinamis.

Contoh
<media:status state="blocked" reason="http://www.reasonforblocking.com"/>
<media:status state="deleted"/>
<media:status state="active"/>

(Ad Manager tidak menyerap atribut reason.)

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<media:thumbnail> <media:content> atau
<item> 		Direkomendasikan
Deskripsi
Mengizinkan thumbnail video agar muncul di antarmuka Ad Manager. Ad Manager saat ini hanya memerlukan atribut URL dari elemen ini, tetapi Anda dapat memberikan atribut tambahan jika diinginkan: tinggi, lebar, dan waktu (durasi gambar yang direpresentasikan oleh thumbnail akan muncul di video).

Ad Manager tidak pernah menampilkan thumbnail yang berukuran lebih besar dari 280x190 piksel. Jika URL tertaut ke gambar yang lebih besar, Ad Manager akan menautkan ke versi aslinya tetapi gambar akan disesuaikan skalanya secara visual dengan CSS inline untuk ditampilkan di UI.

Contoh
<media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<pubDate> <item> Opsional
Deskripsi

Mengidentifikasi tanggal konten dipublikasikan. Elemen ini hanya digunakan untuk aturan iklan video.

Semua stempel waktu harus mematuhi spesifikasi RFC 822 atau mengikuti format ISO 8601. Jika zona waktu tidak disertakan dalam string stempel waktu, zona waktunya disetel ke default menjadi Waktu Standar Pasifik (PST).

Contoh
<pubDate>2006-02-19T04:22:39+05:00</pubDate>
<pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate>
Lihat contoh setiap format tanggal
Contoh

RFC 822

  • Wed, 31 Oct 2016 08:00:00 EST
  • Wed, 31 Oct 2016 13:00:00 GMT
  • Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
  • 20161031
  • 2016-10-31
  • 2016-10-31T08:00:00+01:00

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<tms:tmsId> <item> Opsional
Deskripsi

ID alfanumerik yang berisi 14 karakter unik untuk konten TV premium, seperti acara TV dan film, digunakan untuk mengaitkan program dengan jadwal TV atau jadwal penayangan film. ID ini ditujukan khusus untuk judul, bahasa deskripsi, dan versi program tertentu. ID tersebut digunakan untuk mengenali dan menyinkronkan aset hiburan.

Nilai untuk tmsId harus dimulai denganEP (episode), MV (film), atauSP (olahraga).

Pelajari ID Gracenote (TMS) lebih lanjut.

Contoh
<tms:tmsId>EP123456789000</tms:tmsId>
<tms:tmsId>MV123456789000</tms:tmsId>
<tms:tmsId>SP123456789000</tms:tmsId>

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<tms:tmsSeriesId> <item> Opsional
Deskripsi

Sama halnya dengan elemen <tmsId>, ID ini adalah ID alfanumerik yang berisi 14 karakter unik dari program induk seri.

Nilai untuk tmsSeriesId harus dimulai dengan SH (show/acara).

Pelajari ID Gracenote (TMS) lebih lanjut.

Contoh
<tms:tmsSeriesId>SH12345678000</tms:tmsSeriesId>

Elemen yang khusus digunakan untuk Penyisipan Iklan Dinamis

Elemen Elemen turunan dari Persyaratan
<dfpvideo:ingestUrl> <item> Wajib *
Deskripsi

* Wajib diisi untuk Penyisipan Iklan Dinamis.

Node untuk menetapkan URL penyerapan video ke file m3u8 master digunakan untuk pengondisian dan pembuatan playlist.

  • Atribut "type": harus disetel ke application/x-mpegURL untuk HLS, atau application/dash+xml untuk DASH.
  • Atribut "preconditioned": harus disetel ke true atau false guna menunjukkan apakah ingestURL bagi konten ini sudah dikondisikan untuk iklan mid-roll, artinya segmen telah dipisah saat jeda iklan. Atribut ini secara default disetel ke false jika tidak ditetapkan secara eksplisit.

    Konten dianggap telah ditentukan jika segmen video dalam streaming waktunya tepat bagi titik tanda menyisipkan iklan. Jika sudah ditentukan, seharusnya terdapat penanda #EXT-X-PLACEMENT-OPPORTUNITY di streaming HLS untuk menunjukkan ke Ad Manager bahwa jeda iklan seharusnya disisipkan pada titik ini dalam konten video.

    Pelajari lebih lanjut konten yang ditentukan dan konten yang ditentukan sebelumnya untuk penyisipan iklan mid-roll.

Contoh
Untuk HLS
<dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl>
Untuk DASH
<dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true">
https://cdn.example.com//playlist.mpd
</dfpvideo:ingestUrl>
Satu konten video dapat berisi HLS dan DASH. Sebaiknya gunakan URL penyerapan yang aman (https).

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:lastMediaModifiedDate> <item> Direkomendasikan
Deskripsi

Menunjukkan waktu file video yang dirujuk di <dfpvideo:ingestUrl> terakhir kali diubah. Jika nilai ini pernah diperbarui pada feed, lastModifiedDate untuk konten juga perlu diperbarui.

Semua stempel waktu harus mematuhi spesifikasi RFC 822 atau mengikuti format ISO 8601. Jika zona waktu tidak disertakan dalam string stempel waktu, zona waktunya disetel ke default menjadi Waktu Standar Pasifik (PST).

Contoh
<dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>
<dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39
+0000</dfpvideo:lastMediaModifiedDate>
Lihat contoh setiap format tanggal
Contoh
RFC 822
  • Wed, 31 Oct 2016 08:00:00 EST
  • Wed, 31 Oct 2016 13:00:00 GMT
  • Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
  • 20161031
  • 2016-10-31
  • 2016-10-31T08:00:00+01:00

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:closedCaptionUrl> <item> Bervariasi *
Deskripsi

* Hanya diperlukan jika Anda telah mengaktifkan subtitel di antarmuka.

Node untuk menetapkan URL ke file subtitel/teks tertutup. Semua file teks tertutup yang tersedia harus diberikan di feed sebagai beberapa elemen closedCaptionUrl satu file teks per bahasa.

Subtitel manifes HLS untuk video on demand
Jika elemen feed ini ada, hanya subtitel dari feed yang akan diserap dan subtitel yang ditentukan dalam manifes HLS akan diabaikan. Subtitel manifes HLS hanya diserap jika tidak ada elemen feed subtitel.

Format yang didukung adalah TTML/DXFP (application/ttaf+xml) dan WebVTT (text/vtt).

  • Atribut "language": wajib diisi (tidak boleh kosong), dan harus disetel ke bahasa file teks. Atribut ini harus mematuhi RFC5646, dan tidak boleh berisi string "$$$$$". Penggunaan atribut ini mirip dengan atribut xml:lang seperti yang tercantum dalam XML.
  • Atribut "name": tidak boleh berisi string "$$$$$".
  • Atribut "type": harus disetel ke jenis MIME file teks.
  • Atribut "characteristics": harus disetel ke salah satu string berikut (atau dapat dikosongkan):**
    • "public.accessibility.transcribes-spoken-dialog"
    • "public.accessibility.describes-music-and-sound"
    • "public.easy-to-read"

** Akan ada peringatan jika "characteristics" tidak sesuai dengan string di atas, tetapi atribut tersebut akan tetap berfungsi.

Untuk sumber konten tunggal, kombinasi language dan name harus unik untuk setiap file teks tertutup. Misalnya, [language="en", name="English"] dan [language="en", name="English (CC)"].

Contoh

<dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl>

<dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl

kembali ke atas

Elemen Elemen turunan dari Persyaratan
<dfpvideo:fw_caid> <item> Bervariasi *
Deskripsi

* Hanya diperlukan bagi pengguna Freewheel.

Node untuk menetapkan ID aset kustom Freewheel yang digunakan untuk penargetan iklan.

Contoh
<dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

kembali ke atas

Untuk mengatasi persoalan terkait pemecahan masalah atau pemadaman DAI, hubungi dukungan penayang.

Apakah ini membantu?

Bagaimana cara meningkatkannya?

Perlu bantuan lain?

Coba langkah-langkah selanjutnya berikut:

Posting ke komunitas bantuan Dapatkan jawaban dari anggota komunitas
Hubungi kami Beri tahu kami selengkapnya dan kami akan membantu Anda
true
Memulai Penyisipan Iklan Dinamis

Panduan kami untuk memberikan pengalaman iklan tanpa kendala di seluruh konten video live, linear, dan on-demand.
Lihat panduan

Telusuri
Hapus penelusuran
Tutup penelusuran
Menu utama
9373788086923597255
true
Pusat Bantuan Penelusuran
true
true
true
true
true
148
false
false