Seç-izle yayınlarında atlanabilir reklamları etkinleştirme

Bu kılavuzda, atlanabilir reklamlar içeren bir VOD akışı istemek, atlama 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 reklam isteği gönderme

Atlanabilir reklamlar içeren bir seç-izle akışı istemek için dai-sas parametresini akış isteğinizde 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 içerik yönetim sistemi kimliği.
{VIDEO_ID} Yayının video kimliği.

Vücut parametreleri

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

Örnek istek (cURL)

HLS yayın 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'deki 'dash' yerine şunu ekleyin:

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

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

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

Reklam atlama işlemini yönetme

Reklam atlama işlemini yönetmek için mevcut reklamı mı yoksa reklam arasının tamamını mı atladığınıza bağlı olarak Ad veya AdBreak yapılarındaki bilgileri kullanın. start değerini alıp duration değerini ekleyin, ardından akışta bu noktaya gidin. SkipMetadata alt mesajı, reklamın atlanabilir hale gelmesine kalan süreyi saniye cinsinden ifade eden offset değerini de içerir. SkipMetadata alt mesajı yalnızca atlanabilir reklamlara dahil edilir.

ad_breaks Reklam aralarının listesi.
start (sayı) Aranın başladığı yayının konumu (saniye cinsinden).
duration (sayı) Reklam arasının saniye cinsinden süresi.
ads (object(Ad)) Akıştaki reklamların listesi.
start (sayı) Akıştaki reklamın başladığı konum (saniye cinsinden).
duration (sayı) Reklamın süresi (saniye cinsinden).
skip_metadata (object(SkipMetadata)) Atlanabilir reklamlar için isteğe bağlı meta veriler. Bu ayar, reklamın atlanabilir olduğunu gösterir ve atlama kullanıcı arayüzünün ve izleme etkinliğinin nasıl ele alınacağına dair talimatlar içerir.
offset (sayı) Ofset, oynatıcının atlama düğmesini oluşturmak için reklamın başından itibaren beklemesi 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ığında, yayın yanıtına dahil edilen atlama etkinliği URL'sini pingleyin. SkipMetadata alt mesajına dahil edilir.

Atla düğmesi şartları

Atlanabilir reklamlarda atlama düğmesini aşağıdaki tasarım koşullarını karşılayacak şekilde oluşturun. Bu şartlara uyulmaması, sitenizde veya uygulamanızda yayınlanan Google reklamlarına kısıtlamalar uygulanmasına neden olabilir.

Geri sayım saati

Reklam, VAST'ta belirtilen skipoffset zamanına kadar atlanabilir olmamalıdır. Bu atlanabilir olmayan 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

Soldan sağa doğru yazılan diller için atlama düğmesini video oynatıcının sağ alt tarafına yerleştirin. Sağdan sola yazılan diller için atlama düğmesini video oynatıcının sol alt tarafına yerleştirin.

Atla düğmesi boyutu

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

Metin ve simge

Atlama düğmesinde hem metin hem de simge olmalıdır. Simge olarak sonraki materyali atlama simgesini kullanabilirsiniz.

Erişilebilirlik

Kullanıcı, klavye veya uzaktan kumanda kullanarak atlama düğmesine gidebilmelidir. Geri sayım tamamlandığında uygulama, atlama düğmesine odaklanmalıdır.

Uluslararası hale getirme

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

Reklam kapsülleri

Atlama düğmesi, reklam kapsülünde gösterilen mevcut 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.