Макросы – это особые строки в коде креатива. Менеджер рекламы заменяет их на другие значения или код в зависимости от настроек креатива. Если вам понадобится что-то в них изменить, вы сможете просто обновить исходные данные для макроса, не трогая код креатива.
Ниже приводятся рекомендации по работе с отдельными типами макросов, однако вы можете применять их по своему усмотрению. Они могут использоваться в коде самых разных объектов, обрабатываемых сервером объявлений: в сторонних и собственных креативах, объявлениях Креативной студии, URL перехода по клику и тегах объявлений.
Что нужно учитывать при работе с макросами
- Регистр
В макросах учитывается регистр. Например, нужно указывать вариант%%CACHEBUSTER%%, а не%%Cachebuster%%. - Наличие или отсутствие экранирования
Макросы с экранированием и без него заменяются фактическими значениями по-разному. Подробнее о том, как использовать макросы с экранированием и без экранирования… - Добавление макросов
В сторонние креативы или URL тегов VAST макросы добавляются автоматически, если Менеджер рекламы распознает сторонний сервер. В собственные креативы и шаблоны креативов макросы нужно добавлять вручную. Если вы не знаете, в какую часть кода нужно добавить макрос, свяжитесь со своим поставщиком креативов.
При размещении рекламы с помощью шаблона креатива в поле "URL перехода по клику" будет указано значение, только если в шаблоне используется макрос отслеживания кликов. - Зарезервированные символы и кодировка URL (кодирование с помощью знака %)
В Менеджере рекламы зарезервированы некоторые строчные буквы со знаком %:%a
%c
%h
%i
%n
%p
%kНе используйте такие строки при кодировании URL, так как из-за них при подстановке значений вместо макросов могут возникать ошибки.
- Макросы не поддерживаются при работе с прямым автоматизированным размещением
Ознакомьтесь со списком функций, которые доступны в рамках прямого автоматизированного размещения.
Ссылки на описания отдельных макросов
Макросы визуализации
Макросы визуализации обычно используются при отрисовке креатива, обеспечивая его корректную работу и внешний вид.
Рекламный блок| Макрос |
|---|
%%ADUNIT%% |
Макрос рекламного блока при показе креатива вставляет в его код путь к рекламному блоку, полученный из тега Google Publisher Tag.
Ниже показано, как добавить макрос ADUNIT в код стороннего креатива.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
Макрос рекламного блока преобразуется в полный путь к рекламному блоку из исходного запроса объявления и включает в себя код сети. Ниже показано, как путь к рекламному блоку добавляется в код объявления при показе.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Этот макрос работает только с одобренными рекламными блоками, предложенными Менеджером рекламы. Если предложен рекламный блок третьего уровня, то макрос, используемый в коде креатива, заменяется рекламным блоком второго уровня. После одобрения предложенного рекламного блока макрос заменяется на рекламный блок третьего уровня.
| Макрос | Экранирование |
|---|---|
%%DEST_URL_ESC%% |
С однократным экранированием |
%%DEST_URL_ESC_ESC%% |
С двойным экранированием |
%%DEST_URL_UNESC%% |
Без экранирования |
Макрос целевого URL заменяется на URL перехода по клику креатива, который представляет собой URL перехода по клику позиции или переопределенный URL для креатива внутри позиции.
Макросы целевого URL применяются в собственных креативах и шаблонах креативов. Данный макрос может пригодиться, если в коде креатива должен быть URL перехода по клику, и этот URL меняется, когда креатив или шаблон используются в различных позициях.
Есть три вида макросов URL перехода по клику: с однократным экранированием, с двойным экранированием и без экранирования. Обычно выбор типа экранирования (без экранирования, однократное или двойное) зависит от стороннего сервиса отслеживания кликов. Иногда необходимо использовать экранированные URL, но порой это не требуется. Чтобы узнать, какой уровень экранирования требуется стороннему сервису отслеживания, изучите строку click= в теге внешнего объявления или в коде собственного креатива в Менеджере рекламы.
-
click=: однократное экранирование (%%DEST_URL_ESC%%). -
click0=: без экранирования (%%DEST_URL_UNESC%%). -
click1=: однократное экранирование (%%DEST_URL_ESC%%). -
click2=: двойное экранирование (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, который работает аналогично элементу %%DEST_URL_ESC%%. Мы рекомендуем использовать вариант %%DEST_URL_ESC%%, но изменять код старых креативов и шаблонов необязательно.%u или %%DEST_URL%%, то при нажатии на креатив будет выполняться переход на URL с атрибутом xsd:string. Максимальная длина атрибута – 1024 символа.| Макрос |
|---|
%%FILE:file_display_name%% |
Макрос файлового сервера %%FILE:file_display_name%% заменяется полным URL объекта креатива. Этот макрос следует использовать для вызова загруженных объектов (например, изображений) в коде собственного креатива.
Чтобы использовать такой макрос, замените строку file_display_name на название объекта креатива, которое показывается в Менеджере рекламы при просмотре подробной информации о креативе.
| Макрос |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Эти макросы позволяют во время показа объявления добавлять в специальный код креатива сведения о высоте и ширине, заданные в Менеджере рекламы в поле "Размер целевого рекламного блока".
Их удобно использовать в шаблоне, на основе которого затем можно создавать креативы разных размеров. Вместо того чтобы указывать размеры для каждого креатива, внедрите макросы высоты и ширины, которые будут динамически подставлять соответствующие значения.
| Макрос |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Этот макрос позволяет передавать в креатив пользовательские переменные, например значения таргетинга, пары "ключ-значение", заменять строки таргетинга или URL перехода. Так вы сможете показывать рекламу в зависимости от того, какой контент интересен тому или иному пользователю.
Макрос "Соответствие по шаблону" может произвести до 100 замен для одного креатива.
Экранирование макроса "Соответствие по шаблону"
Макрос "Соответствие по шаблону" возвращает значение в том виде, в каком оно было получено. Если вы используете этот макрос в одном из полей URL, например в поле "URL тега VAST" или "Сторонний URL отслеживания" в видеокреативе, вам может потребоваться экранированное значение. Для этого нужно использовать тройное экранирование в запросе.
%%PATTERN:key%%
Разберем пример. У вас есть два креатива для определенной позиции: один для женской аудитории, а другой – для мужской. Ключ, используемый в макросе, должен содержать только буквы, цифры и символы подчеркивания (_).
Ниже описано, как работает эта процедура.
- С помощью ключей-значений вы передаете в тег креатива нужное значение (в нашем случае это пол):
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Затем вам нужно выполнить динамическую подстановку специального значения (пола пользователя) в собственное или стороннее объявление с помощью макроса
<some creative script here>...&gender=%%PATTERN:gender%%. - Весь макрос
%%PATTERN:gender%%будет заменен значениемmale(мужчины). - При этом Менеджер рекламы вызовет и покажет пользователю вариант креатива, предназначенный для мужчин.
%%PATTERN:TARGETINGMAP%%
%%PATTERN:TARGETINGMAP%% заменяет настройки таргетинга и динамически создает теги возврата.
Пример добавления макроса TARGETINGMAP в тег объявления:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Пример того, как пара "ключ-значение" вставляется в код объявления при показе:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Этот макрос создает тег возврата, передающий данные между двумя сетями Менеджера рекламы ("Сеть А" и "Сеть Б").
Пример креатива, зарезервированного в сети А:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Если в сети Б нет кампаний, показ будет возвращен в сеть А, как показано ниже.
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // Параметр noloop предотвращает возникновение бесконечного цикла.
.display();
</script>Макрос TARGETINGMAP в теге возврата передается в запросе на сторонний сервер, что позволяет использовать несколько значений в динамическом креативе.
Пример креатива, зарезервированного в Менеджере рекламы:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
При показе из Менеджера рекламы код выглядит так:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Теперь сторонняя сеть получила доступ к динамически сгенерированным параметрам dfpAdUnit и targeting. Можно создавать следующий тег возврата:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // Параметр noloop предотвращает возникновение бесконечного цикла – см. https://support.google.com/admanager/answer/2811375.
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Для этого необходим шаблон кода, который будет выглядеть примерно так:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Вы также можете использовать специальный ключ url, чтобы подставлять вместо него URL ссылающейся страницы.
Обратите внимание, что url является зарезервированным ключом. Любые пары "ключ-значение" в тегах Менеджера кампаний 360, которые содержат url в качестве названия ключа, будут заменены на URL перехода.
| Макрос |
|---|
%%TAG_PARAM%% |
Макрос %%TAG_PARAM%% можно использовать вместе с параметрами тега объявления. Поддерживаются следующие параметры:
Если этот макрос используется с поддерживаемым параметром, вместо него подставляется значение этого параметра.
Например, %%TAG_PARAM:correlator%% (поддерживается) заменяется значением параметра correlator из тега объявления, тогда как %%TAG_PARAM:ppid%% (не поддерживается) не заменяется никаким значением.
| Макрос |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Макрос %%TARGET_IN_NEW_WINDOW%% указывает, какие настройки целевого окна заданы для рекламного блока, в котором показывается креатив: новое окно (_blank) или другое значение.
-
Если задан параметр
_blank, макрос заменяется значением1. -
Во всех остальных случаях (в том числе если значение не задано) макрос заменяется значением
0.
Макрос %%TARGET_WINDOW%% (целевое окно) позволяет задать фактический размер целевого окна.
| Макрос |
|---|
%%TARGET_WINDOW%% |
Макрос %%TARGET_WINDOW%% заменяется данными целевого окна, соответствующего рекламному блоку, в котором показывается креатив. Этот макрос можно использовать в коде креатива, чтобы указывать, будет ли креатив на различных сайтах открываться в новом окне или в текущем.
Например, в качестве значения целевого окна рекламного блока AdManager_News.com будет указано _top, а для рекламного блока AdManager_Fashion.com будет выбран вариант _new. Если в код креатива включен макрос %%TARGET_WINDOW%%, он будет заменен на _top при показе на сайте AdManager_News.com и _new – на сайте AdManager_Fashion.com.
Пример реализации:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Макрос %%TARGET_IN_NEW_WINDOW%% позволяет задавать в качестве параметра целевого окна значение _blank или использовать аналогичные варианты.
| Макрос |
|---|
%%TFCD%% |
Тег контента для детей (TFCD – tag for child-directed content) позволяет вам сообщить сторонним поставщикам о том, что запрос рекламы поступил со страницы с контентом для детей. Этот макрос помогает соблюдать закон США "О защите личных сведений детей в интернете" (COPPA).
Макрос тега контента для детей можно включать в любые URL переадресации или запросы сторонних креативов, например в формате coppa=%%TFCD%%. Его также можно добавить в код JavaScript, чтобы с помощью тега возврата Google Publisher Tag выбирать для показа креативы, подходящие детям. Макрос заменяется значением 1 для детского контента и 0 для любых других материалов в зависимости от характера страницы, сайта или мобильного приложения, которое отправило запрос в Менеджер рекламы.
Если вы используете рекламные сервисы Google и хотите добавить тег ресурса для детей на уровне сайта или приложения, узнайте, как указать, что сайт или приложение предназначены для детей.
| Макрос |
|---|
[%URI_ENCODE:переменная%] |
Макрос кодировки URI обеспечивает корректное преобразование пробелов и других специальных символов в переменные значения шаблонов креативов для использования в URI, известных также как URL.
Пример
Допустим, в шаблоне вашего креатива задан список переменных под названием Color (цвет) с двумя значениями: dark blue (темно-синий) и light green (светло-зеленый). По умолчанию Менеджер рекламы добавляет в код шаблона строку [%Color%]:
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
При создании креатива вместо [%Color%] подставляется текстовая строка для выбранного элемента. В этом примере текстовые строки содержат пробелы, которые нужно закодировать для корректной работы URL. Чтобы добиться этого, используйте макрос [%URI_ENCODE:Color%].
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Paint!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Этот макрос особенно полезен, если переменная шаблона креатива используется для определения URL перехода по клику или URL переадресации, некорректное кодирование которых может привести к возникновению ошибок.
Пример
Допустим, в шаблоне вашего креатива задана переменная URL под названием LandingPage (целевая страница). По умолчанию Менеджер рекламы добавляет в код шаблона строку [%LandingPage%]:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Click here!</a>
Если URL [%LandingPage%] содержит параметры запроса, например ?page=home&sport=baseball, формат получившегося URL будет некорректным. Это приведет к ошибкам при переадресации. В этом примере текст после амперсанда (&) будет соотнесен с полным URL, а не с URL переадресации. Чтобы избежать этого, используйте макрос [%URI_ENCODE:LandingPage%].
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Click here!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Макросы отслеживания
Эти макросы чаще всего используются для отслеживания и при создании отчетов.
Блокировка кеша (случайное число)| Макрос |
|---|
%%CACHEBUSTER%% |
Макрос очистки кеша нужен для того, чтобы сервер объявлений получал новый запрос при каждом выполнении кода: это обеспечивает точную статистику показов. Если такого макроса в коде креатива нет, то данные о показах, предоставленные Google Менеджером рекламы и сторонним сервером объявлений, могут не совпадать. Обратите внимание, что не все сторонние рекламодатели требуют добавлять этот макрос.
Большинство поставщиков предлагают в своих тегах плейсхолдеры для вставки макросов блокировки кеша. Допустим, код файла внешнего объявления содержит такую строку:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[СЛУЧАЙНОЕ_ЧИСЛО]
Выделите [СЛУЧАЙНОЕ_ЧИСЛО] и нажмите кнопку Вставить макрос CacheBuster, чтобы заменить им этот плейсхолдер:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER, чтобы уменьшить расхождения при использовании в Менеджере рекламы счетчика показов Менеджера кампаний 360.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Макрос блокировки кеша в ответах VAST
Макрос %%CACHEBUSTER%% заменяется одним и тем же случайным числом для всех событий в данном креативе. Это особенно удобно при показе видеообъявлений, так как для всех событий отслеживания видео в ответе VAST будет использоваться одно и то же случайное число.
| Макрос | Экранирование |
|---|---|
%%CLICK_URL_UNESC%% |
Без экранирования |
%%CLICK_URL_ESC%% |
С однократным экранированием |
%%CLICK_URL_ESC_ESC%% |
С двойным экранированием |
Макрос отслеживания кликов заменяется специальным URL, который позволяет отслеживать в Менеджере рекламы клики по сторонним креативам. Обычно такой макрос объединяется с URL перехода по клику креатива в анкере (<a>). Не добавляйте макрос отслеживания кликов в качестве источника изображения или окна iframe. В этом случае клик будет регистрироваться каждый раз, когда показывается изображение или окно iframe. Такая ситуация недопустима, и подобные клики будут исключаться как недействительные.
Используйте %%CLICK_URL_UNESC%% в начале ссылки. Используйте макрос %%CLICK_URL_ESC%%, когда счетчик кликов является параметром другого URL.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">ссылка</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">ссылка</a>
Подробнее о макросах с экранированием и без…
Проверка реализации макроса отслеживания кликов
Если неправильно разместить макрос отслеживания кликов, он не будет работать. Чтобы проверить, будут ли в Менеджере рекламы должным образом регистрироваться клики, выполните следующие действия:
- Запустите предварительный просмотр креатива.
- Нажмите на креатив в режиме предварительного просмотра.
В Менеджере рекламы должно появиться подтверждение отслеживания кликов. Если этого не произошло, значит макрос отслеживания кликов реализован неверно.
| Макрос | Чем заменяется |
|---|---|
%eaid! |
Идентификатор позиции |
%eadv! |
Идентификатор рекламодателя, позиция которого показывается |
%ebuy! |
Идентификатор заказа, позиция которого показывается |
%ecid! |
Идентификатор креатива |
%eenv! |
Индикатор среды разработки (тип тега): i – iframe, j – JavaScript |
%epid! |
Идентификатор рекламного блока, в котором показывается позиция |
%esid! |
Идентификатор рекламного блока высшего уровня по отношению к рекламному блоку, в котором показывается позиция
Это устаревший макрос, поэтому он может некорректно работать с вашей сетью.
|
Макросы этого типа позволяют передавать идентификаторы из Менеджера рекламы при показе креатива на странице. Их можно использовать в коде собственных креативов или в URL перехода по клику. Это позволяет сопоставлять идентификаторы из Менеджера рекламы и собственной базы данных издателя при устранении неполадок и подготовке отчетов.
Если вы используете такие макросы в URL перехода по клику, их можно отделять друг от друга любыми поддерживаемыми символами. Так, строка http://www.site.com/?%eaid!;%ecid! может быть заменена на вариант http://www.site.com/?1234567;4265598.
| Макрос |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (идентификатор устройства) |
%%ADVERTISING_IDENTIFIER_TYPE%% (тип устройства) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (параметр ограничения отслеживания) |
Макрос %%ADVERTISING_IDENTIFIER_PLAIN%% позволяет разработчикам мобильных приложений отправлять партнерам сбрасываемый идентификатор устройства, с помощью которого можно подбирать объявления на основе интересов. Так вы сможете легко обеспечивать рекламодателям и агентствам доступ по рекламному идентификатору.
С помощью макроса %%ADVERTISING_IDENTIFIER_TYPE%% разработчики мобильных приложений могут отправлять информацию о типе устройств, а с помощью %%ADVERTISING_IDENTIFIER_IS_LAT%% – задействовать настройку ограничения отслеживания объявлений (LAT). Она передает сигнал об ограничении отслеживания объявлений с устройства.
Подробнее о таргетинге на идентификаторы устройств с возможностью сброса…
Требования
Необходимо использовать безопасные креативы, которые поддерживают протокол HTTPS. Данное требование распространяется как на креативы, так и на любые сторонние пиксели, используемые для отслеживания конверсий. Креативы, которые не зашифрованы по протоколу HTTPS, будут обрабатываться, но макрос не будет подставлять значение.
Принцип работы
- В Менеджере рекламы необходимо добавить макросы в креатив и/или URL отслеживания.
-
В макросы добавляется идентификатор устройства, относящийся к пользователю, типу устройства или ограничению отслеживания, который затем включается в креатив при отправке запросов на сторонний сервер.
Макрос не сработает, если запрос объявления поступил от приложения для детей (TFCD) или если активировано ограничение отслеживания объявлений (LAT). В таких случаях вместо подстановки значения будет показана пустая строка ("").
Формат
Этот макрос отправляет 32 прописные шестнадцатеричные цифры, разделенные на 5 групп дефисами, в формате 8-4-4-4-12, что в общей сложности составляет 36 символов (32 буквы и цифры, а также 4 дефиса).
Пример: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41.
Ознакомьтесь со списком значений в макросе, которые позволяют передавать сведения о поддерживаемых типах устройств и ограничении отслеживания объявлений (LAT).
| Макрос |
|---|
%%PREVIEW_MODE%% |
Макрос предварительного просмотра можно использовать в коде собственных креативов, чтобы запрещать серверу или сторонним системам регистрировать предварительные просмотры. Макрос заменяется значением true, если выполняется предварительный просмотр креатива в Менеджере рекламы, и false при обычном показе.
| Макрос |
|---|
%%SCHEME%% |
Макрос схемы заменяется значением http: или https: в зависимости от того, какой протокол использует страница, на которой показывается креатив. Его можно поместить в начале URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Макрос |
|---|
%%SITE%% |
Заменяется доменом параметра URL, используемого в теге объявлений, например google.com. С помощью этого макроса можно изменять креативы в зависимости от того, где был сделан запрос. Он не используется при обработке рекламных материалов Ad Exchange, которые помечены как анонимные.
| Макрос | Экранирование |
|---|---|
%%VIEW_URL_ESC%% |
С однократным экранированием |
%%VIEW_URL_UNESC%% |
Без экранирования |
Этот макрос позволяет Менеджеру рекламы регистрировать показ каждый раз, когда креатив скачивается на устройство пользователя и начинается его загрузка. Его следует использовать только во внестраничных креативах.
Отправлять запрос серверу можно разными способами. Мы рекомендуем использовать тег <img>.
<!-- Этот тег img не виден пользователям. Он отправляет через браузер запрос на адрес VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Этот тег img показывает объявление.-->
<img src="[%Imagefile%]" border="0">
Первый тег <img> извлекает изображение размером 1 x 1 из элемента VIEW_URL. Установите для стиля значение display:none, чтобы он был скрыт и не влиял на макет страницы.
Макросы запросов объявлений, обеспечивающие соблюдение регламента GDPR
Эти макросы чаще всего используются в запросах, в отношении которых действует Генеральный регламент ЕС о защите персональных данных (GDPR).
Генеральный регламент ЕС о защите персональных данных (GDPR)| Макрос |
|---|
${GDPR} |
Заменяется значением gdpr=, связанным с запросом.
| Макрос |
|---|
${GDPR_CONSENT_XXXX} |
Заменяется на значение строки спецификации Transparency & Consent Framework, связанное с запросом. Макрос не сработает, если строка пуста или недействительна. Этот макрос позволяет передавать строку спецификации TC стороннему поставщику креативов с помощью URL креативов, для которых не используются алгоритмические продажи.
Вместо атрибута XXXX укажите идентификатор IAB GVL, присвоенный стороннему поставщику. Если строка спецификации TC пуста или содержит недопустимые данные, макрос не сработает.
Если у стороннего поставщика, связанного с указанным вами идентификатором IAB GVL, нет согласия пользователей, креативы с макросом ${GDPR_CONSENT_XXXX} могут быть заблокированы.
Макрос не сработает, если он задействован в теге VAST и у стороннего поставщика нет согласия пользователя.
Макрос ${GDPR_CONSENT_XXXX} должен содержаться в URL только в одном экземпляре. Уточните у своего стороннего поставщика требования к передаче строки спецификации TC и ограничения на длину URL. При поступлении подходящих запросов, соответствующих спецификации IAB TCF версии 2.0, вместо этого макроса будет подставлена полная и неизмененная строка TC.
Макросы TCF, присутствующие в HTML-коде креатива HTML5, не срабатывают. Макросы TCF поддерживаются только в медийных креативах с переадресацией и специальных медийных креативах. Для этого используются поля "Сторонний URL" и "Код HTML" соответственно.
| Макрос |
|---|
${ADDTL_CONSENT} |
Заменяется значением строки дополнительного согласия, связанной с запросом.
| Макрос |
|---|
%%TFUA%% |
Заменяется единицей, чтобы пометить запрос объявления для пользователей из ЕЭЗ и Великобритании, не достигших минимального возраста согласия.
Макросы для видео
Такие макросы обычно используются для того, чтобы включить дополнительные сведения в креатив.
Продолжительность видеообъявления в миллисекундах| Макрос |
|---|
%%VIDEO_AD_DURATION%% |
Позволяет указать продолжительность видеообъявления в миллисекундах. В случае с контейнерами и перенаправлениями VAST макрос заменяется продолжительностью объявления, указанной в Менеджере рекламы.
| Макрос | Экранирование |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Без экранирования |
%%DESCRIPTION_URL_ESC%% |
С однократным экранированием |
%%DESCRIPTION_URL_ESC_ESC%% |
С двойным экранированием |
Макрос %%DESCRIPTION_URL_ESC%% (с однократным экранированием) применяется внутри URL, а %%DESCRIPTION_URL_UNESC%% (без экранирования) – во всех остальных случаях. Подробнее о макросах с экранированием и без него…
В тегах объявлений с переадресацией эти макросы заменяются на URL описания из параметра description_url исходного тега Google Publisher Tag. Как правило, URL описания совпадает с URL перехода. Укажите параметр description_url для тега Google Publisher Tag, если у вас есть вставки, для которых SDK IMA не может точно определить URL страницы, или если вы работаете с видеорекламой в Менеджере рекламы или AdSense для видео.
%%DESCRIPTION_URL%%, назначение которого аналогично макросу %%DESCRIPTION_URL_UNESC%%. Изменять код для старых креативов и шаблонов необязательно.| Макрос | Экранирование |
|---|---|
%%REFERRER_URL_UNESC%% |
Без экранирования |
%%REFERRER_URL_ESC%% |
С однократным экранированием |
%%REFERRER_URL_ESC_ESC%% |
С двойным экранированием |
Макрос %%REFERRER_URL_ESC%% (с однократным экранированием) применяется внутри URL, а макрос %%REFERRER_URL_UNESC%% (без экранирования) – во всех остальных случаях. Подробнее о макросах с экранированием и без него…
Макрос заменяется URL перехода (адресом страницы с видеопроигрывателем). Происходит это так: Менеджер рекламы анализирует параметр запроса URL, выделяет URL перехода и заменяет им макрос. Для этого нужно использовать Google IMA SDK и учитывать следующие условия:
- На странице должен быть активирован доступ к скриптам.
- Макрос не работает в окнах iframe.
%%REFERRER_URL%%, назначение которого аналогично макросу %%REFERRER_URL_UNESC%%. Изменять код для старых креативов и шаблонов необязательно.Макросы видеоконтента
Такие макросы применяются при работе с объявлениями, таргетинг которых настроен на источники видеоконтента.
| Макрос |
|---|
%%VIDEO_DURATION%% |
Позволяет указать продолжительность видео в миллисекундах.
| Макрос |
|---|
%%VIDEO_ID%% |
Заменяется уникальным идентификатором, который в системе управления контентом соответствует воспроизводимому в настоящий момент видео, или значением dfpvideo:ContentID из MRSS.
| Макрос |
|---|
%%VIDEO_METADATA:key%% |
Передает метаданные видеоресурса, в котором отображается креатив (на основе пар "ключ-значение"). Ключи и значения задаются в Менеджере рекламы на вкладке "Видео".
Настроив таргетинг на ключ метаданных видеоконтента, вы можете развернуть его с помощью макроса "Метаданные видео". Ключ, используемый в макросе, должен содержать только буквы, цифры и символы подчеркивания (_).
| Макрос | Экранирование |
|---|---|
%%VIDEO_TITLE%% |
С однократным экранированием |
Этот макрос заменяется названием видео, указанным в Менеджере рекламы.
Чтобы использовать этот макрос, нужно включить прием контента.
| Макрос |
|---|
%%FW_CAID%% |
Позволяет указать специальный идентификатор объявления FreeWheel.
Относится только к издателям, использующим FreeWheel для показа видеорекламы.
| Макрос |
|---|
%%IAB_CATEGORIES%% |
Передает рекламные категории креативов, вручную классифицированных с помощью ярлыков. Макрос возвращает разделенный запятыми список применимых стандартных категорий IAB (конвертированных из категорий Google).
Этот макрос могут использовать издатели, которые предоставляют видеоинвентарь для FreeWheel и хотят передавать рекламные категории в качестве специальных параметров. Например, вы можете добавить макрос &iab_categories=%%IAB_CATEGORIES%% в свой тег VAST с переадресацией.
