Макросы для собственных креативов

Как использовать макросы с экранированием и без экранирования

Необходимый уровень технических знаний

Это статья для пользователей, которые разрабатывают собственные креативы и обладают необходимыми навыками.

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

Макросы используются в собственных креативах для разных целей. Например, они могут служить тегами для целевых URL (перехода по клику) и URL отслеживания кликов. Макросы бывают без экранирования, с экранированием и с двойным экранированием.

При экранировании один символ (или последовательность символов) заменяет другой. URL можно передавать через интернет только как набор символов ASCII. Однако в URL могут использоваться символы, не входящие в этот набор. Их необходимо закодировать при передаче, чтобы они правильно распознавались.

При разработке собственных креативов в код нужно добавить один или несколько из следующих элементов:

  • Неэкранированный URL отслеживания кликов: %%CLICK_URL_UNESC%%.
  • Экранированный URL отслеживания кликов: %%CLICK_URL_ESC%%.
  • Неэкранированный целевой URL: %%DEST_URL%%.
  • Экранированный целевой URL: %%DEST_URL_ESC%%.
  • Макрос целевого URL с двойным экранированием: %%DEST_URL_ESC_ESC%%.

Чтобы клики гарантированно отслеживались, а пользователи попадали на целевую страницу, используйте нужный вариант URL. При неверном выборе клики могут не отслеживаться, а пользователи – не попадать на нужную страницу.

Если требуется как URL отслеживания кликов, так и URL перехода по клику, макросы нужно правильно объединить в последовательность ("цепочку").

В этой статье мы расскажем, как правильно использовать макросы для целевых URL и URL отслеживания кликов, а также как объединять их в цепочку. Кроме того, мы рассмотрим примеры ошибок.

Пример вставки макросов

Ниже приведен пример вставки неэкранированного макроса для URL отслеживания кликов из Менеджера кампаний 360. Некоторые параметры удалены или сокращены для наглядности.

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

Сравните этот URL с его экранированной версией:

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

В экранированном URL зарезервированные символы были экранированы (технически использовано двойное экранирование) с помощью знака %. Например, знаки вопроса (?) всегда представлены последовательностью символов %253F, а знаки равенства (=) – последовательностью символов %253D.

Пример 1A. Корректное отслеживание кликов по собственному креативу в Менеджере рекламы

Предположим, при клике по собственному креативу должен осуществляться переход на следующий адрес:

http://www.google.com/page.html?param1=red&param2=blue

Графический креатив отслеживает клики следующим образом:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

В браузер посетителя поступит следующий код креатива:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Это правильный URL клика. URL клика Менеджера рекламы не экранирован, а целевой URL экранирован.

Пример 1B. Неверное отслеживание кликов по собственному креативу в Менеджере рекламы

Типичная ошибка в приведенном выше примере – применение экранированного макроса URL клика. В коде креатива это выглядит так:

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

В браузер посетителя поступит следующий код креатива:

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Этот код некорректен. Так как все параметры экранированы, сервер Adclick не сможет выполнить их синтаксический анализ. Вместо этого сервер будет интерпретировать их как запрос для страницы /aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

Так как этой страницы не существует, сервер Adclick выдаст ошибку 404 ("Не найдено"), и посетитель не будет перенаправлен на целевую страницу.

Пример 1С. Некорректное отслеживание кликов по собственному креативу в Менеджере рекламы

Ещё одна распространенная ошибка заключается в использовании неэкранированного макроса целевого URL. В коде креатива это выглядит так:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

В браузер посетителя поступит следующий код креатива:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

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

Если сервер не перезапишет неверно отформатированный URL, он будет интерпретирован следующим образом:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

В этом случае последний символ & интерпретируется как разделитель нового параметра для ПЕРВОГО запроса сервера, а не как параметр, передающийся на сервер, на котором размещена целевая страница объявления. Из-за этого сервер может неправильно обработать URL клика, и пользователь попадет не на ту страницу, на которую должен. Даже если посетитель будет перенаправлен, второй параметр (param2) может не передаться на целевую страницу.

Пример 2А. Корректное объединение стороннего счетчика кликов и макроса

Рекламодатель может попросить вас реализовать в креативе сторонний счетчик кликов. Он независимо подсчитывает число кликов по креативу и впоследствии помогает при анализе данных или сверке с рекламодателем.

Как правило, счетчик кликов представлен в виде URL. Вот пример такого URL из Менеджера кампаний 360:

http://ad.doubleclick.net/clk;a;b;c?[URL перехода по клику][целевой URL]

URL (ad.doubleclick.net) ведет на сервер, где сохраняются данные о показе или клике. Другие сторонние URL похожи на этот. URL перехода по клику должен быть представлен двумя макросами:

  • Макрос отслеживания кликов с одинарным экранированием: %%CLICK_URL_ESC%%.
  • Макрос целевого URL с двойным экранированием: %%DEST_URL_ESC_ESC%%.

Оба макроса относятся к одному и тому же URL перехода по клику. Их необходимо добавить после знака вопроса (?). Вот пример графического креатива с URL отслеживания кликов из Менеджера кампаний 360:

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

При использовании шаблона креатива сторонний счетчик кликов обычно представлен в коде креатива как идентификатор тега URL. Поскольку в браузер посетителя поступил код креатива, значение макроса будет заменено на ожидаемое. Пример:

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Предварительный просмотр креатива и тестирование макросов

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

  1. Откройте креатив в новом окне.

    JavaScript не сработает, если открыть окно предварительного просмотра непосредственно в Менеджере рекламы. Кроме того, вы не сможете просмотреть расширенную версию макроса.

  2. Воспользуйтесь инструментами разработчика в браузере, чтобы проверить элементы и DOM.

Проверьте макросы отслеживания кликов

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

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

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

Чтобы проверить такие макросы, необходимо воспользоваться инструментом для отслеживания трафика. Он позволяет регистрировать и просматривать HTTP-запросы. Решение для отслеживания трафика можно найти среди инструментов разработчика в некоторых браузерах. Существует и стороннее ПО для этих целей.

С помощью инструмента для анализа трафика вам необходимо проверить HTTP-запросы при загрузке креатива. Убедитесь, что запрос ping успешно передается на сервер, регистрирующий показ. Проверьте, не возникают ли ошибки в ходе отправки HTTP-запросов.

  • Если ошибок нет и запрос ping доходит до сервера, который регистрирует показ, то макросы настроены правильно.
  • Если ошибки есть, вернитесь к исходному коду собственного креатива и устраните неполадки. Распространенный код ошибки при неправильном размещении макросов – HTTP 204.

Эта информация оказалась полезной?

Как можно улучшить эту статью?
Поиск
Очистить поле поиска
Закрыть поиск
Главное меню
939756453713440674
true
Поиск по Справочному центру
true
true
true
true
true
148
false
false