Трансформируем ваши данные в прибыль
Коннектор для работы с API Яндекс.Директ - сервисом контекстной рекламы Яндекса
Поля, которые доступны в рамках выбранного отчета.
Получает основные метрики эффективности рекламных кампаний без учета конверсий
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую приведена статистика, в формате YYYY-MM-DD |
campaign_id | ID кампании | String | Идентификатор кампании |
campaign_name | Название кампании | String | Название кампании |
ad_group_id | ID группы объявлений | String | Идентификатор группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний |
ad_id | ID объявления | String | Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний |
criterion_id | ID критерия | String | Идентификатор условия показа, заданного рекламодателем: для показа по ключевой фразе или синониму — идентификатор ключевой фразы; для показа по автотаргетингу — идентификатор автотаргетинга; для показа по условию нацеливания на аудиторию — идентификатор условия нацеливания на аудиторию |
criterion | Критерий | String | Название или текст условия показа, заданного рекламодателем: для показа по ключевой фразе или синониму — фраза с идентификатором; для показа по автотаргетингу — значение «---autotargeting»; для показа по условию нацеливания на аудиторию — название условия ретаргетинга и подбора аудитории |
impressions | Показы | Int64 | Количество показов |
clicks | Клики | Int64 | Количество кликов |
cost_exclude_vat | Расход без НДС | Decimal(18, 2) | Общий расход без учета НДС |
vat | НДС | Decimal(18, 2) | Размер НДС |
cost_with_vat | Расход с НДС | Decimal(18, 2) | Стоимость кликов с учетом НДС |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Получает статистику по конверсиям, целям и ROI с выбранной моделью атрибуции
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую приведена статистика, в формате YYYY-MM-DD |
campaign_id | ID кампании | String | Идентификатор кампании |
campaign_name | Название кампании | String | Название кампании |
ad_group_id | ID группы объявлений | String | Идентификатор группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний |
ad_id | ID объявления | String | Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний |
impressions | Показы | Int64 | Количество показов |
clicks | Клики | Int64 | Количество кликов |
cost_with_vat | Расход с НДС | Decimal(18, 2) | Стоимость кликов с учетом НДС |
revenue_{goal_id}_{attribution} | Выручка по цели | Float64 | Ценность конверсий по указанной цели. Имя поля содержит идентификатор цели и обозначение модели атрибуции. Например, поле revenue_1234567_FC содержит доход по цели 1234567, источник визита определен по модели «первый переход» |
conversions_{goal_id}_{attribution} | Конверсии по цели | Float64 | Количество целевых визитов (конверсий), в ходе которых произошло достижение указанной цели. Имя поля содержит идентификатор цели и обозначение модели атрибуции. Например, поле conversions_1234567_FC содержит количество визитов, в рамках которых произошло достижение цели 1234567 |
conversion_rate_{goal_id}_{attribution} | Коэффициент конверсии по цели | Float64 | Отношение количества целевых визитов, в ходе которых произошло достижение указанной цели, к количеству кликов. Может превышать 100, поскольку один клик может быть источником нескольких визитов. Имя поля содержит идентификатор цели и обозначение модели атрибуции |
cost_per_conversion_{goal_id}_{attribution} | Стоимость конверсии по цели | Float64 | Средняя стоимость целевого визита по указанной цели. Имя поля содержит идентификатор цели и обозначение модели атрибуции. Например, поле cost_per_conversion_1234567_FC содержит среднюю стоимость визита, в рамках которого произошло достижение цели 1234567 |
goals_roi_{goal_id}_{attribution} | ROI по цели | Float64 | Рентабельность инвестиций в рекламу по указанной цели по ценности конверсий. Рассчитывается как (Revenue_<id_цели>_<модель> – Cost) / Cost. Имя поля содержит идентификатор цели и обозначение модели атрибуции |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Позволяет создать кастомный отчет с выбранными полями и метриками. Типы отчетов: 1 - Аккаунт, 2 - Объявления, 3 - Группы объявлений, 4 - Кампании, 5 - Критерии, 6 - Универсальный, 7 - Охват и частота, 8 - Поисковые запросы. Доступные поля зависят от выбранного типа отчета.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую приведена статистика, в формате YYYY-MM-DD |
campaign_id | ID кампании | String | Идентификатор кампании (доступно в отчетах типа 2, 3, 4) |
campaign_name | Название кампании | String | Название кампании (доступно в отчетах типа 2, 3, 4) |
campaign_type | Тип кампании | String | Тип кампании: TEXT_CAMPAIGN, MOBILE_APP_CAMPAIGN, DYNAMIC_TEXT_CAMPAIGN, SMART_CAMPAIGN, MCBANNER_CAMPAIGN, CPM_BANNER_CAMPAIGN, CPM_DEALS_CAMPAIGN, CPM_FRONTPAGE_CAMPAIGN, CPM_PRICE, UNIFIED_CAMPAIGN |
ad_group_id | ID группы объявлений | String | Идентификатор группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний (доступно в отчетах типа 2, 3) |
ad_group_name | Название группы объявлений | String | Название группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний (доступно в отчетах типа 2, 3) |
ad_id | ID объявления | String | Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний (доступно только в отчете типа 2) |
ad_format | Формат объявления | String | Формат показа объявления: IMAGE — графический, TEXT — текстовый, VIDEO — видео, SMART_MULTIPLE — смарт-баннер, SMART_SINGLE — смарт-объявление, ADAPTIVE_IMAGE — адаптивный графический, SMART_TILE — смарт-плитка |
ad_network_type | Тип площадки | String | Тип площадки, где показано объявление: SEARCH — на поиске; AD_NETWORK — в сетях |
criterion_id | ID критерия | String | Идентификатор условия показа, заданного рекламодателем: для показа по ключевой фразе или синониму — идентификатор ключевой фразы; для показа по автотаргетингу — идентификатор автотаргетинга (доступно в отчетах типа 5, 6, 8) |
criterion | Критерий | String | Название или текст условия показа, заданного рекламодателем: для показа по ключевой фразе или синониму — фраза с идентификатором; для показа по автотаргетингу — значение «---autotargeting» (доступно в отчетах типа 5, 6, 8) |
criterion_type | Тип критерия | String | Тип условия показа, заданного рекламодателем: KEYWORD — ключевая фраза; AUTOTARGETING — автотаргетинг; RETARGETING — условие нацеливания на аудиторию по условию ретаргетинга и подбора аудитории; INTERESTS_AND_DEMOGRAPHICS — условие нацеливания на аудиторию по профилю пользователей |
query | Поисковый запрос | String | Поисковый запрос, по которому было показано объявление (доступно только в отчете типа 8) |
matched_keyword | Соответствующее ключевое слово | String | Подобранная фраза: для показа по синониму ключевой фразы — текст синонима; для показа по дополнительной релевантной фразе — текст дополнительной релевантной фразы; для показа динамического объявления — текст ключевой фразы, автоматически сформированной на основе страницы рекламируемого сайта (доступно только в отчете типа 8) |
match_type | Тип соответствия | String | Тип соответствия ключевой фразе: RELATED_KEYWORD — показ по дополнительной релевантной фразе; SYNONYM — показ по семантическому соответствию ключевой фразы; KEYWORD — показ по ключевой фразе; NONE — в остальных случаях (недоступно в отчете типа 7) |
device | Устройство | String | Тип устройства, на котором было показано объявление: DESKTOP, MOBILE, TABLET или SMART_TV (недоступно в отчете типа 8) |
gender | Пол | String | Пол пользователя: GENDER_MALE, GENDER_FEMALE или UNKNOWN (недоступно в отчете типа 8) |
age | Возраст | String | Возрастная группа пользователя: AGE_0_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45_54, AGE_55 или UNKNOWN (недоступно в отчете типа 8) |
mobile_platform | Мобильная платформа | String | Тип операционной системы: ANDROID, IOS, OTHER или UNKNOWN (недоступно в отчетах типа 7, 8) |
carrier_type | Тип оператора связи | String | Тип связи: CELLULAR — мобильная связь; STATIONARY — wi-fi или проводной интернет; UNKNOWN — определить не удалось (недоступно в отчетах типа 7, 8) |
rl_adjustment_id | ID корректировки ставок | String | Идентификатор условия ретаргетинга и подбора аудитории, в соответствии с которым применена корректировка ставок для целевой аудитории (доступно в отчетах типа 5, 6) |
targeting_location_id | ID региона таргетинга | String | Идентификатор региона таргетинга. В случае использования расширенного геотаргетинга может отличаться от региона местонахождения пользователя |
targeting_location_name | Название региона таргетинга | String | Название региона таргетинга |
targeting_category | Категория таргетинга | String | Категория таргетинга: EXACT — целевые запросы; ALTERNATIVE — альтернативные запросы; COMPETITOR — запросы с упоминанием конкурентов; BROADER — широкие запросы; ACCESSORY — сопутствующие запросы (недоступно в отчете типа 7) |
location_of_presence_id | ID региона присутствия | String | Идентификатор региона фактического присутствия пользователя |
location_of_presence_name | Название региона присутствия | String | Название региона фактического присутствия пользователя |
placement | Площадка | String | Конкретная площадка размещения (недоступно в отчете типа 7) |
external_network_name | Внешняя сеть | String | Название внешней рекламной сети (недоступно в отчетах типа 7, 8) |
slot | Слот | String | Позиция размещения объявления на странице |
impressions | Показы | Int64 | Количество показов |
weighted_impressions | Взвешенные показы | Decimal(18, 2) | Взвешенные показы. Каждый показ учитывается с весом TrafficVolume / 100, где TrafficVolume — объем трафика с позиции, на которой произошел показ. Таким образом, WeightedImpressions = Impressions × AvgTrafficVolume / 100 |
clicks | Клики | Int64 | Количество кликов |
ctr | CTR | Decimal(18, 2) | CTR, в процентах |
weighted_ctr | Взвешенный CTR | Decimal(18, 2) | Взвешенный CTR, в процентах. Рассчитывается как (Clicks / WeightedImpressions) × 100% |
avg_cpc | Средняя цена клика | Decimal(18, 2) | Средняя стоимость клика |
avg_effective_bid | Средняя эффективная ставка | Decimal(18, 2) | Средняя ставка за клик с учетом всех корректировок. Данные доступны только для кампаний с оплатой за клик |
avg_cpm | Средняя цена за тысячу показов | Decimal(18, 2) | Средняя стоимость за тысячу показов (доступно только в отчете типа 7) |
avg_impression_frequency | Средняя частота показов | Decimal(18, 2) | Средняя частота показов одному пользователю, до двух знаков после запятой. Данные доступны только для медийных кампаний (доступно только в отчете типа 7) |
cost | Расход | Decimal(18, 2) | Стоимость кликов |
avg_impression_position | Средняя позиция показа | Decimal(18, 2) | Средняя позиция показа объявления. При расчете учитываются только показы на первой странице результатов поиска Яндекса. Наивысшая позиция имеет номер 1 |
avg_click_position | Средняя позиция клика | Decimal(18, 2) | Средняя позиция, на которой произошел клик по объявлению. При расчете учитываются только клики на первой странице результатов поиска Яндекса. Наивысшая позиция имеет номер 1 |
avg_traffic_volume | Средний трафик | Decimal(18, 2) | Средний объем трафика |
sessions | Сессии | Int64 | Количество сессий на сайте |
bounces | Отказы | Int64 | Количество отказов (сессии с одним просмотром страницы) |
bounce_rate | Показатель отказов | Decimal(18, 2) | Процент отказов от общего числа сессий |
avg_pageviews | Среднее количество просмотров страниц | Decimal(18, 2) | Среднее количество просмотров страниц за сессию |
impression_reach | Охват показов | Int64 | Количество уникальных пользователей, увидевших объявления (доступно только в отчете типа 7) |
conversions | Конверсии | Int64 | Количество конверсий |
conversion_rate | Коэффициент конверсии | Decimal(18, 2) | Отношение конверсий к кликам (в процентах) |
cost_per_conversion | Стоимость конверсии | Decimal(18, 2) | Средняя стоимость одной конверсии |
profit | Прибыль | Decimal(18, 2) | Прибыль от рекламной кампании |
revenue | Выручка | Decimal(18, 2) | Общая выручка от рекламной кампании |
goals_roi | ROI по целям | Decimal(18, 2) | Возврат инвестиций по целям |
income_grade | Доходность | String | Категория доходности кампании |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Справочная информация о кампаниях и объявлениях аккаунта. При выборе 'Рекламные кампании' получаете список кампаний с их названиями. При выборе 'Объявления' получаете информацию об объявлениях с привязкой к группам.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую приведена статистика, в формате YYYY-MM-DD |
campaign_id | ID кампании | String | Идентификатор кампании |
campaign_name | Название кампании | String | Название кампании (доступно только при выборе 'Рекламные кампании') |
ad_id | ID объявления | String | Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний (доступно только при выборе 'Объявления') |
ad_group_name | Название группы объявлений | String | Название группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний (доступно только при выборе 'Объявления') |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
