Для досвідчених користувачів ми підготували список параметрів, які зараз підтримуються в стилях пошуку. Код, який ви створюєте в AdSense, містить усі налаштування основних параметрів. Є два обов’язкові параметри: pubId
та query
. Параметр pubId надає система AdSense, а для параметра query
ви маєте змінити код і вказати значення. Усі інші параметри є необов’язковими. Їх опис наведено нижче.
Типи параметрів
Параметри бувають двох типів:
- параметри на рівні сторінки, які застосовуються до всіх рекламних блоків на сторінці;
- параметри на рівні блоку, які застосовуються до окремих рекламних блоків.
Нижче подано приклад вихідних даних із генератора коду для двох рекламних блоків. Щоб налаштувати цей код, потрібно вказати обов’язковий параметр query
в схемі pageOptions
(наприклад, "query": myQuery
). Це все, що потрібно, щоб почати показ оголошень. Крім того, можна налаштувати додаткові параметри на рівні сторінки в блоці на сторінці, а також параметри на рівні окремих блоків у схемах adblock1
і adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Опис параметрів на рівні сторінки
Ці параметри потрібно вказати на сторінці лише один раз. Вони застосовуються до всіх рекламних блоків на сторінці.
Обов’язково
Параметр | Опис і приклади |
---|---|
adPage |
Обов’язковий, коли користувач переходить на наступну або попередню сторінку результатів
Параметр |
pubId |
Обов’язковий Це ваш ідентифікатор клієнта AdSense. pubId – це частина вашого ідентифікатора клієнта AdSense, указана після фрагмента "partner-". Наприклад, якщо ваш ідентифікатор клієнта – "partner-test-property", параметр pubId матиме значення "test-property". Це стандартний протокол для реклами в користувацькому пошуку. Приклад: 'pubId' : 'test-property' |
query |
Обов’язковий Це пошуковий запит, який вводить користувач. Значення параметра запиту має бути незашифрованим. Приклади:
|
resultsPageBaseUrl |
Обов’язковий, якщо на сторінці є блоки пов’язаних пошукових запитів Цей параметр визначає URL-адресу сторінки результатів пошуку, яка відкривається, коли користувач натискає пов’язаний пошуковий термін. resultsPageBaseUrl може мати власні параметри, за винятком пошукового запиту, який додається автоматично.
Приклад:
|
styleId |
Обов’язковий Цей параметр визначає ідентифікатор стилю пошуку, який буде застосовано до рекламних блоків або блоків пов’язаних пошукових запитів на сторінці. Докладніше про використання стилів пошуку. Зверніть увагу: якщо налаштувати для запиту параметр styleId, оголошення або пов’язані пошукові запити будуть відображатись у вибраному стилі, а застарілі параметри стилю ігноруватимуться. Якщо в запиті не вказано параметр styleId, використовуватиметься стиль системи за умовчанням. Приклад:
|
Необов’язковий
Параметр | Опис і приклади |
---|---|
linkTarget |
Необов’язковий Цей параметр визначає, у якому вікні після кліку оголошення відкриватиметься сторінка: у тому самому чи новому. За умовчанням для параметра задано значення "_top". Цей параметр також можна використовувати на рівні блоку.
Приклад: 'linkTarget' : '_blank' |
maxTermLength |
Необов’язковий Цей параметр визначає максимальну кількість символів у пов’язаному пошуковому терміні (включно з пробілами). Якщо не вказати максимальне значення, обмеження щодо символів не застосовуватиметься. Приклад: 'maxTermLength' : 50 |
referrerAdCreative |
Необов’язковий Якщо користувач перейшов на сторінку контенту, що містить блок пов’язаних пошукових запитів, натиснувши на іншому веб-сайті оголошення або посилання, яким ви керуєте, у цьому параметрі потрібно дослівно вказати текст такого оголошення чи посилання. Нижче наведено правила, які застосовуються до 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> , у якому має з’явитись оголошення.
Приклад:
|
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 |