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
- VOD akışları için DAI API çağrılarını uygulayan bir uygulama. Daha fazla bilgi için DAI API VOD akış kılavuzuna bakın.
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 Ad
struct veya AdBreak
struct'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.
|
Ö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.