VOD yayın atlanabilir reklamları

Bu kılavuzda, atlanabilir reklamlar içeren bir VOD yayını istemek, atla düğmesini Google Ads koşullarına göre oluşturmak ve ilişkili izleme etkinliklerini göndermek için DAI API'nin nasıl kullanılacağı gösterilmektedir.

Ön koşullar

Atlanabilir reklamlar için istekte bulunma

Atlanabilir reklamlar içeren VOD yayını isteğinde bulunmak için yayın isteğinizde dai-sas parametresini iletmeniz gerekir.

API uç noktası

POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded

Yol parametreleri

{CMS_ID} Akışın İYS kimliği.
{VIDEO_ID} Akışın video kimliği.

Gövde parametreleri

dai-sas Atlanabilir reklamları etkinleştirmek için dai-sas=1 değerini ayarlayın.

Örnek istek (cURL)

HLS akış istekleri için:

curl -X POST \
     -d 'dai-sas=1' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream

DASH akışları için URL'de 'dash' ifadesini kullanın:

https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream

İsteğinizin gövdesine birden çok akış parametresi eklemek için aşağıdaki biçimi kullanın:

-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \

Reklam atlama sorununu çözme

Atlanan reklamları yönetmek için geçerli reklamı mı yoksa reklam arasının tamamını mı atladığınıza bağlı olarak Adstruct veya AdBreakstruct'taki bilgileri kullanın. start değerini alıp duration değerini ekleyin, ardından akışta bu noktaya gidin. SkipMetadata alt mesajı, reklamın atlanabilmesi için saniye cinsinden bir değer olan offset değerini de içerir. SkipMetadata alt mesajı yalnızca atlanabilir reklamlara dahil edilir.

ad_breaks Reklam aralarının listesi.
start (number) Akışta aranın başladığı konum (saniye cinsinden).
duration (number) Reklam arasının saniye cinsinden süresi.
ads (object(Ad)) Akıştaki Reklamların listesi.
start (number) Reklamın, akışta saniye cinsinden başlatıldığı konum.
duration (number) Reklamın saniye cinsinden süresi.
skip_metadata (object(SkipMetadata)) Atlanabilir reklamlar için isteğe bağlı meta veriler. Ayarlanırsa bu, reklamın atlanabilir olduğunu gösterir ve atlama kullanıcı arayüzü ile izleme etkinliğinin nasıl işleneceğine ilişkin talimatları içerir.
offset (number) ofset, oynatıcının atla düğmesini oluşturmak için reklama geçmesi gereken süreyi saniye cinsinden gösterir. VAST'ta sağlanmazsa atlanır.
tracking_url (dize) Atlama etkinliğinde pinglenmesi gereken bir URL.

Örnek yanıt

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

Reklam atlandıktan sonra, akış yanıtında bulunan atlama etkinliği URL'sini pingleyin. Bu öneri, SkipMetadata alt mesajda yer almaktadır.

Atla düğmesi gereksinimleri

Atlanabilir reklamlar için atla düğmesini aşağıdaki tasarım gereksinimlerine göre oluşturun. Bu şartlara uyulmaması, sitenize veya uygulamanıza Google reklamlarının sunulmasına kısıtlamalar uygulanmasına neden olabilir.

Geri sayım saati

Reklam, VAST'ta belirtilen skipoffset süresine kadar atlanabilir olmamalıdır. Bu atlanamayan bu süre boyunca kullanıcıya reklamın X saniye içinde atlanabileceğini bildiren bir bildirim göstermeniz gerekir. Bildirim, kullanıcının diline çevrilmelidir.

Atla düğmesi konumu

Dilin soldan sağa doğru ayarlanması için atla düğmesini video oynatıcının sağ alt tarafına yerleştirin. Dilin sağdan sola okunması için atla düğmesini video oynatıcının sol alt kısmına yerleştirin.

Atla düğmesi boyutu

Düğme ve metin, rahat bir deneyimde açıkça okunabilecek kadar büyük olmalıdır.

Metin ve simge

Atla düğmesinde hem metin hem de ikon olmalıdır. Simgeniz olarak sonraki materyali atla simgesini kullanabilirsiniz.

Erişilebilirlik

Kullanıcı, bir klavye veya uzaktan kumandayı kullanarak atla düğmesine gidebilmelidir. Geri sayım tamamlandığında uygulama "atla" düğmesine odaklanır.

Uluslararası hale getirme

Atlama metninin kullanıcının diline çevrilmesi önerilir.

Reklam kapsülleri

Atla düğmesi, reklam kapsülündeki geçerli reklamı veya kapsülün tamamını atlamak için kullanılabilir.

"Reklamı atla" çevirileri

"Reklamı atla" metninizi kullanıcının yerel ayarına göre çevirmek için skipAdTranslations.json dosyasını kullanın.