Запрос без тегов можно использовать вместо тега объявления, чтобы получить исходный код креатива, показ которого выполняется в Менеджере рекламы. Такие запросы обычно создаются, если необходимо выполнять специальную обработку и показ, например при размещении рекламы на телеприставках и прочих платформах, не поддерживающих теги или SDK Google.
Когда вы отправляете запрос без тегов, Менеджер рекламы возвращает только код креатива, не показывая объявление. Если оно не будет найдено, придет сообщение 200/OK и пустой ответ.
Чтобы объявление демонстрировалось, а его показы отслеживались, в приложении, проигрывателе или на сайте должен выполняться специальный код.
Как создать запрос без тегов вручную
Запрос без тегов состоит из базового URL, а также обязательных и необязательных параметров. С помощью параметров вы можете указать, например, рекламный блок, размер креатива, а также другую информацию в формате пар "ключ-значение".
Для безопасности используйте протокол SSL (https://).
Начните с базового URL
Используйте следующий базовый URL: https://securepubads.g.doubleclick.net/gampad/adx?
Укажите параметры запроса
Обязательные параметры| Параметр | Описание |
|---|---|
iu |
Код рекламного блока в сети Google Менеджера рекламы, включающий код вашей сети Google Менеджера рекламы. Чтобы разделить блоки на уровни, используйте косую черту ( Пример
При работе с Инструментом управления клиентами (MCM) и запросами без тегов в коде сети рекомендуется использовать структуру Пример (MCM)
|
sz |
Размер креатива. Если размеров несколько, их нужно разделять вертикальной линией ( ПримерДля одного размера: Рекомендуем вместо вертикальной линии ( ПримерВместо |
url |
URL домена, к которому относится исходный запрос объявления. Указывать этот URL обязательно только для запросов из MCM. Пример
|
c |
Параметр корреляции или очистки кеша. Это случайное число (буквы использовать запрещено), которое создается издателем для вызова сервера объявлений при каждой загрузке страницы, что обеспечивает корректный подсчет показов. Пример
|
tile |
Положение тега объявления на странице. Значение должно быть уникальным целым числом. Для простоты рекомендуем использовать последовательно увеличивающиеся числа. Этот параметр необходим лишь в том случае, если несколько тегов объявлений на одной странице используют один и тот же код рекламного блока ( Пример
tile=, должны выполняться в пределах 30 секунд, чтобы при обработке того же коррелятора c= не был выбран прежний креатив. |
| Параметр | Описание |
|---|---|
d_imp |
Включает и выключает отложенные показы. Если параметр включен, подсчет показов прекращается. После этого для их регистрации используется макрос просмотренных показов в возвращенном креативе или значение параметра Пример
|
d_imp_hdr |
Включает и выключает передачу информации об отложенных показах в заголовке. Если параметр включен, URL просмотра, который используется для подсчета показов, возвращается в заголовке HTTP. По умолчанию эта информация в заголовке не определена. Издателю нужно будет вручную выполнить запрос ping для этого URL просмотра, чтобы показ был засчитан. Подробнее об учете количества показов и запросах без тегов…
Пример
|
t |
Пары "ключ-значение" на уровне рекламного места. Каждый ключ и его значения разделяются знаком равенства ( ПримерПараметр Используйте Пример
В ключах и значениях нельзя использовать следующие символы: ПримерЗапрос |
m |
Устанавливает тип MIME в заголовке HTTP. Пример
|
mob |
Указывает на мобильное устройство как источник запроса объявления. Пример
|
ppid |
Идентификатор, назначаемый издателем (PPID), – это уникальная комбинация символов, которую вы отправляете в Google Менеджер рекламы. Она используется для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других методов управления рекламой на разных устройствах. Пример
|
u_w |
Сведения о ширине экрана мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример
|
u_h |
Сведения о высоте экрана мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример
|
submodel |
Сведения о модели мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример
Значения модификаций
|
Как активировать отслеживание показов
При работе с запросами без тегов в Менеджере рекламы можно регистрировать скачанные показы, которые также называются отложенными. Для этого используйте один из способов ниже (но не оба одновременно, поскольку это может привести к двойному или тройному учету показов).
Мы рекомендуем указанный ниже способ 1. Однако для этого вам потребуется доступ к заголовкам HTTP-ответов и возможность реализовать протокол на основе заголовков.
Способ 1. Регистрируйте показы, считывая заголовки HTTP-ответов
Добавьте в запросы без тегов параметры d_imp=1 и d_imp_hdr=1, чтобы Google Менеджер рекламы не регистрировал обычный или скачанный показ, пока вы вручную не выполните для этого показа запрос ping (для этого нужно добавить Google-Delayed-Impression в заголовок HTTP). Google Менеджер рекламы после запроса ping зарегистрирует обычный и скачанный показы для сервера объявлений.
Чтобы показы не дублировались при подсчете, не связывайте макрос просмотренных показов с креативами, которые были возвращены запросами без тегов.
Способ 2. Используйте макрос просмотренных показов в коде креативов
Если у вас нет доступа к заголовкам HTTP-ответов, вам необходимо сегментировать свой инвентарь и добавить макрос просмотренных показов в код креативов, полученных с помощью запроса без тегов. Он преобразуется в URL, который отправляется креативом при показе.
Как оправить запрос без тегов, чтобы получить код креатива
Веб-контент
Обычно запросы без тегов используются на платформах, не поддерживающих теги или SDK Google. На веб-страницах полученный исходный код будет выполняться только в том случае, если вы загружаете запрос в окне <iframe>.
Как запрашивать код креативов при работе со специальными средами, не поддерживающими Google SDK
Чтобы получить исходный код креатива в среде, в которой не поддерживается SDK или теги Google (например, в случае со сторонней телеприставкой), выполните следующие действия:
- Убедитесь в правильности указания агента пользователя в заголовке
User-Agent, чтобы таргетинг работал корректно. - Убедитесь, что платформа поддерживает мультимедийные технологии, в том числе JavaScript и раскрытие креативов.
- Отправьте HTTPS-запрос в Google Менеджер рекламы.
- Если запрос верен, то Менеджер рекламы возвратит ответ HTTP 200/OK.
Какие функции не поддерживаются при работе с запросами без тегов
- Active View
- Ad Exchange
- Файлы cookie и идентификаторы, используемые мобильными приложениями для отслеживания
- Контейнеры креативов
- Динамическое размещение AdSense, Ad Exchange и Рекламы в приложении
- Показ на нативном инвентаре
- Приоритетные сделки
- Предварительный просмотр креативов
- Выбор рекламы
Теги изображений HTML (<img>), в которых используется элемент gampad/ad, не поддерживают код отслеживания JavaScript и не обеспечивают подсчет скачанных показов.
Создавать отчеты по таким креативам в Менеджере рекламы можно с помощью показателя Общее количество передач кода.
