Руководство по реализации вставки на стороне сервера

Эта функция работает только в сетях, с которыми напрямую сотрудничает менеджер аккаунта Google. В вашей сети она может быть недоступна. За дополнительной информацией обращайтесь к менеджеру своего аккаунта. Если у вас нет менеджера аккаунта, то в вашей сети эта функция недоступна.

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

1. Отправьте инструкции по интеграции своему партнеру по технологиям, который выполняет вставку на стороне сервера

Чтобы Менеджер рекламы мог выполнять аутентификацию сторонних серверных вызовов (например, от инструментов или поставщиков, которые выполняют динамическую вставку объявлений), сторонние серверы должны подключаться к серверам Менеджера рекламы с использованием SSL-сертификата, выпущенного этим сервисом.

Попросите партнера по технологиям на стороне сервера выполнить действия, описанные на этой странице.

Менеджер кампаний 360 также требует использования SSL-сертификата при работе с запросами объявлений на стороне сервера. Если с помощью серверных вызовов планируется запрашивать видеокреативы, то ваш партнер должен следовать инструкциям по интеграции Менеджера кампаний 360.

2. Создайте серверный тег объявления

Издатели, использующие сторонние серверы для отправки запросов объявлений в Менеджер рекламы, должны создать тег видеообъявления одним из следующих двух способов:

Сгенерировать его в интерфейсе Менеджера рекламы

Подробнее о том, как создать тег видеообъявления в Менеджере рекламы…

Вручную создать URL для тега видеообъявления

Ознакомьтесь со списком обязательных и необязательных параметров URL, которые поддерживаются в тегах видеообъявлений VAST, а также с дополнительными требованиями, которые нужно соблюдать при отслеживании просмотров, конверсий и кликов.

URL для серверных тегов объявлений, использующие пути /gampad/ads или /gampad/live/ads, должны относиться к домену serverside.doubleclick.net вместо pubads.g.doubleclick.net. Возможно, вам придется изменить URL вручную.

3. Сгенерируйте запрос объявления на стороне сервера

После создания тега партнеру, который отправляет серверный запрос в Менеджер рекламы, необходимо выполнить следующие действия:

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

  В значении параметра ssss учитывается регистр. Если издателю присваивается значение examplesource, то передать нужно вариант ssss=examplesource, а не ssss=ExampleSource.
  Поставщики технологии совмещения видео, использующие межсерверную интеграцию, получают это значение от Google и могут сообщить его вам. По всем вопросам, связанным со значением этого параметра, обращайтесь к менеджеру вашего аккаунта Google.

• Динамически передать IP-адрес с устройства клиента. Это можно сделать с помощью заголовка X-Forwarded-For или указать адрес как значение параметра ip в запросе Менеджера рекламы. Используйте только один из этих методов, а не оба одновременно.

  Если не передать полный IP-адрес клиентского устройства одним из указанных выше методов, это может привести к ошибкам с показом рекламы.

• Передать полные HTTP-заголовки с клиентского устройства или из клиентской среды, в том числе:

  • User-Agent. Это должна быть полная строка, переданная браузером пользователя. Менять ее нельзя. В случае с мобильными объявлениями, отрисовка которых выполняется в WebView или встроенных мобильных браузерах, пересылается строка, полученная мобильной платформой из WebView или браузера (например, в iOS это может быть Mobile Safari). Если отрисовка объявлений выполняется в оригинальном мобильном приложении, заголовок User-Agent должен соответствовать Руководству для мобильных приложений.

    Строки, сгенерированные классами подключения URL мобильной платформы (например, Dalvik в Android или CFNetwork в iOS), недействительны.

  • Accept-Encoding. Для этого параметра должно быть задано значение gzip,deflate. Тогда Менеджер рекламы будет выполнять сжатие ответов. Это обязательная процедура, поскольку без нее объем ответов будет в 20 раз больше.

Единственный заголовок, который не следует пересылать в запросе объявления на стороне сервера, – это заголовок файла cookie.

Дополнительные требования, которые нужно выполнять при регистрации просмотров, конверсий и кликов

Настоятельно рекомендуется отправлять все просмотры и конверсии со стороны клиента, а не сервера. Издатели должны отправлять со стороны клиента запросы ping, информирующие о выполнении показов и конверсий. В исключительных случаях издателям может быть предоставлена возможность регистрировать просмотры, конверсии и клики на стороне сервера.

Если ваша система предполагает отправку просмотров, конверсий и кликов с сервера, вам необходимо включить параметр ipe=ssb в исходные запросы объявлений, которые отправляются из серверной среды.

Какие ещё требования нужно соблюдать, чтобы Менеджер рекламы мог обрабатывать запросы объявлений и конверсии при использовании вставки на стороне сервера:

• Передавайте информацию обо всех событиях просмотров, конверсий и кликов в том порядке, в котором они произошли. Например, не отправляйте событие клика раньше, чем событие показа, поскольку пользователь не может нажать на объявление, которое ещё не было ему показано.
• Не отправляйте события в составе пакета. Высылайте их сразу же после того, как они были зарегистрированы.

Этот трафик действителен только для запроса на резервирование и не будет аккредитован MRC, если иное не указано в условиях соглашения о бета-версии.