Uygulama için gerekli parametreler

Ad Exchange talebi için IMA SDK kullanmadan etikete dayalı bir video çözümü uygulamak, beta özelliğidir ve ağınızda kullanılamayabilir. Daha fazla bilgi için hesap yöneticinize başvurabilirsiniz.

Aşağıda VAST reklam etiketi URL parametrelerinin alt kümesini görebilirsiniz. Bu parametreler, IMA SDK ile entegre edilmediği zaman uygulama için etikete dayalı video çözümlerinde gerekli olur.

Web için gerekli parametreler veya Programatik para kazanma için önerilen parametreler listesine bakın.

 Listedeki belirli bir parametreye gidin

an correlator description_url env gdfp_req idtype

is_lat iu msid output pvid pvid_s

rdid sz unviewed_position_start url wta

 

Parametre	Ayrıntılar
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
description_url (Açıklama URL'si)	Açıklama URL'si parametresi, sayfada oynatılan videoyu açıklaması gereken bir değişken değerini kabul eder. Genellikle video oynatıcıyı içeren sayfadır ancak videoyu açıklayan metne sahip bir sayfa da olabilir. description_url değeri, web sayfası video oynatıcıları ve CTV/OTT cihazları için URL olarak kodlanmış ve mobil uygulama içi video oynatıcılar için kodlanmamış olmalıdır. Bu parametre, IMA SDK tarafından otomatik olarak ayarlanmaz. Bunun manuel olarak ayarlanması gerekir. Kullanım örneği URL olarak kodlanmış: description_url= https%3A%2F%2Fwww.sample.com%2Fgolf.html Kodlanmamış: description_url= https://www.sample.com/golf.html Gereklilik Web, uygulama ve Ad Exchange için gereklidir Programatik para kazanma için önerilir
env (Ortam)	Ortam parametresi, yayın içi isteğini veya isteğin özel olarak bir video oynatıcıdan geldiğini gösteren sabit değeri kabul eder. Olası değerler, video ve işitsel reklamlar için kullanılabilen instream veya yalnızca video reklamlar için kullanılabilen vp değerleridir. Kullanım örneği Video ve/veya işitsel: env=instream Yalnızca video: env=vp Gereklilik Web ve uygulama için gereklidir
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
iu (Reklam birimi)	Reklam birimi parametresi, şu biçimde mevcut reklam birimine ayarlanması gereken değişken değeri kabul eder: /network_id/.../ad_unit Kullanım örneği iu=/6062/videodemo Gereklilik Web ve uygulama için gereklidir
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
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
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
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.
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
wta (Neden bu reklam?)	"Neden bu reklam?" parametresi, video oynatıcının "Neden Bu Reklam?" oluşturma desteğini gösteren sabit değeri kabul eder. "Neden bu reklam?" işlevi, IMA SDK kullanılırken otomatik olarak desteklenir. IMA SDK kullanılmadığında, video oynatıcılar IAB VAST standardında belirtildiği gibi VAST Icon ve IconClickFallbackImage desteğini uygulamalıdır. İşitsel reklam istekleri, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesi tamamlayıcılarda oluşturulacaksa veya kullanıcıya başka bir şekilde sağlanacaksa wta=1 göndermelidir. AEA'da Google talebi ve Google tarafından barındırılan rezervasyon trafiğine uygun olmaları için reklam isteklerinin, VAST yanıtında belirtildiği gibi Reklam Seçenekleri simgesinin video reklamda veya tamamlayıcı reklamlarda oluşturulduğunu ya da tüm reklam öğeleri için kullanıcıya başka şekilde sağlandığını belirtmek üzere wta=1 göndermesi gerekir. Kullanım örneği Destekleniyor: wta=1 Desteklenmiyor: wta=0 Gereklilik Ad Exchange için gereklidir Web ve uygulama AEA trafiği için gereklidir Programatik para kazanma için önerilir