Примечание
ROMI center поддерживает следующие динамические URL параметры для рекламных площадок:
- Яндекс Директ
- Facebook Ads*
- ВКонтакте
- myTarget
При экспорте данных из рекламных сервисов, ROMI center передает и динамические параметры из ссылок объявлений. Благодаря этому в отчетах вы можете смотреть затраты в разрезе UTM-меток.
Однако API рекламных сервисов не передают некоторые динамические параметры. В отчетах такие параметры будут отображаться названиями вместо значений. Например, название {position} вместо значения 0.
Далее в статье представлен полный список поддерживаемых и неподдерживаемых динамических параметров в разрезе рекламных сервисов.
Динамические параметры в utm-метках Яндекс Директ
Поддерживаемые параметры
При загрузке данных о расходах по кампаниям Яндекс Директ, ROMI center обрабатывает следующие значения динамических параметров в 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 | |
Неподдерживаемые параметры
Некоторые параметры Яндекс Директ не передает в API, поэтому они не поддерживаются.
| Название параметра | Описание | Значение |
|---|---|---|
| {addphrasestext} | Текст автоматически добавленной фразы | Текст фразы. |
| none, если показ не был инициирован автоматически добавленной фразой | ||
| {creative_id} | Идентификатор креатива из конструктора | Число |
| {interest_id} | Идентификатор интереса к мобильным приложениям | Число |
| {matched_keyword} | Подобранная фраза (используйте вместе с {match_type}) | Текст подобранной фразы, синонима или дополнительной релевантной фразы |
| {position} | Точная позиция объявления в блоке | Номер позиции в блоке |
| {param1} | Специальный параметр 1 | |
| {param2} | Специальный параметр 2 |
Примечание
Обратите внимание:
Параметры {keyword}, {phrase_id} и {retargeting_id} — поддерживаются частично. При наличии всех трёх в одной ссылке, динамические значения в некоторых из них не будут передаваться. В этом случае рекомендуем убрать из ссылок менее важные параметры, чтобы получать корректные динамические значения.
Динамические параметры в utm-метках Facebook Ads*
Поддерживаемые параметры
При загрузке данных о расходах по кампаниям Facebook, ROMI center обрабатывает следующие значения динамических параметров в utm-метках:
| Название параметра | Описание | Значение |
|---|---|---|
| ad_id={{ad.id}} | Идентификатор объявления | Число |
| adset_id={{adset.id}} | Идентификатор группы объявлений | Число |
| campaign_id={{campaign.id}} | Идентификатор рекламной кампании | Число |
| ad_name={{ad.name}} | Название объявления | Текст |
| adset_name={{adset.name}} | Название группы объявлений | Текст |
| campaign_name={{campaign.name}} | Название рекламной кампании | Текст |
Неподдерживаемые параметры
Некоторые параметры Facebook не передает в API, поэтому они не поддерживаются.
| Название параметра | Описание | Значение |
|---|---|---|
| placement={{placement}} | место размещения объявления (Feed, Stories, Instant Article, Right Column и др.) | Текст |
| site_source_name={{site_source_name}} | название сайта, на котором размещено объявление (fb — Facebook, ig- Instagram, msg — Messenger, an — Audience Network) | Текст |
Примечание
Обратите внимание:
Для корректной передачи utm-меток из Facebook Ads*, их нужно прописывать в специальном поле “Параметры URL”. Подробнее читайте в статье.
Динамические параметры в utm-метках Вконтакте
Поддерживаемые параметры
При загрузке данных о расходах по кампаниям Вконтакте, ROMI center обрабатывает следующие значения динамических параметров в utm-метках:
| Название параметра | Описание | Значение |
|---|---|---|
| {ad_id} | Идентификатор объявления | Число |
| {campaign_id} | Идентификатор рекламной кампании | Число |
| {campaign_name} | Название кампании из рекламного кабинета | Текст |
Неподдерживаемые параметры
Некоторые параметры Вконтакте не передает в API, поэтому они не поддерживаются.
| Название параметра | Описание | Значение |
|---|---|---|
| {random} | Случайное число | Число |
| {platform} | Платформы, с которых совершались переходы по рекламе (только для форматов рекламная запись с кнопкой и карусель) | Текст |
| {price_list_id} | Параметр объявлений динамического ретаргетинга | Число |
| {product_id} | Параметр объявлений динамического ретаргетинга | Число |
Динамические параметры в utm-метках myTarget
Поддерживаемые параметры
При загрузке данных о расходах по кампаниям myTarget, ROMI center обрабатывает следующие значения динамических параметров в utm-метках:
| Название параметра | Описание | Значение |
|---|---|---|
| {{advertiser_id}} | Идентификатор рекламодателя | Число |
| {{campaign_id} | Идентификатор рекламной кампании | Число |
| {{campaign_name}} | Название рекламной кампании | Текст |
| {{banner_id}} | Идентификатор баннера | Число |
Неподдерживаемые параметры
Некоторые параметры myTarget не передает в API, поэтому они не поддерживаются.
| Название параметра | Описание | Значение |
|---|---|---|
| {{geo}} | Идентификатор региона по геодереву myTarget, из которого был сделан переход | Число |
| {{gender}} | Пол пользователя, который сделал переход | Текст |
| {{age}} | Возраст пользователя, который сделал переход | Число |
| {{random}} | Случайное число. Часто используется в ссылках (аудит-пикселях) для более точного подсчета показов | Число |
| {{impression_weekday}} | День недели, в который произошел показ баннера | Текст |
| {{impression_hour}} | Час, в который произошел показ по Московскому времени в 24-часовом формате | Число |
| {{user_timezone}} | Временная зона пользователя, которому был сделан показ | Число |
