Макросы Менеджера кампаний 360
Информация об использовании различных типов макросов Менеджер кампаний 360 представлены в специальном руководстве.
-
Таблицу ниже можно отфильтровать. Например, введите "отслеживающие объявления", чтобы увидеть все макросы, которые в них поддерживаются.
-
Подробная информация о каждом макросе доступна по справочной ссылке.
Macro | Name | Works in | Help link |
---|---|---|---|
Макрос строки клика | %c | код объявления. | Подробнее... |
Макрос замены | %e | URL перехода, объявления для отслеживания, URL переадресации, код креатива (любого типа), теги показов, теги кликов, источник значка поведенческой рекламы. Теги Floodlight поддерживают только макрос %ers! . Объявления для отслеживания кликов не поддерживают макросы %eexcid! и %eexpid! . | Подробнее... |
%g | Макрос геоданных | URL перехода по клику, объявления для отслеживания, URL переадресации, код объявления (всех типов), теги показов, теги кликов, источник значка поведенческой рекламы | Подробнее... |
Макрос сервера объявлений | %h | код объявления (всех типов). | Подробнее... |
Макрос показа | %i | теги межстраничных мест размещения. | Подробнее... |
%k | Макрос ключевого слова | URL перехода по клику, объявления для отслеживания, URL переадресации, код объявления (всех типов), заголовки фреймов, теги показов, теги кликов, источник значка поведенческой рекламы | Подробнее... |
%m | Макрос соответствия | URL перехода по клику, теги для отслеживания кликов, объявления для отслеживания, URL переадресации, код объявления (всех типов), теги показов, теги кликов, источник значка поведенческой рекламы | Подробнее... |
Макрос случайного числа | (%n | Подробнее... | |
%p | Макрос соответствия шаблона | URL перехода по клику, объявления для отслеживания, URL переадресации, код объявления (всех типов), заголовки фреймов, теги Floodlight, теги показов, теги кликов, источник значка поведенческой рекламы | Подробнее... |
%s | Макрос кодового названия сайта | URL перехода по клику, теги отслеживания кликов, объявления для отслеживания, URL переадресации, код объявлений (всех типов), теги Floodlight, теги показов, теги кликов, источник значка поведенческой рекламы | Подробнее... |
%u | Макрос URL целевой страницы | Код креативов (всех типов), теги показов для медийных креативов с графическими объектами | Подробнее… |
Попробуйте воспользоваться Google Поиском. |
Введение
Что такое макросы Менеджера кампаний 360?
Макросы Менеджера кампаний 360 – это короткие команды, которые сервер объявлений Менеджера кампаний 360 заменяет значениями, например ключевыми словами, URL или названиями сайтов. Одни макросы помогают регистрировать информацию для отчетов, другие позволяют определить, какое объявление было показано пользователю и куда он перешел после клика. Обычно длина макросов составляет лишь несколько символов, поэтому добавлять их в теги очень просто.
Макросы Менеджера кампаний 360 можно внедрять в разные объекты, в том числе в URL целевой страницы, HTML-код креатива, заголовок фрейма или тег Floodlight. Макрос может срабатывать при показе рекламы или других событиях, например при вызове Floodlight. Кроме того, он может быть задействован динамически (на основании индивидуальной информации для пользователя). Все зависит от типа макроса и его расположения.
Некоторые макросы можно использовать только в отдельных ситуациях. Макрос, добавленный в неподдерживаемый источник, может работать некорректно. В этой статье приведена таблица, из которой вы узнаете, как и в каком контексте работают различные макросы. Например, серверы объявлений Менеджера кампаний 360 будут заменять макрос %g
, если он помещен в URL целевой страницы. Если же он находится в теге счетчика кликов, этого происходить не будет.
Общая информация
-
При обработке макросов Менеджера кампаний учитывается регистр. Их следует всегда набирать строчными буквами. Например, макрос
%c
будет работать, а%C
– нет. -
Между макросами можно использовать разделители, но это необязательно. В качестве разделителей рекомендуется использовать запятую (
,
) или вертикальную линию (|
). Если у вас нет достаточного опыта, не применяйте другие символы, так как при их некорректном использовании могут возникнуть проблемы. -
Чтобы изменять макросы в URL отслеживания поставщиков, используйте теги событий. Вот как это делается:
-
Сначала создайте тег события в Менеджере кампаний 360 и добавьте в его свойства URL отслеживания, полученный от поставщика (это может быть URL отслеживания кликов, URL пикселя показов или URL опроса). В Менеджере кампаний 360 макросы можно с легкостью добавлять в URL отслеживания в свойствах тега события или удалять из него.
-
Готовый тег можно связывать с объявлениями: они будут обращаться к нему при показе. В Менеджере кампаний 360 можно связывать такой тег с несколькими объявлениями одновременно (в том числе автоматически), например со всеми рекламными материалами из одной кампании. Подробнее о том, как создавать теги событий…
-
-
%ers!
– это единственный макрос замены, который можно использовать с тегами Floodlight. Подробнее…
Типы макросов
Макрос клика (%с)
Макрос %c
заменяется строкой клика Менеджера кампаний 360 в URL целевой страницы, заданном на уровне креатива. Под термином "строка клика" понимается часть URL, которая указывает на серверы объявлений Менеджера кампаний 360.
Используйте %c_esc
вместо %c
, если хотите вставить неэкранированную версию строки кликов в специальный креатив. В строках кликов Менеджера кампаний 360 используется символ "амперсанд" (&
), что может привести к ошибкам при работе со сторонними серверами.
Учтите, что макрос %c
, назначаемый специальным медийным креативам, не заменяется тегами кликов.
Как работает строка клика. Когда пользователь нажимает на креатив, браузер открывает URL целевой страницы. Строка клика выполняет перенаправление на серверы объявлений Менеджера кампаний 360 перед переходом на целевую страницу рекламодателя. При каждом показе Менеджер кампаний 360 автоматически добавляет строку клика в URL перехода по клику.
Если вручную добавить URL целевой страницы в HTML-код специального креатива, то в этом случае может понадобиться добавить макрос %c
для гарантии переадресации клика на серверы объявлений Менеджера кампаний 360. Также можно добавить макрос %u
(макрос целевой страницы), если вы хотите заменить как строку клика, так и URL целевой страницы: макрос %c%u
заменяется полным URL этого типа.
Процедура внедрения. Пример строки клика:
Чтобы добавить строку клика в URL целевой страницы, поместите макрос %c
в его начало, как в следующем примере:
%chttp%3A%2F%2Fdoubleclick.com%2Fpath%2Fpage.html
При показе креатива вместо макроса %c
подставляется строка клика. Вот как будет выглядеть указанный выше URL целевой страницы после замены макроса %c
в начале URL:
http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fdoubleclick.com%2Fpath%2Fpage.html
В этом примере макрос %c
был заменен строкой клика в начале URL целевой страницы. В результате получился полный URL креатива.
Чтобы вставить URL креатива целиком, объедините макросы %c
(строку клика) и %u
(URL целевой страницы): <a href="%c%u">
. Два макроса заменяют полный URL креатива.
Например, вот что может использоваться вместо кода <a href="%c%u">
:
Когда макрос %u
заменяется на URL целевой страницы, также выполняется замена остальных макросов в этом URL, включая %c
.
Макрос замены (%e)
Макрос %e
заменяется идентификаторами различных свойств объявления. После макроса вставьте процесс доступа, чтобы определить, каким идентификатором его нужно заменить и какой параметр креатива нужно отслеживать. Список методов доступа приводится ниже.
Для определения этих идентификаторов и их связи со свойствами креативов можно использовать таблицы соответствий. Идентификаторы связаны с описаниями в Менеджере кампаний 360 (и в базе данных на вашем сервере). Эти идентификаторы помогут вам отслеживать различные свойства креативов с помощью рекламных серверов Менеджера кампаний 360.
Теги Floodlight поддерживают только один макрос замены – %ers!
. Прочие элементы %e
не поддерживаются. Обратите внимание, что макрос %ers!
подходит для любых других случаев, в которых поддерживаются макросы замены (см. таблицу ниже).
Если вы размещаете отслеживающие объявления на мобильном инвентаре и используете статическую целевую страницу, макрос %e
может работать неправильно.
Список замен
Ниже приведен список методов доступа, которые определяют, чем будет заменяться макрос %e
. Обратите внимание, что макрос %e
находится перед методом доступа.
-
%eaid!
заменяется идентификатором показанного объявления. -
%eadv!
заменяется идентификатором рекламодателя, связанного с показанным объявлением. -
%ebuy!
заменяется идентификатором кампании, связанной с показанным объявлением. -
%ecid!
заменяется идентификатором показанного креатива. -
%eexcid!
заменяется сторонним идентификатором кампании Менеджера кампаний 360, которая связана с показанным объявлением. Этот идентификатор извлекается из поля "Внешний идентификатор" в свойствах кампании. Поскольку он создается не в Менеджере кампаний 360, его можно использовать в работе с отчетами других поставщиков, которые не имеют отношения к этому сервису. Обратите внимание, что внешние идентификаторы не поддерживаются в счетчиках кликов. Подробнее о внешних идентификаторах кампаний… -
%eexpid!
заменяется внешним идентификатором места размещения, в котором было показано объявление. Этот идентификатор извлекается из поля "Внешний идентификатор" в свойствах места размещения. Поскольку он создается не в Менеджере кампаний 360, его можно использовать в работе с отчетами других поставщиков, которые не имеют отношения к этому сервису. Обратите внимание, что внешние идентификаторы не поддерживаются в счетчиках кликов. Подробнее… -
%ekid!
заменяется внутренним идентификатором, определяющим пару "ключ-значение", на которую был настроен таргетинг объявления и которая использовалась при его показе. -
%epid!
заменяется идентификатором места размещения, на котором было показано объявление. -
%erv!
заменяется версией визуализированного креатива и изменяется вместе с ней. -
%eenv!
заменяется символом окружения. Под этим термином понимается однобуквенный код, который предназначен для тега Менеджера кампаний 360, запрашивающего объявление. Используемая в нем буква соответствует третьей букве в теге объявления Менеджера кампаний 360 (то есть букве, следующей заad
). Для тега стандартного объявления символом окружения является косая черта (/
), а не буква. Ниже приведено несколько примеров.-
/
указывает на тегиad
(стандартные). -
f
указывает на тегиadf
(фреймы). -
i
указывает на тегиadi
(iframe). -
j
указывает на тегиadj
(JavaScript). -
l
указывает на тегиadl
(iframe/ilayer). -
x указывает на теги
adx
(XML).
-
-
Элемент
%ers!
: в зависимости от контекста заменяется наhttp
илиhttps
. Если макрос добавлен на сайты, использующие безопасное подключение (URL начинается сhttps
), он будет заменен на https. На незащищенных сайтах (URL начинается сhttp
), будет использован вариантhttp
. Этот макрос следует применять, если вы хотите, чтобы протокол тега всегда совпадал с протоколом сайта, где был выполнен показ. Однако обратите внимание, что URL, начинающиеся сhttps
, подходят для любых сайтов, т. е. не нужно использоватьhttp
в теге только потому, что на вашем сайте применяется протоколhttp
. -
%esid!
заменяется идентификатором сайта, связанного с местом размещения объявления. -
%erid!
заменяется идентификатором визуализации. Этот макрос используется только в Менеджере кампаний 360 и соответствует идентификатору креатива. Для устранения неполадок лучше использовать именно его, а не значение из макроса%ecid!
, так как идентификатор визуализации является объектом базы данных самого низкого уровня. Обратите внимание, что у объявлений для отслеживания кликов нет идентификаторов визуализации. Если этот макрос используется в таком объявлении, он заменяется значением0
. -
%eiid!
заменяется уникальным идентификатором клика. Он часто используется при отслеживании установок приложения с помощью стороннего счетчика кликов. -
%edclid!
заменяется идентификатором в URL целевой страницы, чтобы включить улучшенную атрибуцию. Этот вариант подходит для случаев, когда нужно выборочно использовать улучшенную атрибуцию или когда улучшенная атрибуция Floodlight активирована, но в URL применено некорректное форматирование. -
%edimpid!
заменяется идентификатором конкретного показа. Этот макрос позволяет сторонним сервисам отслеживания загружать конверсии и соотносить их с определенными кампаниями.
URL целевой страницы может содержать любое количество макросов %e
. Ниже приведен пример с тремя макросами %e
.
http://site.com/?concept=%eaid!%epid!%esid!&zip=80201
%e
нельзя использовать в счетчиках кликов на сайтах Google Менеджера рекламы, потому что тогда в них будут подставляться значения (например, название сайта или идентификатор рекламодателя), используемые в Менеджере рекламы, а не Менеджере кампаний 360. Подробнее…
Макрос геоданных (%g)
Макрос %g
обеспечивает передачу геоданных, связанных с запросом объявления. Его можно использовать для динамического отслеживания местоположения посетителей при работе со стандартными, собственными и мультимедийными креативами. Макрос %g
заменяется строкой ключей и значений с указанием страны, штата, города, почтового индекса, медиарынка® и типа подключения. Эта информация возвращается к вам через серверы объявлений Менеджера кампаний 360.
Например, макрос %g
для пользователя, находящегося в Нью-Йорке, может быть заменен следующей строкой:
ct=US&st=NY&ac=212&zp=10001&bw=4&dma=3&city=13275
Макрос сервера креативов (%h)
Макрос %h
заменяется именем хоста сервера, показывающего объявление. Благодаря этому нет необходимости прописывать в теге имя хоста: оно может меняться, а соответствующее значение динамически вставляется при показе объявления.
Добавьте макрос %h
в начало URL, как в примере ниже, где сочетание символов "123456" представляет собой идентификатор рекламодателя.
%h
следует всегда использовать с креативами, размещенными в Менеджере кампаний 360.Макрос показа (%i)
Макрос %i
заменяется строкой показа, которая позволяет серверу объявлений Менеджера кампаний 360 отслеживать показы межстраничных объявлений в режиме реального времени.
Макрос %i
следует добавлять в начало URL, как в этом примере:
<img src="%ihttp://static.doubleclick.net/logo.gif">
Макрос %i
нужно использовать во всех межстраничных объявлениях, так как с его помощью сервер объявлений Менеджера кампаний 360 отслеживает их действительные показы.
Добавлять макрос %i
в код такого объявления нужно только один раз, иначе при регистрации показов будут возникать ошибки.
Макрос ключевого слова (%k)
Макрос %k
заменяется подстрокой, обнаруженной в тегах объявлений (в частности, в URL запроса). С его помощью можно показывать в объявлениях введенные пользователем ключевые слова.
Кроме того, этот макрос полезен в случае покупки нескольких ключевых слов, так как он заменяется на ключевое словом, которое вводит рекламодатель. Рассмотрим, как макрос %k
помогает в случае покупки ключевых слов страхование автомобилей
и автокредит
. Пользователю, который ищет информацию о страховании автомобилей
, будет показан креатив с текстом Услуги страхования автомобилей. Если же пользователю нужен автокредит
, в том же креативе он увидит текст Услуги автокредита.
Чтобы указать, какой подстрокой должен заменяться макрос, используйте пару "ключ-значение". Она состоит из двух частей: start_key_string
и end_character
.
[start_key_string]
– это ключ пары. Он указывается в тегах объявлений. Обратите внимание, что элемент [start_key_string]
чувствителен к регистру.
[end_character]
– это символ, обозначающий конец пары "ключ-значение". Если он не указан, а последней парой "ключ-значение" в теге является start_key_string
, сервер объявлений копирует всю строку целиком.
Вставьте макрос и пару "ключ-значение" в следующем порядке: макрос, первое значение, восклицательный знак (!
), второе значение. В целом формат выглядит так:
%k[start_key_string]![end_character]
Макрос %k
находит подстроку, обозначенную этими параметрами,определяет указанное вами ключевое слово и подставляет его вместо себя. Эту пару "ключ-значение" можно вставить в теги ad
или jump
Менеджера кампаний 360.
Если элемент start_key_string
является последней парой "ключ-значение" в теге, символ end_character
можно не использовать. В этом случае он не указывается в тегах ad
и jump
. Вместо этого сервер копирует строку целиком.
Макрос %k
можно также использовать для расшифровки экранированных символов. Когда макрос передает подстроку в HTML-код объявления, все содержащиеся в ней экранированные символы автоматически конвертируются в исходную кодировку. Пример:
src="http://ad.doubleclick.net/adi/av.digital.com/result_front;kw=car+insurance;cat=stext;ord=58822720
Чтобы показать в креативе текст страхование автомобилей
, нужно расшифровать экранированный символ +
. Для этого рекламодатель встраивает в код креатива макрос %k
. Сервер объявлений получает подстроку kw=страхование+автомобилей
и декодирует символ +
. В результате в креативе показывается текст страхование автомобилей.
Теперь код выглядит так:
<a href=http://car.com>Интересует %kkw=!;</a>
Примечание о макросах %k
и %p
: оба они используют подстроку, обозначенную элементом start_key_string
, но обрабатывают ее по-разному. Макрос %k
передает подстроку в HTML-код креатива, а %p
– в URL. В отличие от элемента %p
, макрос %k
работает только в HTML-коде креатива.
Макрос соответствия кода (%m)
%m
. Подробнее…Если настройки браузера не запрещают доступ к файлам cookie, то в момент, когда пользователь нажимает на креатив, макрос %m
заменяется на значение файла cookie DoubleClick, добавленного на устройство пользователя. С помощью этого макроса можно создать список идентификаторов пользователей, чтобы настроить таргетинг на посетителей, которые уже взаимодействовали с креативом. Идентификатор пользователя зашифрован с помощью ключа шифрования идентификатора рекламодателя. Подробнее…
Этот макрос можно использовать в URL целевой страницы, URL переадресации, коде креатива и статических объявлениях для отслеживания кликов (например, в ad.doubleclick.net/clk
). Значение файла cookie DoubleClick представляет собой 64-разрядное целое число длиной не более 20 символов.
Серверы объявлений заменяют макрос %m
в строке клика, которая следует за событием клика, а не в креативе.
- Если пользователь отключил файлы cookie в браузере или отказался их получать, макрос
%m
заменяется 0. - Макрос
%m
, указанный в коде креатива, не действует в браузерах, работающих через прокси-сервер. В этом случае макрос%m
также заменяется 0.
По умолчанию макрос соответствия %m
зашифрован на уровне рекламодателя в Менеджере кампаний 360. Этот способ шифрования может отличаться от используемого при передаче данных.
Если основной способ шифрования для файлов передачи данных не задан на уровне рекламодателя Менеджера кампаний 360, значение макроса %m
будет отличаться. Это значит, что одному и тому же пользователю присваиваются разные идентификаторы.
Если вы хотите, чтобы в вашем аккаунте Менеджера кампаний 360 эти значения совпадали, обратитесь к представителю Google Платформы для маркетинга.
Макрос случайного числа (%n)
Макрос %n
заменяется случайным числом. Случайные значения предотвращают кеширование URL при показе объявления: сервер объявлений при показе динамически создает случайное число и вставляет его в URL вместо %n
. Теперь при каждом показе адрес выглядит по-другому. Это означает, что браузер не может загружать версию объявления, сохраненную в кеше. В результате повышается точность подсчета показов сторонними серверами.
Макрос %n
часто используется издателями, когда для показа креатива Менеджеру кампаний 360 нужно выполнить переадресацию на сторонний сервер. Сторонние площадки, как правило, имеют собственный порядок записи случайных чисел, подобный используемому в Менеджере кампаний 360: ord=[случайное число]?
.
Кроме того, макрос %n
позволяет использовать сторонние инструменты отслеживания кликов. Так как для каждого пользователя макрос %n
заменяется уникальным числом, сторонние серверы могут регистрировать каждый клик отдельно. Трафик-менеджерам следует убедиться, что сторонний инструмент отслеживания поддерживает дополнительную символьную строку, которой будет заменен макрос.
Макрос соответствия шаблона (%p)
Обычно при показе рекламы макрос %p
заменяется подстрокой, найденной в URL запроса в тегах объявлений, т. е. любым текстом, указанным между символами начала и конца строки.
Как назначить подстроку. Чтобы задать начало и окончание нужного типа подстроки, которую будет искать сервер, используйте пару "ключ-значение". Она состоит из двух частей: start_key_string
и end_character
.
-
[start_key_string]
– это ключ пары, который должен присутствовать в тегах объявлений. Он чувствителен к регистру и указывается без квадратных скобок. -
[end_character]
– это символ, обозначающий конец пары "ключ-значение". Если он не указан, а последней парой "ключ-значение" в теге является start_key_string, сервер объявлений копирует всю строку целиком. При вводе значения можно использовать любую последовательность символов ASCII. Длина значения должна быть не менее двух символов. Указывается оно без квадратных скобок.
В целом формат выглядит так:
Как правило, макрос %p
заменяется ключевым словом, которое помогает отслеживать информацию для отчетов. Например, если вы хотите указать название модели автомобиля, добавьте в тег объявления макрос %p
, а также строку начала пары (model=
) и символ конца пары (в данном случае точку с запятой). Помните, что квадратные скобки использовать не нужно. Пример:
При показе объявления Менеджер кампаний 360 ищет model=
в тегах объявлений и извлекает весь текст, который находится между словом model=
и символом окончания (;
).
Для чего применяется макрос %p
:
-
С его помощью рекламодатели передают значения или переменные из тегов Floodlight в теги издателя.
-
Он позволяет издателям динамически передавать значения в URL целевой страницы.
Макрос кодового наименования сайта (%s)
Макрос %s
по-разному работает в обычных тегах объявлений и в тегах Floodlight.
-
Теги объявлений заменяются обозначением сайта в Менеджере кампаний 360. Когда пользователь нажимает на объявление, которое обрабатывается в Менеджере кампаний 360, макрос заменяется обозначением сайта, на котором оно было показано. Обозначение должно совпадать с текстом, указанным на вкладке свойств этого ресурса в Менеджере кампаний 360 (Администратор > Сайты).
Рассмотрим следующий URL, в конце которого указан макрос
%s
:http://advertiser.com/cgi.bin/?%s
Если такой URL указан в объявлении, которое показывается на сайте с обозначением
N255.010101.sandwiches
, то при нажатии на это объявление макрос будет заменен строкойN255.010101.sandwiches
.http://advertiser.com/cgi.bin/?N255.010101.sandwiches
Если получить информацию о сайте в реальном времени невозможно, макрос
%s
может быть заменен пустой строкой. -
Теги Floodlight заменяются идентификатором сайта в Менеджере кампаний 360. При активации тега Floodlight на сайте макрос
%s
заменяется идентификатором сайта. с помощью которого Менеджер кампаний 360 определяет сайты.
%s
нельзя использовать в счетчиках кликов на сайтах Google Менеджера рекламы 360, потому что тогда в макросы будут подставляться значения (например, обозначение сайта или идентификатор рекламодателя), используемые в Менеджере рекламы, а не в Менеджере кампаний 360. Подробнее…Макрос URL целевой страницы (%u)
Макрос %u
заменяется на URL целевой страницы в креативе. Например, <a href="%u">
может заменяться на следующий URL целевой страницы:
Чтобы сразу вставить весь URL креатива, объедините макрос %u
с макросом %c
. В результате вы получите полный URL: %c
(строка клика) + %u
(URL целевой страницы) = полный URL креатива.
Например, вот что может использоваться вместо кода <a href="%c%u">
:
http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fdoubleclick.com%2Fpath%2Fpage.html
%u
заменяется на URL целевой страницы, то же происходит и с остальными макросами в этом URL.