Aşağıdaki tabloda, Ad Exchange yayın içi video etiketlerinin yayıncılar için nasıl ayarlanabileceği gösterilmiştir. Video için reklam etiketi oluşturduktan ve description_url
gibi gerekli parametreleri dahil ettikten sonra, istediğiniz reklam yanıtını elde etmek için önerilen veya isteğe bağlı parametrelerden herhangi birini ekleyebilirsiniz.
URL parametresi | |
---|---|
Zorunlu |
ad_type |
client |
|
description_url |
|
Önerilir |
slotname |
videoad_start_delay |
|
hl |
|
max_ad_duration |
|
min_ad_duration |
|
sdmax |
|
vid_t |
|
vid_d |
|
vid_kw |
|
vpa |
|
vpmute |
|
İsteğe bağlı |
host |
h_ch |
|
yer paylaşımlı reklam |
Temel URL ile başlama
Temel URL, tüm sorgu parametrelerinin eklendiği URL'dir. Açıklamalar, olası değerler ve bu parametrelerin örneklerini aşağıda bulabilirsiniz.
Temel URL: http://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Dize) Tercih edilen reklam türünü belirtir. Alt çizgi kullanılarak birden çok değer birbirine bağlanabilir.
Değerler
video
Tüm video reklamlar (standardvideo_skippablevideo
ile eşdeğerdir)skippablevideo
Yalnızca atlanabilir video reklamlar (atlanabilir reklamları almak için ek yayıncı izinleri gerektirebilir)standardvideo
Yalnızca atlanamayan video reklamlarimage
Belirlenen doğrusal olmayan reklam alanı boyutuna uyan resim reklamlara izin verirtext
Metin reklamlara izin verirÖrnekler
&ad_type=video_text_image
(tüm biçimlere izin verir)&ad_type=video_text
(herhangi bir video biçimine ve metin reklamlara izin verir)&ad_type=standardvideo_image
(yalnızca standart, atlanamayan video ve resim reklamlara izin verir)
client
(Dize) Yayıncının web mülkü kimliği.
Örnek
&client=ca-video-afvtest
description_url
(Dize) Videoyu açıklayan HTML sayfasının tam URL'si. İstekte bulunan oynatıcıyı içeren sayfanın URL'si. Bu, dinamik ayırma için Ad Exchange'i kullanıyorsanız gerekli olur.
description_url
değeri, web sayfası video oynatıcıları ve CTV/OTT cihazları için URL olarak kodlanmış ve mobil uygulama içi video oynatıcılar için kodlanmamış olmalıdır.
Bu parametre, IMA SDK tarafından otomatik olarak ayarlanmaz. Bunun manuel olarak ayarlanması gerekir.
Örnek
http%3A%2F%2Fwww.simplevideoad.com%2Fgolf.html
Tam URL örneği
Aşağıda, gerekli minimum parametreleri içeren bir URL örneği verilmiştir: http://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fwww.simplevideoad.com%2Fgolf.html%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
ca-video-afvtest
yayıncısı için https://myurl.com/page?key=value&key2=value2
açıklama URL'sine sahip video reklamları ister
videoad_start_delay
(Tamsayı) Reklamın, videonun kaçıncı milisaniyesinden sonra oynatılacağını belirtir. Videonun ortasında yayınlanması için varsayılan değer özellikle 1
'dir.
Değerler
-1
İçeriğin sonunda görüntülenen, videodan sonra gösterilen reklamı belirtir0
İçerik oynatılmaya başlamadan önce görüntülenen ve videodan önce gösterilen reklamı belirtir- Herhangi bir pozitif tam sayı
İçerik belirtilen milisaniye süresince oynatıldıktan sonra, videonun ortasında gösterilen reklamı belirtirÖrnekler
videoad_start_delay=-1
(videodan sonra gösterilen reklam)videoad_start_delay=15000
(reklam, içerik yayını başladıktan 15 saniye sonra oynatılır)
slotname
(Dize) AdSense/Ad Exchange reklam alanı kimliğini temsil eder. Bu değer, yayıncı ön ucu tarafından oluşturulur ve reklam alanı (reklam birimi) ile ayarlarını belirler. Her reklam isteği için yalnızca bir reklam alanı geçirilebilir.
Örnek
slotname=1
host
(Dize) 3 yollu gelir paylaşımı için kullanılacak barındırıcı kimliği.
Örnek
host=ca-host-test
(geliri bu barındırıcıyla paylaştırır)
h_ch
(Sayı) Yayıncı ve barındırıcı arasındaki gelir paylaşım düzeyini belirtmek için kullanılan sıra kimliği.
Örnek
ht_id=2
(2. sıra barındırıcı)
hl
(Dize) Reklamları söz konusu dilde istemek için kullanılan dil kodu. Bu kod, herhangi bir ISO 639-1 (iki harfli) veya ISO 639-2 (üç harfli) kodu olabilir. Geçerli kodların tam listesini inceleyin.
Örnekler
hl=en
(İngilizce)hl=es
(İspanyolca)
max_ad_duration
(Tam sayı) Milisaniye cinsinden döndürülmesi gereken maksimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri 100 saniyedir.
Örnek
max_ad_duration=30000
(atlanamayan tüm reklamların maksimum süresi 30 saniyedir)
min_ad_duration
(Tam sayı) Milisaniye cinsinden döndürülmesi gereken minimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri 0 saniyedir.
Örnekler
min_ad_duration=15000
(atlanamayan reklamın süresi en az 15 saniye olmalıdır)min_ad_duration=0
(süre yalnızcamax_ad_duration
değeriyle sınırlıdır)
sdmax
(Tamsayı) Atlanabilir reklamlar için milisaniye cinsinden maksimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri sınırsızdır.
Örnek
sdmax=120000
(döndürülen bir atlanabilir reklamın süresi 2 dakikayı geçemez)
yer paylaşımlı reklam
(Tamsayı) İstenen yer paylaşımlı reklam boyutunu yalnızca alttan üçte birlik kısmı kaplayan doğrusal olmayan yer paylaşımlı reklamlarla sınırlandırmak için kullanılır.
Varsayılan olarak herhangi bir sınır ayarlanmaz.
Örnekler
overlay=1
(yalnızca alttan üçte birlik kısmı kaplayan yer paylaşımı reklam boyutları uygundur; alanın tamamını kullanan yer paylaşımlı reklamlar istenmez)
overlay=0
(varsayılan değer, yer paylaşımlı reklam boyutları için herhangi bir sınır belirlemez;AdsRequest.nonLinearAdSlotWidth
veAdsRequest.nonLinearAdSlotHeight
değerlerine göre yer paylaşımlı reklam boyutları sunulur)
vid_t
(Dize) İçerik video başlığı.
Örnek
vid_t=Video%20Title
(yalnızca başlığı "Video Başlığı" olan içerik videoları)
vid_d
(Tam sayı) İçerik videosunun saniye cinsinden süresi.
Örnek
vid_d=1800
(yalnızca süresi 1.800 saniye olan içerik videoları)
vid_kw
(Dize) İçerik videosu anahtar kelimelerinin virgülle ayrılmış listesi. Örneğin tür, anahtar/değer çiftleri veya diğer meta veriler.
Örnek
vid_kw=drama,series,finale
(yalnızca bu anahtar kelimelerle eşleşen içerik videoları)
vpa
(Tam sayı) Video reklamların otomatik olarak oynatılıp oynatılmayacağını belirtir.
Değerler
0
Tıkla oynat videoyu belirtir1
Otomatik oynatılan videoyu belirtirÖrnekler
vpa=0
(tıkla oynat)vpa=1
(otomatik oynatılan)
vpmute
(Tam sayı) Video reklamların sessiz bir şekilde başlatılıp başlatılmayacağını belirtir.
Değerler
0
Sesin açık olduğunu belirtir (varsayılan)1
Sesin kapalı olduğunu belirtirÖrnekler
vpmute=0
(ses açık)vpmute=1
(sessiz)