Макросы, поддерживаемые в Дисплее и Видео 360

Все макросы, поддерживаемые в Дисплее и Видео 360, приведены в таблице ниже. Подробнее о том, как работать с макросами…

Ограничения

• Макросы Дисплея и Видео 360 не поддерживаются в объявлениях YouTube и креативах на основе данных.
• Динамические креативы из Креативной студии поддерживают только макросы, которые используются в парах "ключ-значение" мест размещения Менеджера кампаний 360. Если вы добавите макросы в URL целевых страниц непосредственно в креативах указанного типа, эти макросы не будут разворачиваться.

Макросы показа объявлений

Макрос	Описание
${CACHEBUSTER}	Этот макрос вставляет случайное число в URL запроса объявления, что предотвращает показ кешированного объявления, если пользователи вернутся на данную страницу.
${CLICK_URL} ${CLICK_URL_ENC} ${CLICK_URL_ENC_ENC}	С помощью этих макросов Дисплей и Видео 360 добавляет URL отслеживания кликов. Версии ENC и ENC_ENC создают такой URL в кодированном и дважды кодированном форматах соответственно. URL отслеживания кликов содержат сведения, связанные с определенным аукционом. Когда пользователь нажимает на креатив, информация об этом сначала поступает на сервер объявлений Дисплея и Видео 360, что позволяет зарегистрировать клик и связанную с ним информацию об аукционе. Только после этого происходит перенаправление на URL издателя. Макрос отслеживания кликов можно установить равным переменной отслеживания кликов креатива или вставить перед внутренним URL перехода по клику креатива. Эти макросы могут заменять заполнитель, например [CLICK], или следуют за фрагментом &click= в URL. Обратите внимание, что эти макросы не будут работать с креативами, которые размещаются с помощью Дисплея и Видео 360.
${CLICK_POINTROLL}	Добавляет URL отслеживания кликов для тегов PointRoll и является закодированным (по аналогии с описанным выше макросом ${CLICK_URL_ENC}).
${DC_DBM_TOKEN}	Предотвращает двойной учет показов при использовании отслеживающего объявления Менеджера кампаний 360 наряду с тегами внешних объявлений в контейнере.
${ifdbm:ваше_собственное_значение}	Этот макрос используется в динамических креативах Google Merchant Center для вставки пользовательского значения. Это значение указывает на то, что объявление было предоставлено сервисом "Дисплей и Видео 360". Предположим, мы добавили макрос {ifdbm} в следующий URL: http://www.newurl.com/product.htm?source={ifdyn:GDN}{ifpla:Shp123}{ifdbm:DiD} В этом случае, если клик по объявлению был связан с показом динамического объявления через сервис "Дисплей и Видео 360", URL примет следующий вид: http://www.newurl.com/product.htm?source=DiD Если клик был выполнен по объявлению, показанному в контекстно-медийной сети Google, URL примет вид: http://www.newurl.com/product.htm?source=GDN Если же клик получен в результате показа товарного объявления, URL будет изменен следующим образом: http://www.newurl.com/product.htm?source=Shp123

Макросы, связанные с аукционом

Макрос	Описание
${ADSTXT_AD_SYSTEM_DOMAIN}	Возвращает домен, связанный с рекламным сервисом. Этот макрос можно использовать вместе с макросом ${ADSXT_PUBLISHER_ID}, чтобы проверять, поступает ли определенный показ от авторизованного продавца. Если в домене, к которому относится инвентарь, отсутствует файл ads.txt, то возвращается пустая строка.
${ADSXT_PUBLISHER_ID}	Позволяет получить идентификатор издателя, указанный в запросе ставки. Этот макрос можно использовать вместе с макросом ${ADSTXT_AD_SYSTEM_DOMAIN}, чтобы проверять, поступает ли определенный показ от авторизованного продавца.
${AUCTION_ID}	Этот макрос вставляет уникальный идентификатор аукциона в URL. При каждой загрузке макроса будет использоваться новое число. Макрос позволяет сделать все исходящие запросы уникальными. В результате каждому вызову объявления соответствуют уникальные запросы и отклики. Макрос идентификатора аукциона или блокировки кеша часто заменяет такие заполнители, как [CACHEBUSTER] или [TIMESTAMP].
${BUNDLE_ID}	Возвращает идентификатор приложения, связанного с запросом ставки, если он известен. Формат зависит от платформы. Например, в Android идентификатор обычно представляет собой название пакета, такое как com.foo.mygame, а в iOS – набор цифр.
${CAMPAIGN_ID}	Возвращает идентификатор позиции, которая осуществляет показ.
${CREATIVE_ID}	Возвращает идентификатор показанного креатива.
${EXCHANGE_ID}	Возвращает идентификатор аукциона, связанного с запросом ставки.
${INSERTION_ORDER_ID}	Возвращает идентификатор заказа на размещение, с которым связан выполненный показ.
${INVENTORY_SOURCE_EXTERNAL_ID}	Возвращает идентификатор сделки, с которой связана ставка, выигравшая аукцион.
${PIXEL_ID_COMMA} Поддержка прекращена 1 июля 2020 г.	С 1 июля 2020 г. этот макрос больше не поддерживается и не разворачивается.
${PUBLISHER_ID}	Возвращает идентификатор аукциона, связанного с запросом ставки. Исключение составляет Verizon Media Exchange – в этом случае макрос возвращает идентификатор издателя Verizon Media Exchange.
${SOURCE_URL}	Возвращает URL, связанный с запросом ставки, если он известен.
${SOURCE_URL_ENC}	Возвращает закодированный URL, связанный с запросом ставки, если он известен.
${UNIVERSAL_SITE_ID}	Возвращает идентификатор сайта, связанного с запросом ставки.

Макрос спецификации TCF

Спецификация IAB TCF версии 2.0 поддерживает добавление макросов в теги креативов. С помощью макроса указывается, куда в URL следует вставить строку TC для передачи, а также определяется наличие поставщиков услуг. Рекламодателям, желающим использовать спецификацию IAB TCF версии 2.0, рекомендуется проверить, могут ли их поставщики пикселей поддерживать макросы, перечисленные ниже. Подробнее…

Макрос	Описание
${GDPR}	0 – трафик из региона, на который не распространяется Генеральный регламент ЕС о защите персональных данных (GDPR). 1 – трафик из региона, на который распространяется регламент GDPR.
${GDPR_CONSENT_xxxxx}	xxxxx – числовой идентификатор поставщика, получающего строку TC в запросе ставки.
${ADDTL_CONSENT}	ADDTL_CONSENT – разделенный точками список идентификаторов поставщиков рекламных технологий Google, на работу с которыми дал согласие пользователь.