Parametreler
Sayfa Düzeyindeki Parametrelerin Açıklamaları
Bu parametrelerin her sayfa için yalnızca bir kez belirtilmesi gerekir. Bu parametreler sayfadaki tüm birimleri etkiler.
Zorunlu
Parametre | Açıklama ve Örnekler |
---|---|
adPage
|
Kullanıcı bir sonraki sonuçlar sayfasına veya önceki sonuçlar sayfasına gittiğinde gereklidir.
|
pubId
|
Gerekli 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
|
İçerik sayfalarındaki İlgili Arama hariç olmak üzere zorunludur. Bu parametre kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır. Not: Bu parametrenin içerik sayfalarındaki ilgili arama özelliğinde kullanılması 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 dışında kendi parametrelerini içerebilir. Örnek: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
Sayfada ilgili arama birimleri olduğunda gereklidir. Bu parametre, ilgili arama birimleri istendiğinde zorunludur. Sayfa bağlamına bağlı olarak hangi türde bir İlgili Arama deneyiminin gösterileceğini kontrol eder:
Not: relatedSearchTargeting sayfa parametresi varsayılan olarak otomatik olarak "query" olarak ayarlanır. Ancak bu varsayılan değerin yalnızca arama sonuçları sayfaları (Arama'da İlgili Arama) için özel olarak tasarlandığını unutmamak önemlidir. İlgili aramayı başka bir sayfa türünde (ör. makaleler, blog yayınları) kullanıyorsanız parametreyi açıkça "content" olarak ayarlamanız gerekir. Not: Bu parametrenin kullanımında aşağıdaki kurallar geçerlidir:
Ö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"tur. Bu parametre, birim düzeyinde de kullanılabilir.
Örnek: 'linkTarget' : '_blank' |
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 veya bağlantı sizin kontrolünüz altındaysa bu parametre tam olarak söz konusu reklam veya bağlantının reklam öğesi metnine ayarlanmalıdır. Bu parametrenin kullanımında aşağıdaki kurallar geçerlidir:
Not: Bu parametre, Ö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ğinde döndürülmesi için kendi ilgili arama terimlerinizin virgülle ayrılmış listesini sağlamanıza olanak tanır. Google, burada sağlanan terimleri kullanabilir veya yok sayabilir.
Not: Bu parametre kullanılırken Örnekler: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
İsteğe bağlı İçerik için İlgili Arama birimi içeren bir içerik sayfasının URL parametreleri listesini belirtir. Bu parametreler, temel içeriği veya kullanıcı deneyimini etkilemeden güvenli bir şekilde yoksayılabilir. Not: İlgili arama terimlerinin sitenizde gösterilebilmesi için Google'ın terimlerin bağlama uygun olduğundan emin olmak üzere sayfalarınızı taraması gerekir. Bir sayfa henüz taranmamışsa veya AdSense tarayıcısı tarafından taranması engellenmişse (ör. robots.txt ile) Google'a sağladığınız önerilen İlgili Arama terimlerini göstermeyiz. İçerikteki İ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 sayfanın temel içeriğini değerlendirmesini engelleyebilir ve yanlış veya alakasız ilgili arama terimlerine yol açabilir. Bu sayfa parametresi, Google'ın tarayıcısına bu önemsiz parametreleri dikkate almaması talimatını vererek içeriğin doğru şekilde dizine eklenmesini sağlar ve gereksiz tarama yükünü azaltır. Bu sayede Google, bir sayfanın daha önce tarandığını daha iyi anlayabilir ve önerilen terimleri (hem Google'ın hem de uygunsa iş ortağının) göstermeye başlayabilir. Bu parametrenin kullanımında aşağıdaki kurallar geçerlidir:
Örnekler:
http://example.com/content?utm_medium=social&page_id=123&click_id=456 'ignoredPageParams' : 'utm_medium,click_id,session_ref' 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 uygulayacağı 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:
adsafe parametresi varsayılan olarak high değerine 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 bu isteği test olarak algılar, reklam gösterimini saymaz ve tıklama sonuçlarını izlemez. adtest parametresinin değeri on olduğunda gelir elde edemezsiniz. Siteler sekmesinde onaylanmamış bir alandan gelen ve adtest parametresinin on olarak ayarlandığı reklam istekleri, "test reklamı" bilgi notu içeren reklamlar döndürür ve tıklanamaz. Test sırasında 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 kapalıdır. Örnek: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
İsteğe bağlı Farklı sayfaların performansını izlemek amacıyla bir Arama İç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 çok kanal varsa kanallar "+" sembolü ile 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ı destekler. Not: Reklamverenler, reklamlarının hedeflediği dilleri belirtir. Bu parametreyi isteğinize eklerseniz Google yalnızca o dile hedeflenmiş veya tüm dillere hedeflenmiş reklamları döndürür, ancak reklam metninin belirtilen dilde olacağını garanti etmez. Genellikle, hl parametresini bu parametrenin gönderildiği sayfanın ana diline ayarlamanız gerekir. Örnekler: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
İsteğe bağlı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
İsteğe bağlı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
İsteğe bağlı Bu parametre, hem izin verilen hem de izin verilmeyen trafikte yalnızca geçersiz trafik çerezi ve yerel depolama kullanan reklamlara izin vermek istediğinizi Google'a bildiren bir boole değeri sağlamanıza olanak tanır.
IVT, varsayılan olarak true değerine ayarlanır. Örnek: 'ivt': false |
Birim Düzeyindeki Parametrelerin Açıklamaları
Bu parametreler, bir sayfadaki tek reklam birimlerinin kullanıcıya sunulma şeklini etkiler. Her bir reklam birimi için her parametre ayrı ayrı ayarlanabilir.
Zorunlu
Parametre | Açıklama ve Örnekler |
---|---|
container
|
Gerekli 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ı 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. Bu 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:
Not: Herhangi bir hata (özellikle de sayfanızın yüklenmesini engelleyebilecekler hatalar) 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 arama sayısı. Bu değer 3'ten küçükse ilgili aramalar gösterilmez. Örnek: 'relatedSearches' : 4 |