Данная статья актуальна для потоков данных о расходах из Яндекс.Директ, 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 (типы условия показа):
|
Название условия нацеливания |
{adtarget_id} |
Идентификатор условия нацеливания динамического объявления. Обрабатывается только если в объявлении есть CriteriaType (типы условия показа) DYNAMIC_TEXT_AD_TARGET или KEYWORD. |
Число |
{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 |
Не передаются параметры:
Название параметра | Описание | Значения |
---|---|---|
{addphrasestext} |
Текст автоматически добавленной фразы | Текст фразы;none , если показ не был инициирован автоматически добавленной фразой |
{creative_id} |
Идентификатор креатива из конструктора | Число |
{interest_id} |
Идентификатор интереса к мобильным приложениям | Число |
{matched_keyword} |
Подобранная фраза (используйте вместе с {match_type} ) |
Текст подобранной фразы, синонима или дополнительной релевантной фразы |
{position} |
Точная позиция объявления в блоке | Номер позиции в блоке |
Обратите внимание: Параметры {keyword}, {phrase_id} и {retargeting_id} — поддерживаются частично. При наличии всех трёх в одной ссылке, динамические значения в некоторых из них не будут передаваться. В этом случае рекомендуем убрать из ссылок менее важные параметры, чтобы получать корректные динамические значения.
Подробнее о динамических параметрах объявлений в справке Яндекс.Директ
Передаются параметры:
Название параметра | Описание |
---|---|
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. Если название кампании будет изменено, то в процессе актуализации произойдет полное перезаписывание данных.
0 Комментарии