Programatik için gerekli ve önerilen 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 Programatik için etikete dayalı video çözümlerine yöneliktir.

Web için gerekli ve önerilen parametreler veya uygulama için gerekli parametreler listesine bakın.

 Listedeki belirli bir parametreye gidin

an description_url hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Parametre	Ayrıntılar
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
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
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
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
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
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
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
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
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
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 "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