За напреднали потребители предоставяме този списък с поддържаните понастоящем параметри за стил на рекламите в мрежата за търсене. Кодът, който генерирате в 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 |
Задължително Това е Вашият Client-ID в AdSense. Вашият pubId е частта от Client-ID, която се отваря след „partner-“. Ако например Client-ID е „partner-test-property“, Вашият pubId е „test-property“. Това е стандартен протокол за CSA. Пример: 'pubId' : 'test-property' |
query |
Задължително Това е заявката за търсене, въведена от потребителя. Стойността на параметъра на заявката не трябва да бъде кодирана. Примери:
|
resultsPageBaseUrl |
Задължително при наличието на сродни елементи за търсене на страницата Указва URL адреса на страницата с резултати от търсенето, на която заявката за търсене е сродната дума за търсене, върху която потребителят е кликнал. resultsPageBaseUrl може да включва свои собствени параметри с изключение на заявката за търсене, която ще бъде добавяна автоматично.
Пример:
|
styleId |
Задължително Посочете идентификационния номер на стила на рекламите в мрежата за търсене, който да се приложи към рекламата или елементите за сродно търсене на страницата. Научете повече за използването на стилове на рекламите в мрежата за търсене. Обърнете внимание, че със зададено styleId за заявка рекламите или сродните търсения ще бъдат изобразявани с въпросния стил, а наследените параметри за стила на рекламите ще бъдат пренебрегнати. Ако в заявката не е посочен styleId, ще бъде зададен стандартен за системата стил. Пример
|
По избор
Параметър | Описание и примери |
---|---|
linkTarget |
По избор Указва дали кликването върху реклама се отваря в същия прозорец или в нов прозорец. Стойността по подразбиране е „_top“. Този параметър може да се използва и на ниво елемент.
Пример: 'linkTarget' : '_blank' |
maxTermLength |
По избор Посочва максималния брой знаци за сродна дума за търсене, включително интервали. Без ограничение, ако не е зададено. Пример: 'maxTermLength' : 50 |
referrerAdCreative |
По избор Ако потребител стигне до страницата Ви със съдържание, която съдържа сродно търсене за елемент от съдържанието, като кликне върху реклама или връзка в друг уебсайт, а рекламата или връзката са под Ваш контрол , този параметър трябва да е зададен на текста на рекламата или на връзката. Следните указания важат за използването на този параметър:
Примери: 'referrerAdCreative': '„търсене на реклами, свързани със зъбни импланти' 'referrerAdCreative': 'Ранни симптоми на псориатичен артрит' |
resultsPageQueryParam |
По избор Указва името на параметъра на URL адреса за заявката за търсене на страницата с резултати от търсенето. Ако не бъде посочено, стойността по подразбиране е „q“. Пример: 'resultsPageQueryParam' : 'query' |
terms |
По избор Този параметър Ви дава възможност да предоставите списък, разделен със запетая, със собствените си свързани думи за търсене, които да бъдат върнати със заявка за сродно търсене, въпреки че Google може и да не използва предоставените тук термини. Пример: 'terms' : 'копи под наем, билет за самолет' |
Настройки за конфигурацията
Параметър | Описание и примери | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 поддържа всички езикови кодове на API на Google Ads. Забележка: Рекламодателите указват езиците, към които са насочени рекламите им. Ако включите този параметър в заявката си, Google извежда само реклами, насочени към този език или към всички езици, но не гарантира, че рекламният текст ще бъде на посочения език.
Обикновено трябва да зададете параметъра Примери: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
По избор
Параметърът Стойността на
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
По избор
Параметърът Стойността по подразбиране на
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
По избор Указва дали потребителите са дали съгласие издателят да споделя лична информация с Google с цел персонализирано рекламиране.
Забележка: По подразбиране параметърът
personalizedAds е зададен на „true“.Пример: 'personalizedAds': false |
Описание на параметрите на ниво елемент
Тези параметри оказват влияние върху начина, по който отделните рекламни елементи на страницата се представят на потребителя. Всеки параметър може да бъде зададен поотделно за всеки рекламен елемент.
Задължителни
Параметър | Описание и примери |
---|---|
container |
Задължително Идентификаторът на празен рекламен контейнер – <div id='afscontainer1'></div> , — където да се показва рекламата.
Пример:
|
maxTop |
Задължителни
Използвайте този параметър, за да укажете броя на рекламите, които да се показват в най-горния рекламен елемент. Забележка: Този параметър се използва вместо
number . Рекламният елемент трябва да е достатъчно широк, така че първият ред от рекламите да не се скрива. Използването на параметъра maxTop на друго разположение на страницата представлява нарушение на правилата.Пример:
|
width |
Задължително Указва ширината на рекламния елемент или на елемента за сродно търсене в пиксели. Примери: 'width' : '700px' 'width' : 700 |
Настройки за конфигурацията
Параметър | Описание и примери | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
По избор Указва функция за JavaScript, която да се извиква, когато рекламите или сродните търсения са се заредили или когато не се показват реклами или сродни търсения. Параметърът трябва да бъде зададен на внедрена от Вас функция на JavaScript за обратно извикване, което позволява извършването на действие, когато извикването на рекламата завърши. Функцията за обратно извикване използва следните параметри:
Забележка: Моля, тествайте функцията за обратно извикване, за да се уверите, че не генерира грешки, особено такива, които може да пречат на зареждането на страницата Ви.
Пример за обратно извикване на JavaScript: 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 |
По избор Броят реклами, които трябва да се показват в този елемент. Стойността по подразбиране е „2“. Пример:
|
||||||||
relatedSearches |
По избор Броят сродни търсения, които трябва да се показват в този елемент. Този параметър връща най-малко три сродни търсения, освен ако не е зададен на нула. Ако не е посочена, стойността по подразбиране е „0“. Пример: 'relatedSearches' : 4 |