Информация на этой странице предназначена для опытных пользователей. Код, создаваемый в AdSense, содержит наиболее часто используемые значения параметров. Есть два обязательных параметра: pubId
и query
. Параметр pubId задается автоматически, но правильное значение 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, которая идет после "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': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Необязательный. Указывает название параметра URL, в котором задается поисковый запрос для страницы результатов поиска. По умолчанию используется значение "q". Пример: 'resultsPageQueryParam' : 'query' |
terms |
Необязательный. С помощью этого параметра вы можете указать, какие связанные поисковые запросы нужно возвратить. Эти запросы вводятся через запятую. Указанное вами значение может игнорироваться. Пример: 'terms' : 'cars rental, flight ticket' |
Настройки конфигурации
Параметр | Описание и примеры | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Необязательный. Определяет правила фильтрации, которые Google будет применять для объявлений, соответствующих поисковому запросу. Ниже описаны возможные значения adsafe и их действие.
Примечание. По умолчанию для параметра
adsafe задается значение "high".Пример: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Необязательный. Параметр adtest указывает, что запрос объявлений является тестовым. Если adtest имеет значение "on", Google воспринимает запрос как тестовый, не учитывает показы объявлений и не отслеживает клики по ним.Когда для Примечание. Используйте этот параметр при тестировании, но потом не забудьте отключить его, иначе вы не будете получать денег за показ рекламы.
По умолчанию используется значение "off". Пример: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Необязательный. Позволяет включить канал AdSense для поиска, чтобы отслеживать эффективность отдельных страниц. При этом следует использовать уникальный идентификатор канала, созданный вами в аккаунте AdSense. Подробнее о том, как отслеживать эффективность рекламы с помощью клиентских каналов… Если каналов несколько, их необходимо разделить знаком плюса (+). Примеры: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Необязательный. Этот параметр определяет целевой язык запрашиваемых объявлений. По умолчанию используется значение "en". Google поддерживает все коды языков Google Ads API. Примечание. Рекламодатели указывают целевой язык для своих объявлений. Если включить в запрос этот параметр, будут показываться только объявления с таргетингом на указанный язык или на все языки. Однако при этом не гарантируется, что объявление будет составлено на выбранном языке.
Обычно для параметра Примеры: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Необязательный.
Параметр По умолчанию используется значение 'utf-8'.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
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 |