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.
|
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:
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:
Ö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' |
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:
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ğ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 Ö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:
Örnekler:
http://example.com/content?utm_medium=social&page_id=123&click_id=456Aş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:
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ı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
İsteğe bağlı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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.
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:
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 |