VOD yayın atlanabilir reklamları

Bu kılavuzda, atlanabilen reklamların yerine, atla düğmesini Google Ads koşulları ve ilişkili izleme etkinliklerini gönderebilir.

Ön koşullar

Atlanabilir reklamlar için istekte bulunma

Atlanabilir reklamlar içeren VOD yayını isteğinde bulunmak için dai-sas parametresini akış isteği.

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ğinize birden fazla akış parametresi eklemek için gövde:

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

Reklam atlama sorununu çözme

Reklamları atlama işlemini başlatmak için Ad struct veya AdBreak atlayıp atlamadığınıza bağlı olarak bir "yapılacaklar" listesi oluşturabilirsiniz. start değerini alıp duration değerini ekleyin, ardından şu noktaya gidin: akışla değiştirebilirsiniz. İlgili içeriği oluşturmak için kullanılan SkipMetadata alt mesaj, offset değerini de içerir. Bu değer, saniye cinsinden geçilebilir. 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ış içinde başladığı konum: saniye.
duration (number) Reklamın saniye cinsinden süresi.
skip_metadata (object(SkipMetadata)) Atlanabilir için isteğe bağlı meta veriler reklam. Ayarlanırsa bu, reklamın atlanabilir olduğunu gösterir ve atlama kullanıcı arayüzü ve izleme etkinliğinin nasıl işleneceğine ilişkin talimatlar.
offset (sayı) Kaydırma saniyenin sonunda oynatıcı, oluşturmak için beklemesi gereken atla düğmesi. VAST'ta sağlanmazsa atlanır.
tracking_url (dize) Atlamada pinglenmesi gereken bir URL unutmayın.

Ö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ımda oluşturun gereksinimlerini karşılayın. Bu koşullara uyulmaması kısıtlamalara neden olabilir sitenize veya uygulamanıza sunulan Google reklamlarına yerleştirilen içeriklerdir.

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 bir bildirim göstermelisiniz. reklamın X saniye içinde atlanabilmesini sağlamalıdır. Bildirim şu dile çevrilmelidir: kullanıcının dili.

Atla düğmesi konumu

Dilin soldan sağa doğru yüklenmesi için atla düğmesini sayfanın sağ alt tarafına yerleştirin değiştirilebilir. Sağdan sola yazılan bir dilde ise atla düğmesini video oynatıcının sol alt tarafında.

Atla düğmesi boyutu

Düğme ve metin, arkaya yaslanıp rahatça okunabilecek kadar büyük olmalıdır sunmaktır.

Metin ve simge

Atla düğmesinde hem metin hem de ikon olmalıdır. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için sonraki materyali atla simgesini seçin.

Erişilebilirlik

Kullanıcı bir klavye veya klavye kullanarak atla düğmesine gidebilmelidir. uzaktan kumandaya dokunun. Geri sayım başladığında uygulama "atla" düğmesine odaklanır belirir.

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 reklamı atlamak için kullanılabilir emin olabiliyoruz.

"Reklamı atla" çeviriler

Tekliflerinizi otomatikleştirmek ve optimize etmek için skipAdTranslations.json dosyası "Reklamı atla" reklamınızı çevirmek için kullanıcının yerel ayarına göre metin.