Получение кода вставки

Коды вставок с уровня сайта

Код вставки с уровня сайта необходимо получить один раз для площадки и установить на все страницы сайта.

При использовании кодов с уровня сайта в интерфейсе Adfox создается логическая структура вашего сайта, включающая в себя деление сайта на разделы и обозначение рекламных площадок в каждом разделе. Разделы имеют шаблоны страниц, которые описывают диапазон URL адресов, входящих в этот раздел.

В интерфейсе Adfox вы можете проверить, к какому разделу сайта в Adfox будет относиться та или иная страница.

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

Укажите параметры кода:

Тип баннера — должен соответствовать типу баннера, указанному для площадки, для которой в данный момент идет получение кода вставки.
Расположение — должно соответствовать расположению площадки, для которой в данный момент идет получение кода вставки.
Разделитель параметров — выберите, какой разделитель параметров будет использоваться в коде вставки.
Вид кода — определяет способ работы кода на странице:
- Асинхронный — производит асинхронную загрузку баннеров;
- Адаптивный — подходит для сайтов с адаптивной версткой.
Количество кодов вставки (опционально) — укажите число рекламных мест на странице сайта, на которых должны показываться баннеры, размещенные на данной площадке. Для каждой копии кода будет сгенерирован разный containerId, чтобы на каждом рекламном месте была показана реклама.

Для одной загрузки страницы по копиям кодов от одной площадки могут быть повторы баннеров. Если нужно избежать повторов, используйте неповторяющиеся баннеры и кампании.
Добавить InPage-параметры (только для баннеров безразмерного типа) — нажмите, чтобы задать параметры InPage-видео.
Список параметров
- Элемент, после которого показывать плеер (по умолчанию undefined) — CSS-селектор, применяемый глобально (document.querySelectorAll), вычисляемый список элементов, после которых может быть вставлен блок InPage, например: #article p.
- Позиция элемента в списке (по умолчанию 0) — позиция элемента в списке, после которой нужно вставлять блок InPage. Может быть задана в процентах (от количества выбранных элементов) или в абсолютных цифрах, например: 50% или 5. Если абсолютное число больше длины списка элементов, блок будет вставлен последним элементом.
Следующие настройки применяются только для кампаний с прямыми продажами. Параметры рекламы РСЯ настраиваются в партнерском интерфейсе РСЯ. Подробнее о подключении монетизации РСЯ.
- Залипание баннера (по умолчанию опция выключена) — настройка фиксации баннера при прокрутке страницы.
- Зона залипания баннера (по умолчанию auto) — выбор зоны прилипания баннера:
  - top — при прокрутке страницы вверх баннер фиксируется в верхней части экрана. Когда страница прокручивается вниз, баннер возвращается в исходное положение.
  - bottom — при прокрутке страницы вниз баннер фиксируется в нижней части экрана. Когда страница прокручивается вверх, баннер возвращается в исходное положение.
  - bottom-right — при прокрутке страницы вниз баннер фиксируется в правой нижней части экрана в отдельном окне. Когда страница прокручивается вверх, баннер возвращается в исходное положение.
  - bottom-left — при прокрутке страницы вниз баннер фиксируется в левой нижней части экрана в отдельном окне. Когда страница прокручивается вверх, баннер возвращается в исходное положение.
  - top-right — при прокрутке страницы вверх баннер фиксируется в правой верхней части экрана в отдельном окне. Когда страница прокручивается вниз, баннер возвращается в исходное положение.
  - top-left — при прокрутке страницы вверх баннер фиксируется в левой верхней части экрана в отдельном окне. Когда страница прокручивается вниз, баннер возвращается в исходное положение.
  - auto — при прокрутке страницы вниз баннер фиксируется в нижней части экрана. Когда страница прокручивается вверх, баннер фиксируется в верхней части экрана.
- Цветовая схема развёрнутого баннера (по умолчанию light) — настройка фона зоны прилипания баннера. Доступна для способов прилипания баннера bottom, top и auto:
  - light — светлый фон;
  - dark — темный фон.
- Повторное воспроизведение видео — если вы хотите, чтобы видео проигрывалось повторно, добавьте вручную в код вставки параметр replayModeсо значением auto (автоматический повтор видео) или manual (плеер покажет экран с кнопкой Повторить).

Примечание

Вы можете изменить значение атрибута id для div и containerId, но оно должно быть одинаковым. Эти атрибуты нужны для идентификации контейнера с рекламой и запроса рекламы, но при этом не влияют на сам запрос. Остальные параметры (owner_id и params) — постоянные, изменить их нельзя.

Коды вставок с уровня площадки

Код вставки с уровня площадки принадлежит определенному разделу сайта. Вы задаете в интерфейсе логическую структуру вашего сайта (разделы, площадки), затем вручную, взяв коды с уровня площадок в каждом разделе сайта, размещаете эти коды на соответствующие места в реальных разделах вашего сайта.

Такой код необходимо вставить именно в тот раздел сайта, где планируется показ рекламы.

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

Откройте вкладку Инвентарь основного меню. Выберите сайт и перейдите на вкладку Разделы → Площадки. Для получения кода вставки нажмите Код вставки рядом с нужной площадкой.

В появившемся окне укажите параметры кода.

Вид кода — определяет способ работы кода на странице:
- Асинхронный — производит асинхронную загрузку баннеров;
- Адаптивный — подходит для сайтов с адаптивной версткой.
Количество кодов вставки (опционально) — укажите число рекламных мест на странице сайта, на которых должны показываться баннеры, размещенные на данной площадке. Для каждой копии кода будет сгенерирован разный containerId, чтобы на каждом рекламном месте была показана реклама.

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

Подробнее о видах кода.
Добавить InPage-параметры (только для баннеров безразмерного типа) — нажмите, чтобы задать настройки InPage-видео. Список параметров приведен в описании кода вставки с уровня сайта.

Примечание

Параметры, настраиваемые в интерфейсе (ранее настройки осуществлялись в параметрах кода вставки):

Тип кода (обычный, сессия, неповторяющиеся баннеры или кампании);
Ограничение по частоте на уровне площадки.

Особенности работы кода вставки с этого уровня:

По коду вставки можно показать только тот баннер, от которого получен код.
Другие баннеры, размещенные на этой же площадке, не могут быть выбраны для показа по этому коду.
Если баннер, от которого получен код, не сможет быть показан (например, баннер не активен), в ответ придет заглушка.
Баннер может быть размещен на нескольких площадках, но статистика будет идти только по той площадке, от которой был получен код вставки.
При запросе не проверяются Шаблоны страниц, указанные в параметрах раздела.
С уровня размещения баннера также можно получить ссылку на пиксель и на переход для промера статистики.

Чтобы получить код вставки, откройте вкладку Кампании основного меню. Выберите параметры, настраиваемые в интерфейсе (ранее настройки осуществлялись в параметрах кода вставки), кампанию и перейдите на вкладку Баннеры → Размещение. У нужного размещения нажмите Код вставки. В появившемся окне укажите параметры кода.

Открывать ссылку (параметр только для стандартных типов баннеров) — выберите, где браузер будет открывать ссылку на сайт рекламодателя — в новом окне браузера или в текущем.
Разделитель параметров — выберите, какой разделитель параметров будет использоваться в коде вставки.
Вид кода — определяет способ работы кода на странице:
- Асинхронный — производит асинхронную загрузку баннеров;
- Адаптивный — подходит для сайтов с адаптивной версткой.
Подробнее о видах кода.
Добавить InPage-параметры (только для баннеров безразмерного типа) — нажмите, чтобы задать настройки InPage-видео. Список параметров приведен в описании кода вставки с уровня сайта.

Примечание

Требования к контейнеру для кода вставки

Для корректного вызова рекламы контейнер должен соответствовать условиям:

У контейнера или его родительских элементов должен отсутствовать стиль display:none, иначе библиотека context.js не сможет определить его размеры.
У контейнера и родительского элемента можно измерить размеры.

Обратите внимание, что если у родительского элемента размеры есть, но внутри него есть несколько вложенных элементов без размеров, то размер контейнера будет определен как 0 × 0. В этом случае задайте размеры контейнера с помощью атрибутов width или height(max-height) и проверьте, что у всех вложенных элементов указаны размеры.

Процесс проверки размеров контейнера

Перед отправкой запроса рекламы библиотека context.js анализирует размеры контейнера с кодом вставки. Запрос будет отправлен, только если возможно измерить размеры контейнера.
Если измерить контейнер не удалось, то библиотека context.js передаст в консоль браузера ошибку CONTAINER_IS_HIDDEN и будет ожидать:
- достраивания DOM (Document Object Model);
- применения стилей с размерами к контейнеру.
После этого будет отправлен запрос к рекламному серверу.