Макросы

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

Макросы – это особые строки в коде креатива. Менеджер рекламы заменяет их другими значениями или кодом в зависимости от настроек креатива. Если вам понадобится что-то в них изменить, вы сможете просто обновить исходные данные для макроса, не трогая код креатива.

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

Что нужно учитывать при работе с макросами

  • Добавление макросов
    В сторонние креативы или URL тегов VAST макросы добавляются автоматически, если Менеджер рекламы распознает сторонний сервер. В собственные креативы и шаблоны креативов макросы нужно добавлять вручную. Если вы не знаете, в какую часть кода нужно добавить макрос, свяжитесь со своим поставщиком креативов.
     
  • Зарезервированные символы и кодировка URL (кодирование с помощью знака %)
    В Менеджере рекламы зарезервированы некоторые строчные буквы со знаком %:

    %a
    %c
    %h
    %i
    %n
    %p
    %k

    Не используйте такие строки при кодировании URL, так как из-за них при подстановке значений вместо макросов могут возникать ошибки.

Ссылки на описания отдельных макросов

Макросы визуализации
Рекламный блок
Целевой URL
Файловый сервер
Высота и ширина
Соответствие по шаблону
Параметр тега
Новое целевое окно
Целевое окно
Тег контента для детей
Кодировка URI для шаблонов креативов


Макросы отслеживания                
Очистка кеша (случайное число)
Клик
Подстановка значений
Идентификатор устройства (iOS, Android, Roku, tvOS)
Режим предварительного просмотра
Схема
Сайт
Просмотренный показ

Макросы запросов объявлений для соблюдения GDPR
Генеральный регламент ЕС о защите персональных данных (GDPR)
Строка спецификации Transparency & Consent Framework
Режим получения дополнительного согласия
Пользователи из ЕЭЗ и Великобритании, не достигшие минимального возраста согласия


Макросы для видео
URL описания видео
URL перехода для видео


Макросы видеоконтента
Продолжительность видео в миллисекундах
Идентификатор видео
Метаданные видео
Название видео
Специальный идентификатор объявления (FreeWheel)
Категории IAB (FreeWheel)

Развернуть все  Свернуть все

Макросы визуализации

Макросы визуализации обычно используются при показе креатива. Они обеспечивают корректность его оформления и работы.

Рекламный блок
 
Макрос
%%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>

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

Целевой URL
 
Макрос Экранирование
%%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:отображаемое_название_файла%% заменяется полным URL объекта креатива. Макрос этого типа следует использовать для вызова загруженных объектов (например, изображений) в коде собственного креатива.

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

Высота и ширина
 
Макрос
%%HEIGHT%%
%%WIDTH%%
 

Эти макросы позволяют во время показа объявления добавлять в специальный код креатива сведения о высоте и ширине, заданные в Менеджере рекламы в поле "Размер целевого рекламного блока".

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

Соответствие по шаблону
 
Макрос
%%PATTERN:key%%
%%PATTERN:TARGETINGMAP%%
%%PATTERN:url%%
 

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

Макрос "Соответствие по шаблону" может произвести до 100 замен для одного креатива.

Экранирование макроса "Соответствие по шаблону"

Макрос "Соответствие по шаблону" возвращает значение в том виде, в каком оно было получено. Если вы используете этот макрос в одном из полей URL, например в поле "URL тега VAST" или "Сторонний URL отслеживания" в видеокреативе, вам может потребоваться экранированное значение. Для этого нужно использовать тройное экранирование в запросе.

%%PATTERN:key%%

Разберем пример. У вас есть два креатива для определенной позиции: один для женской аудитории, а другой – для мужской. Ключ, используемый в макросе, должен содержать только буквы, цифры и символы подчеркивания (_).

Ниже описано, как работает эта процедура.

  1. С помощью ключей-значений вы передаете в тег креатива нужное значение (в нашем случае это пол):
    googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
    .addService(googletag.pubads())
    .setTargeting("gender", "male");
  2. Затем вам нужно выполнить динамическую подстановку критерия в собственное или стороннее объявление с помощью макроса <some creative script here>...&gender=%%PATTERN:gender%%.
  3. Весь макрос %%PATTERN:gender%% будет заменен значением male (мужчины).
  4. При этом Менеджер рекламы вызовет и покажет пользователю вариант креатива, предназначенный для мужчин.

%%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 для шаблонов креативов
 
Макрос
[%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?
page=home&sport=baseball
[%URI_ENCODE:LandingPage%] https%3A%2F%2Fwww.mysportswebsite.com%3F
page%3Dhome%26sport%3Dbaseball

Макросы отслеживания

Эти макросы чаще всего используются для отслеживания и при создании отчетов.

Блокировка кеша (случайное число)
 
Макрос
%%CACHEBUSTER%%
 

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

Большинство поставщиков предлагают в своих тегах плейсхолдеры для вставки макросов блокировки кеша. Допустим, код файла внешнего объявления содержит такую строку:

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>

Подробнее о макросах с экранированием и без

Проверка реализации макроса отслеживания кликов

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

  1. Запустите предварительный просмотр креатива.
  2. Нажмите на креатив в режиме предварительного просмотра.

В Менеджере рекламы должно появиться подтверждение отслеживания кликов. Если этого не произошло, значит макрос отслеживания кликов реализован неверно.

Подстановка значений
 
Макрос Чем заменяется
%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.

Идентификатор устройства (iOS, Android, Roku и tvOS)
 
Макрос
%%ADVERTISING_IDENTIFIER_PLAIN%% (идентификатор устройства)
%%ADVERTISING_IDENTIFIER_TYPE%% (тип устройства)
%%ADVERTISING_IDENTIFIER_IS_LAT%% (настройка ограничения отслеживания)
 

Макрос %%ADVERTISING_IDENTIFIER_PLAIN%% позволяет разработчикам мобильных приложений отправлять партнерам сбрасываемый рекламный идентификатор (IDFA для iOS, AdID для Android, RIDA для Roku и tvOS для Apple TV), с помощью которого можно подбирать объявления на основе интересов. Так вы сможете легко предоставлять рекламодателям и агентствам доступ по рекламному идентификатору.

С помощью макроса %%ADVERTISING_IDENTIFIER_TYPE%% разработчики мобильных приложений могут отправлять информацию о типе устройств, а с помощью %%ADVERTISING_IDENTIFIER_IS_LAT%% – задействовать настройку ограничения отслеживания объявлений (LAT). Она предоставляет пользователям возможность отказываться от подбора персонализированной рекламы на основе информации об их действиях.

Подробнее о таргетинге на идентификаторы устройств с возможностью сброса по паролю

Требования

  • В приложении должна использоваться последняя версия Google Mobile Ads SDK.
  • Необходимо использовать безопасные креативы, которые поддерживают протокол HTTPS. Данное требование распространяется как на креативы, так и на любые сторонние пиксели, используемые для отслеживания конверсий. Креативы, которые не зашифрованы по протоколу HTTPS, будут обрабатываться, но макрос не будет подставлять значение IDFA/AdID/RIDA/tvOS.

Описание

  1. В Менеджере рекламы необходимо добавить макросы в креатив и/или URL отслеживания.
  2. В макросы добавляется идентификатор IDFA/AdID/RIDA/tvOS, относящийся к пользователю, типу устройства или ограничению отслеживания, который затем включается в креатив при отправке запросов третьей стороне.

    Макрос не сработает, если запрос объявления поступил от приложения для детей (TFCD) или если активировано ограничение отслеживания объявлений (LAT). В таких случаях вместо подстановки значения будет показана пустая строка ("").

Формат

В iOS, Android, Roku и tvOS этот макрос отправляет 32 прописные шестнадцатеричные цифры, разделенные на пять групп дефисами, в формате 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=, связанным с запросом.

Строка спецификации Transparency & Consent Framework
 
Макрос
${GDPR_CONSENT_XXXX}
 

Заменяется на значение строки спецификации Transparency & Consent Framework, связанное с запросом. Макрос не сработает, если строка пуста или недействительна. Этот макрос позволяет передавать строку спецификации TC стороннему поставщику креативов с помощью URL креативов, для которых не используются алгоритмические продажи. Вместо атрибута XXXX укажите идентификатор IAB GVL, присвоенный стороннему поставщику. Если строка спецификации TC пуста или содержит недопустимые данные, макрос не сработает.

Если у стороннего поставщика, связанного с указанным вами идентификатором IAB GVL, нет согласия пользователей, креативы с макросом ${GDPR_CONSENT_XXXX} могут быть заблокированы.

Макрос ${GDPR_CONSENT_XXXX} должен содержаться в URL только в одном экземпляре. Уточните у своего стороннего поставщика требования к передаче строки спецификации TC и ограничения на длину URL. При поступлении подходящих запросов, соответствующих спецификации IAB TCF версии 2.0, вместо этого макроса будет подставлена полная и неизмененная строка TC.

Макросы TCF, присутствующие в HTML-коде креатива HTML5, не срабатывают. Макросы TCF поддерживаются только в медийных креативах с переадресацией и специальных медийных креативах. Для этого используются поля "Сторонний URL" и "Код HTML" соответственно.

Режим получения дополнительного согласия
 
Макрос
${ADDTL_CONSENT}
 

Заменяется значением строки дополнительного согласия, связанной с запросом.

Пользователи из ЕЭЗ и Великобритании, не достигшие минимального возраста согласия
 
Макрос
%%TFUA%%
 

Заменяется единицей, чтобы пометить запрос объявления для пользователей из ЕЭЗ и Великобритании, не достигших минимального возраста согласия.

Макросы для видео

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

Продолжительность видеообъявления в миллисекундах
 
Макрос
%%VIDEO_AD_DURATION%%
 

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

URL описания видео
 
Макрос Экранирование
%%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%%. Изменять код для старых креативов и шаблонов необязательно.
URL перехода для видео
 
Макрос Экранирование
%%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%%. Изменять код старых креативов и шаблонов необязательно.
 
С некоторыми параметрами видео можно использовать макрос Параметр тега – он будет заменяться на значения этих параметров.

Макросы видеоконтента

Такие макросы применяются при работе с объявлениями, таргетинг которых настроен на источники видеоконтента.

Доступно только в Google Менеджере рекламы 360.
Продолжительность видео в миллисекундах
 
Макрос
%%VIDEO_DURATION%%
 

Позволяет указать продолжительность видео в миллисекундах.

Идентификатор видео
 
Макрос
%%VIDEO_ID%%
 

Заменяется уникальным идентификатором, который в системе управления контентом соответствует проигрываемому в настоящий момент видео, или значением dfpvideo:ContentID из MRSS.

Метаданные видео
 
Макрос
%%VIDEO_METADATA:key%%
 

Передает метаданные видеоресурса, в котором отображается креатив (на основе пар "ключ-значение"). Ключи и значения задаются в Менеджере рекламы на вкладке "Видео".

Ключ, используемый в макросе, должен содержать только буквы, цифры и символы подчеркивания (_).

Название видео
 
Макрос Экранирование
%%VIDEO_TITLE%% С однократным экранированием
 

Этот макрос заменяется названием видео, указанным в Менеджере рекламы.

Чтобы использовать этот макрос, нужно включить прием контента.

Доступно только в Google Менеджере рекламы 360.
Специальный идентификатор объявления (FreeWheel)
 
Макрос
%%FW_CAID%%
 

Позволяет указать специальный идентификатор объявления FreeWheel.

Относится только к издателям, использующим FreeWheel для показа видеорекламы.

Категории IAB (FreeWheel)
 
Макрос
%%IAB_CATEGORIES%%
 

Передает рекламные категории креативов, вручную классифицированных с помощью ярлыков. Макрос возвращает разделенный запятыми список применимых стандартных категорий IAB (конвертированных из категорий Google).

Этот макрос могут использовать издатели, которые предоставляют видеоинвентарь для FreeWheel и хотят передавать рекламные категории в качестве специальных параметров. Например, вы можете добавить макрос &iab_categories=%%IAB_CATEGORIES%% в свой тег VAST с переадресацией.

Эта информация оказалась полезной?
Как можно улучшить эту статью?

Требуется помощь?

Войдите в свой аккаунт, чтобы мы могли предоставить вам дополнительные варианты поддержки и быстрее решить вашу проблему.

Поиск
Удалить поисковый запрос
Закрыть поиск
Приложения Google
Главное меню
Поиск по Справочному центру
false
false
true
148
false
false