Parametreler
Sayfa düzeyindeki parametre açıklamaları
Bu parametrelerin her sayfa için sadece 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ında İlgili Arama dışında zorunludur. Bu parametre kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır. Not: İçerik sayfalarındaki İlgili Arama'da bu parametrenin kullanılması beklenmedik sonuçlara yol açar. Ö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. İlgili arama birimleri istendiğinde bu parametre zorunludur. Sayfa bağlamına bağlı olarak hangi tür İlgili Arama deneyiminin gösterileceğini kontrol eder:
Not: relatedSearchTargeting sayfa parametresi varsayılan olarak otomatik olarak "query" değerine ayarlanır. Ancak bu varsayılan değerin yalnızca arama sonuçları sayfaları için özel olarak tasarlandığını (Arama'daki İlgili Arama) belirtmek ö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' değeridir. 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: Ö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 ilgili arama birimi içeren bir içerik sayfasının URL parametrelerinin 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örünebilmesi için Google'ın, terimlerin bağlama uygun olduğundan emin olmak amacıyla sayfalarınızı taraması gerekir. Bir sayfa henüz taranmamışsa veya AdSense tarayıcısı tarafından taranması engelleniyorsa (ör. robots.txt ile) Google'a sağladığınız önerilen alakalı arama terimlerini göstermeyiz. İçerikte İlgili Arama ürünü, sayfaları dizine eklemek ve alakalı arama terimleri oluşturmak için Google'ın içerik tarama sisteminden yararlanı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 alakalı arama terimlerine yol açabilir. Bu sayfa parametresi, Google'ın tarayıcısına bu gerekli olmayan parametreleri dikkate almamasını bildirerek içeriğin düzgün şekilde dizine eklenmesini sağlar ve gereksiz tarama yükünü azaltır. Bu sayede Google, bir sayfanın daha önce taranmış olduğunu daha iyi tanıyabilir ve önerilen terimleri (uygun olduğunda hem Google'ın hem de 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 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 göstermek 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 parametresi on olarak ayarlanmış 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örüntülediğiniz reklamlar için ödeme yapılmaz. Varsayılan adtest değeri devre dışı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. 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, Google'a hem izin verilen hem de izin verilmeyen trafikte yalnızca geçersiz trafik çerezi ve yerel depolama kullanan reklamlara izin vermek istediğinizi bildiren bir boole değeri sağlamanıza olanak tanır.
Varsayılan olarak IVT true değerine ayarlanmıştır. Örnek: 'ivt': false |
Birim düzeyindeki parametre 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ı. Belirtilmezse varsayılan olarak 0 değerine ayarlanır. Örnek: 'relatedSearches' : 4 |