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.
|
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
|
İçerik sayfalarındaki İlgili Arama hariç, gereklidir. Bu, kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır. Not: Bu parametrenin İçerik sayfalarındaki İlgili Arama üzerinde kullanılması beklenmeyen 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' |
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' |
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:
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, 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.
Not: Bu parametre kullanılırken Örnekler: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
İsteğe bağlı Temel içeriği veya kullanıcı deneyimini etkilemeden güvenli bir şekilde yoksayılabilecek İçerik İçin İlgili Arama birimine sahip bir içerik sayfasının URL parametrelerinin listesini belirtir. Not: İçerikte İ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ğerlendirme becerisini etkileyebilir ve ilgili arama terimlerinin hatalı veya alakasız olmasına yol açabilir. Bu sayfa parametresi, Google'ın tarayıcısına bu zorunlu olmayan parametreleri dikkate almama talimatı vererek içeriğin dizine uygun şekilde dizine eklenmesini sağlar ve gereksiz tarama yükünü azaltır. Bu, Google'ın bir sayfayı zaten taranmış olarak algılamasını ve önerilen terimleri (hem Google'ın hem de uygunsa iş ortağının terimlerini) göstermeye başlamasını sağlar. Bu parametrenin kullanımında aşağıdaki yönergeler geçerlidir:
Örnekler:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Aşağıdaki göz ardı edilebilir URL parametrelerini sağlamak: '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:
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ı
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 trafiğe özel çerez ve yerel depolama kullanan reklamlara izin vermek istediğinizi Google'a bildiren bir boole sağlamanıza olanak tanır.
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:
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 |