# Какие динамические параметры в UTM-метках доступны для передачи из рекламных площадок

> **Примечание**
> 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} | [Идентификатор интереса к мобильным приложениям](https://yandex.ru/support/direct/impression-criteria/interest-targeting.html) | Число |
| {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}} | Временная зона пользователя, которому был сделан показ | Число |