Video için AdSense ve Oyunlar için AdSense ürünleri, İçerik için AdSense'e göre çok farklı bir etiketleme yapısı kullanır. Bu ürünler, Etkileşimli Medya Reklamları (IMA) etiketi gerektirir ve yalnızca Google IMA SDK entegrasyonu özelliğine ve/veya VAST ve VPAID uyumluluğuna sahip bir video oynatıcı veya oyun başlatıcı (Ör. IMA Bağdaştırıcısı) ile çağrıldığı zaman reklam gösterir.
Bu etiketleri normalde Video için AdSense etiket oluşturma aracı ile oluşturabilirsiniz. Bu reklam etiketleri için belirleyebileceğiniz farklı kriterlerin kapsamlı bir listesi aşağıdadır. Video için AdSense etiketinin reklam yayınlayabilmesi için gereken yalnızca birkaç parametre vardır, ancak kanal kimlikleri, min/maks. reklam süresi, dil ve isteğe bağlı benzer parametreler ekleyerek arzuladığınız reklam yanıtlarını elde edebilirsiniz.
IMA reklam etiketi parametresi | Gerekli parametre |
---|---|
ad_type | Evet |
client | Evet |
description_url | Evet - URL kodlamalı olmalıdır |
channel | Hayır - Varsa önerilir |
adsafe | Hayır - Önerilir |
videoad_start_delay | Hayır - Önerilir |
hl | Hayır - Önerilir |
max_ad_duration | Hayır - Önerilir |
min_ad_duration | Hayır - Önerilir |
sdmax | Hayır - Önerilir |
adtest | Hayır |
cust_age | Hayır |
cust_gender | Hayır |
host | Hayır |
h_ch | Hayır |
overlay | Hayır |
Temel URL
Aşağıdaki URL, aşağıda tanımlanan tüm sorgu parametreleri için temel teşkil eder:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Dize) Tercih edilen reklam türünü belirtir. Bu parametreler, alt çizgi ("_") kullanılarak birleştirilmelidir.
Değerler
- video: Tüm video reklamlar: standardvideo_skippablevideo_bumpervideo ile eşdeğerdir.
- skippablevideo: Yalnızca atlanabilir video reklamlar. Atlanabilir reklamları almak için ek yayıncı izinlerine sahip olmak gerekebilir.
- bumpervideo: Altı saniyelik atlanamayan video reklamlara izin verir.
- standardvideo: Yalnızca atlanamayan video reklamlar.
- image: Belirlenen doğrusal olmayan reklam alanı boyutuna uyan resim reklamlara izin verir.
- text: Metin reklamlara izin verir.
Örnekler
- &ad_type=video_text_image
- Tüm biçimlere izin verir.
- &ad_type=video_text
- Tüm video ve metin reklamlara izin verir.
- &ad_type=standardvideo_image
- Yalnızca standart, atlanamayan video ve resim reklamlara izin verir.
client
(Dize) Yayıncının Web Mülkü Kimliği.
Örnek: &client=ca-video-afvtest
description_url
(Dize) Videoyu açıklayan bir HTML sayfasının URL kodlamalı tam URL'si. Sunucu tarafı programlama dilinizi kullanıp dinamik olarak veya çevrimiçi URL kodlama aracını kullanıp el ile description_url değeri oluşturabilirsiniz.
Örnek: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
URL Örneği
Aşağıda, gerekli minimum parametreleri içeren bir URL örneği verilmiştir. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
ca-video-afvtest yayıncısı için, http://benimurl.com/page?key=value&key2=value2 açıklama URL'sine sahip video reklamları ister
channel
(Dize) AdSense hedeflemesi ve raporlaması için kullanılan, artı işaretleriyle ayrılmış kanallar listesi. Reklam isteği başına en fazla beş kanal eklenebilir.
Örnek: &channel=mychannel+otherchannel+targetingchannel
adsafe
(Dize) Gösterilen reklamları filtrelemek için kullanılan ayarı belirler. Varsayılan değer “high” olarak belirlenmiştir.
Değerler:
- high - (Varsayılan) Aile için güvenli reklamları döndürür. Aile için güvenli olmayan veya yetişkinlere uygun, cinsel içerikli reklamları döndürmez.
- medium - Aile için güvenli ve aile için güvenli olmayan reklamları (ör. kumar veya reçeteli ilaç reklamları) döndürür. Yetişkinlere yönelik cinsel içerikli reklamları döndürmez.
Örnek: &adsafe=high
adtest
(Dize) Bunun bir test uygulaması olup olmadığını belirtir. Olası değerleri "on" veya "off"tur. "on" olarak ayarlanırsa, gösterimler ve tıklamalar AFV hesabına kaydedilmez. Bu parametre test sırasında KULLANILMALIDIR. Ayarlanmamışsa, varsayılan değeri "off"tur.
Değerler:
- off - (Varsayılan) Tüm reklamlar normal bir şekilde kayıt yapar. Üretim için bu ayar kullanılmalıdır.
- on - Bu ayar, test sırasında herhangi bir reklamın gösterim veya tıklama kaydetmemesini sağlar.
Örnek: &adtest=on
videoad_start_delay
(Tamsayı) Reklamın, videonun kaçıncı milisaniyesinden sonra oynatılacağını belirtir. Videonun ortasında yayınlanması için varsayılan değer özellikle “1”dir.
Değerler:
- -1 - İçeriğin sonunda görüntülenen, videodan sonra gösterilen reklamı belirtir
- 0 - İçerik oynatılmaya başlamadan önce görüntülenen ve videodan önce gösterilen reklamı belirtir
- Herhangi bir pozitif tamsayı - İçerik belirtilen milisaniye süresince oynatıldıktan sonra, videonun ortasında gösterilen reklamı belirtir.
Örnek:
- &videoad_start_delay=-1 --Videodan sonra gösterilen reklam.
- &videoad_start_delay=15000 --Reklam, içerik yayını başladıktan 15 saniye sonra oynatılır.
cust_age
(Tamsayı) Kullanıcının yaşını belirtir. Tam yaşın yanı sıra com.google.ads.ima.api.Demographics'tetanımlanan bir yaş grubu da desteklenir.
Örnek:
- &cust_age=1001 --18 ila 24 yaş
- &cust_age=38 --Tam 38 yaşında
cust_gender
(Tamsayı) com.google.ads.ima.api.Demographics'te tanımlandığı gibi kullanıcının cinsiyetini belirtir.
Değerler:
- 1 - Erkek
- 2 - Kadın
Örnek:
- &cust_gender=1 --Erkek
- &cust_gender=2 --Kadın
host
(Dize) 3 yollu gelir paylaşımı için kullanılacak barındırıcı kimliği.
Örnek: &host=ca-host-test --Geliri bu barındırıcıyla paylaştırır.
h_ch
(Dize) Barındırıcı için AdSense hedefleme/raporlama kanalı kimliklerinin, artı işaretleriyle ayrılmış bir listesi.
Örnek: &h_ch=channel1+channel2+channel3 --Barındırıcı için bu ek kanalları raporlar ve hedefler.
ht_id
(Sayı) Yayıncı ve barındırıcı arasındaki gelir paylaşım düzeyini belirtmek için kullanılan sıra kimliği.
Örnek: &ht_id=2 --2. Tabaka barındırıcı
hl
(Dize) Reklamları söz konusu dilde istemek için kullanılan dil kodu. Bu kod, herhangi bir ISO 639-1 (iki harfli) veya ISO 639-2 (üç harfli) kodu olabilir. Geçerli kodların listesi.
Örnek:
- &hl=en --İngilizce.
- &hl=es --İspanyolca
max_ad_duration
(Tamsayı) Milisaniye cinsinden döndürülmesi gereken maksimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri 100 saniyedir.
Örnek: &max_ad_duration=30000 --Atlanamayan tüm reklamların maksimum süresi 30 saniye olacaktır.
min_ad_duration
(Tamsayı) Milisaniye cinsinden döndürülmesi gereken minimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri 0 saniyedir.
Örnek:
- &min_ad_duration=15000 --Döndürülen bir atlanamayan reklamın süresi en az 15 saniye olmalıdır.
- &min_ad_duration=0 --Süre yalnızca max_ad_duration değeriyle sınırlı olacaktır.
sdmax
(Tamsayı) Atlanabilir reklamlar için milisaniye cinsinden maksimum video uzunluğunu belirtir. Ayarlanmamışsa varsayılan değeri sınırsızdır.
Örnek: &sdmax=120000 --Döndürülen bir atlanabilir reklamın süresi 2 dakikayı geçemez.
overlay
(Tamsayı) İstenen yer paylaşımlı reklam boyutunu yalnızca alttan üçte birlik kısmı kaplayan doğrusal olmayan yer paylaşımlı reklamlarla sınırlandırmak için kullanılır. Varsayılan olarak herhangi bir sınır ayarlanmaz.
Örnek:
- &overlay=1 --Yalnızca alttan üçte birlik kısmı kaplayan yer paylaşımlı reklam boyutları reklam isteği için uygun olur. Alanın tamamını kullanan yer paylaşımlı reklamlar istenmeyecektir.
- &overlay=0 --Varsayılan değerdir ve yer paylaşımlı reklam boyutları için herhangi bir sınır belirlemez. Yayınlanacak yer paylaşımlı reklamların boyutlarında, AdsRequest.nonLinearAdSlotWidth ve adsRequest.nonLinearAdSlotHeight temel alınacaktır.