İleri düzey kullanıcılar için şu anda desteklenen arama stili parametrelerinin listesini sağlıyoruz. AdSense'te oluşturduğunuz kodda en sık kullanılan parametre ayarlarının tümü bulunur. Gerekli iki parametre vardır: pubId ve query. pubId parametresi AdSense tarafından sağlanır ancak query parametresi için kodu düzenlemeniz ve bir değer iletmeniz gerekir. Diğer tüm parametreler isteğe bağlıdır ve aşağıda açıklanmıştır.
Parametre türleri
İki tür parametre vardır:
- Sayfadaki tüm reklam birimlerine uygulanan sayfa düzeyindeki parametreler
- Tek reklam birimlerine uygulanan birim düzeyindeki parametreler.
Aşağıda kod oluşturma aracından iki reklam bloku içeren örnek çıkışlar görebilirsiniz. Bu kodu yapılandırmak için pageOptions listesindeki gerekli query parametresini ayarlamanız gerekir (ör. "query": myQuery). Reklam yayınlamaya başlamak için bu işlemin yapılması gerekir. Ayrıca sayfa düzeyindeki blokta isteğe bağlı sayfa düzeyinde parametreler ve adblock1 ile adblock2 listelerinde tek birim düzeyinde parametreler ayarlayabilirsiniz.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Sayfa düzeyindeki parametreler
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Birim düzeyindeki parametreler
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Sayfa düzeyindeki parametrelerin açıklamaları
Bu parametrelerin her sayfa için sadece bir kez belirtilmesi gerekir. Bu parametreler 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 |
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 |
Gerekli Bu parametre kullanıcı tarafından girilen arama sorgusudur. Sorgu parametresinin değeri kodlanmamış olmalıdır. Örnekler:
|
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:
|
styleId |
Gerekli Reklama veya sayfadaki ilgili arama birimlerine uygulanacak arama stilinin kimliğini belirtir. 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
|
İ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 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 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:
Ö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. Örnek: 'terms' : 'cars rental, flight ticket' |
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:
Not:
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 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ıklanma sonuçlarını izlemez.
Not: 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 'off' olarak ayarlanmıştı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 oluşturduğunuz benzersiz kanal kimliğini kullanın. Özel kanallarla reklam performansını izleme hakkında daha fazla bilgi 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 hedeflemesi gereken dili tanımlar. Varsayılan değer 'en' olarak ayarlanmıştır. Google tüm Google Ads 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, Örnekler: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
İsteğe bağlı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
İsteğe bağlı
Varsayılan
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
İsteğe bağlı Kullanıcıların, yayıncının kişiselleştirilmiş reklamcılık amacıyla kişisel bilgileri Google ile paylaşmasına izin vermeyi kabul edip etmediğini belirtir.
Not:
personalizedAds parametresi varsayılan olarak "true" değerine ayarlanmıştır.Örnek: 'personalizedAds': 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.
Gerekli
| Parametre | Açıklama ve örnekler |
|---|---|
container |
Gerekli Reklamın gösterileceği <div id='afscontainer1'></div> boş reklam kapsayıcısının kimliği.
Örnek: |
maxTop |
Gerekli
Ü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: |
width |
Gerekli Reklam biriminin veya ilgili arama biriminin genişliğini piksel cinsinden belirtir. Örnekler: '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 { // büyük olasılıkla hiçbir şey yapılmaz } catch (e) { alert ("Error in callback function"); // Hatayı düzgün bir şekilde ele almak için bir işlem yapın } } else { // Google'dan reklam kapsamı olmadığı zaman yaptığınız gibi } } }; |
||||||||
number |
İsteğe bağlı Bu birimde gösterilmesi gereken reklam sayısı. Varsayılan değer "2" olarak ayarlanmıştır. Örnek: |
||||||||
relatedSearches |
İsteğe bağlı Bu birimde gösterilmesi gereken ilgili arama sayısı. Bu parametre, sıfır olarak ayarlanmadığı sürece en az üç ilgili arama döndürür. Belirtilmezse varsayılan olarak 0 değerine ayarlanır. Örnek: 'relatedSearches' : 4 |