Какие параметры поддерживаются
Из 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} — поддерживаются частично. При наличии всех трёх в одной ссылке, динамические значения в некоторых из них не будут передаваться. В этом случае рекомендуем убрать из ссылок менее важные параметры, чтобы получать корректные динамические значения.
Важно Рекомендуется поддерживать 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. Если название кампании будет изменено, то в процессе актуализации произойдет полное перезаписывание данных.
5 Комментарии