Bu makalede, VAST reklam etiketinde kullanılabilecek parametrelerin tam listesi gösterilmektedir. Belirli bir parametre hakkında daha fazla bilgi edinmek istiyorsanız bu makaleden yararlanabilirsiniz.
Tüm parametrelerin tıklanabilir alfabetik dizinini görüntüleyinBu sayfada
- Reklam sunumu için gerekli parametreler
- Programatik için gerekli parametreler
- Programatik için önerilen parametreler
- Diğer parametreler
false/true desteklenirken Boole parametreleri (ör. vpmute, wta, ad_rule, gdpr vb.) için 0/1 kullanılması önerilir.Uygulama türüne göre parametre listeleri
Belirli bir uygulamayı kullanıyorsanız bu uygulamanın kullanımını ve şartlarını özetleyen özel parametre listelerini kullanabilirsiniz. Özel parametre listesini şu amaçlarla kullanın:
Web Mobil uygulama Bağlı TV Ses Dijital ev dışı
Tüm parametreler
Reklam sunumu için gerekli parametreler
Genel olarak bu parametreler, çoğu uygulama için reklam sunumunda gereklidir. Ancak bazı durumlarda bu bilgiler gerekli olmayabilir. En doğru girişi görmek için belirli uygulama türünüze ait parametre listesini kullanın.
correlator (İlişkilendirici)
Açıklama
İlişkilendirici parametresi (correlator), 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.
Kullanım örnekleri
correlator=4345645667
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında reklam sunma için gereklidir.
SDK kullanımı
- 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.
description_url (Açıklama URL'si)
Açıklama
Açıklama URL'si parametresi (description_url), sayfada oynatılan videoyu açıklaması gereken bir değişken değerini kabul eder.
Açıklama URL'si, bir web uygulamasının, mobil uygulamanın veya TV uygulamasının belirli bir sayfasında oynatılan videolarla ilgili olmalıdır. Tüm videolar ya da tüm reklam istekleri için üst düzey alan adı olmamalıdır. Örneğin, golfle ilgili videolar göstermek için https://www.sample.com/golf.html sayfanız varsa bu sayfayı description_url değerine ayarlayın.
Kullanım örnekleri
description_url değeri, video içeren web sayfaları ve CTV/OTT cihazları için URL olarak kodlanmış olmalıdır. Ancak description_url değeri, mobil uygulamalar için kodlanmamalıdır.
URL olarak kodlanmış:
description_url=
https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fwww.sample.com%2Fgolf.html
Kodlanmamış:
description_url=
https://www.sample.com/golf.html
Koşullar ve öneriler
Bu parametre, web ve mobil uygulamalarda reklam sunumu için gereklidir. Ayrıca dinamik ayırma için Ad Exchange veya AdSense kullanıyorsanız da gereklidir.
Bu parametre, programatik para kazanma için önerilir.
SDK kullanımı
Bu parametre, IMA SDK tarafından otomatik olarak ayarlanmaz. Bunun manuel olarak ayarlanması gerekir.
Platformunuz için IMA SDK kılavuzlarına bakın.
env (Ortam)
Açıklama
Ortam parametresi (env), 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 örnekleri
Video ve/veya işitsel:
env=instream
Yalnızca video:
env=vp
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında reklam sunma için gereklidir.
Bu parametre, istek türü için "Video etiketi"ne göre doğru raporlama yapmak amacıyla gereklidir.
gdfp_req (Şema göstergesi)
Açıklama
Google Ad Manager şema göstergesi parametresi (gdfp_req), reklam isteğinin Google Ad Manager envanteri için olduğunu belirten sabit değeri kabul eder.
Kullanım örnekleri
gdfp_req=1
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında reklam sunma için gereklidir.
iu (Reklam birimi)
Açıklama
Reklam birimi parametresi (iu), şu biçimde mevcut reklam birimine ayarlanması gereken değişken değeri kabul eder: /network_code/.../ad_unit.
Kullanım örnekleri
iu=/6062/videodemo
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında reklam sunma için gereklidir.
output (Çıkış)
Açıklama
Çıkış biçimi parametresi (output), reklamın çıkış biçimine ayarlanması gereken sabit değeri kabul eder.
Kullanım örnekleri
Ağınızın varsayılan VAST sürümünü kullanın:
output=vast
VAST 4'ü kullanın (belirli etiketler için belirli sürümler ayarlayabilirsiniz):
output=xml_vast4
Ağınızın varsayılan VMAP ayarını kullanın:
output=vmap
VMAP 1'i kullanın:
output=xml_vmap1
VAST 4 döndüren VMAP 1'i kullanın (VAST'ı VMAP içinde döndürürseniz):
output=xml_vmap1_vast4
Koşullar ve öneriler
Bu parametre, web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında reklam sunma için gereklidir. Doğru reklam sunma yanıtı biçiminin oluşturulması gerekir.
SDK kullanımı
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.
sz (Boyut)
Açıklama
Boyut (sz) 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 örnekleri
Tek boyut:sz=400x300
Birden fazla boyut:sz=300x250|400x300
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV ve dijital ev dışı ortamlarda reklam sunumu için gereklidir.
Bu parametre, yalnızca ad_type=audio isteniyorsa isteğe bağlıdır.
unviewed_position_start (Geciken gösterimler)
Açıklama
Geciken gösterimler (unviewed_position_start) parametresi, video için geciken gösterimleri belirten sabit değeri kabul eder.
Kullanım örnekleri
unviewed_position_start=1
Koşullar ve öneriler
Gecikmeli gösterim fırsatı olduğunda web ve mobil uygulamalarda reklam sunumu için bu parametre gereklidir.
vpmute (Videoyu oynatma sesini kapatma)
Açıklama
Videoyu oynatma sesini kapatma parametresi (vpmute), 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. Bu parametre, video oynatıcının durumunu değiştirmez. Oynatma davranışı doğrudan video oynatıcı tarafından yönetilmelidir.
Kullanım örnekleri
Oynatma sessiz başlar:
vpmute=1
Oynatma ses açık olarak başlar:
vpmute=0
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda programatik para kazanma için gereklidir.
Bu parametre, Medya Derecelendirme Konseyi (MRC) Video Ölçüm Kuralları uyarınca da önerilir.
Programatik için gerekli parametreler
ott_placement (OTT yerleşimi)
Açıklama
OTT yerleşim parametresi (ott_placement), belirli bir yerleşim türü isteğini belirten sabit değeri kabul eder.
Aşağıdaki örnekler için yerleşim tanımları:
- Duraklatma: Kullanıcı içerik oynatmayı duraklattığında video içeriğinin üzerinde yer paylaşımlı olarak görünen yayın dışı biçim.
- Ana ekran: Bağlı TV cihazının veya OTT uygulamasının ana ekranında görünen reklam. Ana ekrandaki masthead, banner ve kart uygulamaları buna dahildir.
- Resim içinde resim: Video içeriğinin yanında ayrı bir reklam video oynatıcısında oynatılan video içi reklam. Genellikle video içeriğinin sıkıştırılmasını ve ikinci bir video oynatıcının yüklenmesini gerektirir.
- L banner: Video içeriğini sıkıştırıp videonun etrafında reklam oluşturmayı içeren yayın içi görüntülü reklam. Genellikle L şeklinde bir reklam içeriği kutusu olur (ancak bununla sınırlı değildir).
- Yer paylaşımlı: Video içeriğinin üzerinde görünen ancak tam ekranı kaplamayan tüm yayın içi reklam biçimleri. Görüntülü veya video reklam olabilir.
Kullanım örnekleri
Desteklenen biçimler ve ilgili değerleri:
Duraklatma:
ott_placement=1
Ana ekran:
ott_placement=2
Pencere içinde pencere:
ott_placement=3
L banner:
ott_placement=4
Yer paylaşımı:
ott_placement=5
Özel/diğer:
ott_placement=99
Koşullar ve öneriler
Bu parametre yalnızca OTT akış ortamlarında standart olmayan yerleşimlerden para kazanan yayıncılar için web, mobil uygulama ve bağlı TV ortamlarında programatik para kazanma için gereklidir.
plcmt (Yerleşim)
Açıklama
Yerleşim parametresi (plcmt), 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 bildirimleri geçersiz kılar.
Kullanım örnekleri
Yayın içi istek:
plcmt=1
Eşlik eden içerik isteği:
plcmt=2
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için gereklidir.
url (URL)
Açıklama
URL parametresi (url), 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.
- Web'de bu, video oynatıcıyı gösteren sayfanın URL'sidir.
- Web dışı ortamlarda bu değer, para kazanılan 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.*
Not: url, reklam isteğinin yapıldığı konumu ifade ederken description_url video içeriğini açıklayan, web'de taranabilir bir sayfa olduğundan url, description_url'den farklıdır.
Bu parametrenin değeri kodlanmalıdır.
Kullanım örnekleri
url=https%3A%2F%2Fround-lake.dustinice.workers.dev%3A443%2Fhttps%2Fwww.example.com%2Fvideo.html
* Uygulamalarda bu parametre bir değişken URL değerine ayarlanamıyorsa aşağıdaki kalıp önerilir: url=https%3A%2F%2F<app/bundleid>.example.com
Koşullar ve öneriler
Bu parametre, yalnızca web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda programatik para kazanma için gereklidir.
SDK kullanımı
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.
venuetype (Mekan türü)
Açıklama
Mekan türü parametresi (venuetype), ev dışı mekanın türünü belirtmek için kullanılır. Uygun değerler, IAB OpenOOH mekan türü 1.1 sınıflandırması tarafından desteklenen tam sayı numaralandırma kimlikleridir.
Kullanım örnekleri
Otel odaları:
venuetype=80703
Taksinin arka koltuğundaki tablet:
venuetype=103
Koşullar ve öneriler
Bu parametre, dijital ev dışı ortamda programatik para kazanma için gereklidir.
vpa (Videoyu otomatik oynatma)
Açıklama
Otomatik video oynatma (vpa) parametresi, 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, video oynatıcının durumunu değiştirmez. Oynatma davranışı doğrudan video oynatıcı tarafından yönetilmelidir.
Kullanım örnekleri
Otomatik oynatma:
vpa=auto
Oynatmak için tıklama:
vpa=click
Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.
Koşullar ve öneriler
Bu parametre; web, mobil uygulama, bağlı TV ve işitsel ortamlarda programatik para kazanma için gereklidir.
Bu parametre, Medya Derecelendirme Konseyi (MRC) Video Ölçüm Kuralları uyarınca da önerilir.
Programatik için önerilen parametreler
aconp (Kesintisiz ses oynatma)
Açıklama
Kesintisiz ses oynatma parametresi (aconp), oynatıcının kesintisiz olarak sesli içerik oynatmayı amaçlayıp amaçlamadığını gösteren sabit değeri kabul eder. Bu, Google Ad Manager'ın kullanıcı deneyimine en uygun reklamları seçmesine yardımcı olur.
Kullanım örnekleri
Sürekli oynatma açık:
aconp=2
Sürekli oynatma kapalı:
aconp=1
Sesin sürekli oynatılıp oynatılmadığını bilmiyorsanız bu parametre ayarlanmadan bırakılmalı veya aconp=0 olarak ayarlanmalıdır.
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
Bu parametre, Medya Derecelendirme Konseyi (MRC) Ses Ölçüm Kuralları uyarınca da önerilir.
an (Uygulama adı)
Açıklama
Uygulama kimliği parametresi (msid) ve uygulama adı parametresi (an), ç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 eder.
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 örnekleri
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şullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
Marka güvenliği ve alıcılar için daha fazla şeffaflık sağlamak amacıyla uygulama bilgilerinin eklenmesi önemle tavsiye edilir.
SDK kullanımı
IMA SDK her iki parametreyi de otomatik olarak dolduracaktır ancak bunların doğrudan VAST çağrıları da dahil olmak üzere SDK dışı ortamlarda veya Programatik Erişim Kitaplığı (PAL) ya da Yayıncı Kimliği Doğrulanmış Envanter (PAI) kullanılırken manuel olarak belirtilmesi gerekir.
Not: HTML5 IMA SDK'sı kullanılıyorsa uygulama bilgileri kullanılmaz.
dth (Cihaz türü ipucu)
Açıklama
Cihaz türü ipucu parametresi (dth), özellikle bağlı TV ve set üstü kutu ortamlarında cihazın yanlış sınıflandırılmasını azaltmaya yardımcı olan sabit bir 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 ö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
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
SDK kullanımı
Bu parametre, PAL ve PAI (SDK olmayan) uygulamaları için önerilir. IMA SDK veya DAI SDK için gerekli değildir.
givn (Video tek seferlik rastgele sayı)
Açıklama
Programatik Erişim Kitaplığı (PAL) kullanan entegrasyonlarda video tek seferlik rastgele sayı parametresi değişken bir dize değerini kabul eder.
Tek seferlik rastgele sayı URL için güvenlidir. URL olarak kodlamanız gerekmez.
Not: Daha önce eski paln parametresini kullanarak tek seferlik bir sayı sağladıysanız givn parametresine geçmeniz ve paln göndermeyi bırakmanız önemle tavsiye edilir. Her iki parametreyi de eklemeyin.
Kullanım örnekleri
Bu parametreye aktarılan değer hakkında daha fazla bilgiyi PAL ile ilgili başlangıç kılavuzlarında bulabilirsiniz.
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
hl (Dil)
Açıklama
Dil parametresi (hl), 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.
Kullanım örnekleri
İtalyanca reklam isteme:
hl=it
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.
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
msid (Uygulama kimliği)
Açıklama
Uygulama kimliği parametresi (msid) ve uygulama adı parametresi (an), ç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 eder.
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 örnekleri
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şullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
Marka güvenliği ve alıcılar için daha fazla şeffaflık sağlamak amacıyla uygulama bilgilerinin eklenmesi önemle tavsiye edilir.
SDK kullanımı
IMA SDK her iki parametreyi de otomatik olarak dolduracaktır ancak bunların doğrudan VAST çağrıları da dahil olmak üzere SDK dışı ortamlarda veya Programatik Erişim Kitaplığı (PAL) ya da Yayıncı Kimliği Doğrulanmış Envanter (PAI) kullanılırken manuel olarak belirtilmesi gerekir.
Not: HTML5 IMA SDK'sı kullanılıyorsa uygulama bilgileri kullanılmaz.
omid_p (OMID iş ortağı adı)
Açıklama
OMID iş ortağı adı parametresi (omid_p), OMID ölçümünü entegre eden iş ortağının adını ve iş ortağı sürümünü belirten bir değişken değeri kabul eder.
Desteklenen SDK API'leri parametresi (sdk_apis), desteklenen API'lerin tek bir listesi veya virgülle ayrılmış listesi olabilecek değişken değerleri kabul eder.
Bu parametreler, görüntülenebilirlik ve reklam doğrulaması için kullanılan bir parametre grubunun parçalarıdır.
Kullanım örnekleri
PAL kullanılmadığında:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Olası API Çerçevesi değerlerinin listesine bakın.
PAL kullanılırken:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
SDK kullanımı
- 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.
- 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
omidPartnerNameveomidPartnerVersion'ı kullanmanız gerekir. PAL veya IMA SDK'sını kullanmadığınızdaomid_pvesdk_apisparametrelerini ayarlamanız gerekir. - Bu parametre, otomatik olarak ayarlandığından IMA SDK kullanılırken kullanılmamalıdır.
rdid (Sıfırlanabilir cihaz tanımlayıcısı)
Açıklama
Sıfırlanabilir cihaz tanımlayıcısı parametreleri (rdid, idtype, is_lat), değişken değerleri kabul eder. Bu değer, reklam tanımlayıcısı (IFA) olarak da bilinir.
Android veya iOS için IMA SDK'sını kullanan mobil uygulamalarda IMA SDK'sı; rdid, idtype ve is_lat parametreleri ile akış isteklerinize kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcılarını iletir.
IMA SDK kullanılmadığında veya sunucu tarafı işaretleme (SSB) kullanıldığında bunları açık parametreler olarak 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 |
Kullanım örnekleri
Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin.
Koşullar ve öneriler
Bu parametreler belirli bir uygulamada reklam yayınlamak için gerekli olmasa da mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda programatik para kazanma için gereklidir.
Web uygulamalarında sıfırlanabilir cihaz tanımlayıcıları kullanılmaz.
SDK kullanımı
IMA SDK'sı bu alanı otomatik olarak geçirirken, yayıncılar PAL SDK'sını kullanırken bu parametreleri manuel olarak iletir.
sid (Oturum kimliği)
Açıklama
Oturum kimliği (sid) parametresi, yalnızca sıklık sınırı amacıyla kullanılabilecek, gizliliği korumaya yönelik 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 isteklerinde ve mobil uygulama cihazlarından gelen yayın içi video envanterinde desteklenir. Bu özellik şu anda web'de desteklenmemektedir.
sid=0 parametresini ayarlayarak oturum kimliğinin iletilmesini devre dışı bırakabilirsiniz.
Kullanım örnekleri
sid=123e4567-e89b-12d3-a456-426614174000
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
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da dijital ev dışı ortamında programatik para kazanma için gereklidir.
Bu parametre; mobil uygulama, bağlı TV ve işitsel ortamlarda programatik para kazanma için önerilir.
SDK kullanımı
Bu parametre, IMA SDK tarafından otomatik olarak gönderilir.
vconp (Kesintisiz video oynatma)
Açıklama
Kesintisiz video oynatma (vconp) 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.
Kullanım örnekleri
Kesintisiz oynatma AÇIK:
vconp=2
Kesintisiz oynatma KAPALI:
vconp=1
Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır.
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV ve işitsel ortamlarda programatik para kazanma için önerilir.
Bu parametre, Medya Derecelendirme Konseyi (MRC) Video Ölçüm Kuralları uyarınca da önerilir.
vid_d (Video süresi)
Açıklama
Video süresi (vid_d) parametresi, içeriğin süresini saniye cinsinden belirten değişken değeri kabul eder.
vid_dveallcuesparametreleri, 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ı kullanılmalıdı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
allcues'a iletilen işaretler yoksayılır. Videonun ortasında gösterilen reklamlar için süre yine de gereklidir. Bu nedenlevid_dparametresinin iletilmesi gerekir.
Kullanım örnekleri
Süresi 90.000 saniye (25 saat) olan video içeriği süresi:
vid_d=90000
Koşullar ve öneriler
Bu parametre, belirli bir uygulamada reklam yayınlamak için gerekli olmasa da web, mobil uygulama ve bağlı TV ortamlarda programatik para kazanma için önerilir.
vpos (Video konumu)
Açıklama
Video konumu (vpos) 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 örnekleri
Videodan önce gösterilen reklam:
vpos=preroll
Videonun ortasında gösterilen reklam:
vpos=midroll
Videodan sonra gösterilen reklam:
vpos=postroll
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV ve işitsel ortamlarda programatik para kazanma için önerilir.
Reklam kuralları kullanılıyorsa reklam sunucusu tarafından otomatik olarak eklendiği için bu parametreye gerek yoktur.
wta (Neden bu reklam?)
Açıklama
"Neden bu reklam?" parametresi, (wta) video oynatıcının reklam etiketi oluşturma desteğini gösteren sabit değeri kabul eder.
Kullanım örnekleri
Oynatıcı, VAST yanıtında sağlanan Reklam Seçenekleri simgesini oluşturmalıdır. Bu durumda şunları kullanın:
wta=1(veyawtaparametresini atlayın ya dawta'yı ayarlanmış bir değer olmadan iletin)VAST yanıtında sağlanan Reklam Seçenekleri simgesi tamamlayıcılarda oluşturulacaksa veya kullanıcıya başka bir şekilde sağlanacaksa işitsel istekler
wta=1kullanmalıdır.
Oynatıcı, VAST yanıtında sağlanan Reklam Seçenekleri simgesini oluşturmamalıdır. Bu durumda şunları kullanın:
wta=0
Koşullar ve öneriler
Bu parametre, belirli bir uygulama türü için reklam yayınlamak amacıyla gerekli olmasa da web, mobil uygulamalar, bağlı TV ve işitsel için programatik para kazanma özelliğinde kullanılması önerilir.
Parametre kullanıldığında:
&wta=0trafiği, Google talebinden gelen belirli kişiselleştirme türleri için uygun değildir.- AEA'dan gelen
&wta=0trafiği, rezervasyon ve yayıncı tarafından yönetilen Programatik Garantili satır öğelerinde reklam etiketi etkin olan reklam öğeleri için uygun değildir.
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, Google İçerik Bildirimi formunu kullanarak yasa dışı içerik bildirimlerini Google'a iletmelidir.
SDK kullanımı
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 VASTIcon ve IconClickFallbackImage desteğini uygulamalıdır.Diğer parametreler
Genel olarak bu parametreler, reklam yayınlamak için açıkça gerekli olmasa da belirli özellikleri kullanmak veya belirli uygulama türleri için gerekli olabilir.
ad_rule (Reklam kuralı)
Açıklama
Reklam kuralı parametresi (ad_rule), 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, tüm isteklerin reklam kuralı isteği olmasını sağlayan bir Google Ad Manager ağ ayarına bağlıdır. Ağ ayarı kullanılıyorsa reklam etiketinde ad_rule değerinin ayarlanması gerekmez. Reklam isteği bazında devre dışı bırakmak istiyorsanız ağ ayarını geçersiz kılmak için ad_rule=0 parametresini iletebilirsiniz. Ayrıca, reklam kuralları varsayılan olarak etkin değilse sırasıyla ad_rule=1 ve ad_rule=0 parametrelerini ileterek etkinleştirebilir/devre dışı bırakabilirsiniz.
Kullanım örnekleri
Reklam kuralları ayarı devre dışıysa:
- VAST reklam öğesi için istek:
ad_rule=0veya ayarlama
Reklam kuralları ayarı etkinse:
- VAST reklam öğesi için istek:
ad_rule=0 - Reklam kuralları için istek (VMAP):
ad_rule=1veya ayarlama
Reklam kurallarını kullanmamayı tercih ederseniz pmnd, pmxd ve pmad parametrelerini kullanarak VAST etiketleriniz için reklam arasını ve kapsül süresini belirtmek üzere reklam etiketi parametrelerini kullanabilirsiniz.
Koşullar ve öneriler
Bu parametre, belirli bir uygulama türü için reklam yayınlamak amacıyla gerekli olmasa da video reklam kurallarını doğru şekilde kullanmak için gereklidir.
addtl_consent (Ek izin)
Açıklama
Ek İzin parametresi (addtl_consent) değişken değerleri 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.
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
adtest (Reklam testi)
Açıklama
Reklam testi parametresi (adtest), dolgu (garanti edilmeyen) envanteri test etmek için kullanılan sorguların geçersiz trafik olarak tanımlanmamasını ve gelir üzerinde etkisinin olmamasını sağlamak için kullanılmalıdır.
Dolguyu test ederken, test sırasında herhangi bir reklamın gösterim veya tıklama kaydetmemesini sağlamak için bu parametreyi on olarak ayarlayın. Normal şekilde faturalandırılmak için test dışı ortamlarda off olarak ayarlayın. Bu parametre ayarlanmazsa varsayılan olarak off olur.
Not: Doğrudan satılan satır öğelerini test ederken gelir üzerinde etkisi olmayan test satır öğelerini kullanmalısınız.
Kullanım örnekleri
Açık:
adtest=on
Kapalı:
adtest=off
ad_type (Reklam türü)
Açıklama
Reklam türü parametresi (ad_type), istek için döndürülmesi gereken reklam türlerini belirten sabit değeri kabul eder.
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
audio_videodeğeri, iki biçimin de rekabet etmesine olanak tanır ancak yalnızca bir tanesi yayınlanır. Yalnızca video reklam oynatmayı destekleyen işitsel içeriğe video reklam öğeleri veya spor yayınları, video yayınları, haberler vb. gibi yapısı gereği "dinlenebilir" olabilen içerik için yayın içi video oynatıcılara işitsel reklam öğeleri yayınlamak üzere kullanılması amaçlanmıştır. Video içeriklerinde ses hakkında bilgi edinin.
Yalnızca atlanabilir video reklamlara izin verir:
ad_type=skippablevideo
Yalnızca atlanamayan video reklamlara izin verir:
ad_type=standardvideo
Koşullar ve öneriler
- Uygulamanızda video içerik varsa bu parametreyi
video,audio_videoolarak ayarlayın veya ayarlanmamış bırakın. - Uygulamanızda yalnızca ses içeriği varsa (ör. radyo veya konuşma uygulaması) bu parametreyi
audioolarak ayarlamanız gerekir. Bu ayar yapılmadan bırakılırsa hiçbir işitsel reklam döndürülmez.
afvsz (Doğrusal olmayan reklam boyutları)
Açıklama
Doğrusal olmayan reklam boyutları parametresi (afvsz), 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:
200x200250x250300x250336x280450x50468x60480x90729x90
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 örnekleri
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şullar ve öneriler
Bu parametre, belirli bir uygulamaya veya işlem türüne reklam yayınlamak için gerekli olmasa da IMA SDK kullanılmadığında doğrusal olmayan video reklamlar yayınlamak için gereklidir.
allcues (Tüm işaret noktaları)
Açıklama
Tüm işaretler parametresi (allcues), işaret noktalarının virgülle ayrılmış listesi olan milisaniye cinsinden değişken değerleri kabul eder. Google Ad Manager, her bir değer için bir reklam arası döndürür.
vid_dveallcuesparametreleri, 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 nedenlevid_dparametresinin iletilmesi gerekir.
Kullanım örnekleri
10. ve 20. saniyedeki işaret noktaları:
allcues=10000,20000
ciu_szs (Tamamlayıcı boyutları)
Açıklama
Tamamlayıcı boyutlar parametresi (ciu_szs), 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 örnekleri
ciu_szs=728x90,300x250
Çok boyutlu alan içeren boyutlar:
ciu_szs=728x90,300x200|300x250
cmsid (İçerik kaynağı kimliği)
Açıklama
İçerik kaynağı kimliği parametresi (cmsid) ve video kimliği parametresi (vid), 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. Google Ad Manager'da bu kimliği bulmak için Video'yu, 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. Google Ad Manager'da bu kimliği bulmak için Video'yu, ardından İçerik'i ve ardından ilgili video içeriğini tıklayın.
Kullanım örnekleri
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%%
Koşullar ve öneriler
Bu parametreler, belirli bir uygulama veya işlem türüne reklam yayınlamak için gerekli olmasa da video içeriği hedefleme için gereklidir.
cust_params (Özel parametreler)
Açıklama
Özel parametreler (cust_params) 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 örnekleri
Anahtar/değer çiftleri ekleme örneklerini inceleyin.
excl_cat (Hariç tutma kategorisi)
Açıklama
Hariç tutma kategorisi parametresi (excl_cat), değişken değerleri kabul eder ve reklam isteğinde hariç tutma etiketini içeren tüm satır öğelerini engellemek için kullanılır. Hariç tutma kategorisini ve hariç tutma etiketlerini ayarlamak için cust_params parametresini kullanın.
Kullanım örnekleri
İki hariç tutma etiketi (airline_excl_label ve train_excl_label) için hariç tutma kategorisini ayarlamak üzere dikey çizgi (|) kullanarak etiketleri ayırın:
excl_cat=airline_excl_label%7Ctrain_excl_label
Ardından URL kodlamasını uygulayın ve kodlanmış dizeyi cust_params parametresinde kullanın:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (GDPR)
Açıklama
GDPR parametresi (gdpr), sabit değerleri 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 örnekleri
GDPR geçerlidir:
gdpr=1
GDPR geçerli değildir:
gdpr=0
gdpr_consent (GDPR İzni)
Açıklama
GDPR Kullanıcı Rızası parametresi (gdpr_consent), değişken değerleri 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 örnekleri
gdpr_consent=GDPR_CONSENT_123
iabexcl (IAB hariç tutma URL'si)
Açıklama
IAB hariç tutma URL'si parametresi (iabexcl), kategorilerin virgülle ayrılmış listesi olan değişken değerleri kabul eder.
Kullanım örnekleri
iabexcl=3,14,527 "Ticari Kamyonlar", "Arazi Araçları" ve "Ragbi"yi içermez.
IAB İçerik Sınıflandırması kategorilerinin ve kimliklerinin listesini indirebilirsiniz.
idtype (Cihaz türü)
Açıklama
Sıfırlanabilir cihaz tanımlayıcısı parametreleri (rdid, idtype, is_lat), değişken değerleri kabul eder. Bu değer, reklam tanımlayıcısı (IFA) olarak da bilinir.
Android veya iOS için IMA SDK'sını kullanan mobil uygulamalarda IMA SDK'sı; rdid, idtype ve is_lat parametreleri ile akış isteklerinize kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcılarını iletir.
IMA SDK kullanılmadığında veya sunucu tarafı işaretleme (SSB) kullanıldığında bunları açık parametreler olarak 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 |
Kullanım örnekleri
Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin.
Koşullar ve öneriler
Bu parametreler belirli bir uygulamada reklam yayınlamak için gerekli olmasa da mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda programatik para kazanma için gereklidir.
Web uygulamalarında sıfırlanabilir cihaz tanımlayıcıları kullanılmaz.
SDK kullanımı
IMA SDK'sı bu alanı otomatik olarak geçirirken, yayıncılar PAL SDK'sını kullanırken bu parametreleri manuel olarak iletir.
ipd (Envanter iş ortağı alanı)
Açıklama
Envanter iş ortağı alan parametresi (ipd), 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
Kullanım örnekleri
inventorypartnerdomain, iş ortağının envanterden para kazanabilen .txt dosyasını işaret eden app-ads.txt dosyasındadır. ipd parametresindeki değer, inventorypartnerdomain öğelerinden birinin altındaki app-ads.txt dosyasındaki bir değerle eşleşmelidir.Koşullar ve öneriler
Bu parametre, sahibi olmadıkları envanterden para kazanan yayıncılar için gereklidir.
ipe (Gösterim pingleme varlığı)
Açıklama
Gösterim pingleme varlığı parametresi (ipe), 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.
Gösterim ping'i varlığı, bir sunucudan gösterim ping'leri/işaretçileri gönderildiğinde kullanılır.
Kullanım örnekleri
Sunucu tarafı işaretleme (SSB):
ipe=ssb
is_lat (Reklam izlemeyi sınırla)
Açıklama
Sıfırlanabilir cihaz tanımlayıcısı parametreleri (rdid, idtype, is_lat), değişken değerleri kabul eder. Bu değer, reklam tanımlayıcısı (IFA) olarak da bilinir.
Android veya iOS için IMA SDK'sını kullanan mobil uygulamalarda IMA SDK'sı; rdid, idtype ve is_lat parametreleri ile akış isteklerinize kullanıcı hedefleme için sıfırlanabilir cihaz tanımlayıcılarını iletir.
IMA SDK kullanılmadığında veya sunucu tarafı işaretleme (SSB) kullanıldığında bunları açık parametreler olarak 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 |
Kullanım örnekleri
Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin.
Koşullar ve öneriler
Bu parametreler belirli bir uygulamada reklam yayınlamak için gerekli olmasa da mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda programatik para kazanma için gereklidir.
Web uygulamalarında sıfırlanabilir cihaz tanımlayıcıları kullanılmaz.
SDK kullanımı
IMA SDK'sı bu alanı otomatik olarak geçirirken, yayıncılar PAL SDK'sını kullanırken bu parametreleri manuel olarak iletir.
lip (Kapsüldeki son konum)
Açıklama
Kapsüldeki son konum parametresi (lip), hedefleme veya raporlama için kapsüldeki son konumdan gelen bir isteği belirtmek üzere sabit değeri kabul eder.
Not: Bu parametre optimize edilmiş kapsüller için geçerli değildir ve kullanıldığı takdirde yoksayılır.
Kullanım örnekleri
lip=1
ltd (Sınırlı reklamlar)
Açıklama
Sınırlı reklamlar parametresi (ltd), ç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. Yayıncı bu parametreyi manuel olarak ekleyebilir. Bu durumda Google, benzer şekilde, kullanıcı nerede olursa olsun uygun bir sınırlı reklam yayınlamaya çalışır.
Bu parametre, sınırlı reklam isteğini belirtmek için kullanılır ve is_lat parametresinden farklıdır. Bu ayar, kişiselleştirmeyi ve tanımlayıcıların bu amaçlarla kullanılmasını devre dışı bırakır.
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.Bir reklam isteği
ltd=1 (yani sınırlı reklam isteği) içeriyorsa SDK'lar kullanıldığında alan pagead2.googlesyndication.com olarak değişir. SDK'sız entegrasyonlarda yayıncıların pagead2.googlesyndication.com alanına manuel olarak geçmesi gerekir.Kullanım örnekleri
ltd=1
max_ad_duration (Maksimum reklam süresi)
Açıklama
Minimum reklam süresi parametresi (min_ad_duration) ve maksimum reklam süresi parametresi (max_ad_duration), 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.
Bu parametre, reklam öğelerini tek reklamlar için reklam etiketinde veya optimize edilmiş kapsül isteklerinde gereken bir süreyle kısıtlamak için kullanılabilir.
Kullanım örnekleri
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (Minimum reklam süresi)
Açıklama
Minimum reklam süresi parametresi (min_ad_duration) ve maksimum reklam süresi parametresi (max_ad_duration), 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.
Bu parametre, reklam öğelerini tek reklamlar için reklam etiketinde veya optimize edilmiş kapsül isteklerinde gereken bir süreyle kısıtlamak için kullanılabilir.
Kullanım örnekleri
min_ad_duration=15000&max_ad_duration=30000
mridx (Ara reklam sayısı)
Açıklama
Videonun ortasında gösterilen reklam numarası parametresi (mridx), 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 örnekleri
mridx=2
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya veya işlem türüne reklam yayınlamak için gerekli olmasa da belirli bir videonun ortasında gösterilen reklamı hedeflemek, videonun ortasında gösterilen reklam hakkında rapor oluşturmak ve videonun ortasında gösterilen reklam hakkında tahminde bulunmak için gereklidir.
nofb (Yedek yok)
Açıklama
Yedek yok parametresi (nofb), reklam isteğinin yedek video reklamlardan oluşan oynatma listesini döndürmemesi gerektiğini belirten sabit değeri kabul eder.
Kullanım örnekleri
Yedek devre dışı bırakıldı:
nofb=1
Tek reklam yedeği ve optimize edilmiş kapsül reklam büfesi, nofb=1 parametresi ile reklam isteği başına devre dışı bırakılabilir.
npa (Kişiselleştirilmemiş reklam)
Açıklama
Kişiselleştirilmemiş reklamlar parametresi (npa), 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 örnekleri
Kişiselleştirilmemiş reklamlar:
npa=1
Koşullar ve öneriler
Bu parametre yalnızca kullanıcı kişiselleştirmeyi devre dışı bıraktığında gereklidir. Yayıncılar, durumu kontrol ederken kullanıcının durumunu doğru şekilde temsil ettiklerinden emin olmalıdır.
paln (Programatik Erişim Kitaplığı tek seferlik rastgele sayısı – eski)
Açıklama
Programatik Erişim Kitaplığı (PAL) kullanan entegrasyonlarda video tek seferlik rastgele sayı parametresi değişken bir dize değerini kabul eder.
Tek seferlik rastgele sayı URL için güvenlidir. URL olarak kodlamanız gerekmez.
Not: Daha önce eski paln parametresini kullanarak tek seferlik bir sayı sağladıysanız givn parametresine geçmeniz ve paln göndermeyi bırakmanız önemle tavsiye edilir. Her iki parametreyi de eklemeyin.
Kullanım örnekleri
Bu parametreye aktarılan değer hakkında daha fazla bilgiyi PAL ile ilgili başlangıç kılavuzlarında bulabilirsiniz.
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarında programatik para kazanma için önerilir.
pmad (Kapsül maksimum reklam sayısı)
Açıklama
Kapsüldeki maksimum reklam sayısı parametresi (pmad), 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ın kullanabildiği bir özellik olan optimize edilmiş kapsüldeki toplam reklam sayısını sınırlar.
Bu parametre VMAP için kullanılmamalıdır (ad_rule=1 olduğunda).
Kullanım örnekleri
pmad=4
pmnd (Kapsül minimum süresi)
Açıklama
Kapsül minimum süresi parametresi (pmnd) ve kapsül maksimum süresi parametresi (pmxd), 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, gelişmiş video paketine sahip yayıncıların kullanabildiği bir özellik olan optimize edilmiş kapsülde birden fazla reklam istemek için kullanılır. Reklam kuralları kullanıldığında Google Ad Manager bu bilgileri otomatik olarak ekler.
Bu parametre, VMAP için kullanılmamalıdır (ad_rule=1 olduğunda).
Kullanım örnekleri
pmnd=0&pmxd=60000
pmxd (Kapsül maksimum süresi)
Açıklama
Kapsül minimum süresi parametresi (pmnd) ve kapsül maksimum süresi parametresi (pmxd), 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, gelişmiş video paketine sahip yayıncıların kullanabildiği bir özellik olan optimize edilmiş kapsülde birden fazla reklam istemek için kullanılır. Reklam kuralları kullanıldığında Google Ad Manager bu bilgileri otomatik olarak ekler.
Bu parametre, VMAP için kullanılmamalıdır (ad_rule=1 olduğunda).
Kullanım örnekleri
pmnd=0&pmxd=60000
pmxfwt (Kapsül maksimum zorunlu izlenme süresi)
Açıklama
Kapsül maksimum zorunlu izlenme süresi parametresi (pmxfwt), bir kapsülün atlanamayan maksimum süresini milisaniye cinsinden belirten değişken değeri kabul eder.
Atlanamayan ve atlanabilir video reklamların bir karışımını içeren kapsülleri destekliyorsanız ve kullanıcıların reklam süresini sınırlamak istiyorsanız kullanıcının görüntülemesi gereken maksimum atlanamayan reklam süresini tanımlamak için bu parametreyi kullanın.
Not: Atlanabilir reklamlar için tam süre dahil olmak üzere kapsülün maksimum toplam süresi tanımlanırken maksimum kapsül süresi parametresi (pmxd), bu parametrenin yerini alır.
Kullanım örneği
pmxfwt=30000
pod (Kapsül numarası)
Açıklama
Kapsül numarası parametresi (pod), 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 örnekleri
pod=3
Koşullar ve öneriler
Bu parametre, belirli bir uygulama veya işlem türüne reklam yayınlamak için gerekli olmasa da aynı reklamın farklı kapsüllerde yayınlanmasına izin vermek ve rakip hariç tutma, sıklık sınırı ve ilgili özellikleri doğru şekilde kullanmak için gereklidir.
pp (Reklam öğesi profili)
Açıklama
Reklam öğesi profili parametresi (pp), 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 örnekleri
pp=creative_profile
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da video ve işitsel reklam öğesi profilleri olan Google Ad Manager barındırılan reklam öğeleri için medya dosyalarının kısıtlanması söz konusu olduğunda gereklidir. Yönlendirmeler veya programatik reklamlar için bu, şartın karşılandığından emin olmak amacıyla kullanılır ancak medya dosyalarını reklam öğesi profilinde seçilenlerle kısıtlamaz.
ppt (Publisher Privacy Treatment)
Açıklama
Publisher Privacy Treatment parametresi (ppt), reklam isteği için reklam kişiselleştirmenin devre dışı bırakılıp bırakılmayacağını belirtmek üzere kullanılan bir sabit değeri kabul eder.
Bu parametre, npa=1 ve rdp=1'den farklı olabilecek kişiselleştirilmemiş reklamları zorunlu kılma yöntemi sunar. Hem rezervasyonları hem de programatik talebi etkiler.
Yayıncı Gizlilik Değerlendirmesi hakkında daha fazla bilgi
Kullanım örnekleri
Reklam kişiselleştirmeyi devre dışı bırakma:
ppt=1
ppid (Yayıncı tarafından sağlanan tanımlayıcı)
Açıklama
Yayıncı tarafından sağlanan tanımlayıcı (ppid) parametresi; sıklık sınırı, kitle segmentasyonu, 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.
Yayıncı tarafından sağlanan tanımlayıcılar hakkında daha fazla bilgi
Kullanım örnekleri
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya veya işlem türüne reklam yayınlamak için gerekli olmasa da platformdan bağımsız tutarlı bir tanımlayıcı kullanılması gerekir. Diğer tanımlayıcılar mevcut olmadığında ve alıcılara sağlanabileceğinde kullanılabilir.
ppos (Kapsüldeki konum)
Açıklama
Kapsüldeki konum (ppos) 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. Reklam kuralları kullanıldığında Google Ad Manager bu bilgileri otomatik olarak ekler.
Kullanım örnekleri
ppos=2
Koşullar ve öneriler
Bu parametre, belirli bir uygulama veya işlem türüne reklam yayınlamak için gerekli olmasa da konum hedeflemenin gerekli olduğu standart kapsüller ve bu kapsüller hakkında tahmin ve rapor oluşturmak için gereklidir. Rakip hariç tutma, sıklık sınırı ve ilgili özelliklerin de doğru şekilde kullanılması gerekir.
ppsj (Yayıncı tarafından sağlanan sinyaller JSON)
Açıklama
Yayıncı tarafından sağlanan sinyaller JSON parametresi (ppsj), programatik para kazanmayı iyileştirmek için yayıncı tarafından sağlanan kitle ve içerik verilerini içeren base64 kodlu bir JSON nesnesi olan değişken değerini kabul eder.
Bu parametre, alıcılara/teklif verenlere belirli sinyaller göndermek için kullanılabilir.
Yayıncı tarafından sağlanan sinyaller ve desteklenen sınıflandırmalar hakkında daha fazla bilgi
Kullanım örnekleri
JSON nesnesi:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Base64 olarak kodlanmış değeri uygulayın:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Geçerli JSON anahtar/değer çiftlerinin ayrıntılarını
HTML5 IMA SDK örneğinde bulabilirsiniz.
ptpl (Reklam arası şablonu kimliği)
Açıklama
Reklam arası şablon kimliği parametresi (ptpl) ve ad parametresi (ptpln), optimize edilmiş kapsül isteği için hangi reklam arası şablonunun uygulanması gerektiğini belirtmek üzere kullanılan değişken değerleri kabul eder.
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 bu parametrelerden yalnızca biri gereklidir.
Kullanım örnekleri
Reklam arası şablonları oluşturma ve isteme hakkında daha fazla bilgi
Koşullar ve öneriler
Bu parametreler yalnızca doğrudan bir reklam arası şablonu istiyorsanız gereklidir.
ptpln (Reklam arası şablonu adı)
Açıklama
Reklam arası şablon kimliği parametresi (ptpl) ve ad parametresi (ptpln), optimize edilmiş kapsül isteği için hangi reklam arası şablonunun uygulanması gerektiğini belirtmek üzere kullanılan değişken değerleri kabul eder.
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 bu parametrelerden yalnızca biri gereklidir.
Kullanım örnekleri
Reklam arası şablonları oluşturma ve isteme hakkında daha fazla bilgi
Koşullar ve öneriler
Bu parametreler yalnızca doğrudan bir reklam arası şablonu istiyorsanız gereklidir.
pubf (Ad Exchange etiketlerinde genel fiyat tabanları)
Açıklama
Ad Exchange parametresi için herkese açık taban parametresi (pubf) ve Ad Exchange için özel taban parametresi (pvtf), Ad Exchange etiketlerine fiyat tabanları eklemek için kullanılan değişken değerleri kabul eder.
Bu parametreler google_ad_public_floor ve google_ad_private_floor ile eş değerdir.
Kullanım örnekleri
Herkese açık taban:
pubf=123
Özel taban:
pvtf=123
Koşullar ve öneriler
Bu parametreler yalnızca Avrupa Ekonomik Alanı ("AEA") veya İsviçre'de bulunan ve "Taban fiyat" özelliğini kullanmaya uygun olan yayıncılar tarafından kullanılabilir.
İstek gönderme hakkında bilgi edinin.
pvid (Uygulama grubu kimliği)
Açıklama
Uygulama grubu kimliği parametresi (pvid), Android uygulama grubu kimliği olarak ayarlanmış bir değişken değerini, uygulama grubu kapsamı parametresi (pvid_s) ise uygulama grubu kimliğinin kapsamını temsil eden sabit değeri (scope_app veya scope_developer) kabul eder.
Uygulama grubu kimliğini alma ile ilgili Android dokümanlarına bakın.
Kullanım örnekleri
pvid=[AppSetID_value]
pvid_s=scope_app
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da uygulama tabanlı CTV (Android TV) dahil olmak üzere Android cihazlardaki mobil uygulamalarda programatik para kazanma için önerilir.
SDK kullanımı
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.
pvid_s (Uygulama grubu kapsamı)
Açıklama
Uygulama grubu kimliği parametresi (pvid), Android uygulama grubu kimliği olarak ayarlanmış bir değişken değerini, uygulama grubu kapsamı parametresi (pvid_s) ise uygulama grubu kimliğinin kapsamını temsil eden sabit değeri (scope_app veya scope_developer) kabul eder.
Uygulama grubu kimliğini alma ile ilgili Android dokümanlarına bakın.
Kullanım örnekleri
pvid=[AppSetID_value]
pvid_s=scope_app
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya reklam yayınlamak için gerekli olmasa da uygulama tabanlı CTV (Android TV) dahil olmak üzere Android cihazlardaki mobil uygulamalarda programatik para kazanma için önerilir.
SDK kullanımı
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.
pvtf (Ad Exchange etiketlerinde özel fiyat tabanları)
Açıklama
Ad Exchange parametresi için herkese açık taban parametresi (pubf) ve Ad Exchange için özel taban parametresi (pvtf), Ad Exchange etiketlerine fiyat tabanları eklemek için kullanılan değişken değerleri kabul eder.
Bu parametreler google_ad_public_floor ve google_ad_private_floor ile eş değerdir.
Kullanım örnekleri
Herkese açık taban:
pubf=123
Özel taban:
pvtf=123
Koşullar ve öneriler
Bu parametreler yalnızca Avrupa Ekonomik Alanı ("AEA") veya İsviçre'de bulunan ve "Taban fiyat" özelliğini kullanmaya uygun olan yayıncılar tarafından kullanılabilir.
İstek gönderme hakkında bilgi edinin.
rdp (Veri işlemeyi kısıtla)
Açıklama
Veri işlemeyi kısıtlama parametresi (rdp), reklam isteğinin veri işlemeyi kısıtlaması gerektiğini gösteren sabit değeri kabul eder.
Veri İşlemeyi Kısıtla ağ ayarını etkinleştirerek veri işlemeyi ağ düzeyinde kısıtlayabilirsiniz.
Kullanım örnekleri
Veri işlemeyi kısıtla:
rdp=1 veya rdp (ayarlı değer olmadan)
Veri işlemeyi kısıtlama:
rdp=0
scor (Akış ilişkilendirici)
Açıklama
Akış ilişkilendirici (scor) parametresi, her video akışı için oluşturulmuş bir tam sayı olması gereken değişken değeri kabul eder.
scor ve correlator parametrelerinin aynı tam sayı değerine sahip olması gerekmez. Ancak benzersiz bir izleme oturumunu tanımlamak için her video akışı oynatması boyunca ilgili değerlerini korumaları gerekir.
Kullanım örnekleri
scor=17
Koşullar ve öneriler
Bu parametre, belirli bir uygulama veya işlem türüne reklam yayınlamak için gerekli olmasa da web, mobil uygulama, bağlı TV, işitsel ve dijital ev dışı ortamlarda reklam sunma için önerilir.
Bu parametre, 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.
sdk_apis (SDK API çerçevesi)
Açıklama
SDK API çerçevesi (sdk_apis) parametresi, desteklediği tüm API çerçevelerini belirten, sabit tam sayı değerlerinin virgülle ayrılmış listesini kabul eder.
Koşullar ve öneriler
SDK kullanımı
Bu parametre, Programatik Erişim Kitaplığı'nı (PAL) kullanan yayıncılar tarafından kullanılır. IMA SDK'yı kullanırken bu parametreye değer ayarlamaya çalışırsanız değerler, IMA SDK tarafından desteklenen değerlerle geçersiz kılınır.
sdmax (Atlanabilir maks. reklam süresi)
Açıklama
Atlanabilir maksimum reklam süresi (sdmax) 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.
Belirli bir reklam isteğinde atlanabilir video/işitsel reklam öğelerinin süresi için 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 örnekleri
Aşağıdaki ayarları kullanarak:
max_ad_duration= 15000 (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 bir reklam öğesi olduğu ve süresi (atlanamayan) maksimum süreyi aştığı için filtrelenir.
- B Reklam Öğesi, süresi
max_ad_durationdeğerini aşmasına rağmen atlanabilir olduğu ve süresi atlanabilir maksimum değeri aşmadığı için filtrelenmez.
ssss (Sunucu tarafı birleştirme kaynağı)
Açıklama
Sunucu tarafı birleştirme kaynağı (ssss) 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 örnekleri
ssss=mystitcher
Koşullar ve öneriler
Bu parametre, belirli bir uygulamada veya işlem türünde reklam yayınlamak için gerekli olmasa da sunucu tarafı uygulamaları kullanmak için gereklidir.
tfcd (Çocuklara yönelik etiketi)
Açıklama
Çocuklara yönelik olarak değerlendirilme (tfcd) parametresi, isteğin çocuklara yönelik olarak değerlendirilmesi gerektiğini belirten sabit değeri kabul eder.
Kullanım örnekleri
tfcd=1
trt (Trafik türü)
Açıklama
Trafik türü (trt) parametresi, satın alınan veya organik trafiği istemek için kullanılan sabit değeri kabul eder.
Kullanım örnekleri
Satın alınan trafik için istek:
trt=1
Organik trafik için istek:
trt=2
Koşullar ve öneriler
SDK kullanımı
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.
us_privacy (IAB ABD gizliliği)
Açıklama
us_national dizesi için destek, artık GPP kullanılacağı için IAB tarafından sonlandırılmıştır. Ancak Ad Manager, geriye dönük uyumluluk için iletilmişse dizeyi okumaya ve kullanmaya devam eder. Yayıncıların GPP'yi veya diğer gizlilik denetimlerini incelemesi ve us_national'dan geçiş yapması önerilir.
vad_type (Video reklam türü)
Açıklama
Video reklam türü (vad_type) 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 örnekleri
Doğrusal reklam döndürme:
vad_type=linear
Doğrusal olmayan reklam döndürme:
vad_type=nonlinear
vid (Video kimliği)
Açıklama
İçerik kaynağı kimliği parametresi (cmsid) ve video kimliği parametresi (vid), 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. Google Ad Manager'da bu kimliği bulmak için Video'yu, 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. Google Ad Manager'da bu kimliği bulmak için Video'yu, ardından İçerik'i ve ardından ilgili video içeriğini tıklayın.
Kullanım örnekleri
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%%
Koşullar ve öneriler
Bu parametreler, belirli bir uygulama veya işlem türüne reklam yayınlamak için gerekli olmasa da video içeriği hedefleme için gereklidir.
vpi (Video oynatma listesi satır içi)
Açıklama
Video oynatma listesi satır içi (vpi) 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 örnekleri
VAST döndürme:
vpi=1
Yönlendirme döndürme:
vpi=0
