Referans

Parametreler

Sayfa Düzeyi Parametre Açıklamaları

Bu parametrelerin sayfa başına yalnızca bir kez belirtilmesi gerekir. Bunlar sayfadaki tüm birimleri etkiler.

Gerekli

Parametre Açıklama ve Örnekler
adPage Kullanıcı bir sonraki sonuçlar sayfasına veya önceki sonuçlar sayfasına gittiğinde gereklidir.

adPage parametresi, reklamların gösterildiği sonuç sayfasını belirtir. Bu parametre, kullanıcılar arama sonuçlarının ilk sayfasını geçtiğinde kullanılır. Örneğin, beş reklam istendiyse ve adPage parametresi 2 olarak ayarlandıysa döndürülen reklamlar, beş reklamın ikinci sayfası olur.

pubId Zorunlu
Bu, AdSense müşteri kimliğinizdir. pubId'niz müşteri kimliğinizde "partner-" ifadesinden sonra gelen kısımdır. Örneğin, müşteri kimliğiniz "partner-test-property" ise pubId'niz "test-property" olacaktır. Bu standart ÖAR (Özel Arama Reklamları) protokolüdür.

Örnek:

'pubId' : 'test-property'

query Zorunlu
Bu, kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır.

Örnekler:

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query

resultsPageBaseUrl Sayfada ilgili arama birimleri olduğunda gereklidir.
Arama sorgusunun, kullanıcının tıkladığı ilgili arama terimi olduğu arama sonuçları sayfasının URL'sini belirtir. resultsPageBaseUrl, otomatik olarak eklenecek arama sorgusu dışında kendi parametrelerini içerebilir.

Örnek:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

styleId Gerekli
Reklama veya sayfadaki ilgili arama birimlerine uygulanacak özel arama stilinin kimliğini belirtir. Özel arama stillerini kullanma hakkında daha fazla bilgi edinin. Bir istek için styleId ayarlandığında, reklamların veya ilgili aramaların stille birlikte oluşturulacağını ve eski stil parametrelerinin yok sayılacağını unutmayın. İstekte styleId belirtilmezse sistem varsayılan stili oluşturulur.

Örnek:

'styleId': '1234567890'

İsteğe bağlı

Parametre Açıklama ve Örnekler
linkTarget İsteğe bağlı
Bir reklam tıklandığında aynı pencerede mi yoksa yeni pencerede mi açılacağını belirtir. Varsayılan değer "_top" değeridir. Bu parametre, birim düzeyinde de kullanılabilir.
  • '_top' Aynı pencerede açılır.
  • '_blank' Yeni pencerede açılır.

Örnek:

'linkTarget' : '_blank'

maxTermLength İsteğe bağlı
Boşluklar dahil olmak üzere ilgili arama teriminin maksimum karakter sayısını belirtir. Ayarlanmamışsa maksimum değer yoktur.

Örnek:

'maxTermLength' : 50

referrerAdCreative İsteğe bağlı
Bir kullanıcı, başka bir web sitesindeki bir reklamı veya bağlantıyı tıklayarak İçerik İçin İlgili Arama birimi içeren içerik sayfanıza ulaşırsa ve bu reklam ya da bağlantı sizin kontrolünüz altındaysa bu parametre tam olarak söz konusu reklamın veya bağlantının reklam metni olarak ayarlanmalıdır.

Bu parametrenin kullanımında aşağıdaki yönergeler geçerlidir:

  • Parametre, yalnızca İçerik İçin İlgili Arama isteğinde sağlanmalıdır ve diğer tüm isteklerde yok sayılır.
  • Yalnızca kasıtlı olarak diğer web sitelerinden edindiğiniz trafikte kullanılmalıdır ve hiçbir zaman organik trafikte kullanılamaz.
  • Reklam veya bağlantı reklam öğesinin başlık satırını ve/veya açıklamasını içerebilir.
  • Büyük/küçük harfe duyarlı değildir.
  • Geçerli UTF-8 kodlamasını kabul eder; unicode karakterleri / aksan işaretleri desteklenir.
  • Google, gönderdiğiniz parametreyi kullanabilir veya yok sayabilir. Bu parametre kullanıldığında terimlerin seçimini ve sıralamasını etkileyebilir.

Örnekler:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

resultsPageQueryParam İsteğe bağlı
Arama sonuçları sayfasındaki arama sorgusu için URL parametresinin adını belirtir. Belirtilmezse varsayılan olarak "q" kullanılır.

Örnek:

'resultsPageQueryParam' : 'query'

terms İsteğe bağlı
Bu parametre, ilgili arama isteğiyle birlikte döndürülmesi için kendi ilgili arama terimlerinizin virgülle ayrılmış bir listesini sağlamanıza olanak tanır. Google, burada sağlanan terimleri kullanabilir veya kullanmayabilir.

Örnekler:

'terms' : 'cars rental, flight ticket'

Yapılandırma Ayarları

Parametre Açıklama ve Örnekler
adsafe İsteğe bağlı
Google'ın arama sorgusuyla eşleşen reklamlara uygulaması gereken filtreleme kurallarını belirtir. Aşağıda, adsafe için geçerli ayarlar ve her bir değerin döndürülen reklamlara etkisi açıklanmıştır:
  • 'high' 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ı döndürür. Yetişkinlere uygun, cinsel içerikli reklamları döndürmez.
  • 'low' Tüm reklam türlerini döndürür.

Adsafe varsayılan olarak yüksek olarak ayarlanmıştır.

Örnek:

'adsafe': 'medium'

adtest İsteğe bağlı
adtest parametresi, reklam isteğinin bir test olduğunu belirtmek için kullanılır. adtest parametresinin değeri on olduğunda Google, isteği test olarak değerlendirir, reklam gösterimlerini saymaz veya tıklama sonuçlarını izlemez.

adtest parametresinin değeri on olduğunda gelir elde edemezsiniz.

Test yaparken bu parametreyi kullanın ancak üretim sistemlerinde kullanmayın. Aksi takdirde, gösterdiğiniz reklamlar için ödeme yapılmaz.

Varsayılan adtest değeri devre dışı.

Örnek:

'adtest' : 'on'

channel İsteğe bağlı
Farklı sayfaların performansını izlemek amacıyla bir Arama için AdSense kanalı ekleyebilirsiniz. AdSense hesabınızda veya Teknik Hesap Yöneticiniz tarafından oluşturulan benzersiz kanal kimliğini kullanın. Kanallar hakkında daha fazla bilgiyi buradan edinebilirsiniz.

Birden fazla kanal varsa kanallar "+" simgesiyle ayrılmalıdır.

Örnekler:

'channel' :  'testA'  
'channel' :  'testA+testB'  

hl İsteğe bağlı
Bu parametre, istenen reklamların veya ilgili aramaların hedeflemesi gereken dili tanımlar. Varsayılan değer en'dir.

Google tüm AdWords API dil kodlarını desteklemektedir.

Not: Reklamverenler, reklamlarının hedeflediği dilleri belirtir. Bu parametreyi isteğinize eklerseniz Google yalnızca o dil için veya tüm diller için hedeflenen reklamları döndürür, ancak reklam metninin belirtilen dilde olacağını garanti etmez.

Genellikle, hl parametresini, bu parametrenin gönderildiği sayfanın birincil diline ayarlamanız gerekir.

Örnekler:

'hl' : 'es'

ie İsteğe bağlı

ie parametresi, sorgu dizesini yorumlamak için kullanılması gereken karakter kodlama şemasını ayarlar.

Varsayılan ie değeri utf-8'dir.

Değer Standart ad Desteklenen İlişkili Diller
latin1 ISO-8859-1 Batı Avrupa (Katalanca, Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, Endonezce, İtalyanca, Norveççe, Portekizce, İspanyolca, İsveççe)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Romence, Sırpça, Slovakça, Slovence)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltık (Estonca, Letonca, Litvanca)
kiril ISO-8859-5 Bulgarca, Rusça
arabic ISO-8859-6  
yunan ISO-8859-7 Yunanca
hebrew ISO-8859-8 İbranice
latin5 ISO-8859-9  
latin6 ISO-8859-10 İzlanda dili
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
sjis Shift_JIS Japonca
big5 Big5 Geleneksel Çince
gb GB2312 Basitleştirilmiş Çince
utf-8 UTF-8 Tümü
oe İsteğe bağlı

oe parametresi, Google'ın reklam metnini kodlamak için kullanması gereken karakter kodlama şemasını ayarlar. Teknik olarak isteğe bağlı olsa da bu parametre için bir değer iletmek iyi bir uygulamadır.

Varsayılan oe değeri utf-8'dir.

Değer Standart ad Desteklenen İlişkili Diller
latin1 ISO-8859-1 Batı Avrupa (Katalanca, Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, Endonezce, İtalyanca, Norveççe, Portekizce, İspanyolca, İsveççe)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Romence, Sırpça, Slovakça, Slovence)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltık (Estonca, Letonca, Litvanca)
kiril ISO-8859-5 Bulgarca, Rusça
arabic ISO-8859-6  
yunan ISO-8859-7 Yunanca
hebrew ISO-8859-8 İbranice
latin5 ISO-8859-9  
latin6 ISO-8859-10 İzlanda dili
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
sjis Shift_JIS Japonca
gb GB2312 Basitleştirilmiş Çince
utf-8 UTF-8 Tümü
ivt İsteğe bağlı
Bu parametre, hem izin verilen hem de izin verilmeyen trafikte yalnızca geçersiz trafiğe özel çerez ve yerel depolama kullanan reklamlara izin vermek istediğinizi Google'a bildiren bir boole sağlamanıza olanak tanır.
  • true Bu parametre mevcut olmadığında veya "true" olarak ayarlandığında geçersiz trafiğe özel bir çerez ayarlar ve yerel depolama alanını yalnızca izin verilen trafikte kullanırız.
  • false Bu parametreyi "false" olarak ayarladığınızda, geçersiz trafiğe özel bir çerez ayarlar ve hem izin verilen hem de izin verilmeyen trafikte yerel depolamayı kullanırız.

Varsayılan olarak IVT doğru değerine ayarlanır.

Örnek:

'ivt': false

Birim Düzeyi Parametre Açıklamaları

Bu parametreler, bir sayfadaki tek reklam birimlerinin kullanıcıya sunulma şeklini etkiler. Her reklam birimi için her parametre ayrı ayrı ayarlanabilir.

Gerekli

Parametre Açıklama ve Örnekler
container Zorunlu
Reklamın görüneceği boş reklam kapsayıcısının (<div>) kimliği.

Örnek:

'container' : 'afscontainer1'

maxTop Reklam birimi arama sonuçlarının üzerinde olduğunda gereklidir.

Üst reklam biriminde gösterilecek reklam sayısını belirtmek için bu parametreyi kullanın.

Not: Bu parametre, 'number' parametresinin yerine kullanılır. Bu reklam birimi, reklamların ilk satırını kaydırmayacak kadar geniş olmalıdır. Sayfadaki başka bir yerleşimde maxTop parametresini kullanmak politika ihlalidir.

Örnek:

'maxTop' : 4
width Gerekli
Reklamın veya ilgili arama biriminin genişliğini piksel cinsinden belirtir.

Örnek:

'width' : '700px'
'width' : 700

Yapılandırma Ayarları

Parametre Açıklama ve Örnekler
adLoadedCallback İsteğe bağlı
Reklamlar veya ilgili aramalar yüklendiğinde ya da hiçbir reklam veya ilgili arama sunulmadığında çağrılacak bir JavaScript işlevi belirtir. Parametre, reklam çağrısı tamamlandığında bir işlemin gerçekleştirilmesini sağlayan ve sizin tarafınızdan uygulanan bir JavaScript geri çağırma işlevine ayarlanmalıdır.

Geri çağırma işlevi aşağıdaki parametreleri alır:

containerName Reklam veya ilgili arama biriminin kapsayıcı adı.
adsLoaded Gösterilecek en az bir reklam veya ilgili arama terimi olduğunda true (doğru), hiçbir reklam veya ilgili arama döndürülmediğinde ise false (yanlış) olarak ayarlayın.
isExperimentVariant Bir özel stil denemesi çalışıyorsa ve reklamların oluşturulması için denemenin varyantı seçilmişse true (doğru) değerine ayarlanır.
callbackOptions Aşağıdaki alanları içeren bir JSON nesnesi:
termPositions: İlgili arama blokunda, yayıncı tarafından sağlanan terimlerin yanıttaki sıfır dizinli konumuna ait bir eşleme<string,int> içerir. Sağlanmış ancak döndürülmeyen terimler haritada görünmez.

Not: Herhangi bir hata (özellikle de sayfanızın yüklenmesini engelleyebilecekler) oluşturmadığından emin olmak için lütfen geri çağırma işlevinizi test edin.

JavaScript geri çağırma örneği:

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
      

number İsteğe bağlı
Bu birimde gösterilmesi gereken reklam sayısı. Varsayılan değer 2'dir.

Örnek:

'number' : 4

relatedSearches İsteğe bağlı
Bu birimde gösterilmesi gereken ilgili aramaların sayısı. Belirtilmezse varsayılan olarak 0 değerine ayarlanır.

Örnek:

'relatedSearches' : 4