Referans

Parametreler

Sayfa Düzeyinde Parametre Açıklamaları

Bu parametrelerin sayfa başına yalnızca bir kez belirtilmesi gerekir. Sayfadaki tüm birimleri etkiler.

Zorunlu

Parametre Açıklama ve Örnekler
adPage Kullanıcı bir sonraki sonuç sayfasına veya önceki sonuçlar sayfasına gittiğinde gereklidir.

adPage parametresi, reklamlarının gösterildiği sonuç sayfasını belirtir. Bu parametre, kullanıcılar arama sonuçlarının ilk sayfasını geçtiğinde kullanılır. Örneğin, beş reklam istenirse ve adPage parametresi 2 olarak ayarlanırsa döndürülen reklamlar beş reklamın ikinci sayfası olur.

pubId Zorunlu
Bu, AdSense müşteri kimliğinizdir. pubId parametreniz, istemci kimliğinizin "partner-" ifadesinden sonra gelen kısmıdı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 şöyle olmalıdır: kodlanmamıştır.

Not: Bu parametrenin İçerik sayfalarındaki İlgili Arama'da kullanılması, beklenmedik sonuçlar.

Ö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 ait olduğu arama sonuçları sayfasının URL'sini kullanıcının tıkladığı ilgili arama terimidir. resultsPageBaseUrl, kendi parametrelerini (otomatik olarak eklenecek arama sorgusu hariç) içerir.

Ö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. Hangi tür iletişimin İlgili Arama deneyimi, sayfa bağlamına göre gösterilir:
  • 'content' Bu seçeneği İçerik sayfalarındaki İlgili Arama için kullanın (ör. makaleler, blog yayını) ziyaret edebilirsiniz.
  • 'query' Bu seçeneği yalnızca İlgili Arama için kullanın: Arama sonuçları sayfaları.

Not:relatedSearchHedefleme sayfa parametresi otomatik olarak "query" varsayılan olarak. Ancak bu varsayılan değerin özellikle yalnızca arama sonuçları sayfaları için tasarlanmış (Arama'daki İlgili Arama). Şu durumda: diğer türdeki sayfalarda (ör. makaleler, blog yayınları) ilgili aramayı kullanıyorsanız, parametreyi açıkça 'content' olarak ayarlamanız gerekir.

Not: Bu parametrenin kullanımı için aşağıdaki yönergeler geçerlidir:

  • Bu özelliğin değerine bağlı olarak, ilgili belirli arama özellikleri etkinleştirilebilir veya devre dışı bırakılabilir. sayfa parametresine benzer.
  • Sayfa türünü yanlış beyan etme veya varsayılan "sorgu"yu temel alma ayarı Arama sonuçları dışındaki sayfalarda bulunan relatedSearchHedefleme parametresi şunların ihlali olarak değerlendirilir: lütfen unutmayın.
  • Google, ayarlanıp ayarlanmadığından bağımsız olarak bu değerin doğruluğunu düzenli olarak doğrulayabilir manuel olarak veya varsayılan değeri kullanarak.

Örnekler:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId Zorunlu
Reklama veya ilgili arama birimlerine uygulanacak özel arama stilinin kimliğini belirtir yapalım. Özel arama stillerini kullanma hakkında daha fazla bilgi edinin. Bir istek için styleId ayarlandığında, reklamlar veya ilgili aramalar stille oluşturulur, eski stil parametreleri ise yoksayıldı. İ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 bir pencerede mi açılacağını belirtir penceresini kapatın. Varsayılan değer '_top' değeridir. Bu parametre, birim düzeyinde de kullanılabilir.
  • '_top' Aynı pencerede açılır.
  • '_blank' Yeni pencerede açılır.

Örnek:

'linkTarget' : '_blank'
maxTermLength İsteğe bağlı
Boşluklar 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ı, İçerik İçin İlgili Arama birimini içeren içerik sayfanıza gelirse başka bir web sitesindeki bir reklamı veya bağlantıyı tıklayarak ve bu reklamı ya da bağlantıyı sizin kontrolünüz altında tutarak, bu parametre, söz konusu reklamın veya bağlantının reklam öğesi metnine tam olarak ayarlanmalıdır.

Bu parametrenin kullanımı için aşağıdaki yönergeler geçerlidir:

  • Parametre yalnızca İçerik İçin İlgili Arama isteğinde sağlanmalıdır ve diğer tüm isteklerde yoksayılır.
  • Yalnızca diğer kullanıcılardan bilinçli olarak aldığınız trafikte kullanılmalıdır. web sitelerinde yer almalı ve organik trafikte kullanılmamalıdır.
  • Reklamdaki başlık satırını, açıklamayı ve/veya diğer kelimeleri içermelidir. bağlantı reklam öğesi.
  • Reklam veya bağlantı reklam öğesinden değerlerin çıkarılması (veya ek değerler eklenmesi) bu talimatların ihlal edildiği anlamına gelir.
  • Büyük/küçük harfe duyarlı değildir.
  • Geçerli UTF-8 kodlamasını kabul eder; unicode karakterleri / aksan işaretleri desteklenir.
  • Google, gönderdiğiniz parametreyi kullanabilir veya yok sayabilir. Bu ayar kullanıldığında seçimi etkileyebilir artık daha iyi kontrol edebiliyorsunuz.

Not: Bu parametre, terms parametresinden yararlanın.

Ö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, kendi ilgili arama terimlerinizin virgülle ayrılmış bir listesini sağlamanıza olanak tanır bir arama isteği döndürecek olsa da, Google bu içeriği şartlarını kabul edersiniz.

Not: Bu parametreyi kullanırken referrerAdCreative ayrıca zorunludur, relatedSearchTargeting zorunludur ve ayarlanmalıdır 'içerik' olarak değiştirmektir.

Örnekler:

'terms' : 'cars rental, flight ticket'
ignoredPageParams İsteğe bağlı
İçerik İçin İlgili Arama içeren bir içerik sayfası için URL parametrelerinin listesini belirtir reklamlar, temel içerik veya kullanıcı deneyimi etkilenmeden güvenli bir şekilde yok sayılabilen bir birimdir.

Not: İlgili arama terimlerinin sitenizde gösterilebilmesi için Google'ın şunları yapması gerekir: terimlerin bağlamsal açıdan alakalı olduğundan emin olmak için sayfalarınızı tarayın. Bir sayfa henüz tarafından taranan veya taramanın engellenmesi (ör. bir robots.txt tarafından) AdSense tarayıcısı Google'a sağladığınız önerilen İlgili Arama terimleri gösterilmez.

İçerik Üzerinde İlgili Arama ürünü, dizine eklemek için Google'ın içerik tarama sistemini kullanır ve alakalı arama terimleri üretin. Şunun gibi sorgu parametrelerini içeren içerik sayfası URL'leri: oturum kimliklerinin veya diğer dinamik tanımlayıcıların birlikte çalışması tarayıcının temel içeriğini değerlendirebilmesidir ve yanlış veya Alakasız alakalı arama terimleri. Bu sayfa parametresi, Google'ın tarayıcısına bu gerekli olmayan parametreleri kullanarak, içeriğin dizine eklenmesinin uygun şekilde sağlanması ve gereksiz taramanın azaltılması yükleyin. Bu, Google'ın bir sayfayı daha önce taranan sayfa olarak daha iyi tanımasını ve sayfayı yeniden başlatmasını sağlar önerilen şartları (uygunsa hem Google'ın hem de iş ortağının şartları) göstermek

Bu parametrenin kullanımı için aşağıdaki yönergeler geçerlidir:

  • Parametre yalnızca İçerik İçin İlgili Arama isteğinde sağlanmalıdır ve diğer tüm isteklerde yoksayılır.
  • Bu parametrenin değeri, şunlara neden olabilecek URL parametrelerinin virgülle ayrılmış bir listesi olmalıdır: Kullanıcı içerik sayfasına gittiğinde görünür.
  • Büyük/küçük harfe duyarlıdır.
  • Bu listedeki herhangi bir URL parametresi içerik sayfasının URL'sinden kaldırıldığında, sayfanın içeriğini, görünümünü veya kullanıcı deneyimini önemli ölçüde etkilememelidir.
  • Sayfanın içeriğini, görünümünü veya içeriklerini önemli ölçüde etkileyen bir URL parametresi eklemek, kullanıcı deneyiminin bu yazılı talimatların ihlali kapsamında değerlendirildiği anlamına gelir.
  • Google, sağlanan URL parametrelerini yoksaymanın etkisini düzenli olarak doğrulayabilir.

Örnekler:
. Kullanıcı bir içerik sayfasını ziyaret eder ve URL:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
Aş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 işlenir:
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:
  • 'high' Aile için güvenli reklamları döndürür. Aile için güvenli olmayan veya yetişkinlere uygun cinsel içerikli reklamları döndürmez.
  • 'medium' Aile için güvenli ve aile için güvenli olmayan reklamları döndürür. Yetişkinlere uygun cinsel içerikli reklamları döndürmez.
  • 'low' Tüm reklam türlerini döndürü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ı" 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 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. Benzersiz kanal kimliğini kullanın AdSense hesabınızda veya Teknik Hesap Yöneticiniz tarafından oluşturulur. Kanallar hakkında daha fazla bilgiyi burada bulabilirsiniz.

Birden fazla kanal varsa kanallar "+" ile ayrılmalıdır anlamına gelir.

Ö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ı

ie parametresi, sorgu dizesini yorumlamak için kullanılması gereken karakter kodlama şemasını ayarlar.

Varsayılan ie değeri utf-8'dir.

Değer Standart adı İlişkili Desteklenen Diller
latin1 ISO-8859-1, Batı Avrupa (Almanca, Endonezce, Fince, Fransızca, Felemenkçe, Katalanca, İngilizce, İspanyolca, İsveççe, İtalyanca, Norveççe, Portekizce)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Rumence, Sırpça, Slovakça, Slovence)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltık (Estonca, Letonca, Litvanca)
kiril ISO-8859-5 Bulgarca, Rusça
arabic ISO-8859-6  
yunan ISO-8859-7 Yunanca
hebrew ISO-8859-8 İbranice
latin5 ISO-8859-9  
latin6 ISO-8859-10 İzlanda dili
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
Shii'ler Shift_JIS Japonca
big5 Big5 Geleneksel Çince
gb GB2312 Basitleştirilmiş Çince
utf-8 UTF-8 Tümü
oe İsteğe bağlı

oe parametresi, Google'ın reklam metnini kodlamak için kullanması gereken karakter kodlama şemasını ayarlar. Teknik olarak isteğe bağlı olsa da bu parametre için bir değer iletmek iyi bir uygulamadır.

Varsayılan oe değeri utf-8'dir.

Değer Standart adı İlişkili Desteklenen Diller
latin1 ISO-8859-1, Batı Avrupa (Almanca, Endonezce, Fince, Fransızca, Felemenkçe, Katalanca, İngilizce, İspanyolca, İsveççe, İtalyanca, Norveççe, Portekizce)
latin2 ISO-8859-2 Doğu Avrupa (Hırvatça, Çekçe, Macarca, Lehçe, Rumence, Sırpça, Slovakça, Slovence)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltık (Estonca, Letonca, Litvanca)
kiril ISO-8859-5 Bulgarca, Rusça
arabic ISO-8859-6  
yunan ISO-8859-7 Yunanca
hebrew ISO-8859-8 İbranice
latin5 ISO-8859-9  
latin6 ISO-8859-10 İzlanda dili
euc-jp EUC-JP Japonca
Euc-kr EUC-KR Korece
Shii'ler Shift_JIS Japonca
gb GB2312 Basitleştirilmiş Çince
utf-8 UTF-8 Tümü
ivt İsteğe bağlı
Bu parametre, geçersiz trafiğe özel çerez kullanan reklamlara izin vermek istediğinizi Google'a bildiren bir boole değeri sağlamanıza ve hem izin verilen hem de izin verilmeyen trafikte yerel depolama alanı
  • true Bu parametre mevcut olmadığında veya "true" olarak ayarlandığında geçersiz trafiğe özel bir çerez oluşturur ve yerel depolama alanını yalnızca izin verilen trafikte kullanırız.
  • false Bu parametreyi "false" olarak ayarladığınızda geçersiz trafiğe özel bir çerez ayarlayıp hem izin verilen hem de izin verilmeyen trafikte yerel depolama alanını kullanırız.

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.

Zorunlu

Parametre Açıklama ve Örnekler
container Zorunlu
Reklamın görüneceği <div> boş reklam kapsayıcısının 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' yerine kullanılır parametresinden sonra bir değer girin. Bu reklam birimi reklamların ilk satırının sarmalanmaması için yeterince geniş olmalıdır. maxTop kullanma parametresinin diğer herhangi bir yerleşiminde bulunması politika ihlalidir.

Örnek:

'maxTop' : 4
width Zorunlu
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 olduğunda veya hiçbir reklam ya da ilgili arama sunulmadığında. Parametre reklam çağrısı tamamlandı.

Geri çağırma işlevi aşağıdaki parametreleri alır:

containerName Reklamın veya ilgili arama biriminin kapsayıcı adı.
adsLoaded Görüntülenecek en az bir reklam veya ilgili arama terimi olduğunda "doğru", "yanlış" olarak ayarlanır hiçbir reklam veya ilgili arama döndürülmediğinde.
isExperimentVariant Özel stil denemesi çalışıyorsa ve reklamların oluşturulması için deneme seçilir.
callbackOptions Aşağıdaki alanları içeren bir JSON nesnesi:
termPositions: İlgili arama bloğu için, <string,int> içerir / yayıncı tarafından sağlanan yanıtta bu terimlerin sıfır endeksli konumuna dönmesini sağlayabilirsiniz. Bir terim sağlanırsa geri dönmüyorsa haritada görünmez.

Not: Herhangi bir hata oluşturmadığından emin olmak için lütfen geri çağırma işlevinizi test edin. özellikle sayfanızın yüklenmesini etkileyebilecekleri.

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örünmesi gereken ilgili aramaların sayısı. Belirtilmezse varsayılan olarak 0 değerine ayarlanır.

Örnek:

'relatedSearches' : 4