VAST reklam etiketi URL'si, oynatıcı tarafından video ve işitsel reklamları almak için kullanılır. Manuel olarak bir VAST reklam etiketi URL'si oluşturabilir veya aşağıdaki parametreleri kullanarak mevcut bir URL'yi değiştirebilir ve ardından VAST ürün paketi denetleyicisi ile test edebilirsiniz. Buradaki örnek etiketleri kullanarak da inceleyebilir ve test edebilirsiniz.
URL'yle ilgili genel gereksinimler
- Protokol: VAST reklam etiketleri hem http hem de https'yi destekler. Gösterim izleme URL'leri, mevcut SSL ayarına uyar ve http veya https olarak döndürülür. Tıklama ve tıklama izleme başka bir sayfadan yönlendirdikleri için http'yi kullanır.
- Alan adı: Kalıp eşleştirme makrosu veya başka bir dinamik yöntemle oluşturulan dinamik alanların kullanılmasına izin verilmez ve böyle bir kullanım hatayla sonuçlanır.
- Canlı trafik: Tüm reklam aralarının aynı anda yayınlandığı yoğun trafik hacimlerinin işlenebilmesi için canlı video yayını reklam etiketi URL'lerinin yolunda
/live
ifadesi bulunmalıdır.
VAST reklam etiketi örneği
Parametreler ve atanmış değerler içeren örnek bir VAST reklam etiketi URL'si şuna benzer:
https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250
Listedeki belirli bir parametreye gidin
Parametre | Ayrıntılar | |
---|---|---|
aconp
(Kesintisiz ses oynatma) |
MRC Ses Ölçüm Yönergeleri uyarınca önerilir Kesintisiz ses oynatma parametresi, oynatıcının kesintisiz olarak sesli içerik oynatmayı amaçlayıp amaçlamadığını gösteren sabit değeri kabul eder. Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. Kullanım örneğiSürekli oynatma AÇIK: Sürekli oynatma KAPALI: |
|
ad_rule
(Reklam kuralı) |
Reklam kuralı parametresi, VAST reklam öğesinin mi yoksa reklam kuralları yanıtının mı döndürüleceğini gösteren sabit değeri kabul eder. Reklam kuralları için varsayılan ayar Ad Manager ağ ayarına bağlıdır. Belirli reklam etiketleri için bu ayarı aşağıdaki örneklerden yararlanarak geçersiz kılabilirsiniz. Kullanım örneğiVAST reklam öğesi için istek: Reklam kuralları için istek (VMAP): Gereklilik
|
|
ad_type
(Reklam türü) |
Reklam türü parametreleri, istek için döndürülmesi gereken reklam türlerini belirten sabit değeri kabul eder. Bu parametre yalnızca işitsel reklamlar için gereklidir. Kullanım örnekleriYalnızca işitsel reklamlara izin verir: Hem atlanabilir hem de atlanamayan video reklamlara izin verir: Hem işitsel hem de video reklamlara izin verir: audio_video reklam türünün yalnızca yapısı gereği "dinlenebilir" olabilen içerik için video reklam öğelerini video reklam oynatmayı destekleyen işitsel içeriğe veya işitsel reklam öğelerini yayın içi video oynatıcılara yayınlamak üzere kullanılması amaçlanmıştır. Örneğin spor yayınları, video yayınları, haberler vb. Video içeriğinde ses hakkında daha fazla bilgi edinin.
Yalnızca atlanabilir video reklamlara izin verir: Yalnızca atlanamayan video reklamlara izin verir: Gereklilik
|
|
addtl_consent
(Ek İzin) |
Ek İzin parametresi değişken değerlerini kabul eder ve IAB TCF 2.0 sürümüyle entegre olmak isteyen ve henüz IAB Avrupa Küresel Katılımcı Listesi'nde kayıtlı olmayan ancak Google'ın Reklam Teknolojisi Sağlayıcılar (ATP) listesinde yer alan yayıncılar tarafından kullanılır. Doğrudan VAST istekleri, değerleri otomatik olarak okumaz ancak reklam etiketlerine eklendiğinde kabul edilir. Ek İzin Modu teknik spesifikasyonundan bu parametreye aktarılan değerler hakkında daha fazla bilgi edinebilirsiniz. Kullanım örneği
|
|
afvsz
(Doğrusal olmayan reklam boyutları) |
Doğrusal olmayan reklam boyutları parametresi, video reklam alanında görüntülenebilecek doğrusal olmayan reklam boyutlarının virgülle ayrılmış listesi olması gereken sabit değerleri kabul eder. Bunlar, desteklenen şu boyutlardan biri olmalıdır:
IMA SDK kullanılırken bu alanın üzerine yazılır ve alan, nonLinearAdSlotWidth ile nonLinearAdSlotHeight kapsamında olup desteklenen tüm boyutlarla doldurulur. Doğrusal olmayan boyutlar desteklenmediğinde bu parametre dahil edilmeyebilir veya boş bırakılabilir. Kullanım örneğiTüm boyutlar desteklenir: Maksimum genişlik 250'dir: Maksimum yükseklik 60'tır: Maksimum genişlik 100'dür:
Koşul
|
|
allcues
(Tüm işaret noktaları) |
Bu parametre, işaret noktalarının virgülle ayrılmış listesi olan milisaniye cinsinden değişken değerleri kabul eder. Ad Manager, her bir değer için bir reklam arası döndürür.
Reklam kurallarınızda zamana dayalı işaretler kullanılırsa (örneğin, "N saniyede bir" veya "Sabit zamanlarda") reklam kuralında ayarlanan işaretler kullanılır ve Kullanım örneği10. ve 20. saniyedeki işaret noktaları: |
|
ciu_szs
(Tamamlayıcı boyutları) |
Tamamlayıcı boyutlar parametresi, tamamlayıcı boyutların virgülle ayrılmış listesi olan değişken değerleri kabul eder. Dikey çizgiyle ayrılmış ( Kullanım örneği
Çok boyutlu alan içeren boyutlar: |
|
cmsid
(İçerik kaynağı kimliği) vid
(Video kimliği) |
İçerik kaynağı kimliği ve video kimliği parametreleri, değişken değerleri kabul eder. Reklamların video içeriğine hedeflenmesi için ana video etiketinizin bu parametrelerin her ikisini de içermesi gerekir.
Kullanım örneği
Talebe bağlı video hizmetiyle Dinamik Reklam Ekleme için etiket oluşturuyorsanız doğru içerik kaynağını ve video kimliğini dinamik olarak ekleyecek makrolar kullanmanız gerekir. Örnek: Gereklilik
|
|
correlator
(İlişkilendirici) |
İlişkilendirici parametresi, aynı sayfa görüntülemesinden gelen birden fazla istek tarafından paylaşılan değişken değeri kabul eder. Çerezsiz ortamdakiler dahil olmak üzere rakip hariç tutmaları uygulamak için kullanılır. IMA SDK kullanılıyorsa ilişkilendirici değeri otomatik olarak ayarlanır. Oynatıcınız bu değeri ayarlamaya çalışırsa SDK, kendi değeriyle bu değerin üzerine yazar. IMA SDK kullanılmıyorsa bu değeri, birden fazla sayfa görüntülemeleri tarafından tekrar kullanılmayan gerçek bir rastgele, pozitif, tam sayı değerine ayarladığınızdan emin olun. Kullanım örneği
Gereklilik
|
|
cust_params
(Özel anahtar/değer çifti parametreleri) |
Özel parametreler; demografi, sayfadaki belirli konumlar ya da belirli bir sayfa veya sayfalar gibi özel hedeflemeler ayarlamanıza olanak tanıyacak anahtar/değer çiftleri olan değişken değerleri kabul eder. Kullanım örneğiAnahtar/değer çiftleri ekleme örneklerini inceleyin. |
|
description_url
(Açıklama URL'si) |
Açıklama URL'si parametresi, sayfada oynatılan videoyu açıklaması gereken bir değişken değerini kabul eder. İçeriği açıklayan 1-3 paragrafla sayfayı özetleyin. Örneğin, önceden tanımlanmış bloklardan
Bu parametre, IMA SDK tarafından otomatik olarak ayarlanmaz. Bunun manuel olarak ayarlanması gerekir. Kullanım örneğiURL olarak kodlanmış: Kodlanmamış: Gereklilik
|
|
dth
(Cihaz türü ipucu) |
Cihaz türü ipucu parametresi, özellikle bağlı TV ve set üstü kutu ortamlarında cihazın yanlış sınıflandırılmasını azaltmaya yardımcı olan sabit değeri kabul eder. Cihazın yanlış sınıflandırılması, yayıncı veya bağlı TV OEM kaynaklı istenmeyen hatalardan kaynaklanabilir. Bu parametre, bağlı TV envanterinin yeniden sınıflandırılabileceği durumları otomatik olarak işaretlemek için Google'ın diğer sinyalleriyle birlikte kullanılır. Kullanım örneğiBağlı TV'den istek: Set üstü kutu ortamından istek: Gereklilik
Bu parametre, PAL ve PAI (SDK olmayan) uygulamaları için önerilir. IMA SDK veya DAI SDK için gerekli değildir. |
|
env
(Ortam) |
Ortam parametresi, yayın içi isteğini veya isteğin özel olarak bir video oynatıcıdan geldiğini gösteren sabit değeri kabul eder. Olası değerler, video ve işitsel reklamlar için kullanılabilen Kullanım örneğiVideo ve/veya işitsel: Yalnızca video: Gereklilik |
|
excl_cat
(Hariç tutma kategorisi) |
Hariç tutma kategorisi parametresi, değişken değerleri kabul eder ve söz konusu hariç tutma etiketini içeren satır öğelerinin belirli bir reklam isteği için uygun olmasını engellemek üzere kullanır. Bu parametre Kullanım örneği
|
|
gdfp_req
(Ad Manager şema göstergesi) |
||
gdpr
(GDPR) |
GDPR parametresi, sabit değerlerini kabul eder ve IAB TCF 2.0 sürümüyle entegre olmak isteyen yayıncılar tarafından kullanılır. Doğrudan VAST istekleri, değerleri otomatik olarak okumaz ancak reklam etiketlerine eklendiğinde kabul edilir. Yalnızca 0 ve 1 bu parametre için geçerli değerlerdir. 0 değeri GDPR'nin geçerli olmadığı, 1 ise GDPR'nin geçerli olduğu anlamına gelir. GDPR geçerliyse gdpr_consent parametresini kullanarak geçerli bir TC dizesi sağlamanız gerekir. Çerçeveyi uygulamayla ilgili genel yönergelerden veya IAB TCF 2.0 sürümü spesifikasyonunun TC dizesinden bu parametreye aktarılan değerler hakkında daha fazla bilgi edinebilirsiniz. Kullanım örneğiGDPR geçerlidir: GDPR geçerli değildir: |
|
gdpr_consent
(GDPR Kullanıcı Rızası) |
GDPR Kullanıcı Rızası parametresi, değişken değerlerini kabul eder ve IAB TCF 2.0 sürümüyle entegre olmak isteyen yayıncılar tarafından kullanılır. Doğrudan VAST istekleri, değerleri otomatik olarak okumaz ancak reklam etiketlerine eklendiğinde kabul edilir. Çerçeveyi uygulamayla ilgili genel yönergelerden veya IAB TCF 2.0 sürümü spesifikasyonunun TC dizesinden bu parametreye aktarılan değerler hakkında daha fazla bilgi edinebilirsiniz. Kullanım örneği
|
|
hl
(Dil) |
Dil parametresi, ilgili dilde reklamları kabul etmek ve Ad Exchange veya AdSense Video için dinamik ayırmada reklam seçimi ve video reklam oluşturma dilini göstermek amacıyla kullanılan sabit değeri kabul eder. Parametre değeri, ISO 639-1 (iki harfli) veya ISO 639-2 (üç harfli) kodlarından herhangi biri olabilir. Geçerli kodların listesini inceleyin. Atlanırsa değer varsayılan olarak Ad Exchange'de dile göre reklam hedefleme içeren herhangi bir dil olur. Kullanım örneği
Gereklilik
|
|
iabexcl
(IAB hariç tutma URL'si) |
iabexcl URL parametresi, kategorilerin virgülle ayrılmış listesini kabul eder.
Kullanım örneği
|
|
ipd
(Envanter iş ortağı alanı) |
Envanter iş ortağı alan parametresi, yayıncının Inventorypartnerdomain parametresi, IPD bildirimi, özellikle isteğin geldiği reklam envanterinin başka bir iş ortağına (envanter paylaşan iş ortağı) ait olabileceği envanter paylaşımı kullanım alanlarında önemlidir. ads.txt/app-ads.txt ve envanter paylaşım iş ortakları hakkında daha fazla bilgi |
|
ipe
(Gösterim pingleme varlığı) |
Gösterim pingleme varlığı parametresi, sabit bir değeri kabul eder. Bu değer, kaynağı istemci yerine sunucu olan gösterim ping'lerini ve dönüşümleri göstermek için kullanılır. Kullanım örneğiSunucu tarafı işaretleme (SSB): |
|
iu
(Reklam birimi) |
||
lip
(Kapsüldeki son konum) |
Kapsüldeki son konum parametresi, isteğin kapsüldeki son konumdan geldiğini gösteren sabit değeri kabul eder. Bu parametre, yalnızca standart kapsüller içindir. Kullanım örneği
|
|
ltd
(Sınırlı reklamlar) |
Sınırlı reklamlar parametresi, çerez veya diğer yerel tanımlayıcıların kullanımına izin verilmediğinde reklamların sınırlı şekilde yayınlanıp yayınlanmayacağını gösteren sabit değeri kabul eder.
Kullanım örneği
|
|
min_ad_duration
(Reklam minimum süresi) max_ad_duration
(Reklam maksimum süresi) |
Reklam süresi parametreleri, birlikte dikkate alındığında milisaniye olarak bir reklamın eşleşmesi gereken süre aralığını belirten değişken değerleri kabul eder. Tek reklam ve optimize edilmiş kapsül istekleri için tek reklam süresini sınırlamak üzere bu parametreyi kullanın. Kullanım örneği
|
|
mridx
(Videonun ortasında gösterilen reklam sayısı) |
Videonun ortasında gösterilen reklam numarası parametresi, videonun ortasında gösterilen reklamın sıra numarasını (örneğin videonun ortasında gösterilen reklam 1, videonun ortasında gösterilen reklam 2 vb.) temsil eden değişken değeri kabul eder. Kullanım örneği
|
|
msid
(Uygulama kimliği) an
(Uygulama adı) |
Uygulama kimliği ve uygulama adı parametreleri, çoğu programatik video reklam için gerekli olduklarından mobil uygulamadan ve bağlı TV cihazlarından gönderilen isteklere uygulanması gereken değişken değerleri kabul etmelidir. IMA SDK her iki parametreyi de otomatik olarak dolduracaktır ancak bunların doğrudan VAST çağrıları dahil olmak üzere SDK olmayan ortamlarda veya Programatik Erişim Kitaplığı (PAL) ya da Yayıncı Kimlik Doğrulamalı Envanter (PAI) kullanılırken manuel olarak belirtilmesi gerekir. Uygulama adı, iOS ve tvOS üzerinde kullanıcıların okuyabileceği bir ad olmalıdır ancak SDK, uygulama kimliğine erişemez. Böyle durumlarda Kullanım örneği
Uygulama kimlikleri, farklı uygulama mağazalarında farklı şekilde adlandırılır ve biçimlendirilir. Uygulama tanımlama için IAB yönergelerine veya yaygın benzersiz tanımlayıcı örneklerine bakın. Bir uygulama mağazasının bulunmadığı platformlar için IAB, yayıncıların mağaza kimlikleri için şu biçimi kullanmasını önerir: Koşul
|
|
nofb
(Yedek devre dışı bırakıldı) |
Yedek devre dışı bırakıldı parametresi, reklam isteğinin yedek video reklamların oynatma listesini döndürmemesi gerektiğini gösteren sabit değeri kabul eder. Kullanım örneğiYedek devre dışı bırakıldı: |
|
npa
(Kişiselleştirilmemiş reklam) |
Kişiselleştirilmemiş reklamlar parametresi, reklam isteğinin kişiselleştirilmemiş olarak değerlendirilmesi gerektiğini gösteren sabit değeri kabul eder. İsteği kişiselleştirilmemiş olarak etiketlemek için özel olarak Kullanım örneğiKişiselleştirilmemiş reklamlar: |
|
omid_p
(OMID iş ortağı adı) |
OMID iş ortağı adı parametresi, OMID ölçümünü entegre eden iş ortağının adını ve iş ortağı sürümünü belirten değişken değerini kabul eder. Bu parametre yalnızca Open Measurement SDK'sını (OM SDK'sı) kullanırken Aktif Görüntüleme ölçümü isteyen yayıncılar için geçerlidir. IMA SDK otomatik olarak ayarlandığı için bu ayar kullanılmamalıdır. Programatik Erişim Kitaplığı'nı (PAL) kullanırken OMID desteğini belirtmek için iş ortağı adını ve sürümünü ayarlamak üzere Kullanım örneğiPAL kullanılırken: PAL kullanılmadığında: |
|
output
(Reklam çıkış biçimi) |
Reklam çıkışı parametresi, reklamın çıkış biçimine ayarlanması gereken sabit değeri kabul eder. Ağınızda ayarlanan VAST sürümü için VAST söz konusu olduğunda, video oynatıcınız IMA SDK'yı kullanıyorsa video reklam isteğinin çıkış parametresi her zaman Ağınızda etkinleştirdiğiniz varsayılan VMAP sürümünü (ör. VMAP 1) döndürmek için Kullanım örneğiAğınızın varsayılan VAST ayarı: VAST 4: Ağınızın varsayılan VMAP ayarı: VMAP 1: VAST 4 döndüren VMAP 1: Gereklilik |
|
plcmt
(Yerleşim) |
Yerleşim parametresi, IAB spesifikasyonlarındaki yönergelere göre yayın içi envanterin yayın içi mi yoksa eşlik eden mi olarak tanımlandığını belirtmek için kullanılan sabit değeri kabul eder. Yayın içi olmayan isteklerde bu alan, alıcılar için bildirilen envanter biçimine göre otomatik olarak doldurulur ve tüm yayın içi veya eşlik eden içerik bildirimlerini geçersiz kılar. Kullanım örneğiYayın içi istek: Eşlik eden içerik isteği: Gereklilik |
|
pmad
(Kapsül maksimum reklam sayısı) |
Kapsül reklamı maksimum sayısı parametresi, kapsüldeki maksimum reklam sayısını gösteren değişken değeri kabul eder. Bu parametre, gelişmiş video paketine sahip yayıncılar tarafından kullanılabilen optimize edilmiş kapsüllere özeldir. VMAP için kullanılmamalıdır ( Kullanım örneği
|
|
pmnd
(Kapsül minimum süresi) pmxd
(Kapsül maksimum süresi) |
Kapsül süresi parametreleri, birlikte dikkate alındığında milisaniye olarak bir kapsülün eşleşmesi gereken süre aralığını belirten değişken değerleri kabul eder. Bu parametreler, birden fazla reklam istemek için kullanılır. * Bunlar, gelişmiş video paketine sahip yayıncılar tarafından kullanılabilen optimize edilmiş kapsüllere özeldir. VMAP için kullanılmamalıdırlar ( Kullanım örneği
|
|
pod
(Kapsül numarası) |
Kapsül numarası parametresi, videodaki kapsülün sıra numarasını (örneğin kapsül 1, kapsül 2 vb.) temsil eden değişken değeri kabul eder. Kullanım örneği
Gereklilik
|
|
pp
(Reklam öğesi profili) |
Reklam öğesi profili parametresi, video ve işitsel reklam öğesi profilinde ayarlanan yapılandırmaya göre yayınlanmaya uygun reklam öğelerini kontrol eden değişken değeri kabul eder. Kullanım örneği
Gereklilik
|
|
ppt
(Publisher Privacy Treatment) |
Yayıncı Gizlilik Değerlendirmesi parametresi, reklam isteği için reklam kişiselleştirmenin kapatılıp kapatılmayacağını belirtmek üzere kullanılan sabit değeri kabul eder. Yayıncı Gizlilik Değerlendirmesi hakkında daha fazla bilgi Kullanım örneğiReklam kişiselleştirmeyi kapatın: |
|
ppid
(Yayıncı tarafından sağlanan tanımlayıcı) |
Yayıncı tarafından sağlanan tanımlayıcı (PPID) parametresi; sıklık sınırı, kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu ve cihazlar arasında diğer kitleye dayalı reklam yayınlama kontrolleri için kullanılacak bir tanımlayıcının değişken değerini kabul eder. Kullanım örneği
|
|
ppos
(Kapsüldeki konum) |
Kapsüldeki konum parametresi, kapsül içindeki konumu (örneğin konum 1, konum 2 vb.) temsil eden değişken değeri kabul eder. Bu parametre, yalnızca standart kapsüller içindir ve tamamlayıcı otomatik doldurma için gerekli değildir. Kullanım örneği
Gereklilik
|
|
ppsj
(Yayıncı tarafından sağlanan sinyaller JSON) |
Yayıncı tarafından sağlanan sinyaller JSON parametresi, programatik ile para kazanmayı iyileştirmek için yayıncı tarafından sağlanan kitle ve içerik verilerini içeren base64 kodlu bir JSON nesnesini kabul eder. Yayıncı tarafından sağlanan sinyaller ve desteklenen sınıflandırmalar hakkında daha fazla bilgi Geçerli JSON anahtar/değer çiftlerinin ayrıntılarını Kullanım örneğiJSON nesnesi: Base64 olarak kodlanmış değer: |
|
ptpl
(Reklam arası şablon kimliği) ptpln
(Reklam arası şablon adı) |
Reklam arası şablon kimliği ve adı, değişken değerlerini kabul eder ve optimize edilmiş kapsül isteğine hangi reklam arası şablonunun uygulanması gerektiğini belirtir. Reklam arası şablonları, bir reklam arasına hangi reklam spotlarının veya özel reklam spotlarının dahil edileceğini ve bunların hangi sırayla yayınlanacağını yapılandırmanıza olanak tanır. Kullanım örneğiReklam arası şablonları oluşturma ve isteme hakkında daha fazla bilgiyi burada bulabilirsiniz. |
|
pubf
(Ad Exchange etiketlerinde genel fiyat tabanları) pvtf
(Ad Exchange etiketlerinde özel fiyat tabanları) |
Kullanım örneği
|
|
pvid
(Uygulama grubu kimliği) pvid_s
(Uygulama grubu kapsamı) |
Kullanıcılar Android cihazlarda kişiselleştirmeyi devre dışı bıraktığında para kazanma için uygulama grubu kimlik değerleri gerekir.
IMA/PAL SDK'sı bu alanı otomatik olarak geçirirken, SDK olmayan uygulamalara sahip yayıncılar uygulama grubu SDK'sını çağırmalı ve bu parametreleri reklam isteğinde manuel olarak iletmelidir. Uygulama grubu kimliğini alma ile ilgili Android dokümanlarına bakın. Kullanım örneği
Koşul
|
|
rdid
(Sıfırlanabilir cihaz tanımlayıcıları) |
Sıfırlanabilir cihaz tanımlayıcıları, değişken değerleri kabul eder. Yerleşik uygulamalarda (web veya mobil web'de değil) SDK, Neredeyse tüm programatik video reklamlar için bu değerlerin bulunması gerekir.
Kullanım örneğiSıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin. Gereklilik
|
|
rdp
(Veri işlemeyi kısıtlama) |
Veri işlemeyi kısıtlama parametresi, reklam isteğinin veri işlemeyi kısıtlaması gerektiğini gösteren sabit değeri kabul eder. Veri işlemeyi kısıtlamak için özel olarak Kullanım örneği
|
|
scor
(Akış ilişkilendirici) |
Akış ilişkilendirici parametresi, her video akışı için oluşturulmuş bir tam sayı olması gereken değişken değeri kabul eder. Sayının, bir akış içinde aynı olması ve sayfa görüntüleme içinde benzersiz olması gerekir. Bir kullanıcı aynı sayfada birden fazla video izliyorsa rakip hariç tutma, sıklık sınırı ve ilgili özellikler için kullanılır. Kullanım örneği
Gereklilik
|
|
sdk_apis
(SDK API çerçevesi) |
SDK API çerçevesi parametresi, oynatıcının desteklediği tüm API çerçevelerini belirten, sabit tam sayı değerlerinin virgülle ayrılmış listesini kabul eder. Olası API Çerçevesi değerlerinin listesine bakın. Bu parametre, IMA SDK kullanmayan yayıncılar için Programatik Erişim Kitaplığı'ndaki (PAL) API'leri destekler. IMA SDK, IMA SDK tarafından desteklenen değerlerle ayarlanmış değerleri geçersiz kılar. Kullanım örneği
|
|
sdmax
(Atlanabilir maks. reklam süresi) |
Söz konusu reklam isteği için atlanabilir video/işitsel reklam öğelerinin süresi boyunca izin verilmesi gereken üst sınırı temsil eden milisaniye cinsinden bir süre alır.
Kullanım örneğiAşağıdaki ayarları kullanarak:
Aşağıdaki reklam öğeleri için:
Şunlarla sonuçlanır:
|
|
sid
(Oturum Kimliği) |
Oturum kimliği parametresi, yalnızca sıklık sınırı amacıyla kullanılabilecek, gizliliği koruyan bir reklam tanımlayıcısı türü olan değişken değeri kabul eder. Oturum kimliği, bağlı TV'lerden gelen yayın içi video istekleri ve mobil uygulama cihazlarından gelen yayın içi video envanteri için desteklenir. Şu anda web için desteklenmemektedir. IAB'nin IFA yönergeleri uyarınca bu parametre UUID biçiminde doldurulmalıdır. Kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcıları hakkında daha fazla bilgi
Kullanım örneği
Gereklilik
|
|
ssss
(Sunucu tarafı birleştirme kaynağı) |
Sunucu tarafı birleştirme kaynak parametresi, video birleştirme teknolojisi sağlayıcınız için Google tarafından sağlanmış tanınan bir değere ayarlanması gereken sabit değeri kabul eder. Google ile sunucular arası entegrasyon kullanan video birleştirme teknolojisi sağlayıcılarına, Google'dan bu değer verilir ve bu sağlayıcılar size bu değeri sunabilir. Bu parametrenin ayarlanması gereken değerle ilgili sorularınız için Google hesap yöneticinizle iletişime geçebilirsiniz. Kullanım örneği
Koşul
|
|
sz
(Boyut) |
Boyut parametresi, ana video reklam alanının boyutuna ayarlanması gereken değişken değeri kabul eder. Çok sayıda boyut olduğunda dikey çizgi ( Boyuttan sonra " Kullanım örneği
Gereklilik
Bu parametre, yalnızca |
|
tfcd
(Çocuklara yönelik etiketi) |
Çocuklara yönelik parametresi, reklam isteğini çocuklara yönelik olarak değerlendirilme için etiketleyen sabit değeri kabul eder. Kullanım örneği
|
|
trt
(Trafik türü) |
Trafik türü parametresi, satın alınan veya organik trafiği istemek için kullanılan sabit değeri kabul eder. Bir istekte trafik türü parametresi yoksa IMA SDK varsayılan değeri doldurmaz. Böyle durumlarda, sunucu varsayılan değer olarak Kullanım örneğiSatın alınan trafik için istek: Organik trafik için istek: |
|
unviewed_position_start
(Geciken gösterimler) |
||
url
(URL) |
URL parametresi, isteğin gönderildiği tam URL olarak ayarlanması gereken bir değişken değerini kabul eder. Bu değer, alıcıların bu isteğin geldiği bağlamı belirleyip anlamasına yardımcı olmak için gereklidir. Reklam isteğinde mümkün olduğunca dinamik olarak doldurulmalıdır. Bir web sayfasında bu, video oynatıcıyı gösteren sayfanın URL'sidir. IMA SDK kullanıyorsanız URL değeri otomatik olarak ayarlanır. Oynatıcınız bu değeri ayarlıyorsa IMA SDK ayarlanan değere uyar. Bu değer, bir uygulamada (mobil veya CTV) para kazandıran video veya işitsel envanteri en doğru şekilde temsil edecek URL olarak ayarlanmalıdır. Örneğin, kullanıcı bir mobil uygulamada video izliyorsa ve bu video masaüstü URL'leri üzerinden de izlenebiliyorsa.* Bu parametrenin değeri kodlanmalıdır. Kullanım örneği
* Uygulamalarda, bu parametre bir değişken URL değerine ayarlanamıyorsa parametrenin şu kalıba göre ayarlanması önerilir: Gereklilik
|
|
vad_type
(Video reklam türü) |
Video reklam türü parametresi, doğrusal bir reklam mı yoksa doğrusal olmayan bir reklam mı döndürüleceğini gösteren sabit değeri kabul eder. Kullanım örneğiDoğrusal reklam döndürme: Doğrusal olmayan reklam döndürme: |
|
vid_d
(Video süresi) |
Bu parametre, içeriğin süresini saniye cinsinden gösteren değişken değeri kabul eder.
Kullanım örneğiSüresi 90.000 saniye (25 saat) olan video içeriği süresi: |
|
vconp
(Kesintisiz video oynatma) |
MRC Video Ölçüm Kuralları uyarınca önerilir Kesintisiz video parametresi, oynatıcının TV yayınına benzer şekilde video içeriğini kesintisiz olarak oynatmayı amaçlayıp amaçlamadığını gösteren sabit değeri kabul eder. Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. Kullanım örneğiSürekli oynatma AÇIK: Sürekli oynatma KAPALI: |
|
vpa
(Videoyu otomatik oynatma) |
Şuna istinaden önerilir: MRC Video Ölçüm Kuralları Otomatik video oynatma parametresi, bir reklamdaki video içeriğinin otomatik oynatma veya tıklama ile başlatılıp başlatılmayacağını gösteren sabit değeri kabul eder. Olası değerler, sayfada kullanıcının işlem yapması bekleniyorsa Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. Kullanım örneğiOtomatik oynatma: Oynatmak için tıklama: Gereklilik
|
|
vpi
(Video oynatma listesi inred) |
Video oynatma listesi inred parametresi, satır içi VMAP'nin sunulup sunulmayacağını (VAST'ı VMAP'nin içinde döndürür) gösteren sabit değeri kabul eder. Bu parametre, gecikmeyi azaltmanın yanı sıra video akışında sıklık sınırlarını ve rakip hariç tutmaları garanti etmek için kullanılabilir. Kullanım örneğiVAST döndürme: Yönlendirme döndürme: |
|
vpmute
(Videoyu oynatma sesini kapatma) |
Şuna istinaden önerilir: MRC Video Ölçüm Kuralları Sessiz video parametresi, video oynatıcının sesi kapatıldığında reklam oynatmanın başlatılıp başlatılmayacağını gösteren sabit değeri kabul eder. Kullanım örneğiSesi kapatılmış: Sesi açılmış: Gereklilik |
|
vpos
(Video konumu) |
Video konumu parametresi, reklam isteğinin videodan önce mi, videonun ortasında mı yoksa videodan sonra mı gönderildiğini gösteren sabit değeri kabul eder. Kullanım örneğiVideodan önce gösterilen reklam: Videonun ortasında gösterilen reklam: Videodan sonra gösterilen reklam: Gereklilik
|
|
wta
(Neden bu reklam?) |
"Neden bu reklam?" parametresi, video oynatıcının reklam etiketi oluşturma desteğini gösteren sabit değeri kabul eder. Hiçbir Reklam etiketi işlevi, IMA SDK kullanılırken otomatik olarak desteklenir. IMA SDK kullanılmadığında, video oynatıcılar IAB VAST standardında belirtildiği gibi VAST Yayıncı, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesini oluşturmayacaksa İşitsel reklam istekleri, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesi tamamlayıcılarda oluşturulacaksa veya kullanıcıya başka bir şekilde sağlanacaksa AEA'dan gelen trafik için Reklamlar, Avrupa Ekonomik Alanı'nda (AEA) yayınlanan reklamlarla ilgili geçerli yasal koşullara uymalıdır. Buna, kullanıcıların yasa dışı içeriği bildirmeleri için bir mekanizma da dahildir. Yayıncılar, uygun formu kullanarak yasa dışı içerik bildirimlerini Google'a iletmelidir. Kullanım örneğiDesteklenenler:
Desteklenmiyor: Gereklilik
|