Полный список динамических параметров в ссылках объявлений, которые обрабатывает OWOX BI

Данная статья актуальна для потоков данных о расходах из Яндекс.Директ, Facebook, ВКонтакте, myTarget, Bing Ads в Google Analytics и Google BigQuery.

Обратите внимание, OWOX BI не поддерживает обработку динамических UTM-параметров и макросов для таких сервисов, как LinkedIn, Twitter, Criteo, AdRoll, Outbrain, Yahoo Gemini, Яндекс.Маркет, Hotline, TrafMag и Sklik, даже если в этих сервисах есть возможность задавать динамические параметры/макросы.

При экспорте данных из рекламных сервисов в Google Analytics, OWOX BI передает и динамические параметры из ссылок объявлений. Благодаря этому в отчетах Google Analytics вы можете смотреть затраты в разрезе UTM-меток.

Однако API рекламных сервисов не передают некоторые динамические параметры. В отчетах такие параметры будут отображаться названиями вместо значений. Например, название {position} вместо значения 0.

Чтобы сохранить возможность получать отчеты по затратам в разрезе UTM-меток, вам нужно перенести параметры, которые не поддерживаются в API сервисов, в дополнительные GET-параметры и собирать в пользовательские параметры Google Analytics.

• Данные по расходам будут доступны только в разрезе передаваемых UTM-меток.
• Сессионные данные будут доступны в разрезе неподдерживаемых динамических параметров (в пользовательских параметрах) и UTM-меток.

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

Яндекс. Директ

Передаются параметры:

Название параметра	Описание	Значения
{ad_id}	Номер (ID) объявления	Число
{banner_id}	Номер (ID) объявления на баннере	Число
{addphrases}	Инициирован ли этот показ дополнительными релевантными фразами	yes — показ по дополнительной релевантной фразе; no — показ по одной из исходных фраз
{campaign_name}	Название кампании	Текст до 60 символов
{campaign_name_lat}	Транслитерированное название кампании	Текст латиницей до 60 символов. Важно: этот параметр обрабатывается только если название кампании в рекламном кабинете содержит текст латиницей, цифры и/или спецсимволы. В других случаях, например если в названии будет текст кириллицей, значение параметра не будет распознано.
{campaign_type}	Тип кампании	type1 — текстово-графические объявления; type2 — реклама мобильных приложений; type3 — динамические объявления; type4 — смарт баннеры
{campaign_id}	Идентификатор рекламной кампании	Число
{device_type}	Тип устройства, на котором произведен показ	desktop / mobile / tablet
{gbid}	Идентификатор группы	Число
{keyword}	Ключевая фраза, по которой было показано объявление (текстово-графическое или реклама мобильных приложений)	Текст ключевой фразы без минус-слов
{phrase_id}	Идентификатор ключевой фразы для текстово-графических объявлений или рекламы мобильных приложений	Число
{retargeting_id}	Идентификатор условия нацеливания на аудиторию, связывающего группу объявлений с условиями ретаргетинга и подбора аудитории или интересами к мобильным приложениям. Обрабатывается только если в объявлении есть CriteriaType (типы условия показа) AUDIENCE_TARGET или KEYWORD.	Число
{coef_goal_context_id}	Идентификатор корректировки ставок для условия ретаргетинга и подбора аудитории	Число
{match_type}	Тип соответствия условия показа и поискового запроса. Обратите внимание: параметр {match_type} поддерживается в потоке Яндекс.Директ → Google Analytics, но не подерживается в потоке Яндекс.Директ → Google BigQuery.	rm — автотаргетинг; syn — синоним; rkw — дополнительная релевантная фраза
{adtarget_name}	Условие нацеливания динамического объявления. Обрабатывается только если в объявлении есть следующие CriteriaType (типы условия показа): для потоков Яндекс.Директ → Google Analytics — DYNAMIC_TEXT_AD_TARGET или KEYWORD; для потоков Яндекс.Директ → Google  BigQuery — DYNAMIC_TEXT_AD_TARGET, KEYWORD или AUTOTARGETING.	Название условия нацеливания
{adtarget_id}	Идентификатор условия нацеливания динамического объявления. Обрабатывается только если в объявлении есть CriteriaType (типы условия показа) DYNAMIC_TEXT_AD_TARGET или KEYWORD.	Число
{position_type}	Тип блока, если показ произошел на странице с результатами поиска Яндекса	premium — премиум-показы; other — блок справа или блок внизу; none — объявление было показано в сетях (РСЯ или внешние сети)
{source}	Место показа	Домен площадки — при показе в сетях (РСЯ или внешние сети); none — при показе на поиске Яндекса. Важно: Согласно документации Яндекс.Директ, при показе объявления на поисковых площадках Рекламная сеть Яндекса (РСЯ) для параметра {source} может быть передан как домен, так и значение none. При этом Яндекс.Директ API не позволяет определить наверняка, какое значение для {source} было присвоено в момент перехода по объявлению. Это ограничение может привести к несовпадению параметров UTM-разметки в рекламном сервисе и таблицах GBQ и, как следствие, к расхождениям при расчете стоимости сессий. В рамках потока Яндекс.Директ → Google Analytics, при показе на поиске Яндекса параметр {source} поддерживается частично.
{source_type}	Тип площадки, на которой произведен показ объявления	search — поиск; context — сети
{region_name}	Регион, в котором было показано объявление	Название региона
{region_id}	Идентификатор региона, в котором было показано объявление	Число
{param1}	Специальный параметр 1
{param2}	Специальный параметр 2

 

Не передаются параметры:

Название параметра	Описание	Значения
{addphrasestext}	Текст автоматически добавленной фразы	Текст фразы; none, если показ не был инициирован автоматически добавленной фразой
{creative_id}	Идентификатор креатива из конструктора	Число
{interest_id}	Идентификатор интереса к мобильным приложениям	Число
{matched_keyword}	Подобранная фраза (используйте вместе с {match_type})	Текст подобранной фразы, синонима или дополнительной релевантной фразы
{position}	Точная позиция объявления в блоке	Номер позиции в блоке

 

Обратите внимание: Параметры {keyword}, {phrase_id} и {retargeting_id} — поддерживаются частично. При наличии всех трёх в одной ссылке, динамические значения в некоторых из них не будут передаваться. В этом случае рекомендуем убрать из ссылок менее важные параметры, чтобы получать корректные динамические значения.

Подробнее о динамических параметрах объявлений в справке Яндекс.Директ

 

Facebook

Передаются параметры:

Название параметра	Описание
ad_id={{ad.id}}	Идентификатор объявления
adset_id={{adset.id}}	Идентификатор группы объявлений
campaign_id={{campaign.id}}	Идентификатор рекламной кампании
ad_name={{ad.name}}	Название объявления
adset_name={{adset.name}}	Название группы объявлений
campaign_name={{campaign.name}}	Название рекламной кампании

 

Не передаются параметры:

Название параметра	Описание
placement={{placement}}	место размещения объявления (Feed, Stories, Instant Article, Right Column и др.)
site_source_name={{site_source_name}}	название сайта, на котором размещено объявление (fb — Facebook, ig- Instagram, msg — Messenger, an — Audience Network)

 

Подробнее о динамических параметрах в Справочном центре Facebook

 

ВКонтакте

Передаются параметры:

Название параметра	Описание
{ad_id}	Идентификатор объявления
{campaign_id}	Идентификатор рекламной кампании
{campaign_name}	Название кампании из рекламного кабинета

 

Не передаются параметры:

Название параметра	Описание
{random}	Случайное число
{platform}	Платформы, с которых совершались переходы по рекламе (только для форматов рекламная запись с кнопкой и карусель)
{price_list_id}	Параметр объявлений динамического ретаргетинга
{product_id}	Параметр объявлений динамического ретаргетинга

 

Подробнее о динамических параметрах в разделе «Помощь» ВКонтакте

 

myTarget

Передаются шаблоны (параметры):

Название параметра	Описание
{{advertiser_id}}	Идентификатор рекламодателя
{{campaign_id}	Идентификатор рекламной кампании
{{campaign_name}}	Название рекламной кампании
{{banner_id}}	Идентификатор баннера

 

Не передаются шаблоны (параметры):

Название параметра	Описание
{{geo}}	Идентификатор региона по геодереву myTarget, из которого был сделан переход
{{gender}}	Пол пользователя, который сделал переход
{{age}}	Возраст пользователя, который сделал переход
{{random}}	Случайное число. Часто используется в ссылках (аудит-пикселях) для более точного подсчета показов
{{impression_weekday}}	День недели, в который произошел показ баннера
{{impression_hour}}	Час, в который произошел показ по Московскому времени в 24-часовом формате
{{user_timezone}}	Временная зона пользователя, которому был сделан показ

 

Подробнее о шаблонах в справке myTarget

 

Bing Ads

Передаются параметры:

Название параметра	Описание
{CampaignId}	ID кампании, которая привела к показу объявления
{AdGroupId}	ID группы объявлений, которая привела к показу объявления
{MatchType}	Тип соответствия условия показа объявления
{BidMatchType}	Тип соответствия ставки ключевого слова
{Network}	Рекламная сеть, в которой была показано объявление
{Device}	На каком устройстве пользователь кликнул на объявление
{IfMobile:string}	Возвращает указанный вами текст из string, если объявление было показано на мобильном устройстве
{IfNotMobile:string}	Возвращает указанный вами текст из string, если объявление было показано на десктопе, лэптопе или планшете
{IfSearch:string}	Возвращает указанный вами текст из string, если объявление было показано в поисковой сети
{IfContent:string}
{keyword:default}	Заменяет ключевое слово которое совпало с поисковым запросом пользователя
{AdId}	Числовой идентификатор показанного объявления
{OrderItemId}	Числовой идентификатор ключевого слова, которое привело к показу объявления
{QueryString}	Поисковый запрос пользователя
{param1}	Cвойство из Keyword, или default если объявление показано без Keyword или значение параметра пустое
{param2}	Cвойство из Keyword, или default если объявление показано без Keyword или значение параметра пустое
{param3}	Cвойство из Keyword, или default если объявление показано без Keyword или значение параметра пустое

 

Не передаются шаблоны (параметры):

Название параметра	Описание
{Campaign}	Название кампании, которая привела к показу объявления
{AdGroup}	Название группы объявлений, которая привела к показу объявления
{TargetId}	ID ключевого слова (kwd), списка ремаркетинга или аудитории (aud), динамической цели объявления (dat) или целевой локации (loc), которые привели к показу объявления
{IfNative:string}	Возвращает указанный вами текст из string, если объявление было показано в Microsoft Audience Ad
{IfPLA:string}	Возвращает указанный вами текст из string, если объявление было показано как реклама товара
{ignore}	Игнорирует элементы отслеживания в финальных URL
{lpurl}, {lpurl+2}, {escapedlpurl+2}, {lpurl+3}, {escapedlpurl+3}, {unescapedlpurl}, {escapedlpurl}	Параметры шаблона отслеживания: финальные URL
{ProductId}	Только для Bing Shopping Campaigns: Числовой идентификатор товара, который привёл к показу объявления
{CriterionId}	Только для Bing Shopping Campaigns: Идентификатор группы товаров Bing Shopping для Product Ads
{product_country}	Только для Bing Shopping Campaigns: Страна продажи для продукта в кликнутом объявлении. Например, US, UK
{product_language}	Только для Bing Shopping Campaigns: Язык информации о продукте, как указано в данных Merchant Center. Например, EN, FR
{seller_name}	Только для Bing Shopping Campaigns: Название продавца или название магазина, в зависимости от того, появилась реклама на агрегаторе или нет

 

Подробнее о параметрах объявлений в справке Bing Ads

Важно Рекомендуется поддерживать UTM-разметку объявлений, а также настройки рекламных кампаний в неизменном виде с момента их создания по следующим причинам:
- OWOX BI атрибутирует расходы на сессии пользователей в соответствии с UTM-метками;
- отдельные настройки рекламных кампаний используются OWOX BI для распознавания динамических параметров в UTM. Так, текущее название рекламной кампании используется для определения {campaign_name}.
Изменения в настройках рекламных кампаний и объявлений приведет к несовпадению значений UTM в новых и ранее импортированных данных, что станет причиной расхождений при расчете стоимости сессий.
Рассмотрим пример:
В настройках объявления используется динамический параметр utm_campaign={campaign_name}. Исходное название рекламной кампании — Campaign123.
01.01.2021 произошел клик по объявлению, и в результирующей ссылке вместо {campaign_name} было подставлено значение utm_campaign=Campaign123. Именно с таким значением этот переход на сайт запишется в системы аналитики (Google Analytics, OWOX BI hit streaming). 
05.01.2021 рекламодатель меняет название кампании на Campaign777.
06.01.2021 пользователь настраивает поток из этой рекламной системы в OWOX BI.
Как результат, OWOX BI при импорте расходов за 01.01.2021 для этого объявления подставит актуальное на момент импорта данных значение utm_campaign=Campaign777 вместо utm_campaign=Campaign123, которое было в момент перехода. Таким образом, расходы не будут соотнесены с сессией.
Аналогичный результат будет получен и при актуализации данных в уже настроенном активном потоке в OWOX BI. Если название кампании будет изменено, то в процессе актуализации произойдет полное перезаписывание данных.