Обратите внимание: Этот список актуален как для потока Яндекс.Директ → Google Analytics, так и для потока Яндекс.Директ → Google BigQuery.
Какие параметры поддерживаются
Из URL-параметров объявлений Яндекс.Директ, OWOX BI обрабатывает следующие:
| Название параметра | Описание | Значения |
|---|---|---|
{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} |
Тип соответствия условия показа и поискового запроса |
|
{adtarget_name} |
Условие нацеливания динамического объявления Обрабатывается только если в объявлении есть следующие CriteriaType (типы условия показа):
|
Название условия нацеливания |
{adtarget_id} |
Идентификатор условия нацеливания динамического объявления | Число |
{position_type} |
Тип блока, если показ произошел на странице с результатами поиска Яндекса | premium — премиум-показы;other — блок справа или блок внизу;none — объявление было показано в сетях (РСЯ или внешние сети) |
{source} |
Место показа |
Домен площадки — при показе в сетях (РСЯ или внешние сети) Важно: Согласно документации Яндекс.Директ, при показе объявления на поисковых площадках Рекламная сеть Яндекса (РСЯ) для параметра {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} |
Точная позиция объявления в блоке | Номер позиции в блоке |
Если вы используете в UTM-метках параметры, которые не поддерживаются в API, то увидите названия самих параметров вместо их значений. Например, {position} вместо 1. Это не позволит проверить затраты в разрезе UTM-меток в отчетах.
Чтобы получать отчеты по затратам в разрезе UTM-меток, перенесите параметры, которые не поддерживаются в API, из UTM-меток в дополнительные GET-параметры и собирайте их в пользовательские параметры Google Analytics:
- данные по расходам будут доступны только в разрезе передаваемых UTM-меток,
- сессионные данные будут доступны в разрезе неподдерживаемых динамических параметров (в пользовательских параметрах) и UTM-меток.
Обратите внимание: Параметры {keyword}, {phrase_id} и {retargeting_id} — поддерживаются частично. При наличии всех трёх в одной ссылке, динамические значения в некоторых из них не будут передаваться. В этом случае рекомендуем убрать из ссылок менее важные параметры, чтобы получать корректные динамические значения.
Параметры указаны для API версии 5 по состоянию на третий квартал 2019. С последующими обновлениями API данный список может изменится.
5 Комментарии