Bildirim

Yalnızca Google Ad Manager 360'ta kullanılabilir.

Video Çözümleri için MRSS feed öğeleri

Aşağıdaki tabloda, Video Çözümleri'nin XML feed'inizde tanıdığı (ve bazı durumlarda olmasını beklediği) tüm alanlar listelenmiştir. Yalnızca bu öğeler tanınır.

Listedeki belirli bir öğeye gidin

Gerekli öğeler
<atom:link>
<item>
<dfpvideo:contentId>
<dfpvideo:lastModifiedDate>
<dfpvideo:version>
<title>

Önerilen ve isteğe bağlı öğeler
<dfpvideo:cuepoints>
<dfpvideo:keyvalues>
<dfpvideo:thirdPartyContentId>		 <media:content>
<media:status>

<media:thumbnail>
<pubDate>

Dinamik Reklam Ekleme öğeleri

Bu öğeler, Dinamik Reklam Ekleme'ye özeldir ve yukarıdaki öğelerle birlikte kullanılmalıdır.

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

Örnek feed'de öğelerin bağlam içindeki bir örneğini görebilirsiniz.

İçerik kimliği artık büyük/küçük harfe duyarlıdır. Hem büyük hem de küçük harf içeren bir içerik kimliği, onunla aynı olan ancak yalnızca küçük harflerle yazılan kimlikten farklı olarak kabul edilir. Bu durum, Ad Manager raporlarınızda da böyle gösterilir.

Gerekli öğeler

<atom:link> <channel> Zorunlu
Açıklama
Feed'in sayfa oluşturma bilgilerini tanımlar. Ad Manager, bu öğeyi iki özellik için okur: rel ve href.
  • rel, href özelliğindeki URL'nin, feed'in sonuç grubuyla nasıl ilgili olduğunu belirtir.
  • rel='next': href URL'sinin, özet akışı sonuç grubunun sonraki sayfasına işaret ettiğini belirtir. Feed'de rel='next' içeren bir <atom:link> etiketi varsa bu durum başka bir sonuç sayfası olduğunu gösterir. Aksi takdirde geçerli sayfa, sonuç grubundaki son sayfadır.
  • href, <atom:link> etiketinde kaynağı tanımlayan bir URL'yi belirtir.
    • Örnek

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

    Önemli notlar:

    • Ad Manager ilk kez bir içerik kaynağı oluşturduğunda feed URL grubunun, feed'in ilk sonuç grubunu döndürmesini bekler. 100 öğelik (sayfa başına) bir sonuç grubu önerilir.
    • Feed sayfasında <atom:link> öğesi yoksa Ad Manager bu sayfayı, feed'in son sayfası olarak değerlendirir.

    başa dön

    Öğe Üst öğesi Gereklilik
    <item> <channel> Zorunlu
    Açıklama
    Feed'deki tek bir videoyu tanımlar. Ad Manager video feed'leri, bir veya daha fazla <item> girişi içerebilir. Her giriş, düzgün meta veri beslemesi için üç öğe içermek zorundadır:

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

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:contentId> <item> Zorunlu
    Açıklama
    Ad Manager'da CMS içerik kimliği olarak saklanan bu parametre, Ad Manager'ın ilgili videoya göre hangi reklamları yayınlayabileceğini belirlemek için reklam isteğinin bir parçası olarak biçimlendirilen önemli bir istek parametresidir.
     
    İçerik kimliği değeri bir dize olmalıdır ve büyük/küçük harfe duyarlıdır. Değer, bir video reklam isteğindeki vid parametresi için kullanılabilir.
    Örnek
    <dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:lastModifiedDate> <item> Zorunlu
    Açıklama

    Videonun herhangi bir özelliğinin veya meta verilerinin en son değiştirildiği tarihi belirtir.

    Ad Manager'ın değiştirilmiş içeriği beslemesi için lastModifiedDate belirtilmiş olmalı ve feed en son değiştirilen içerik en üstte olacak şekilde sıralanmalıdır.

    Tüm zaman damgaları, RFC 822 spesifikasyonuna uymalı veya IS0 8601 biçimini izlemelidir. Saat dilimi, zaman damgası dizesine dahil değilse varsayılan olarak Pasifik Standart Saati (PST) olur.

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

    <dfpvideo:lastModifiedDate>Cum, 15 Oca 2021 08:00:00 EST
    </dfpvideo:lastModifiedDate>
    Tarih biçimi örneklerini inceleyin
    Örnekler
    RFC 822
    • Cum, 15 Oca 2021 08:00:00 EST
    • Cum, 15 Oca 2021 13:00:00 GMT
    • Cum, 15 Oca 2021 15:00:00 +0200

    ISO 8601

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

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:version> <channel> Zorunlu
    Açıklama
    Bu feed'in kullandığı MRSS spesifikasyonunun geçerli sürümünü belirtir. Değer bir tam sayı ile doldurulmalı ve feed başına bir kez ayarlanmalıdır.
    Bu alan için geçerli tek değer 2'dir.
    Örnek
    <dfpvideo:version>2</dfpvideo:version>

    başa dön

    Öğe Üst öğesi Gereklilik
    <title> <item> Zorunlu
    Açıklama

    Video girişinin adı.

    Örnek
    <title>Videom</title>

    başa dön

    Önerilen ve isteğe bağlı öğeler

    Öğe Üst öğesi Gereklilik
    <dfpvideo:cuepoints> <item> Değişiklik gösterir *
    Açıklama

    * Video, videonun ortasında gösterilen reklam araları içeriyorsa zorunludur.

    Saniye cinsinden işaret noktalarını virgüllerle ayrılmış olarak tanımlar. İşaret noktaları, videoda bir reklamın eklenebileceği zamanlardır.

    Kesirli saniyeler en fazla 3 basamak için desteklenir (örneğin, 55,532 saniye). 3. basamaktan sonrası kesilir.

    Videolarda maksimum 1.000 işaret noktası sınırı vardır. Bir video bu sınıra ulaştığında tüm işaret noktaları kısaltılır.

    Örnek
    <dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:keyvalues> <item> İsteğe bağlı
    Açıklama
    Video için herhangi bir özel meta veri tanımlar. Şu özelliklere sahiptir: key, value ve type (string veri türleriyle sınırlıdır).
     
    MRSS feed'inizle beslenen anahtar/değer çiftleri, Ad Manager arayüzünde tanımlanan anahtar/değer çiftleriyle aynı biçim gereksinimlerine tabidir. Anahtar/değer çiftlerinizin bu biçim gereksinimleriyle uyumlu olmasını sağlayın.
    Örnekler
    <dfpvideo:keyvalues key="episode" value="5" type="string"/>
    <dfpvideo:keyvalues key="season" value="2" type="string"/>
    <dfpvideo:keyvalues key="title" value="Örnek Başlık" type="string"/>
    <dfpvideo:keyvalues key="recommended count" value="5" type="string"/>
    <dfpvideo:keyvalues key="description" value="Burada çok fazla metin var" type="string"/>

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:thirdPartyContentId> <item> İsteğe bağlı
    Açıklama
    Bu özelliğin, kullanılmadan önce etkinleştirilmesi gerekir. Kullanmak için hesap yöneticinize başvurun.

    Bu öğe, YouTube videoları içeren özel bir MRSS feed'iniz varsa kullanılır. Ağınızdaki MRSS içerikleri aynı YouTube videosunu belirtemez.

    Bu öğe için yalnızca bir tane gerekli özellik vardır:

    • "id" özelliği: Bu, YouTube içerik kaynağındaki contentId'ye başvurmalıdır.
    Örnek
    <dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

    başa dön

    Öğe Üst öğesi Gereklilik
    <media:content> <item> Öneri:
    Açıklama

    Bu öğenin, kaynak URL'si ve süre gibi yararlı meta veri bilgileri sağlayan özellikleri vardır. Bu, <item> öğesinin isteğe bağlı bir alt öğesidir.

    Ad Manager, <media:content> öğesinin şu özelliklerini okuyabilir:

    • "duration" özelliği: Ad Manager, her <item> öğesi için yalnızca bir süreyi tanır. Birden fazla belirtilirse süre rastgele bir girişten seçilir. Beklenmedik bir süre seçilebilir.

      Süre değeri saniye cinsinden olmalıdır (tam sayı cinsinden; ondalıksız).

      Videonun ortasında gösterilen reklamları yayınlamak için duration özelliği gereklidir.
    • "url" özelliği: Video kaynağının doğrudan URL'si. Yalnızca Ad Manager arayüzündeki içerik ayrıntılarında bir bağlantı göstermek için kullanılır.
    Örnek
    <media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

    başa dön

    Öğe Üst öğesi Gereklilik
    <media:status> <media:content> veya
    <item>     		İsteğe bağlı
    Açıklama
    Videonun Ad Manager'da etkin, etkin değil veya arşivlendi seçeneklerinden hangisiyle işaretlendiğini belirler. Bu öğe yoksa varsayılan durum etkindir. Değerler küçük/büyük harfe duyarlı değildir ve aşağıdaki durumu içerebilir:
    • etkin (Ad Manager'da "Etkin" olarak işaretlenir)
    • silinmiş (Ad Manager'da "Arşivlendi" olarak işaretlenir; yeni "silinmiş" videolar beslenmez)
    • engellenmiş (Ad Manager'da "Etkin değil" olarak işaretlenir)
    Bir kullanıcı Ad Manager içindeki belirli bir videonun durumunu değiştirirse feed'de yapılan sonraki durum değişiklikleri yok sayılır. Kullanıcı, Ad Manager kullanıcı arayüzünde Kaynak ayarını kullan'ı tıklayarak geçersiz kılmayı kaldırabilir. Bu işlemden sonra Ad Manager, feed'deki durum güncellemelerini kullanmaya devam edecektir.
    Yayıncılar ve İYS iş ortakları, aşağıdakilerden birini gerçekleştirerek önceden yüklenmiş ancak etkin olmayan/desteği sonlandırılmış içeriğin Ad Manager tarafından yeniden koşullandırılmasını önleyebilir:
    • (Önerilen) MRSS feed'inde <media:status state=" deleted"/> ifadesini destekleme.
    • İçeriği feed'de tutun ancak içeriği VOD beslemesi için uygun olmayan hâle getirmek üzere dinamik reklam eklemeyle ilgili tüm öğeleri içerikten kaldırın. Kaldırılacak belirli öğeler için Dinamik Reklam Ekleme öğeleri bölümüne gidin.

    Dinamik Reklam Ekleme ile yayın sırasında yayın durumu

    Dinamik Reklam Ekleme yayın durumu, hem kaynağın hem de içeriğin durumu dikkate alınarak belirlenir. Aşağıda, iki değer de dikkate alındığında bekleyebileceğiniz davranışları görebilirsiniz:

    İçerik kaynağı durumu İçerik durumu           Yayın durumu             
    Etkin Etkin İçerik yayınlanır
    Etkin Etkin değil İçerik yayınlanır
    Etkin Arşivlendi İçerik yayınlanmaz (404 hatası)
    Etkin değil Etkin İçerik yayınlanmaz (404 hatası)
    Etkin değil Etkin değil İçerik yayınlanmaz (404 hatası)
    Etkin değil Arşivlendi İçerik yayınlanmaz (404 hatası)
    Arşivlendi Etkin İçerik yayınlanmaz (404 hatası)
    Arşivlendi Etkin değil İçerik yayınlanmaz (404 hatası)
    Arşivlendi Arşivlendi İçerik yayınlanmaz (404 hatası)
     
    • Etkin: Reklam yayınlamaya uygundur.
    • Etkin değil: Reklam yayınlamaya uygun değildir. 
    • Arşivlendi: İçerik hedefli reklam yayınlamaya uygun değildir ancak tüm ağ hedefli reklamları yayınlayabilir.

    İçerik kaynağı durumu etkin değil, arşivlenmiş veya içerik durumu arşivlenmiş olarak işaretlenirse Dinamik Reklam Ekleme aracılığıyla yayınlanmaz.

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

    (Ad Manager, reason özelliğini beslemez.)

    başa dön

    Öğe Üst öğesi Gereklilik
    <media:thumbnail> <media:content> veya
    <item>     		Öneri:
    Açıklama
    Videonun küçük resminin, Ad Manager arayüzünde gösterilmesini sağlar. Ad Manager şu anda bu öğenin yalnızca URL özelliğine ihtiyaç duyar ancak isterseniz şu ek özellikleri sağlayabilirsiniz: yükseklik, genişlik ve zaman (küçük resimle gösterilen görüntünün videoda görünme süresi).

    Ad Manager arayüzü, hiçbir zaman 280 pikselden geniş ve 190 pikselden yüksek bir küçük resim göstermez. URL büyük bir resme bağlanıyorsa Ad Manager orijinal sürüme bağlanır ancak resmi, kullanıcı arayüzünde gösterilmesi için satır içi CSS ile görsel olarak ölçeklendirir.

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

    başa dön

    Öğe Üst öğesi Gereklilik
    <pubDate> <item> İsteğe bağlı
    Açıklama

    İçeriğin yayınlandığı tarihi belirtir. Bu öğe, yalnızca video reklam kuralları için kullanılır.

    Tüm zaman damgaları, RFC 822 spesifikasyonuna uymalı veya IS0 8601 biçimini izlemelidir. Saat dilimi, zaman damgası dizesine dahil değilse varsayılan olarak Pasifik Standart Saati (PST) olur.

    Örnekler
    <pubDate>2006-02-19T04:22:39+05:00</pubDate>
    <pubDate>Paz, 19 Şubat 2006 09:22:39 +0000</pubDate>
    Tarih biçimi örneklerini inceleyin
    Örnekler

    RFC 822

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

    başa dön

    Dinamik Reklam Ekleme'ye özel öğeler

    Öğe Üst öğesi Gereklilik
    <dfpvideo:ingestUrl> <item> Gerekli *
    Açıklama

    * Dinamik Reklam Ekleme için zorunludur.

    Koşullandırma ve oynatma listesi oluşturma için kullanılan ana m3u8 dosyasının video besleme URL'sini belirten düğüm.

    • "type" özelliği: HLS için application/x-mpegURL, DASH için application/dash+xml olarak ayarlanmalıdır.
    • "preconditioned" özelliği: Bu içeriğe ait ingestURL öğesinin videonun ortasında gösterilen reklamlar için koşullandırılıp koşullandırılmadığını belirtecek şekilde true veya false olarak ayarlanmalıdır. Bu, segmentlerinizin reklam araları sırasında zaten bölündüğünü gösterir. Bu özellik, açıkça belirtilmediği takdirde varsayılan olarak false olur.

      Akışınızdaki video segmentleri, reklam eklemek üzere işaret noktaları için hassas bir şekilde zamanlanmışsa içerik koşullandırılmış olarak kabul edilir. Bu durumda, Ad Manager'da video içeriğindeki bu noktaya bir reklam arasının eklenmesi gerektiğini belirtmek için HLS akışında bir #EXT-X-PLACEMENT-OPPORTUNITY işareti olmalıdır.

      Videonun ortasında gösterilen reklam ekleme için koşullandırılmış ve önceden koşullandırılmış içerik hakkında daha fazla bilgi

    Örnekler
    HLS için
    <dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl>
    DASH için
    <dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true">
    https://cdn.example.com//playlist.mpd
    </dfpvideo:ingestUrl>
    Tek bir video içeriği parçasında hem HLS hem de DASH olabilir. Güvenli (https) besleme URL'lerinin kullanılması önerilir.

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:lastMediaModifiedDate> <item> Öneri:
    Açıklama

    <dfpvideo:ingestUrl> içinde başvurulan video dosyasının en son ne zaman değiştirildiğini belirtir. Bu değer feed'de herhangi bir zamanda güncellenirse içeriğin lastModifiedDate değeri de güncellenmelidir.

    Tüm zaman damgaları, RFC 822 spesifikasyonuna uymalı veya IS0 8601 biçimini izlemelidir. Saat dilimi, zaman damgası dizesine dahil değilse varsayılan olarak Pasifik Standart Saati (PST) olur.

    Örnekler
    <dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>
    <dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39
    +0000</dfpvideo:lastMediaModifiedDate>
    Tarih biçimi örneklerini inceleyin
    Örnekler
    RFC 822
    • Çar, 31 Eki 2016 08:00:00 EST
    • Çar, 31 Eki 2016 13:00:00 GMT
    • Çar, 31 Eki 2016 15:00:00 +0200
    ISO 8601
    • 20161031
    • 2016-10-31
    • 2016-10-31T08:00:00+01:00

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:closedCaptionUrl> <item> Değişiklik gösterir *
    Açıklama

    * Yalnızca arayüzde altyazıları etkinleştirdiğinizde gerekir.

    Altyazı dosyasının URL'sini belirten düğüm. Kullanılabilir tüm altyazı dosyaları, feed'de her dil için bir altyazı dosyası olacak şekilde birden fazla closedCaptionUrl öğesi olarak sağlanmalıdır.

    Seç-izle video için HLS manifest altyazıları
    Bu feed öğesi mevcutsa yalnızca feed'den alınan altyazılar beslenir ve HLS manifestinde belirtilen altyazılar yok sayılır. HLS manifest altyazıları yalnızca altyazı feed öğesi yoksa beslenir.

    Desteklenen biçimler TTML/DXFP (app/ttaf+xml) ve WebVTT'dir (text/vtt).

    • "language" özelliği: Gereklidir (boş olamaz) ve altyazı dosyasının diline ayarlanmalıdır. RFC5646 ile uyumlu olmalıdır ve "$$$$$" dizesini içeremez. Bu özellik, XML'de ayrıntılı olarak açıklanan xml:lang özelliğine benzer şekilde kullanılır.
    • "name" özelliği: "$$$$$" dizesini içeremez.
    • "type" özelliği: Altyazı dosyalarının MIME türüne ayarlanmalıdır.
    • "characteristics" özelliği: Aşağıdakilerden birine ayarlanmalıdır (veya boş olabilir):**
      • "public.accessibility.transcribes-spoken-dialog"
      • "public.accessibility.describes-music-and-sound"
      • "public.easy-to-read"

    ** "characteristics" özelliği yukarıdaki şekillerde ayarlanmazsa bir uyarı gösterilir ancak özellik yine de çalışır.

    Tek bir içerik kaynağı söz konusu olduğunda language ve name kombinasyonu, her bir altyazı dosyası için benzersiz olmalıdır. Örneğin, [language="en", name="English"] and [language="en", name="English (CC)"].

    Örnekler

    <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

    başa dön

    Öğe Üst öğesi Gereklilik
    <dfpvideo:fw_caid> <item> Değişiklik gösterir *
    Açıklama

    * Yalnızca Freewheel kullanıcıları için gerekir.

    Reklam hedeflemesi için kullanılan Freewheel özel öğe kimliğini belirten düğüm.

    Örnek
    <dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

    başa dön

    DAI sorunlarını giderme veya kesintilerle ilgili konular için yayıncı destek ekibiyle iletişime geçin.

    Bu size yardımcı oldu mu?

    Bunu nasıl iyileştirebiliriz?

    Daha fazla yardıma mı ihtiyacınız var?

    Bir sonraki adımları deneyin:

    Yardım topluluğunda yayınlayın Topluluk üyelerinden sorularınıza cevap alın
    Bize ulaşın Bize daha fazla bilgi verin, size yardımcı olalım
    true
    Dinamik Reklam Ekleme'yi kullanmaya başlayın

    Canlı, doğrusal ve isteğe bağlı video içeriğinde sorunsuz bir reklam deneyimi sunma rehberimiz.
    Rehberi inceleyin

    Arama
    Aramayı temizle
    Aramayı kapat
    Ana menü
    92323766982668674
    true
    Yardım Merkezinde Arayın
    true
    true
    true
    true
    true
    148
    false
    false