Referans

Parametreler

Sayfa Düzeyinde Parametre Açıklamaları

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

Gerekli

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

adPage parametresi, reklamlarını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 istenirse ve adPage parametresi 2 olarak ayarlanırsa 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 (ÖAR) protokolüdür.

Örnek:

'pubId' : 'test-property'

query İçerik sayfalarındaki İlgili Arama hariç olmak üzere, zorunludur.
Bu, kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır.

Not: Bu parametreyi İçerik sayfalarındaki İlgili Arama'da kullanmak, beklenmedik sonuçlara neden olur.

Ö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 hariç kendi parametrelerini içerebilir.

Örnek:

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

relatedSearchTargeting Sayfada ilgili arama birimleri olduğunda gereklidir.
İlgili arama birimleri istendiğinde bu parametre zorunludur. Sayfa bağlamına bağlı olarak, görüntülenen İlgili Arama deneyiminin türünü kontrol eder:
  • 'content' Bu seçeneği İçerik sayfalarındaki İlgili Arama için kullanın (ör. makaleler, blog yayınları).
  • 'query' Bu seçeneği yalnızca Arama sonuçları sayfalarında İlgili Arama için kullanın.

Not:relatedSearchHedefleme sayfa parametresi varsayılan olarak otomatik şekilde "query" (sorgu) değerine ayarlıdır. Ancak, bu varsayılan değerin yalnızca arama sonuçları sayfaları (Arama'daki İlgili Arama) için özel olarak tasarlandığını unutmamanız önemlidir. İlgili aramayı diğer türlerde (ör. makaleler, blog yayınları) kullanıyorsanız parametreyi açık bir şekilde "content" (içerik) olarak ayarlamanız gerekir.

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

  • Bu sayfa parametresinin değerine bağlı olarak, ilgili belirli arama özellikleri etkinleştirilebilir veya devre dışı bırakılabilir.
  • Arama sonuçlarıyla ilgili olmayan sayfalarda, sayfa türünün yanlış tanıtılması veya ilgili SearchHedefleme parametresi için varsayılan "sorgu" ayarının temel alınması, bu yazılı talimatların ihlali olarak değerlendirilir.
  • Google, manuel olarak veya varsayılan değer kullanılarak ayarlanmasına bakılmaksızın bu değerin doğruluğunu düzenli olarak doğrulayabilir.

Örnekler:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
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 da dahil olmak üzere ilgili bir 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 gelirse ve bu reklam veya bağlantı sizin kontrolünüz altındaysa bu parametre tam olarak söz konusu reklamın veya bağlantının reklam öğesi metnine ayarlanmalıdır.

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

  • Bu parametre yalnızca İçerik İçin İlgili Arama isteğinde sağlanmalıdır ve diğer tüm isteklerde yoksayılır.
  • Yalnızca kasıtlı olarak diğer web sitelerinden aldığınız trafikte kullanılmalıdır ve organik trafikte kullanılmamalıdır.
  • Reklam veya bağlantı reklam öğesinin başlık satırını ve/veya açıklamasını içermelidir.
  • Reklamın veya bağlantı reklam öğesinin parçası olmayan değerlerin eklenmesi, bu yazılı talimatların ihlali olarak değerlendirilir.
  • 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. Parametre kullanıldığında terimlerin seçimini ve sıralamasını etkileyebilir.

Not: terms parametresi kullanılırken bu parametre zorunludur.

Ö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, alakalı bir arama isteğiyle döndürülmesi için kendi ilgili arama terimlerinizin virgülle ayrılmış listesini sağlamanıza olanak tanır. Ancak Google burada belirtilen terimleri kullanabilir veya kullanmayabilir.

Not: Bu parametreyi kullanırken referrerAdCreative ayrıca zorunludur, relatedSearchTargeting parametresi de zorunludur ve "content" olarak ayarlanmalıdır.

Örnekler:

'terms' : 'cars rental, flight ticket'

ignoredPageParams İsteğe bağlı
İçerik İçin İlgili Arama birimine sahip olan ve temel içeriği veya kullanıcı deneyimini etkilemeden güvenli bir şekilde yoksayılabilecek içerik sayfası için URL parametrelerinin listesini belirtir.

Not: İlgili arama terimlerinin sitenizde gösterilebilmesi için, terimlerin bağlamsal açıdan alakalı olduğundan emin olmak üzere Google'ın sayfalarınızı taraması gerekir. Bir sayfa henüz taranmadıysa veya AdSense tarayıcısı tarafından taranması engellendiyse (ör. robots.txt tarafından) Google'a sağladığınız önerilen İlgili Arama terimlerini göstermeyiz.

İçerik Üzerinde İlgili Arama ürünü, sayfaları dizine eklemek ve alakalı arama terimleri oluşturmak için Google'ın içerik tarama sistemini kullanır. İzleme değişkenleri, kullanıcı kimlikleri, oturum kimlikleri veya diğer dinamik tanımlayıcılar gibi sorgu parametrelerini içeren içerik sayfası URL'leri, tarayıcının temel içeriğini değerlendirme becerisini etkileyebilir ve hatalı veya alakasız ilgili arama terimlerine yol açabilir. Bu sayfa parametresi, Google tarayıcısına bu gerekli olmayan parametreleri dikkate almama talimatı vererek içeriğin dizine düzgün şekilde eklenmesini sağlar ve gereksiz tarama yükünü azaltır. Bu sayede Google, bir sayfanın zaten taranmış olduğunu daha iyi anlayabilir ve önerilen terimleri (uygunsa hem Google hem de iş ortağının terimleri) göstermeye başlar.

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

  • Bu parametre yalnızca İçerik İçin İlgili Arama isteğinde sağlanmalıdır ve diğer tüm isteklerde yoksayılır.
  • Bu parametrenin değeri, herhangi bir kullanıcı içerik sayfasına gittiğinde görünebilecek URL parametrelerinin virgülle ayrılmış bir listesi olmalıdır.
  • Form, büyük/küçük harfe duyarlıdır.
  • Bu listedeki herhangi bir URL parametresi içerik sayfasının URL'sinden kaldırıldığında, sayfanın içeriği, görünümü veya kullanıcı deneyimi üzerinde önemli bir etki olmayacaktır.
  • Sayfa içeriğini, görünümünü veya kullanıcı deneyimini önemli ölçüde etkileyen bir URL parametresi eklenmesi, bu yazılı talimatların ihlali olarak değerlendirilir.
  • Google, sağlanan URL parametrelerini yoksaymanın etkisini düzenli olarak doğrulayabilir.

Örnekler:
Kullanıcı bir içerik sayfasını ziyaret eder ve URL şu şekildedir:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Aşağıdaki göz ardı edilebilir URL parametrelerini sağlama:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
İçerik sayfasının URL'si şu şekilde ele alınır:
http://example.com/content?page_id=123

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 değerine ayarlanı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 on değeri olduğunda Google, isteği bir test olarak değerlendirir ve reklam gösterimlerini saymaz veya tıklama sonuçlarını izlemez.

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

Siteler sekmesinde onaylanmamış bir alandan gelen reklam parametresi açık olarak ayarlanmış reklam istekleri, "test reklamı" yer paylaşımına sahip ve tıklanamayan reklamlar döndürür.

Test sırasında bu parametreyi kullanın ancak üretim sistemlerinde kullanmayın. Aksi takdirde görüntülediğiniz reklamlar için ödeme yapılmaz.

Varsayılan adtest değeri kapalıdır.

Ö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 burada bulabilirsiniz.

Birden fazla kanal, "+" 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 dili hedefleyen veya tüm dilleri hedefleyen 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ı İlişkili Desteklenen Diller
latin1 ISO-8859-1 Batı Avrupa (Almanca, Endonezce, Fince, Fransızca, Felemenkçe, Katalanca, İngilizce, İspanyolca, İsveççe, İtalyanca, Norveççe, Portekizce)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Rumence, 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 İzlandaca
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
Shii'ler 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ı İlişkili Desteklenen Diller
latin1 ISO-8859-1 Batı Avrupa (Almanca, Endonezce, Fince, Fransızca, Felemenkçe, Katalanca, İngilizce, İspanyolca, İsveççe, İtalyanca, Norveççe, Portekizce)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Rumence, 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 İzlandaca
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
Shii'ler Shift_JIS Japonca
gb GB2312 Basitleştirilmiş Çince
utf-8 UTF-8 Tümü
ivt İsteğe bağlı
Bu parametre, Google'ı hem izin verilen hem de izin verilmeyen trafikte geçersiz trafiğe özel çerez ve yerel depolama alanı kullanan reklamlara izin vermek istediğinizi bildiren bir boole sağlamanıza olanak tanır.
  • true Bu parametre olmadığında veya "true" olarak ayarlandığında, geçersiz trafiğe özel çerez oluşturur 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 depolama alanını kullanırız.

IVT, varsayılan olarak doğru değerine ayarlanmıştır.

Örnek:

'ivt': false

Birim Düzeyinde Parametre Açıklamaları

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

Gerekli

Parametre Açıklama ve Örnekler
container Zorunlu
Reklamın gösterileceğ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ın sarmalanmaması için yeterince geniş olmalıdır. Sayfadaki başka bir yerleşimde bulunan 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 aramalar sunulmadığında çağrılacak bir JavaScript işlevini belirtir. Parametre, sizin uyguladığınız ve reklam çağrısı tamamlandığında bir işlemin yapılmasına izin veren bir JavaScript geri çağırma işlevine ayarlanmalıdır.

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

containerName Reklamın veya ilgili arama biriminin kapsayıcı adı.
adsLoaded Gösterilecek en az bir reklam veya ilgili arama terimi olduğunda "doğru", hiçbir reklam veya ilgili arama döndürülmediğinde ise "yanlış" olarak ayarlanır.
isExperimentVariant Özel stil denemesi çalışıyorsa ve reklamların oluşturulması için denemenin varyantı seçilmişse doğru olarak ayarlanır.
callbackOptions Şu alanları içeren bir JSON nesnesi:
termPositions: İlgili arama bloğu için yayıncı tarafından sağlanan terimlerin, yanıttaki bu terimlerin sıfır dizine eklenmiş konumuna eşlem eşlemesini<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 engelleyebilecek olanlar) 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