Коннектор для работы с API аналитической платформы TargetADS, которая сводит медийные размещения с целевыми действиями на сайте и считает атрибуцию. Токен доступа выдаётся в интерфейсе TargetADS и жёстко привязан к одному проекту, поэтому при подключении рядом с токеном указывается ID проекта. Важно про расход: в API TargetADS его нет вообще. Расход, CPM, CPC и CPA видны в интерфейсе платформы, но ни одним полем наружу не отдаются, поэтому в выгрузках коннектора этих колонок нет. Данные доступны только за завершившиеся сутки: за сегодняшний день TargetADS отчёт не отдаёт, и коннектор сам подрезает правую границу периода до вчерашней даты.
Поля, которые доступны в рамках выбранного отчета.
Основной отчёт: показы, клики, охват и целевые действия по дням и размещениям. Целевые метрики считаются по выбранным в потоке модели и окну атрибуции, а сами значения модели и окна попадают в выгрузку колонками, чтобы в витрине было видно, чем посчитаны цифры.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
source_name | Источник | String | Название медиа-источника размещения |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
ctr | CTR | Float64 | Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: TargetADS делит клики на показы без защиты от нуля, а показы и клики к размещению приходят по разным каналам. Если размещение остановили, показы обнуляются, а клик-трекер продолжает принимать обращения, и CTR за такой день выходит бессмысленным: при единичных показах приходят значения вида 5000%, при нулевых была бы бесконечность, её коннектор заменяет на пустое. Отдельная история размещения с одним лишь клик-трекингом, без пикселя показа (у таких в названии обычно cpc): там показов не бывает вовсе. Для витрины считайте CTR сами из показов и кликов, а эту колонку держите как справочную |
reach | Охват | Int64 | Количество уникальных пользователей за день, между днями не суммируется: сложив дни, вы получите не охват периода, а сумму дневных охватов |
frequency | Частота | Float64 | Среднее количество показов на одного пользователя за день |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
target_event_count | Целевые действия | Float64 | Количество целевых действий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_event_value | Ценность целевых действий | Float64 | Сумма значений целевых событий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_amount | Сумма транзакций | Float64 | Выручка по электронной торговле. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_quantity | Количество товаров | Float64 | Количество товаров в транзакциях. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
attribution_model | Модель атрибуции | String | Код модели атрибуции, по которой посчитаны целевые метрики строки |
attribution_window | Окно атрибуции | String | Окно атрибуции в днях, выбранное в настройках потока |
Тот же набор метрик, что и по размещениям, но с разбивкой до креатива. Строк получается в разы больше, поэтому период режется на недельные куски.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
source_name | Источник | String | Название медиа-источника размещения |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
creative_name | Креатив | String | Название креатива внутри размещения |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
ctr | CTR | Float64 | Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: TargetADS делит клики на показы без защиты от нуля, а показы и клики к размещению приходят по разным каналам. Если размещение остановили, показы обнуляются, а клик-трекер продолжает принимать обращения, и CTR за такой день выходит бессмысленным: при единичных показах приходят значения вида 5000%, при нулевых была бы бесконечность, её коннектор заменяет на пустое. Отдельная история размещения с одним лишь клик-трекингом, без пикселя показа (у таких в названии обычно cpc): там показов не бывает вовсе. Для витрины считайте CTR сами из показов и кликов, а эту колонку держите как справочную |
reach | Охват | Int64 | Количество уникальных пользователей за день, между днями не суммируется: сложив дни, вы получите не охват периода, а сумму дневных охватов |
frequency | Частота | Float64 | Среднее количество показов на одного пользователя за день |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
target_event_count | Целевые действия | Float64 | Количество целевых действий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_event_value | Ценность целевых действий | Float64 | Сумма значений целевых событий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_amount | Сумма транзакций | Float64 | Выручка по электронной торговле. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_quantity | Количество товаров | Float64 | Количество товаров в транзакциях. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
attribution_model | Модель атрибуции | String | Код модели атрибуции, по которой посчитаны целевые метрики строки |
attribution_window | Окно атрибуции | String | Окно атрибуции в днях, выбранное в настройках потока |
Воронка досмотров видеокреативов по дням. Метрики набираются только на видеоформатах: у баннерных размещений все колонки досмотров будут нулевыми. Атрибуция на этот отчёт не влияет, целевых метрик в нём нет.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
creative_name | Креатив | String | Название креатива внутри размещения |
impressions | Показы | Int64 | Количество показов рекламы |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_start | Запуски | Int64 | Количество запусков ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_start_on_mute | Запуски без звука | Int64 | Количество запусков с выключенным звуком. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_q25 | Досмотры 25% | Int64 | Досмотры до четверти ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_q50 | Досмотры 50% | Int64 | Досмотры до середины ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_q75 | Досмотры 75% | Int64 | Досмотры до трёх четвертей ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_complete | Полные досмотры | Int64 | Полные досмотры ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_skip | Пропуски | Int64 | Количество пропусков ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
video_close | Закрытия | Int64 | Количество закрытий ролика. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
Метрики видимости креативов: сколько показов попало в видимую область, как долго креатив был на экране и какую его часть было видно. Набираются только на размещениях с JS-счётчиком площадки. Метрика медианной длительности видимости в документации есть, но API на неё отвечает внутренней ошибкой, поэтому в отчёт она не входит.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
creative_name | Креатив | String | Название креатива внутри размещения |
impressions | Показы | Int64 | Количество показов рекламы |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
visible_impressions | Видимые показы | Int64 | Показы, попавшие в видимую область экрана. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
avg_visible_impressions_duration | Средняя длительность видимости | Float64 | Сколько секунд креатив в среднем находился в видимой области. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
part_of_screen | Доля экрана | Float64 | Какую часть экрана в среднем занимал креатив, в процентах. Если площадка видимость не измеряет, TargetADS присылает в этом поле nan, и колонка остаётся пустой |
part_of_visible_screen | Доля видимой области | Float64 | Какую часть видимой области в среднем занимал креатив, в процентах. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
visible_part | Видимая часть креатива | Float64 | Какая часть самого креатива в среднем была видна, в процентах. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
creative_width | Ширина креатива | Float64 | Средняя ширина креатива в пикселях. В API это поле называется CreativeWeight, но означает именно ширину, а не вес файла |
creative_height | Высота креатива | Float64 | Средняя высота креатива в пикселях |
Сводка недействительного трафика по дням и креативам. SIVT доступен только в этом отчёте: как только в группировку попадает страна или город, TargetADS переключает запрос на таблицу событий, где метрики SIVT нет, и отвечает ошибкой валидации. Поэтому качество трафика и география разведены по разным отчётам. Событийная детализация причин лежит в отчёте «Детализация GIVT».
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
creative_name | Креатив | String | Название креатива внутри размещения |
impressions | Показы | Int64 | Количество показов рекламы |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
givt | GIVT | Int64 | Показы, отсеянные как заведомо недействительный трафик: дата-центры, краулеры, известные боты |
sivt | SIVT | Int64 | Показы, отсеянные как сложный недействительный трафик: имитация человеческого поведения |
part_of_givt | Доля GIVT | Float64 | Доля GIVT от всех показов, в процентах |
Показы, клики и охват в разбивке по странам и городам. Страна и город - кастомные поля TargetADS: с ними запрос идёт по таблице событий, где нет ни метрик качества трафика, ни измеримых показов, поэтому этих колонок в отчёте нет. Строк здесь заметно больше, чем в статистике по размещениям: города дробят каждое размещение на десятки тысяч строк в сутки.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
country | Страна | String | Страна пользователя по данным геолокации |
city | Город | String | Город пользователя по данным геолокации |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
ctr | CTR | Float64 | Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: TargetADS делит клики на показы без защиты от нуля, а показы и клики к размещению приходят по разным каналам. Если размещение остановили, показы обнуляются, а клик-трекер продолжает принимать обращения, и CTR за такой день выходит бессмысленным: при единичных показах приходят значения вида 5000%, при нулевых была бы бесконечность, её коннектор заменяет на пустое. Отдельная история размещения с одним лишь клик-трекингом, без пикселя показа (у таких в названии обычно cpc): там показов не бывает вовсе. Для витрины считайте CTR сами из показов и кликов, а эту колонку держите как справочную |
reach | Охват | Int64 | Количество уникальных пользователей за день, между днями не суммируется: сложив дни, вы получите не охват периода, а сумму дневных охватов |
frequency | Частота | Float64 | Среднее количество показов на одного пользователя за день |
Где именно откручивались показы: домен площадки и SSP, через которую он куплен. Самый крупный по количеству строк отчёт - у программатика доменов бывают десятки тысяч в сутки, поэтому период раскладывается на задачи по одному дню.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
domain | Домен | String | Домен площадки, на которой показалась реклама |
ssp | SSP | String | Supply-Side Platform, через которую куплен показ |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
ctr | CTR | Float64 | Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: TargetADS делит клики на показы без защиты от нуля, а показы и клики к размещению приходят по разным каналам. Если размещение остановили, показы обнуляются, а клик-трекер продолжает принимать обращения, и CTR за такой день выходит бессмысленным: при единичных показах приходят значения вида 5000%, при нулевых была бы бесконечность, её коннектор заменяет на пустое. Отдельная история размещения с одним лишь клик-трекингом, без пикселя показа (у таких в названии обычно cpc): там показов не бывает вовсе. Для витрины считайте CTR сами из показов и кликов, а эту колонку держите как справочную |
reach | Охват | Int64 | Количество уникальных пользователей за день, между днями не суммируется: сложив дни, вы получите не охват периода, а сумму дневных охватов |
frequency | Частота | Float64 | Среднее количество показов на одного пользователя за день |
impressions_with_js | Измеримые показы | Int64 | Показы, на которых отработал JS-счётчик площадки. Если размещение эту метрику не измеряет, TargetADS присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение» |
Целевые действия в разбивке по конкретным событиям проекта: какое событие и сколько раз произошло после касания с размещением. Список событий проекта лежит в отчёте «Справочник целевых событий». Тип и категория события заполнены только у проектов, где они заданы при настройке событий.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
target_event_type | Тип целевого события | String | Тип целевого события в терминах TargetADS |
target_event_category | Категория целевого события | String | Категория целевого события |
target_event_name | Целевое событие | String | Системное название целевого события |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
target_event_count | Целевые действия | Float64 | Количество целевых действий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_event_value | Ценность целевых действий | Float64 | Сумма значений целевых событий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_amount | Сумма транзакций | Float64 | Выручка по электронной торговле. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_quantity | Количество товаров | Float64 | Количество товаров в транзакциях. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
attribution_model | Модель атрибуции | String | Код модели атрибуции, по которой посчитаны целевые метрики строки |
attribution_window | Окно атрибуции | String | Окно атрибуции в днях, выбранное в настройках потока |
Транзакции и товары, привязанные к медийным касаниям. Работает только на проектах с настроенной передачей данных электронной торговли: без неё колонки транзакций и товаров будут пустыми, а суммы нулевыми. Товарные поля площадка отдаёт списками через запятую в порядке позиций транзакции.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата, за которую получена статистика |
placement_name | Размещение | String | Название размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение» |
target_ecom_id | ID транзакции | String | Идентификатор транзакции из данных электронной торговли |
target_ecom_items_name | Товары | String | Названия товаров транзакции, перечислены через запятую |
target_ecom_items_category_1 | Категория товаров | String | Категория первого уровня, перечислена через запятую по товарам транзакции |
impressions | Показы | Int64 | Количество показов рекламы |
clicks | Клики | Int64 | Количество кликов по рекламе |
target_event_count | Целевые действия | Float64 | Количество целевых действий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_event_value | Ценность целевых действий | Float64 | Сумма значений целевых событий. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_amount | Сумма транзакций | Float64 | Выручка по электронной торговле. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
target_ecom_quantity | Количество товаров | Float64 | Количество товаров в транзакциях. Значение зависит от выбранных в потоке модели и окна атрибуции. У линейных моделей дробное: одно целевое действие делится между всеми касаниями пути |
attribution_model | Модель атрибуции | String | Код модели атрибуции, по которой посчитаны целевые метрики строки |
attribution_window | Окно атрибуции | String | Окно атрибуции в днях, выбранное в настройках потока |
Дерево трекинга TargetADS плоской таблицей: кампания, источник, размещение и креатив с их идентификаторами. Нужен, чтобы связать статистику с идентификаторами: в агрегированных отчётах TargetADS отдаёт только названия, id размещений и креативов в группировках не существует. Период на справочник не влияет, каждая выгрузка это срез на день запуска.
| Поле | Название | Тип | Описание |
|---|---|---|---|
placement_id | ID размещения | Int64 | Идентификатор размещения. Тем же числом размещение обозначено в отчёте «Детализация GIVT» |
placement_name | Размещение | String | Название размещения |
placement_created | Дата создания | Date | Дата создания размещения в TargetADS |
placement_status | Статус | String | Статус размещения: active, paused или archived |
source_id | ID источника | Int64 | Идентификатор медиа-источника |
source_name | Источник | String | Название медиа-источника |
marketing_campaign_id | ID кампании | Int64 | Идентификатор маркетинговой кампании |
marketing_name | Кампания | String | Название маркетинговой кампании |
landing_page | Ссылка размещения | String | Адрес лендинга, заданный на размещении |
creative_id | ID креатива | Int64 | Идентификатор креатива |
creative_name | Креатив | String | Название креатива |
creative_landing_page | Ссылка креатива | String | Адрес лендинга, заданный на креативе |
Целевые события проекта: системное имя, человекочитаемое название, категория и тип. Служит расшифровкой к отчёту по конверсиям, где события приходят системными именами. Период на справочник не влияет.
| Поле | Название | Тип | Описание |
|---|---|---|---|
event_name | Событие | String | Системное название целевого события |
event_human_name | Название | String | Человекочитаемое название события из интерфейса |
event_category | Категория | String | Категория события |
event_type | Тип | String | Тип события |
event_sys_type | Системный тип | String | Системный тип события в терминах TargetADS |
Событийная детализация недействительного трафика: по каждому показу и клику видно устройство, домен, географию и то, какая именно проверка его отсеяла. Отчёт сырой и объёмный, за сутки набегают десятки и сотни тысяч строк, поэтому период раскладывается на задачи по одному дню. Названия размещений и креативов коннектор подмешивает из справочника: API в этом отчёте отдаёт только идентификаторы.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата события, выделена из времени для нарезки по дням |
event_datetime | Время события | DateTime | Дата и время события |
event_type | Тип события | String | Тип события: показ или клик |
device_id | ID устройства | String | Идентификатор устройства пользователя |
session_id | ID сессии | String | Идентификатор сессии |
placement_id | ID размещения | Int64 | Идентификатор размещения, тот же, что в справочнике размещений |
placement_name | Размещение | String | Название размещения, подмешано из справочника: само API в этом отчёте отдаёт только идентификаторы |
creative_id | ID креатива | Int64 | Идентификатор креатива |
creative_name | Креатив | String | Название креатива, подмешано из справочника |
device_type | Тип устройства | String | Тип устройства: mobile, desktop, tablet |
platform | Платформа | String | Платформа, с которой пришло событие |
domain | Домен | String | Домен площадки, на которой произошло событие |
ssp | SSP | String | Supply-Side Platform, через которую куплен показ |
ip | IP | String | IP-адрес события |
country | Страна | String | Страна по данным геолокации |
region | Регион | String | Регион по данным геолокации |
city | Город | String | Город по данным геолокации |
user_agent | User-Agent | String | Строка User-Agent браузера |
custom_params | Кастомные параметры | String | Дополнительные параметры события в виде JSON |
is_givt | Признак GIVT | Int64 | 1 - событие признано недействительным трафиком, 0 - нет |
givt_reason_data_centre | Причина: дата-центр | Int64 | 1 - трафик пришёл из дата-центра |
givt_reason_unknown_device | Причина: неизвестное устройство | Int64 | 1 - устройство не удалось опознать |
givt_reason_crawler | Причина: краулер | Int64 | 1 - опознан поисковый бот или краулер |
givt_reason_behavior | Причина: поведение | Int64 | 1 - подозрительное поведение на странице |
givt_reason_suspicious_activity | Причина: активность | Int64 | 1 - подозрительная активность устройства |