Трансформируем ваши данные в прибыль
Коннектор для работы с Ad Exchange API площадки oohdesk (api.dooh.oohdesk.ru). Позволяет выгружать статистику по рекламным кампаниям, рекламный инвентарь по операторам, а также справочники операторов, городов, клиентов и креативов на модерации.
Поля, которые доступны в рамках выбранного отчета.
Агрегированная статистика по рекламным кампаниям из эндпоинта `/ad-exchange/stat/get-stat`. Группируется по дню, часу или ставке. При `group_by=bid` в результате появляются дополнительные колонки с информацией о сторонах, маркерах, городах, клиентах и агентствах.
| Поле | Название | Тип | Описание |
|---|---|---|---|
title | Группа | String | Заголовок группы (дата/час при group_by=day/hour; адрес стороны при group_by=bid). |
date | Месяц | String | Месяц периода в формате YYYY-MM (приходит при group_by=bid). |
trade_model | Trade model | Int32 | Код торговой модели кампании (10 — аукцион). |
values_show_count | Показы | Int64 | Количество показов рекламы за период. |
values_cost_agency | Расход агентства | Float64 | Сумма списания с агентства. |
values_cost_client | Расход клиента | Float64 | Сумма списания с клиента. |
values_resp_count | Отклики | Int64 | Количество откликов на рекламные ставки. |
values_ots | OTS | Int64 | Opportunity to see — потенциальные контакты с рекламой. |
values_plan_daily | Дневной план | Int64 | Дневной план показов кампании. |
values_is_estimated_ots | OTS оценочный | UInt8 | Признак того, что OTS получен оценочным методом (true/false). |
side_id | ID стороны | Int64 | Идентификатор стороны рекламной поверхности (group_by=bid). |
side_code | Код стороны | String | Код стороны (A/B/C/...) для group_by=bid. |
side_gid | GID стороны | String | GID стороны (уникальный код носителя). |
side_address | Адрес стороны | String | Физический адрес рекламной поверхности. |
side_espar_id | Espar ID | String | Идентификатор стороны в системе Espar. |
side_grp | GRP стороны | String | Gross Rating Points стороны. |
side_ots | OTS стороны | String | OTS стороны. |
side_ots_estimated | OTS оценочный стороны | Float64 | Оценочный OTS стороны. |
side_has_camera | Есть камера | Int8 | Наличие камеры на стороне (0/1). |
side_has_wifi_trap | Есть Wi-Fi-сниффер | Int8 | Наличие Wi-Fi-сниффера на стороне (0/1). |
side_has_ots_estimation | Есть оценка OTS | Int8 | Признак наличия оценки OTS у стороны (0/1). |
side_has_macs_trap | Есть MAC-сниффер | Int8 | Наличие MAC-сниффера на стороне (0/1). |
side_media_type | Тип медиа | String | Тип медиа стороны: video/image и т.п. |
side_frame_id | Frame ID | Int64 | Идентификатор кадра. |
side_estimated_updated_at | Дата обновления оценки | Int64 | UNIX timestamp обновления оценочных метрик стороны. |
side_marker_locality_id | ID локации стороны | Int64 | ID локации (locality_id) маркера стороны. |
side_marker_real_city | Город стороны | String | Реальное название города стороны. |
side_marker_address | Адрес маркера стороны | String | Адрес маркера стороны. |
side_operator_name | Оператор стороны | String | Имя оператора, владеющего стороной. |
side_type_name | Тип конструкции | String | Тип рекламной конструкции (Биллборд, Суперсайт и т.п.). |
marker_locality_id | ID локации | Int64 | ID локации маркера. |
marker_real_city | Реальный город | String | Реальное название города маркера. |
marker_address | Адрес маркера | String | Адрес маркера. |
city_name | Название города | String | Имя города из справочника. |
city_alias | Алиас города | String | Алиас города (latin). |
city_temperature | Температура (взвешенность) | Float64 | Поле temperature из city — служебная числовая метка. |
client_name | Имя клиента | String | Имя клиента кампании (group_by=bid). |
client_type | Тип клиента | String | Тип клиента кампании. |
client_campaign_id | ID кампании | Int64 | ID рекламной кампании клиента (group_by=bid). |
agency_name | Имя агентства | String | Имя агентства, ведущего кампанию (group_by=bid). |
nested | Вложенные креативы | String | JSON-список вложенных креативов/ставок (group_by=bid). Сериализован при сохранении. |
Полный рекламный инвентарь по операторам из эндпоинта `/ad-exchange/inventory/list`. Если параметр `OID операторов` пуст — коннектор обходит всех операторов с непустым `oid` из `/ad-exchange/operator/list`. К каждой записи добавляются `operator_oid`, `operator_name`, `operator_alias`.
| Поле | Название | Тип | Описание |
|---|---|---|---|
id | ID носителя | Int64 | Числовой ID носителя на стороне oohdesk. |
oid | OID носителя | String | Строковый OID носителя (формат `oohdesk-<id>`). |
price | Цена | Float64 | Цена показа. |
bid_floor | Минимальная ставка | Float64 | Bid floor — минимальная ставка для участия в аукционе. |
city | Город | String | Город, к которому привязан носитель. |
city_id | ID города | Int32 | ID города из справочника `cities`. |
real_city | Реальный город | String | Фактическое название города (может отличаться от city). |
address | Адрес | String | Физический адрес рекламной конструкции. |
gid | GID | String | Уникальный код стороны носителя. |
side | Сторона | String | Сторона носителя (A/B/...). |
view | Вид носителя | String | Тип/вид конструкции (Биллборд 6x3, Суперсайт и т.п.). |
ots | OTS | String | Opportunity to see носителя. |
grp | GRP | String | Gross Rating Points носителя. |
operator | Оператор | String | Название оператора-владельца носителя. |
has_wifi_trap | Есть Wi-Fi-сниффер | Int8 | Наличие Wi-Fi-сниффера (0/1). |
hasCamera | Есть камера | Int8 | Наличие камеры на носителе (0/1). |
updated_at | Дата обновления | String | Дата последнего обновления записи (ISO с TZ). |
mediaParams_duration | Длительность ролика, мс | Int32 | Длительность одного показа в миллисекундах. |
mediaParams_resolution_width | Ширина, px | Int32 | Ширина креатива/экрана в пикселях. |
mediaParams_resolution_height | Высота, px | Int32 | Высота креатива/экрана в пикселях. |
position_lat | Широта | String | Географическая широта установки носителя. |
position_lng | Долгота | String | Географическая долгота установки носителя. |
images_preview | Превью | String | URL превью-картинки фото-отчёта. |
operator_oid | OID оператора | String | OID оператора, к которому относится носитель. Добавляется коннектором. |
operator_name | Имя оператора | String | Имя оператора из `/ad-exchange/operator/list`. Добавляется коннектором. |
operator_alias | Алиас оператора | String | Латинский alias оператора. Добавляется коннектором. |
Список городов, доступных в DSP oohdesk. Источник: `/ad-exchange/city/list`. Используется как справочник для сопоставления с `city_id` в других отчётах.
| Поле | Название | Тип | Описание |
|---|---|---|---|
id | ID города | Int64 | ID города в API oohdesk. |
name | Название | String | Название города (русское). |
alias | Алиас | String | Латинский alias города. |
lat | Широта | Float64 | Широта центра города. |
lng | Долгота | Float64 | Долгота центра города. |
timezone | Таймзона | Int32 | Часовой пояс города (UTC+N). |
temperature | Температура | Float64 | Служебная числовая метка temperature. |
Список клиентов агентства из `/ad-exchange/client/list`. Доступен только клиентам типа «агентство».
| Поле | Название | Тип | Описание |
|---|---|---|---|
id | ID клиента | Int64 | ID клиента в API oohdesk. |
name | Название | String | Имя клиента. |
Список креативов с их статусом модерации из `/ad-exchange/creative-moderation/list`. Поддерживает фильтрацию по `client_id` и `operator_oid`.
| Поле | Название | Тип | Описание |
|---|---|---|---|
media_id | ID медиа | Int64 | ID креатива в системе oohdesk. |
status | Статус модерации | String | Статус: prepared | pending | approved | rejected | unknown. |
message | Сообщение модератора | String | Комментарий модератора (для rejected — причина отказа). |
operator_name | Имя оператора | String | Имя оператора, к которому относится креатив. |
operator_alias | Алиас оператора | String | Латинский alias оператора. |
operator_oid | OID оператора | String | UUID оператора в системе oohdesk. |
