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.

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

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

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

pmad pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp schain 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 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 İşitsel reklamlar için gereklidir
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 addtl_consent=1~1.35.41.101
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 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  İç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  İç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 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 Web ve uygulama için gereklidir 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. İçeriği açıklayan 1-3 paragrafla sayfayı özetleyin. Örneğin, önceden tanımlanmış bloklardan description_url sayfa içeriğini dinamik olarak birleştirin. Farklı bir açıklama URL'si sağlama hakkında daha fazla bilgi 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 Web, uygulama ve Ad Exchange için gereklidir Programatik para kazanma için önerilir
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 bir sabit değer 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 örnekleri Şuradan gelen istekler: Özellikli telefon: dth=1 Akıllı telefon: dth=2 Masaüstü: dth=3 Tablet: dth=4 Bağlı TV: dth=5 Oyun konsolu: dth=6 Set üstü kutu: dth=7 Gereklilik Bağlı TV'de programatik para kazanma için önerilir. 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 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 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 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
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 gdpr_consent=GDPR_CONSENT_123
givn plan (Video tek seferlik rastgele sayı)	For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value. The nonce is URL safe—you don't need to URL-encode it. Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters. Usage example You can read more about the value passed to this parameter in the getting started guides for PAL.
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 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 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. 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  Uygulama için her iki parametre de gereklidir 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 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   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
kapsül (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 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 Programatik para kazanma için önerilir
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ğ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 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 Uygulama için gereklidir 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. 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 Uygulama için gereklidir 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
schain (Tedarik zinciri)	Tedarik zinciri parametresi, serileştirilmiş SupplyChain nesnesi olması gereken bir değişken değeri kabul eder. Bu parametre dahil edildiğinde Google, alıcılara göndermeden önce alınan tüm schain nesnelerine bir düğüm ekler. SupplyChain bilgilerini OpenRTB yerine bir etiket aracılığıyla iletmek için IAB belgelerinin tamamını inceleyin. Schain'in doğru şekilde ayrıştırılmasıyla ilgili koşulları inceleyin . IAB dokümanlarına göre, aşağıdakiler SupplyChain nesnesi için serileştirmeyi tanımlar: {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject ve SupplyChainNode özellikleri, isteğe bağlı alanların atlanabileceği ve virgül ayırıcıların isteğe bağlı olarak hariç tutulabileceği şekilde virgül ile ayrılır. Her SupplyChainNode öğesi bir "!" ile ayrılır. Herhangi bir mülkün değeri URL kodlaması gerektiren karakterler (ör. "," veya ",") içeriyorsa değer, serileştirmeden önce URL olarak kodlanmalıdır. Serileştirme sırası SupplyChainObject özellikleri şu sırayla serileştirilir: ver,complete SupplyChainNode özellikleri şu sırayla serileştirilir: asi,sid,hp,rid,name,domain,ext Not: ext öğesinin içeriği exchange'e özeldir. Google Ad Manager bu özelliği ayrıştırmaz. SupplyChain nesnesinin nasıl serileştirileceğine dair örnekler Aşağıda, yukarıdaki SupplyChain nesnesini serileştirmenin iki yolu gösterilmektedir: Boş isteğe bağlı alanlar için virgülle serileştirme 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, Boş isteğe bağlı alanlar için virgül olmadan serileştirme 1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 SupplyChain nesnesi hakkında daha fazla bilgi Kullanım örnekleri schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,, asi değeri exchange,1 olsaydı, kaçış karakterleriyle serileştirme şöyle olurdu: 1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1 Gereklilik Google Ad Manager'a istek göndermeden önce ödeme aracılarından yararlanan yayıncılar için gereklidir. Üçüncü taraf reklam sunucusu teknolojisini kullanan yayıncılar da buna dahildir.
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 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 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 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 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 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 Web ve uygulama için gereklidir 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 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   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 Programatik para kazanma için önerilir
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 &wta parametresi gönderilmediğinde varsayılan olarak &wta=1 olur. 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 Icon ve IconClickFallbackImage desteğini uygulamalıdır. Yayıncı, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesini oluşturmayacaksa &wta=0 göndermelidir. &wta=1 içeren veya &wta parametresi içermeyen bir reklam isteği, yayıncının verilen Reklam Seçenekleri bilgilerini oluşturacağını gösterir. İş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önderebilir. AEA'dan gelen trafik için &wta=0 içeren istekler, Google etiketinin etkin olduğu rezervasyon reklam öğeleri için uygun olmaz. 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ği Desteklenenler: wta=1 veya wta parametresi yok Desteklenmiyor: wta=0 Gereklilik Ad Exchange için gereklidir Web ve uygulama AEA trafiği için gereklidir Programatik para kazanma için önerilir