Manuel olarak ana video etiketi oluşturma veya düzenleme
Ana video etiketi, bir video oynatıcının video reklamları almak için kullandığı URL'dir. Doğru URL parametrelerini kullanan bir ana video etiketi hazırlamak için aşağıdaki tablolara bakın. Etiketi hazırladıktan sonra Video Suite Inspector ile test edebilirsiniz.
Örnek ana video reklam etiketlerini incelemeParametreler ve atanmış değerler içeren örnek bir video etiketi şunun gibi görünür:
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
Buradaki örnek etiketleri kullanarak da etiketleri inceleyip test edebilirsiniz.
Listedeki belirli bir parametreye gitme
Gerekli parametreler correlator description_url env gdfp_req iu output sz unviewed_position_start url |
İsteğe bağlı parametreler ad_rule ciu_szs cmsid | vid cust_params hl msid | an nofb pp ppid rdid | idtype | is_lat tfcd npa vconp vpa vpmute |
Özel SDK parametreleriafvsz excl_cat lip max_ad_duration | min_ad_duration mridx pmad pmnd | pmxd pod ppos scor vad_type vpos |
bulunmalıdır
.Video Çözümleri, hem https hem de http’yi destekler. Gösterimler ve VAST izleme URL'leri, SSL ayarına uyar ve https ya da http'den uygun olanını döndürür. Tıklama URL'si ve tıklama izleme başka bir sayfadan yönlendirdiği için http'dir.
Gerekli parametreler
Aşağıdaki parametreler, tüm ana video etiketleri için gereklidir. Bu parametrelerden her birinin sabit bir değeri vardır. Örneğin env
parametresi her zaman vp
parametresine eşittir ve isteğin bir video oynatıcıdan geldiğini gösterir.
Parametre | Açıklama | Değer |
---|---|---|
env |
İsteğin bir video oynatıcıdan geldiğini gösterir. | vp |
gdfp_req |
Kullanıcının Ad Manager şemasında olduğunu belirtir. | 1 |
unviewed_position_start |
Bu değer 1 olarak ayarlandığında, videonun geciken gösterimleri açılır. | 1 |
Değişken değerlere sahip gerekli parametreler
Aşağıdaki parametreler, tüm ana video etiketleri için gereklidir. Bu parametrelerin değerleri değişken olduğundan lütfen yol göstermesi için açıklamaya ve örnek değerlere bakın.
Parametre | Açıklama | Örnek değer |
---|---|---|
output |
Reklamın çıkış biçimi. Ağınızda etkinleştirdiğiniz VAST sürümünde (ör. VAST 4) Ağınızda etkinleştirdiğiniz varsayılan VMAP sürümünü (ör. VMAP 1) döndürmek için Not: Video oynatıcınız IMA SDK'yı kullanıyorsa video reklam isteğinin çıkış parametresi her zaman |
|
iu |
Mevcut reklam birimi. Şu biçime sahiptir:
/network_id/.../ad_unit |
/6062/videodemo |
sz |
Ana video reklam alanının boyutu. Çok sayıda boyut olduğunda dikey çizgi ( Boyuttan sonra " |
400x300 |
Değer, sayfada oynatılan videoyu açıklamalıdır. Genellikle video oynatıcıyı barındıran sayfadır ancak videoyu açıklayan metne sahip bir sayfa da olabilir. |
URL olarak kodlanmış örnek: Kodlanmamış örnek: |
|
url |
Bu, reklam isteğinin gönderilme kaynağı olan tam URL'dir. Bir web sayfasında bu, video oynatıcıyı gösteren sayfanın URL'sidir. Bir uygulama içinde ise paket adıdır. IMA SDK kullanıyorsanız URL değerini otomatik olarak ayarlar. Oynatıcınız bu değeri ayarlıyorsa IMA SDK değerinin üzerine yazar ve kendi değerini ayarlar. |
https://www.videoad.com/golf.html |
correlator |
Aynı sayfa görüntülemesinden gelen birden fazla istek tarafından paylaşılan, rastgele pozitif sayısal değer. İlişkilendirici, ç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 IMA SDK, kendi rastgele 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 değere ayarladığınızdan emin olun. |
4345645667 |
İsteğe bağlı parametreler
Aşağıdaki parametreler isteğe bağlıdır. Bu parametrelerin değerleri değişken olduğundan lütfen yol göstermesi için açıklamaya ve örnek değerlere bakın.
Parametre | Açıklama | Örnek değer |
---|---|---|
ad_rule |
Bir VAST reklam öğesi veya reklam kuralları yanıtı döndürülüp döndürülmeyeceğini belirtir. Reklam kuralları kullanıyorsanız |
Bir reklam öğesi isteğini (VAST) belirtmek için ad_rule=0 Bir reklam kuralları isteğini (VMAP) belirtmek için ad_rule=1 |
ciu_szs |
Tamamlayıcı boyutların virgülle ayrılmış listesi. Dikey çizgiyle ayrılmış ( |
Tamamlayıcı boyutları: Çok boyutlu alan içeren tamamlayıcı boyutları:
|
|
Reklamların video içeriğini hedefleyebilmesi için ana video etiketinizin hem
|
Talebe bağlı video hizmetiyle Dinamik Reklam Ekleme için etiket oluşturuyorsanız doğru |
cust_params |
Anahtar/değer parametreleri | Bir reklam etiketine anahtar/değer çiftleri eklemeyi öğrenin. |
hl |
Reklamları söz konusu dilde istemek için kullanılan dil kodu. Bu parametre, Ad Exchange veya AdSense Video içindeki videoya dinamik ayırmada, reklam seçimi ve video reklam oluşturma dili için kullanılır. Dil, ISO 639-1 (iki harfli) veya ISO 639-2 (üç harfli) kodlarından herhangi biri olabilir. Geçerli kodların listesini inceleyin. Atlanırsa varsayılan olarak Ad Exchange'de dile göre reklam hedefleme içeren herhangi bir dil olur. |
it |
msid |
Bu iki parametre, mobil uygulamadan ve bağlı TV cihazlarından gönderilen tüm isteklere uygulanmalıdır. Çoğu programatik video reklam için mobil uygulama veya bağlı TV envanterinden yapılan isteklerde bu iki değerin de bulunması gerekir. |
msid=com.package.publisher, an=sample%20app |
nofb |
Reklam isteğinizin "yedek video" reklamları içeren bir oynatma listesi döndürüp döndürmemesi gerektiğini belirtir. |
&nofb=1 |
pp |
Video reklam öğesi profilinde ayarlanan yapılandırmaya göre hangi reklam öğelerinin yayınlanmak için uygun olduğunu kontrol eder. |
pp=video_creative_profile |
ppid |
Yayıncı Tarafından Sağlanan Tanımlayıcı (PPID), yayıncıların sıklık sınırı, kitle segmentasyonu ve hedefleme, sıralı reklam rotasyonu ve diğer kitleye dayalı reklam yayını kontrolleri için cihazlarda kullanılacak bir tanımlayıcı göndermesini sağlar. Daha fazla bilgi | 12JD92JD8078S8J29SDOAKC0EF230337 |
rdid |
Yerel uygulamalarda (web veya mobil web'de değil) SDK, Neredeyse tüm programatik video reklamlar için bu değerlerin bulunması gerekir. |
Sıfırlanabilir cihaz tanımlayıcıları ile ilgili ayrıntılı örnekleri inceleyin. |
tfcd |
Reklam isteğini, çocuklara yönelik olarak değerlendirilmesi için etiketler. tfcd hakkında daha fazla bilgi |
https://.../gampad/ad?tfcd=1&iu=/12345/adunit |
npa |
Reklam isteğini, kişiselleştirilmemiş İsteği kişiselleştirilmemiş olarak etiketlemek için özel olarak |
https://.../gampad/ad?npa=1&iu=/12345/adunit |
vconp |
MRC Video Ölçüm Kuralları uyarınca önerilir
Oynatıcının, TV yayınına benzer şekilde içerik videolarını sürekli olarak arka arkaya oynatmayı amaçlayıp amaçlamadığını belirtir. Olası değerler, sürekli oynatma AÇIK ise Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. |
Sürekli oynatma AÇIK:vconp=2
Sürekli oynatma KAPALI: |
vpa |
MRC Video Ölçüm Kuralları uyarınca önerilir
Reklamın otomatik oynatma veya tıklama ile başlatılıp başlatılmayacağını belirtir. Olası değerler, sayfada kullanıcının işlem yapması bekleniyorsa Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. |
Otomatik oynatma:vpa=auto
Tıklama: |
vpmute |
MRC Video Ölçüm Kuralları uyarınca önerilir
Video oynatıcının sesi kapatıldığında reklam oynatmanın başlatılıp başlatılmayacağını belirtir. Olası değerler, sesi kapatılmış için Bu parametre bilinmiyorsa ayarlanmadan bırakılmalıdır. |
Sesi kapatılmış:vpmute=1
Sesi açılmış: |
Özel SDK parametreleri
Mevcut Ad Manager mimarisi, video reklam isteklerinin akışta ve sayfada daha önce gösterilen reklamlarla ilgili bilgiler içermesini gerektirmektedir. Bu bilgiler, geçmişteki etkinliğin genel durumunun anlaşılmasının yanı sıra reklam hariç tutma ve yinelemeler için gerekli hesaplamaların yapılabilmesini sağlar.
Boyutlar, reklam kuralları ve video konumları ile ilgili SDK parametreleri
Parametre | Açıklama | Örnek değer | Gerekli |
---|---|---|---|
afvsz |
Video reklam alanında görüntülenebilen doğrusal olmayan reklam boyutlarının virgülle ayrılmış listesi. Bu boyutlar, desteklenen şu boyutlar arasından herhangi biri olmalıdır:
Not: IMA SDK'sı kullanılırken bu alanın üzerine yazılır ve alan, nonLinearAdSlotWidth ve nonLinearAdSlotHeight kapsamında olan ve desteklenen tüm boyutlarla doldurulur. |
Tüm boyutlar desteklenir: 250 gibi maks. genişlik: 80 gibi maks. yükseklik: 100 gibi maks. genişlik: |
Hayır, doğrusal olmayan boyutlar desteklenmediğinde parametre dışarıda bırakılabilir veya boş olabilir. |
pod |
Video içindeki bir kapsülü ifade eder. İlk kapsül için &pod=1 ; ikinci kapsül için &pod=2 vb. iletin. Rakip hariç tutma, sıklık sınırı ve ilgili özellikler için kullanılır. |
3 |
Hayır, ancak rakip hariç tutma, sıklık sınırı ve ilgili özellikler gibi özelliklerin doğru çalışması için iletilmelidir. |
ppos |
Kapsül içindeki konumu ifade eder. Tamamlayıcı otomatik doldurma için gereklidir. İlk konum için Bu parametre, yalnızca standart kapsüller içindir. |
2 |
Hayır, ancak rakip hariç tutma, sıklık sınırı ve ilgili özellikler gibi özelliklerin doğru çalışması için iletilmelidir. |
vpos |
Reklam isteğinin videodan önce gösterilen reklamdan mı, videonun ortasında gösterilen reklamdan mı, yoksa videodan sonra gösterilen reklamdan mı gönderildiğini belirtir. | preroll midroll postroll |
Hayır |
mridx |
İsteğin videonun ortasında gösterilen reklamlardan hangisinden yapıldığını belirten sayı tabanlı dizin (1., 2., 3. vb.). | 2 |
Hayır |
lip |
Bir kapsüldeki son konumdan yapılan istek için eklenmesi gerekir. Bu parametre, yalnızca standart kapsüller içindir. |
true |
Evet (standart kapsüller için) |
min_ad_duration max_ad_duration |
Bu iki parametre birlikte dikkate alındığında, milisaniye olarak bir reklamın eşleşmesi gereken süre aralığını belirler. Tek bir reklam istemek için kullanılır. |
15000 30000 |
Hayır |
pmnd pmxd |
Bu iki parametre birlikte dikkate alındığında, milisaniye olarak bir kapsülün eşleşmesi gereken süre aralığını belirler. Birden fazla reklam (yani kapsül) istemek için kullanılır. * |
0 60000 |
Evet (optimize edilmiş kapsüller için) |
pmad |
Bir kapsüldeki maksimum reklam sayısı * | 4 | Hayır |
* Bu parametreler, gelişmiş video paketine sahip yayıncılar tarafından kullanılabilen optimize edilmiş kapsüllere özeldir. Ayrıca VMAP için kullanılmamalıdırlar (ad_rule=1
olduğunda).
Diğer SDK parametreleri
Parametre | Açıklama | Örnek değer | Gerekli |
---|---|---|---|
scor |
Her video akışı için oluşturulan bir tam sayıdır. Bu 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. | 17 |
Hayır, ancak rakip hariç tutma, sıklık sınırı ve ilgili özellikler gibi özelliklerin doğru çalışması için iletilmelidir. |
vad_type |
İsteğe karşılık olarak doğrusal bir reklam mı, yoksa doğrusal olmayan bir reklam mı döndürüleceğini belirtir. | linear nonlinear |
Hayır |
excl_cat |
Reklam hariç tutma kategorisi. Söz konusu hariç tutma etiketini içeren satır öğelerinin belirli bir reklam isteği için uygun olmasını engeller; cust_params ile çalışır. |
&custom_params=excl_cat |
Hayır |