Как загрузить код креатива с помощью запроса без тегов

Запрос без тегов можно использовать вместо тега объявления, чтобы получить исходный код креатива, показ которого выполняется в Менеджере рекламы. Такие запросы обычно создаются, если необходимо выполнять специальную обработку и показ, например при размещении рекламы на телеприставках и прочих платформах, не поддерживающих теги или SDK Google.

Когда вы отправляете запрос без тегов, Менеджер рекламы возвращает только код креатива, не показывая объявление. Если оно не будет найдено, придет сообщение 200/OK и пустой ответ.

Чтобы демонстрировалось объявление и осуществлялось отслеживание показов, в приложении, проигрывателе или на сайте должен выполняться специальный код.

Запросы без тегов не следует использовать для показа рекламы в электронной почте. Ознакомьтесь с информацией о том, какие функции не поддерживаются.

Как создать запрос без тегов вручную

Запрос без тегов должен создаваться на основе базового URL, в который вы добавили все обязательные и подходящие необязательные параметры. Используйте их, чтобы указать различные сведения о запросе, например задать рекламный блок, размер креатива, пары "ключ-значение" и т. д.

Для безопасности используйте протокол SSL (https://).

Создайте базовый URL

Используйте следующий базовый URL: https://securepubads.g.doubleclick.net/gampad/adx?

Укажите параметры запроса

Обязательные параметры

Параметр	Описание
iu	Код рекламного блока в сети Google Менеджера рекламы, включающий код вашей сети Google Менеджера рекламы. Чтобы разделить блоки на уровни, используйте косую черту (/). Пример iu=/123/homepage iu=/456/sports/baseball При работе с Инструментом управления клиентами (MCM) и запросами без тегов в коде сети рекомендуется использовать структуру parent,child. Пример (MCM) iu=/123,456/homepage
sz	Задает размер креатива. Если размеров несколько, их нужно разделять вертикальной линией (|). Пример Для одного размера: sz=320x50, для разных размеров: sz=320x50|300x50. Рекомендуем вместо вертикальной линии (|) использовать код %7c, Пример Вместо &sz=216x36|300x50|320x50 указывайте &sz=216x36%7c300x50%7c320x50.
url	URL домена, к которому относится исходный запрос объявления. Указывать этот URL обязательно только для запросов из MCM. Пример url=www.example.com
c	Параметр корреляции или очистки кеша. Это случайное число (буквы использовать запрещено), которое создается издателем для вызова сервера объявлений при каждой загрузке страницы, что обеспечивает корректный подсчет показов. Пример c=8362527364
tile	Определяет положение тега объявления на странице. Значение должно быть уникальным целым числом. Для простоты рекомендуем использовать последовательно увеличивающиеся числа. Этот параметр необходим лишь в том случае, если несколько тегов объявлений на одной странице используют один и тот же код рекламного блока (iu=) и параметр корреляции (c=). Пример https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Необязательные параметры

Параметр	Описание
d_imp	Включает и выключает отложенные показы. Если параметр включен, подсчет показов прекращается. После этого для их регистрации используется макрос просмотренных показов в возвращенном креативе или значение параметра d_imp_hdr. Пример d_imp=1 d_imp=0 (значение по умолчанию для подсчета показов Google Менеджера рекламы)
d_imp_hdr	Включает и выключает передачу информации об отложенных показах в заголовке. Если параметр включен, URL просмотра, который используется для подсчета показов, возвращается в заголовке HTTP. По умолчанию эта информация в заголовке не определена. Издателю нужно будет вручную выполнить запрос ping для этого URL просмотра, чтобы показ был засчитан. Подробнее об учете количества показов и запросах без тегов… Заголовок Google-Delayed-Impression содержит URL показов Google Менеджера рекламы. Заголовок Google-3rdParty-Delayed-Impression содержит URL сторонней службы отслеживания показов (если он есть в креативе). Пример d_imp_hdr=1 d_imp_hdr=0 (явным образом отключает передачу информации об отложенных показах в заголовке)
t	Пары "ключ-значение" на уровне рекламного места. Каждый ключ и его значения разделяются знаком равенства (=), а их пары – знаком амперсанда (&). Каждая пара "ключ-значение" должна быть преобразована в кодировку URL, после чего аналогичным образом конвертируется вся строка. Все ключи в парах "ключ-значение" должны быть уникальными. Если один ключ используется несколько раз, будет учитываться только одно из связанных с ним значений. Пример Параметр t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith присваивает ключу genre значение action, а ключу movie – значение Mr & Mrs Smith. Обратите внимание, что знак & однократно кодируется (%26), когда он разделяет пары "ключ-значение", и двукратно кодируется (%2526), когда он используется внутри значения. Используйте excl_cat в качестве специального ключа для конкурентных исключений. Пример t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines В ключах и значениях нельзя использовать следующие символы: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Пробелы можно использовать в значениях (их нужно заменять строкой %20 или знаком +), но не в ключах. Пример Запрос t=a%3Db%252Bc, в котором ключу a присваивается значение b+c, обрабатываться не будет.
m	Устанавливает тип MIME в заголовке HTTP. Пример m=text/wml
mob	Указывает на мобильное устройство как источник запроса объявления. Пример mob=js (это единственное допустимое значение)
ppid	Идентификатор, назначаемый издателем (PPID), – это уникальная комбинация символов, которую вы отправляете в Google Менеджер рекламы. Она используется для ограничения частоты показов, сегментирования аудитории, таргетинга, последовательной ротации объявлений и других методов управления рекламой на разных устройствах. Пример ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Сведения о ширине экрана мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример u_w=1024
u_h	Сведения о высоте экрана мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример u_h=768
submodel	Сведения о модели мобильного устройства, которые приоритетны по отношению к данным, полученным автоматически. Пример submodel=iPhone4%2C1 (запятая, отделяющая значение модификации определенной модели, кодируется) Значения модификаций iPhone (первое поколение): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iPhone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iPhone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM и LTE): iPhone5,1 iPhone 5 (CDMA и LTE): iPhone5,2 iPhone 5c (GSM и CDMA): iPhone5,3 iPhone 5c (GSM и CDMA): iPhone5,4 iPhone 5s (GSM и CDMA): iPhone6,1 iPhone 5s (GSM и CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6S: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2 iPod (первое поколение): iPod1,1 iPod (второе поколение): iPod2,1 iPod (третье поколение): iPod3,1 iPod (четвертое поколение): iPod4,1 iPod (пятое поколение): iPod5,1 iPad (первое поколение, Wi-Fi): iPad1,1 iPad (первое поколение, AT&T): iPad1,2 iPad (второе поколение, Wi-Fi): iPad2,1 iPad (второе поколение, AT&T): iPad2,2 iPad (второе поколение, Verizon): iPad2,3 iPad (второе поколение, Wi-Fi): iPad2,4 iPad (третье поколение, Wi-Fi): iPad3,1 iPad (третье поколение, Verizon): iPad3,2 iPad (третье поколение, AT&T): iPad3,3 iPad (четвертое поколение, Wi-Fi): iPad3,4 iPad (четвертое поколение, AT&T): iPad3,5 iPad (четвертое поколение, Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM и LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA и LTE 1, 3, 5, 13, 25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Сбрасываемый идентификатор устройства можно использовать для ограничения частоты показов и настройки таргетинга на целевую аудиторию. Подробнее о том, как настроить такой идентификатор для запросов без тегов…

Как активировать отслеживание показов

При работе с запросами без тегов в Менеджере рекламы можно регистрировать скачанные показы, которые также называются отложенными. Для этого используйте один из способов ниже (но не оба одновременно, поскольку это может привести к двойному или тройному учету показов).

Мы рекомендуем указанный ниже способ 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 и не допускают подсчет скачанных показов.

Создавать отчеты по таким креативам в Менеджере рекламы можно с помощью показателя Общее количество передач кода.