За напредне кориснике наводимо ову листу тренутно подржаних параметара стила огласа за претрагу. Кôд који генеришете у AdSense-у садржи сва најчешће коришћена подешавања параметара. Постоје два обавезна параметра: pubId и query. AdSense наводи pubId, али морате да измените кôд и проследите вредност за параметар query. Сви други параметри су опционални и описани су у наставку.
Типови параметара
Постоје два типа параметра:
- Параметри на нивоу странице који се примењују на све огласне јединице на страници
- Параметри на нивоу јединице који се примењују на појединачне огласне јединице.
Ево примера резултата генератора кода са два блока огласа: Да бисте конфигурисали овај кôд, морате да подесите обавезни параметар query на мапи pageOptions (нпр. “query”: myQuery). То је све што је неопходно како бисте почели да приказујете огласе. Можете да подесите и опционалне параметре на нивоу странице у блоку на нивоу странице и параметре на нивоу појединачне јединице на мапама adblock1 и adblock2.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Параметри на нивоу странице
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Параметри на нивоу јединице
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Описи параметара на нивоу странице
Ови параметри треба да се одреде само једном по страници. Утичу на све јединице на страници.
Обавезно
| Параметар | Опис и примери |
|---|---|
adPage |
Обавезан када корисник оде на следећу или претходну страницу са резултатима
Параметар |
pubId |
Обавезан Ово је ваш ИД AdSense клијента. Ваш pubId је део ИД-а клијента приказан после 'partner-'. На пример, ако је ИД клијента 'partner-test-property, pubId је 'test-property'. Ово је стандардни протокол за огласе за прилагођену претрагу. Пример: 'pubId' : 'test-property' |
query |
Обавезан Ово је упит за претрагу који унесе корисник. Вредност параметра упита треба да буде некодирана. Примери:
|
resultsPageBaseUrl |
Обавезан када на страници постоје јединице сродне претраге Наводи URL странице резултата претраге на којој је упит за претрагу термин за сродну претрагу на који је корисник кликнуо. resultsPageBaseUr може да садржи своје параметре, осим упита за претрагу који се аутоматски додаје.
Пример:
|
styleId |
Обавезан Наводи ИД стила огласа за претрагу који треба да се примени на огласне јединице или јединице сродне претраге на страници. Сазнајте више о коришћењу стилова за претрагу. Имајте у виду да се уз подешен styleId за захтев огласи или сродне претраге приказују са тим стилом, а старе верзије параметара стила се занемарују. Ако styleId није наведен у захтеву, приказује се подразумевани системски стил. Пример
|
Опционално
| Параметар | Опис и примери |
|---|---|
linkTarget |
Опционалан Наводи да ли се одредиште клика на оглас отвара у истом или у новом прозору. Подразумевана вредност је '_top'. Овај параметар може да се користи и на нивоу јединице.
Пример: 'linkTarget' : '_blank' |
maxTermLength |
Опционалан Наводи максимални број знакова термина за сродну претрагу, укључујући размаке. Нема ограничења ако није подешен. Пример: 'maxTermLength' : 50 |
referrerAdCreative |
Опционалан Ако кликом на оглас или линк на другом веб-сајту корисник дође на страницу која садржи јединицу сродне претраге за садржај и ви контролишете тај оглас или линк, треба да подесите овај параметар на текст тог огласа или на линк онако како је написан. За коришћење овог параметра важе следеће смернице:
Примери: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Опционалан Наводи назив параметра URL-а за упит за претрагу на страници резултата претраге. Ако није наведен, подразумевана вредност је ‘q’. Пример: 'resultsPageQueryParam' : 'query' |
terms |
Опционалан Овај параметар вам омогућава да наведете листу термина за сродну претрагу раздвојених зарезима која ће се приказати уз захтев за сродну претрагу, а Google може да користи или да не користи термине наведене овде. Пример: 'terms' : 'cars rental, flight ticket' |
Подешавања конфигурације
| Параметар | Опис и примери | |||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Опционалан Наводи правила филтрирања која Google треба да примени на огласе који се подударају са упитом за претрагу. У наставку су важећа подешавања за adsafe и ефекат који свака вредност има на приказане огласе:
Напомена: Параметар
adsafe је подразумевано подешен на 'high'.Пример: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Опционалан Параметром adtest се показује да је захтев за огласе тест. Када је вредност параметра adtest 'on', Google третира захтев као тест и не рачуна приказе огласа нити прати резултате учесталости кликова.
Када је вредност параметра Напомене:
Подразумевана вредност параметра adtest је 'off'. Пример: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Опционалан Можете да наведете канал AdSense-а за претрагу да бисте пратили учинак различитих страница. Користите јединствени ИД канала који сте направили на AdSense налогу. Сазнајте више о праћењу учинка огласа помоћу прилагођених канала. Ако имате више канала, треба да буду одвојени симболом +. Примери: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Опционалан Овај параметар утврђује језик који захтевани огласи треба да циљају. Подразумевана вредност је 'en'. Google подржава све кодове језика Google Ads API-ја. Напомена: Оглашавачи наводе језике које циљају огласи. Ако у захтеву наведете овај параметар, Google ће приказивати само огласе који циљају тај језик или циљају све језике, али не гарантује да ће текст огласа бити на наведеном језику.
Обично треба да подесите параметар Примери: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Опционално
Параметар Подразумевана вредност параметра
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Опционално
Параметар Подразумевана вредност параметра
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Опционалан Наводи да ли су корисници дали сагласност да објављивач дели личне податке са Google-ом у сврху персонализованог оглашавања.
Напомена: Параметар
personalizedAds је подразумевано подешен на 'true'.Пример: 'personalizedAds': false |
Описи параметара на нивоу јединице
Ови параметри утичу на начин на који се појединачне огласне јединице на страници представљају кориснику. Сваки параметар може да се подеси појединачно за сваку огласну јединицу.
Обавезно
| Параметар | Опис и примери |
|---|---|
container |
Обавезан ИД празног контејнера огласа <div id='afscontainer1'></div> у ком оглас треба да се приказује.
Пример: |
Подешавања конфигурације
| Параметар | Опис и примери | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Опционалан Наводи JavaScript функцију која ће се позивати када се учитају огласи или сродне претраге или када се не приказују ни огласи ни сродне претраге. Параметар треба да буде подешен на JavaScript функцију повратног позива коју примењујете, што омогућава обављање радње када се обави позив за оглас. Функција повратног позива прима следеће параметре:
Напомена: Тестирајте функцију повратног позива и проверите да ли генерише грешке, нарочито грешке које могу да ометају учитавање странице.
Пример JavaScript повратног позива: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // највероватније не радите ништа } catch (e) { alert ("Error in callback function"); // Радите нешто за елегантно отклањање грешке } } else { // оно што увек радите када нема покривености огласима из Google-а } } }; |
||||||||
maxTop |
Опционално
Помоћу овог параметра наведите број огласа који ће се приказивати у огласној јединици у врху. Напомена: Овај параметар се користи уместо параметра
number. Та огласна јединица треба да буде довољно широка да се први ред огласа не прелама. Коришћење параметра maxTop на неком другом одредишту за пласман на страници је кршење смерница.Пример: |
||||||||
number |
Опционалан Број огласа који треба да се прикажу у овој јединици. Подразумевана вредност је 2. Пример: |
||||||||
relatedSearches |
Опционалан Број сродних претрага које треба да се прикажу у овој јединици. Овај параметар приказује најмање три сродне претраге ако није подешен на нулу. Ако није наведен, подразумевана вредност је 0. Пример: 'relatedSearches' : 4 |
||||||||
width |
Опционално Наводи ширину огласне јединице или јединице сродне претраге у пикселима. Примери: 'width' : '700px''width' : 700 |