--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/support/adfox/en/banners/specs/code-transfer.md - https://yandex.com/support/adfox/ru/banners/specs/code-transfer.md - href: ru/banners/specs/code-transfer.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/adfox/ru/llms.txt # Проброс кода ## Описание {#description3} Проброс кода позволяет установить произвольный HTML-код в контейнер баннера. Если код содержит скрипты, они будут выполнены в контексте страницы. Возможности баннера, доступные при добавлении в Adfox: - в качестве кода может быть установлен как HTML5-код, так и асинхронный код вставки от любой системы управления рекламой; - к размещению принимается HTML-код, который может выходить за пределы контейнера, например, показывающий Fullscreen, Background или баннеры с расхлопом. Особенности формата: - статистика по переходам может учитываться только при размещении [HTML5-кода баннера с учетом требований](#clicksrequirements); - при размещении баннера с кодом вставки статистика по переходам не учитывается. Для размещения кода вставки Adfox с библиотекой context.js воспользуйтесь шаблоном [Проброс кода Adfox [context]](https://yandex.com/support/adfox/ru/banners/specs/adfox-code-transfer.md). ## Требования к коду {#coderequirements} 1. Максимально допустимое количество символов в HTML-коде — 65 000. 1. JavaScript и CSS предпочтительнее размещать внутри HTML-кода баннера. Если итоговый HTML-код превышает максимально допустимый размер, уменьшите его, разместив JavaScript и CSS в отдельных файлах: 1. Сохраните JS и CSS-код в отдельные файлы с расширением .js или .css. 1. Файлы по весу не должны превышать 10 МБ. 1. Загрузите файлы на вкладку **Файлы** рекламной кампании и подключите в HTML-код полученные ссылки на файлы: - Если в проекте прописаны абсолютные ссылки (`src="js/script.js"`, `src="css/style.css"`), то при загрузке проекта Adfox распознает пути к файлам, автоматически загрузит их на вкладку **Файлы** и заменит все ссылки на эти файлы в загружаемом проекте. - Если в проекте прописаны относительные ссылки (например, `src="../js/script.js"`), воспользуйтесь одним из способов: - замените ссылки на файлы `.js` и `.css` на абсолютные — сработает парсинг Adfox и все ссылки будут заменены автоматически; - вручную загрузите файлы `.js` и `.css` на вкладку **Файлы**. Затем получите ссылки на эти файлы в Adfox и поменяйте в HTML-коде относительные ссылки на полученные. Пример подключения JS и CSS-файлов: ```html ``` 1. Можно установить произвольный HTML-код, код вставки Adfox с библиотекой context.js или асинхронный код вставки другой рекламной системы (без функции document.write). {% note info %} Если в HTML-коде, который требуется добавить в Adfox в качестве баннера, присутствует `document.write`, использовать шаблон **Проброс кода [context]** нельзя. В таком случае рекомендуем добавить код через шаблон [Banner HTML5 [context]](https://yandex.com/support/adfox/ru/banners/specs/banner-html5.md). {% endnote %} ## Требования для подсчета переходов в баннере с HTML5-кодом {#clicksrequirements} 1. Подсчет переходов в баннере. Чтобы в Adfox у баннера считалась статистика по переходам, необходимо в HTML-коде в теге `а` для атрибута `href` прописать переменную: `%banner.reference_mrc_user25%` Также для ссылок используйте атрибут `target` с переменной `%banner.target%` в значении атрибута. Если атрибут отсутствует, ссылка откроется внутри iframe, то есть рекламируемый сайт откроется на баннерном месте. Пример HTML-кода для подсчета переходов по баннеру: ```html Сайт рекламодателя ``` 1. Подсчет переходов с нескольких ссылок в баннере. Допустим, в баннере есть несколько ссылок для перехода, ведущих на разные страницы рекламируемого сайта, и по каждой из них нужно получить количество переходов. ```html Первая ссылка Вторая ссылка ``` Замените значения атрибута `href`на переменные `%request.reference_mrc%&pf=%banner.eventN:urlenc%`, где вместо N должен быть номер события с 1 по 28. Например: ```html Первая ссылка Вторая ссылка ``` Соответствие ссылок и переменных нужно сообщить менеджеру, добавляющему баннер в Adfox. Так как при добавлении баннера нужно будет на вкладке **События** указать для События 1 первую ссылку, а для События 2 — вторую ссылку. ## Добавление баннера {#addbanner3} 1. Чтобы добавить баннер с кодом, используйте шаблон **Проброс кода [context]**. 1. Если в типе баннера такой шаблон отсутствует, [добавьте его из предзаданных](https://yandex.com/support/adfox/ru/ad-inventory/settings/template.md#predefined-template). 1. При добавлении баннера укажите параметры: #| || **Параметр** | **Описание** || || **Ссылка на промерочный пиксель** | По умолчанию используется пиксель Adfox `//banners.adfox.ru/transparent.gif`. При необходимости вести учет показов в сторонней системе, удалите пиксель Adfox и укажите другую ссылку. || || **HTML-код вставки** | Вставьте HTML-код. || || **URL перехода** | Укажите ссылку для перехода на сайт рекламодателя при условии, что в HTML-коде выполнены [требования по вставке кода для подсчета переходов](#clicksrequirements). Если HTML-код содержит несколько ссылок на разные страницы рекламируемого сайта, поле **URL перехода** оставьте пустым, а ссылки укажите на вкладке **События** после добавления баннера. Для корректной работы перехода обязательно проверьте наличие протокола в ссылке (`http://` или `https://`). || || **Имя атрибута class контейнера баннера** | При необходимости укажите имя (или несколько имен через пробел) для атрибута `class` контейнера с баннером. || || **Настройка рекламной метки**: - **Метка рекламы** - **Домен** | {% note info %} Если баннер имеет [sticky-формат](*sticky), добавьте вручную в код своего блока верстку для метки «Реклама». Не рекомендуем включать метку «Реклама» в параметрах баннера в Adfox. {% endnote %} {% include [ad-label-add-menu](../../_includes/labeling/ad-label/ad-tag-settings.md) %} || || **Добавить рекламное меню** | Чтобы добавить токен на некликабельный баннер, в настройках баннера включите опцию **Добавить рекламное меню**. При показе баннера на нем будет отображаться значок меню ![](../../_images/kebab.png) в правом верхнем углу. По клику на значок откроется информация о рекламодателе и кнопка для копирования токена (если для баннера включена маркировка или указан сторонний токен). В рекламном меню находится ссылка на правила применения рекомендательных технологий. Она необходима, чтобы соблюсти требования п. 3 ч. 1 ст. 10.2-2 Федерального закона от 27.07.2006 N 149-ФЗ «Об информации, информационных технологиях и о защите информации». {% note info %} Если баннер некликабельный (поле **URL перехода** не заполнено) и подлежит маркировке, вы можете включить рекламное меню: так токен будет доступен при показе баннера. {% endnote %} || || **Маркировка рекламы** | Раздел **Маркировка рекламы** доступен, только если в настройках рекламной кампании выбран порядок маркировки **Передавать данные в ЕРИР**. Заполните поля в этом разделе, чтобы [зарегистрировать креатив в ОРД Яндекса](https://yandex.com/support/adfox/ru/labeling/token.md). Токен будет присвоен креативу автоматически. || |# ## Добавление баннера по умолчанию {#defoltbanner} 1. Чтобы добавить баннер по умолчанию с произвольным HTML-кодом, [воспользуйтесь генератором кода](https://yandex.ru/promo/yan/adfox-specs/default-generator/). 1. Выберите тип кода **Сторонний код вставки** и вставьте HTML-код в поле для ввода кода. 1. Добавьте при необходимости промерочные пиксели. 1. Скопируйте полученный код и установите его в поле **Код** с типом **JavaScript**. Пример размещения стороннего кода: ![](../../_images/banners/default.transfer_any_2.png =500x){style="border: solid 1px #cccccc; max-width=500px"} ## Обратиться в службу поддержки Написать в чат Написать письмо [*sticky]: Баннер фиксируется в окне браузера и сопровождает пользователя при прокрутке страницы. {% included (../../_includes/labeling/ad-label/ad-tag-settings.md) %} В списке **Метка рекламы** выберите `Реклама` или `Соцреклама` — на баннер будет добавлена метка. Если метка уже есть в дизайне креатива, в выпадающем списке можно оставить значение `Отключена`. {% note info %} Добавление метки «Соцреклама» не определяет креатив как социальную рекламу. Чтобы креатив был маркирован как социальная реклама в ЕРИР, необходимо выбрать опцию **Договор социальной рекламы с оплатой** или **Договор социальной рекламы по квоте** в соответствующем [договоре с конечным рекламодателем](../../../labeling/token.md#step-2). {% endnote %} В поле **Домен** укажите домен рекламодателя — он будет добавлен в метку: «Реклама \| example.com» или «Соцреклама \| example.com» (только если в выпадающем списке выбрано значение `Реклама` или `Соцреклама`). {% endincluded %}