Москва+7 495 215-10-97

Коннектор TargetADS

Коннектор для работы с 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Количество кликов по рекламе
ctrCTRFloat64Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: 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Количество кликов по рекламе
ctrCTRFloat64Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: 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 присылает ноль: ноль здесь означает «данных нет», а не «нулевое значение»
givtGIVTInt64Показы, отсеянные как заведомо недействительный трафик: дата-центры, краулеры, известные боты
sivtSIVTInt64Показы, отсеянные как сложный недействительный трафик: имитация человеческого поведения
part_of_givtДоля GIVTFloat64Доля GIVT от всех показов, в процентах

География

Показы, клики и охват в разбивке по странам и городам. Страна и город - кастомные поля TargetADS: с ними запрос идёт по таблице событий, где нет ни метрик качества трафика, ни измеримых показов, поэтому этих колонок в отчёте нет. Строк здесь заметно больше, чем в статистике по размещениям: города дробят каждое размещение на десятки тысяч строк в сутки.

ПолеНазваниеТипОписание
dateДатаDateДата, за которую получена статистика
placement_nameРазмещениеStringНазвание размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение»
countryСтранаStringСтрана пользователя по данным геолокации
cityГородStringГород пользователя по данным геолокации
impressionsПоказыInt64Количество показов рекламы
clicksКликиInt64Количество кликов по рекламе
ctrCTRFloat64Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: TargetADS делит клики на показы без защиты от нуля, а показы и клики к размещению приходят по разным каналам. Если размещение остановили, показы обнуляются, а клик-трекер продолжает принимать обращения, и CTR за такой день выходит бессмысленным: при единичных показах приходят значения вида 5000%, при нулевых была бы бесконечность, её коннектор заменяет на пустое. Отдельная история размещения с одним лишь клик-трекингом, без пикселя показа (у таких в названии обычно cpc): там показов не бывает вовсе. Для витрины считайте CTR сами из показов и кликов, а эту колонку держите как справочную
reachОхватInt64Количество уникальных пользователей за день, между днями не суммируется: сложив дни, вы получите не охват периода, а сумму дневных охватов
frequencyЧастотаFloat64Среднее количество показов на одного пользователя за день

Домены и SSP

Где именно откручивались показы: домен площадки и SSP, через которую он куплен. Самый крупный по количеству строк отчёт - у программатика доменов бывают десятки тысяч в сутки, поэтому период раскладывается на задачи по одному дню.

ПолеНазваниеТипОписание
dateДатаDateДата, за которую получена статистика
placement_nameРазмещениеStringНазвание размещения. В API TargetADS это поле называется MediaCampaign, в интерфейсе платформы - «Размещение»
domainДоменStringДомен площадки, на которой показалась реклама
sspSSPStringSupply-Side Platform, через которую куплен показ
impressionsПоказыInt64Количество показов рекламы
clicksКликиInt64Количество кликов по рекламе
ctrCTRFloat64Отношение кликов к показам в процентах, считает сама площадка. Полагаться на него нельзя: 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_idID транзакции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_idID размещенияInt64Идентификатор размещения. Тем же числом размещение обозначено в отчёте «Детализация GIVT»
placement_nameРазмещениеStringНазвание размещения
placement_createdДата созданияDateДата создания размещения в TargetADS
placement_statusСтатусStringСтатус размещения: active, paused или archived
source_idID источникаInt64Идентификатор медиа-источника
source_nameИсточникStringНазвание медиа-источника
marketing_campaign_idID кампанииInt64Идентификатор маркетинговой кампании
marketing_nameКампанияStringНазвание маркетинговой кампании
landing_pageСсылка размещенияStringАдрес лендинга, заданный на размещении
creative_idID креатива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

Детализация GIVT

Событийная детализация недействительного трафика: по каждому показу и клику видно устройство, домен, географию и то, какая именно проверка его отсеяла. Отчёт сырой и объёмный, за сутки набегают десятки и сотни тысяч строк, поэтому период раскладывается на задачи по одному дню. Названия размещений и креативов коннектор подмешивает из справочника: API в этом отчёте отдаёт только идентификаторы.

ПолеНазваниеТипОписание
dateДатаDateДата события, выделена из времени для нарезки по дням
event_datetimeВремя событияDateTimeДата и время события
event_typeТип событияStringТип события: показ или клик
device_idID устройстваStringИдентификатор устройства пользователя
session_idID сессииStringИдентификатор сессии
placement_idID размещенияInt64Идентификатор размещения, тот же, что в справочнике размещений
placement_nameРазмещениеStringНазвание размещения, подмешано из справочника: само API в этом отчёте отдаёт только идентификаторы
creative_idID креативаInt64Идентификатор креатива
creative_nameКреативStringНазвание креатива, подмешано из справочника
device_typeТип устройстваStringТип устройства: mobile, desktop, tablet
platformПлатформаStringПлатформа, с которой пришло событие
domainДоменStringДомен площадки, на которой произошло событие
sspSSPStringSupply-Side Platform, через которую куплен показ
ipIPStringIP-адрес события
countryСтранаStringСтрана по данным геолокации
regionРегионStringРегион по данным геолокации
cityГородStringГород по данным геолокации
user_agentUser-AgentStringСтрока User-Agent браузера
custom_paramsКастомные параметрыStringДополнительные параметры события в виде JSON
is_givtПризнак GIVTInt641 - событие признано недействительным трафиком, 0 - нет
givt_reason_data_centreПричина: дата-центрInt641 - трафик пришёл из дата-центра
givt_reason_unknown_deviceПричина: неизвестное устройствоInt641 - устройство не удалось опознать
givt_reason_crawlerПричина: краулерInt641 - опознан поисковый бот или краулер
givt_reason_behaviorПричина: поведениеInt641 - подозрительное поведение на странице
givt_reason_suspicious_activityПричина: активностьInt641 - подозрительная активность устройства

Получите от ваших данных больше чем когда либо

+7