Параметры
Описание параметров уровня страницы
Эти параметры необходимо указывать только один раз на странице. Они влияют на все блоки на странице.
Необходимый
Параметр | Описание и примеры |
---|---|
adPage | Требуется, когда пользователь переходит на следующую или предыдущую страницу результатов. Параметр |
pubId | Необходимый Это ваш идентификатор клиента AdSense. Ваш pubId — это часть вашего идентификатора клиента, которая идет после «partner-». Например, если ваш идентификатор клиента — «partner-test-property», ваш pubId — «test-property». Это стандартный протокол для CSA. Пример: 'pubId' : 'test-property' |
query | Требуется, за исключением связанного поиска на страницах контента. Это поисковый запрос, введенный пользователем. Значение параметра запроса не должно быть закодировано. Примечание. Использование этого параметра в связанном поиске на страницах контента приведет к неожиданным результатам. Примеры: 'query' : 'flowers' 'query' : 'black & decker' 'query' : myQuery // myQuery is a variable containing the search query |
resultsPageBaseUrl | Требуется, если на странице есть связанные поисковые блоки. Указывает URL-адрес страницы результатов поиска, на которой поисковый запрос представляет собой связанный поисковый запрос, на который щелкнул пользователь. ResultPageBaseUrl может включать свои собственные параметры, за исключением поискового запроса, который будет добавлен автоматически. Пример: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting | Требуется, если на странице есть связанные поисковые блоки. Этот параметр является обязательным при запросе связанных единиц поиска. Он контролирует, какой тип связанного поиска отображается в зависимости от контекста страницы:
Примечание. Для параметра страницы linkedSearchTargeting по умолчанию автоматически устанавливается значение «запрос». Однако важно отметить, что это значение по умолчанию специально разработано только для страниц результатов поиска (связанный поиск в поиске). Если вы используете связанный поиск на страницах любого другого типа (например, статей, сообщений в блогах), вы должны явно установить для параметра «контент». Примечание. К использованию этого параметра применяются следующие рекомендации:
Примеры: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId | Необходимый Указывает идентификатор стиля пользовательского поиска, который будет применен к объявлению или связанным с ним блокам поиска на странице. Узнайте больше об использовании пользовательских стилей поиска. Обратите внимание, что если для запроса установлен styleId, объявления или связанные поисковые запросы будут отображаться с использованием этого стиля, а устаревшие параметры стиля будут игнорироваться. Если styleId не указан в запросе, будет отображен стиль системы по умолчанию. Пример: 'styleId': '1234567890' |
Необязательный
Параметр | Описание и примеры |
---|---|
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' |
ignoredPageParams | Необязательный Указывает список параметров URL-адреса для страницы контента с блоком «Похожий поиск контента», который можно безопасно игнорировать, не влияя на основной контент или взаимодействие с пользователем. Примечание. Прежде чем связанные поисковые запросы смогут появиться на вашем сайте, Google должен просканировать ваши страницы, чтобы убедиться, что эти термины контекстуально релевантны. Если страница еще не просканирована или заблокирована для сканирования (например, файлом robots.txt) сканером AdSense , мы не будем показывать предлагаемые термины связанного поиска, которые вы предоставляете Google. Продукт «Похожий поиск по контенту» использует систему сканирования контента Google для индексации страниц и создания релевантных поисковых запросов. URL-адреса страниц контента, содержащие параметры запроса, такие как переменные отслеживания, идентификаторы пользователей, идентификаторы сеансов или другие динамические идентификаторы, могут помешать сканеру оценить основное содержимое страницы и могут привести к неточным или нерелевантным связанным поисковым запросам. Этот параметр страницы дает указание сканеру Google игнорировать эти несущественные параметры, обеспечивая правильную индексацию контента и снижая ненужную нагрузку при сканировании. Это позволяет Google лучше распознавать страницу как уже просканированную и начать показывать предлагаемые условия (как Google, так и партнерские, если это соответствует критериям). К использованию этого параметра применяются следующие рекомендации:
Примеры: http://example.com/content?utm_medium=social&page_id=123&click_id=456Предоставление следующих игнорируемых параметров URL: 'ignoredPageParams' : 'utm_medium,click_id,session_ref'Будет рассматривать URL-адрес страницы контента как: http://example.com/content?page_id=123 |
Параметры конфигурации
Параметр | Описание и примеры | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe | Необязательный Указывает правила фильтрации, которые Google должен применять к объявлениям, соответствующим поисковому запросу. Ниже приведены допустимые настройки Adsafe и влияние каждого значения на возвращаемые объявления:
По умолчанию для Adsafe установлено высокое значение. Пример: 'adsafe': 'medium' | |||||||||||||||||||||||||||||||||||||||||||||||||||
adtest | Необязательный Параметр adtest используется для указания того, что запрос рекламы является тестовым. Если параметр adtest имеет значение on , Google рассматривает запрос как тест и не подсчитывает показы объявления и не отслеживает результаты кликов. Если параметр adtest имеет значение on , вы не получаете никакого дохода. Запросы объявлений с параметром adtest, поступающие из домена, который не был одобрен на вкладке «Сайты», будут возвращать объявления с наложением «тестовое объявление», на которые нельзя нажать. Используйте этот параметр при тестировании, но не используйте его в производственных системах, иначе вам не будут платить за показываемую вами рекламу. Значение adtest по умолчанию отключено. Пример: 'adtest' : 'on' | |||||||||||||||||||||||||||||||||||||||||||||||||||
channel | Необязательный Вы можете включить канал AdSense для поиска для отслеживания эффективности различных страниц. Используйте уникальный идентификатор канала, созданный в вашей учетной записи AdSense или вашим техническим менеджером аккаунта. Подробнее о каналах можно узнать здесь . Несколько каналов должны быть разделены символом «+». Примеры: 'channel' : 'testA' 'channel' : 'testA+testB' | |||||||||||||||||||||||||||||||||||||||||||||||||||
hl | Необязательный Этот параметр определяет язык, на который должны ориентироваться запрошенные объявления или связанные поисковые запросы. Значение по умолчанию — en . Google поддерживает все языковые коды API AdWords . Примечание. Рекламодатели указывают языки, на которые ориентированы их объявления. Если вы включите этот параметр в свой запрос, Google вернет только объявления, ориентированные на этот язык или все языки, но не гарантирует, что текст объявления будет на указанном языке. Обычно для параметра hl следует указать основной язык страницы, с которой отправляется этот параметр. Примеры: 'hl' : 'es' | |||||||||||||||||||||||||||||||||||||||||||||||||||
ie | Необязательный Параметр Значение
| |||||||||||||||||||||||||||||||||||||||||||||||||||
oe | Необязательный Параметр Значение
| |||||||||||||||||||||||||||||||||||||||||||||||||||
ivt | Необязательный Этот параметр позволяет вам указать логическое значение, сообщающее Google о том, что вы хотите разрешить рекламу, использующую недействительные файлы cookie только для трафика и локальное хранилище, как для согласованного, так и для несогласованного трафика.
По умолчанию для IVT установлено значение true. Пример: 'ivt': false |
Описание параметров уровня устройства
Эти параметры влияют на то, как отдельные рекламные блоки на странице представляются пользователю. Каждый параметр можно настроить индивидуально для каждого рекламного блока.
Необходимый
Параметр | Описание и примеры |
---|---|
container | Необходимый Идентификатор пустого рекламного контейнера <div> , в котором должно отображаться объявление.Пример: 'container' : 'afscontainer1' |
maxTop | Требуется, если рекламный блок находится над результатами поиска. Используйте этот параметр, чтобы указать количество объявлений, отображаемых в верхнем рекламном блоке. Примечание. Этот параметр используется вместо параметра «число». Этот рекламный блок должен быть достаточно широким, чтобы первая строка объявлений не переворачивалась. Использование параметра maxTop в любом другом месте размещения на странице является нарушением политики. Пример: 'maxTop' : 4 |
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. Пример: 'number' : 4 | ||||||||
relatedSearches | Необязательный Количество связанных поисковых запросов, которые должны появиться в этом блоке. По умолчанию 0, если не указано. Пример: 'relatedSearches' : 4 |