VAST reklam etiketi URL parametreleri

VAST reklam etiketi URL parametreleri

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.

Genel URL şartları

  • 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: Kalıp eşleştirme makrosu veya başka bir dinamik yöntemle oluşturulan dinamik alan adlarının kullanımına izin verilmez ve bunlar hataya neden olur.
  • 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

 yer işaretiListedeki belirli bir parametreye gidin

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
env
excl_cat
gdfp_req
gdpr
gdpr_consent
hl

iabexcl
idtype
ipd
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
omid_p
output
plcmt
pmad

pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
scor
sdk_apis

sdmax
sid
ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

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ği

Sürekli oynatma AÇIK:
aconp=2

Sürekli oynatma KAPALI:
aconp=1

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ği

VAST reklam öğesi için istek:
ad_rule=0

Reklam kuralları için istek (VMAP):
ad_rule=1

Gereklilik

Gerekli Video reklam kuralları için gereklidir

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.

ad_type audio veya audio_video olarak ayarlandığında, vpmute parametresi 0 olarak ayarlanmalıdır.

Kullanım örnekleri

Yalnızca işitsel reklamlara izin verir:
ad_type=audio

Hem atlanabilir hem de atlanamayan video reklamlara izin verir:
ad_type=video

Hem işitsel hem de video reklamlara izin verir:
ad_type=audio_video
(Bu değer, her iki biçimin de rekabet etmesine olanak tanır ancak yalnızca bir tanesi yayınlanır.)

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:
ad_type=skippablevideo

Yalnızca atlanamayan video reklamlara izin verir:
ad_type=standardvideo

Gereklilik

Gerekli İşitsel reklamlar için gereklidir

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:

  • 200x200
  • 250x250
  • 300x250
  • 336x280
  • 450x50
  • 468x60
  • 480x90
  • 729x90

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ği

Tüm boyutlar desteklenir:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90

Maksimum genişlik 250'dir:
afvsz=200x200,250x250

Maksimum yükseklik 60'tır:
afvsz=450x50,468x60

Maksimum genişlik 100'dür:
//empty; no values supported

 

Koşul

Gerekli IMA SDK kullanılmadığında doğrusal olmayan video reklamlar için gereklidir

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.

vid_d ve allcues parametreleri, videonun ortasında gösterilen reklamları içerik besleme olmadan yayınlamak için kullanılır. Videonun ortasında gösterilen reklamları döndürmek için reklam kuralları da gerekir.

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 allcues'a iletilen işaretler yoksayılır. Videonun ortasında gösterilen reklamlar için süre yine de gereklidir. Bu nedenle vid_d parametresinin iletilmesi gerekir.

Kullanım örneği

10. ve 20. saniyedeki işaret noktaları:
allcues=10000,20000

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ış (|) değerler, çok boyutlu reklam alanını gösterir.

Kullanım örneği

ciu_szs=728x90,300x250

Çok boyutlu alan içeren boyutlar:
ciu_szs=728x90,300x200|300x250

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.

cmsid, her içerik kaynağı için benzersiz bir sayıdır. Ad Manager'da bu kimliği bulmak için Video ardından İçerik kaynakları'nı ve ardından kaynağın adını tıklayın.

vid, belirli bir videoyu tanımlayan bir dize veya sayıdır. Bu kimlik, içeriğinizi barındıran İYS tarafından atanır. Ad Manager'da bu kimliği bulmak için Video ardından İçerik'i ve ardından ilgili içerik kaynağını tıklayın.

Kullanım örneği

cmsid=[value]&vid=[value]

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: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Gereklilik

Gerekli Video içeriği hedefleme için gereklidir

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

correlator=4345645667

Gereklilik

Gerekli Web ve uygulama için gereklidir

önerilir Programatik para kazanma için önerilir

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ği

Anahtar/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. Genellikle video oynatıcıyı içeren sayfadır ancak videoyu açıklayan metne sahip bir sayfa da olabilir.

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.

Kullanım örneği

URL olarak kodlanmış:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

Kodlanmamış:
description_url=
https://www.sample.com/golf.html

Gereklilik

Gerekli Webuygulama ve Ad Exchange için gereklidir

önerilir Programatik para kazanma için önerilir

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 instream veya yalnızca video reklamlar için kullanılabilen vp değerleridir.

Kullanım örneği

Video ve/veya işitsel:
env=instream

Yalnızca video:
env=vp

Gereklilik

Gerekli Web ve uygulama için gereklidir

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 cust_params ile çalışır.

Kullanım örneği

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

(Ad Manager şema göstergesi)

Ad Manager şema göstergesi parametresi, kullanıcının Ad Manager şemasında olduğunu gösteren sabit değeri kabul eder.

Kullanım örneği

gdfp_req=1

Gereklilik

Gerekli Web ve uygulama için gereklidir

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ği

GDPR geçerlidir:
gdpr=1

GDPR geçerli değildir:
gdpr=0

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

hl=tr

Gereklilik

önerilir Programatik para kazanma için önerilir

iabexcl

(IAB hariç tutma URL'si)

iabexcl URL parametresi, kategorilerin virgülle ayrılmış listesini kabul eder.

Kullanım örneği

iabexcl=3,14,527  "Ticari Kamyonlar", "Arazi Araçları" ve "Ragbi"yi içermez.

IAB İçerik Sınıflandırması hakkında daha fazla bilgi

ipd

(Envanter iş ortağı alanı)

Envanter iş ortağı alan parametresi, yayıncının app-ads.txt (veya ads.txt) dosyasındaki inventorypartnerdomain bildirimlerine ayarlanması gereken değişken değerleri kabul eder. 

Inventorypartnerdomain parametresi, ads.txt/app-ads.txt dosyasını doğrulama amaçları doğrultusunda envanter paylaşım iş ortağının alan adını göstermesine yardımcı olan bir IAB spesifikasyonudur.

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ği

Sunucu tarafı işaretleme (SSB):
ipe=ssb

iu

(Reklam birimi)

Reklam birimi parametresi, şu biçimde mevcut reklam birimine ayarlanması gereken değişken değeri kabul eder:

/network_code/.../ad_unit

Kullanım örneği

iu=/6062/videodemo

Gereklilik

Gerekli Web ve uygulama için gereklidir

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

lip=true

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.

Uyarı

ltd=1 ayarı diğer URL parametrelerinin aksine IMA SDK'nın davranışını, istek SDK'sız olarak değerlendirilecek ve depolamaya izin verilmeyecek şekilde değiştirir.

Kullanım örneği

ltd=1

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

min_ad_duration=15000&max_ad_duration=30000

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

mridx=2

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 msid parametresi gönderilmez ve SDK, uygulama paketini an parametresi üzerinden gönderir.

Kullanım örneği

msid=com.package.publisher&an=sample%20app

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: com.publisher.deviceplatform

Koşul

Gerekli Uygulama için her iki parametre de gereklidir

önerilir Programatik para kazanma için önerilir

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ği

Yedek devre dışı bırakıldı:
nofb=1

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 npa=1 değerini ayarlamanız veya npa'yı (ayarlı değer olmadan) eklemeniz gerekir. Bu parametrenin olmadığı veya npa=0 olarak ayarlanmış reklam istekleri, varsayılan olarak kişiselleştirilmiş reklamlar olur.

Kullanım örneği

Kişiselleştirilmemiş reklamlar:
npa=1

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 omidPartnerName ve omidPartnerVersion API'lerini kullanmanız gerekir. PAL veya IMA kullanmadığınızda omid_p ve sdk_apis parametrelerini (virgülle ayrılmış diğer API'leri de içerebilecek desteklenen API'ler) ayarlamanız gerekir.

Kullanım örneği

PAL kullanılırken:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'

PAL kullanılmadığında:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

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 output=vast'ı kullanın. Belirli reklam etiketleri veya sitenizin belirli bölümleri için belirli VAST veya VMAP sürümlerini isteyebilirsiniz.

VAST söz konusu olduğunda, video oynatıcınız IMA SDK'yı kullanıyorsa video reklam isteğinin çıkış parametresi her zaman output=xml_vast4 olarak ayarlanacaktır. SDK tüm üçüncü taraf reklam sunucularının sunabileceği VAST sürümlerinin tamamıyla geriye dönük uyumlu olduğu için bu durum hiçbir güvenilirlik riski taşımamaktadır.

Ağınızda etkinleştirdiğiniz varsayılan VMAP sürümünü (ör. VMAP 1) döndürmek için output=vmap kullanın. VMAP içinde VAST döndürürseniz döndürülecek VAST sürümünü belirtmek için xml_vmap1_vast3 veya xml_vmap1_vast4 kullanabilirsiniz.

Kullanım örneği

Ağınızın varsayılan VAST ayarı:
output=vast

VAST 4:
output=xml_vast4

Ağınızın varsayılan VMAP ayarı:
output=vmap

VMAP 1:
output=xml_vmap1

VAST 4 döndüren VMAP 1:
output=xml_vmap1_vast4

Gereklilik

Gerekli Web ve uygulama için gereklidir

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ği

Yayın içi istek:
plcmt=1

Eşlik eden içerik isteği:
plcmt=2

Gereklilik

 Gerekli Web ve Programatik para kazanma için gereklidir

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 (ad_rule=1 olduğunda).

Kullanım örneği

pmad=4

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 (ad_rule=1 olduğunda).

Kullanım örneği

pmnd=0&pmxd=60000

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

pod=3

Gereklilik

Gerekli Rakip hariç tutma, sıklık sınırı ve ilgili özelliklerin düzgün şekilde çalışması için gereklidir.

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

pp=creative_profile

Gereklilik

önerilir Programatik para kazanma için önerilir

ppt

(Yayıncı Gizlilik Değerlendirmesi)

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ği

Reklam kişiselleştirmeyi kapatın:
ppt=1

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

ppid=12JD92JD8078S8J29SDOAKC0EF230337

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

ppos=2

Gereklilik

Gerekli Rakip hariç tutma, sıklık sınırı ve ilgili özelliklerin düzgün şekilde çalışması için gereklidir.

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ı
HTML5 IMA SDK örneğinde bulabilirsiniz.

Kullanım örneği

JSON nesnesi:
{
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
  }]
}

Base64 olarak kodlanmış değer:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s
idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj
pbIjEiLCIyODQiXX1dfQ

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.

Reklam arası şablonu istemek için 2 parametreden (ad veya kimlik) yalnızca biri gereklidir.

Kullanım örneği

Reklam 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ı)

pubf, google_ad_public_floor ile eş değerdir. pvtf ise google_ad_private_floor ile eş değerdir. Bunlar Ad Exchange etiketlerine fiyat tabanları eklemek için kullanılır.

Kullanım örneği

pubf=123
pvtf=123

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.

pvid parametresi Android uygulama grubu kimliği olarak ayarlanmış bir değişken değerini, pvid_s parametresi ise uygulama grubu kimliğinin kapsamını temsil eden sabit değeri (scope_app veya scope_developer) kabul eder.

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

pvid=[AppSetID_value]
pvid_s=scope_app

Koşul

Gerekli Uygulama için gereklidir

önerilir Programatik para kazanma için önerilir

rdid
idtype
is_lat

(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, rdid, idtype ve is_lat parametreleri ile akış isteklerinize kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcılarını iletir. SSB akışlarında, istemci tarafı reklam isteğinde olduğu gibi bu açık parametreleri iletmeniz gerekir. Cihaz tanımlayıcıları hakkında daha fazla bilgi

Neredeyse tüm programatik video reklamlar için bu değerlerin bulunması gerekir.

Uyarı

Apple, iOS 14.5 sürümünden itibaren LAT sinyali için desteğini sonlandırmıştır. Google, kullanıcının App Tracking Transparency'yi destekleyen iOS sürümlerinde izlemeye izin verdiğini belirtmek için sıfır olmayan bir IDFA'dan yararlanır. Bu nedenle, doğru işletim sistemi sürümünü belirten geçerli bir UserAgent gereklidir.

Kullanım örneği

Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin.

Gereklilik

Gerekli Uygulama için gereklidir

önerilir Programatik para kazanma için önerilir

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 rdp=1 değerini ayarlamanız veya rdp'yi (ayarlı değer olmadan) eklemeniz gerekir. Veri İşlemeyi Kısıtla ağ ayarı etkinleştirilmediği takdirde, bu parametrenin olmadığı veya rdp=0 olarak ayarlanmış reklam istekleri kısıtlanmaz.

Kullanım örneği

rdp=1

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

scor=17

Gereklilik

Gerekli Rakip hariç tutma, sıklık sınırı ve ilgili özelliklerin düzgün şekilde çalışması için gereklidir.

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

sdk_apis=2,7,9

sdmax

(Atlanabilir maks. reklam süresi)

sdmax (atlanabilir maks. reklam süresi) reklam isteği parametresi, yayıncıların atlanabilir reklamlar için istedikleri maksimum reklam süresini belirtmesine olanak tanıyan değişken değeri kabul eder.

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.

sdmax'i atlanabilir reklamlar için bağımsız olarak veya atlanabilir ve atlanamayan reklamlar için farklı maksimum süreler sağlamak amacıyla mevcut max_ad_duration parametresiyle birlikte kullanın.

Kullanım örneği

Aşağıdaki ayarları kullanarak:

  • max_ad_duration = 15.000 (15 saniye)
  • sdmax = 45.000 (45 saniye)

Aşağıdaki reklam öğeleri için:

  • A Reklam Öğesi: Atlanamayan; 30 sn
  • B Reklam Öğesi: Atlanabilir; 30 sn

Şunlarla sonuçlanır:

  • A reklam öğesi, atlanamayan olduğu ve süresi (atlanamayan) maksimum değeri aştığı için filtrelenecek.
  • Süresi max_ad_duration'ı aşmasına rağmen atlanabilir olduğu ve süresi atlanabilir maksimum değeri aşmadığı için B reklam öğesi filtrelenmez.
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

sid=0 parametresini ayarlayarak oturum kimliğinin iletilmesini devre dışı bırakabilirsiniz.

Kullanım örneği

123e4567-e89b-12d3-a456-426614174000

Gereklilik

önerilir Programatik para kazanma için önerilir

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

ssss=mystitcher

Koşul

Gerekli Sunucu tarafı uygulamalar için gereklidir

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 (|) karakteri ile ayrılmalıdır.

Boyuttan sonra "v" eklemeyin.

Kullanım örneği

sz=400x300

Gereklilik

Gerekli Web ve uygulama için gereklidir

Bu parametre, yalnızca ad_type=audio isteniyorsa isteğe bağlıdır.

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

tfcd=1

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 0 (tanımlanmamış trafik) sağlar.

Kullanım örneği

Satın alınan trafik için istek:
trt=1

Organik trafik için istek:
trt=2

unviewed_position_start

(Geciken gösterimler)

Geciken gösterimler parametresi, video için geciken gösterimleri belirten sabit değeri kabul eder.

Kullanım örneği

unviewed_position_start=1

Gereklilik

Gerekli Web ve uygulama için gereklidir

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

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* Uygulamalarda, bu parametre bir değişken URL değerine ayarlanamıyorsa parametrenin şu kalıba göre ayarlanması önerilir:
url=https%3A%2F%2F< app/bundleid>.adsenseformobileapps.com

Gereklilik

Gerekli Web ve uygulama için gereklidir

önerilir Programatik para kazanma için önerilir

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ği

Doğrusal reklam döndürme:
vad_type=linear

Doğrusal olmayan reklam döndürme:
vad_type=nonlinear

vid_d

(Video süresi)

Bu parametre, içeriğin süresini saniye cinsinden gösteren değişken değeri kabul eder. 

vid_d ve allcues parametreleri, videonun ortasında gösterilen reklamları içerik besleme olmadan yayınlamak için kullanılır. Videonun ortasında gösterilen reklamları döndürmek için reklam kuralları da gerekir.

Kullanım örneği

Süresi 90.000 saniye (25 saat) olan video içeriği süresi:
vid_d=90000

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ği

Sürekli oynatma AÇIK:
vconp=2

Sürekli oynatma KAPALI:
vconp=1

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 click, video otomatik olarak oynatılıyorsa auto'dur.

Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.

Kullanım örneği

Otomatik oynatma:
vpa=auto

Oynatmak için tıklama:
vpa=click

Gereklilik

önerilir Programatik para kazanma için önerilir

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ği

VAST döndürme:
vpi=1

Yönlendirme döndürme:
vpi=0

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ği

Sesi kapatılmış:
vpmute=1

Sesi açılmış:
vpmute=0

Gereklilik

 Gerekli Web ve Programatik para kazanma için gereklidir

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ği

Videodan önce gösterilen reklam:
vpos=preroll

Videonun ortasında gösterilen reklam:
vpos=midroll

Videodan sonra gösterilen reklam:
vpos=postroll

Gereklilik

önerilir Programatik para kazanma için önerilir

wta

(Neden bu reklam?)

"Neden bu reklam?" parametresi, video oynatıcının "Neden Bu Reklam?" oluşturma desteğini gösteren sabit değeri kabul eder.

"Neden bu reklam?" 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 Icon ve IconClickFallbackImage desteğini uygulamalıdır.

İş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 wta=1 göndermelidir.

AEA'da Google talebi ve Google tarafından barındırılan rezervasyon trafiğine uygun olmaları için reklam isteklerinin, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesinin video reklamda veya tamamlayıcı reklamlarda oluşturulduğunu ya da tüm reklam öğeleri için kullanıcıya başka şekilde sağlandığını belirtmek üzere wta=1 göndermesi gerekir.

Kullanım örneği

Destekleniyor:
wta=1

Desteklenmiyor:
wta=0

Gereklilik

Gerekli Ad Exchange için gereklidir

Gerekli Web ve uygulama AEA trafiği için gereklidir

önerilir Programatik para kazanma için önerilir

Bu size yardımcı oldu mu?

Bunu nasıl iyileştirebiliriz?
Arama
Aramayı temizle
Aramayı kapat
Google uygulamaları
Ana menü