Трансформируем ваши данные в прибыль
Коннектор для работы с API SAPE DSP (traffic.sape.ru) — программатик-платформы для закупки рекламы. Поддерживает REST API v2 и XML-RPC.
Поля, которые доступны в рамках выбранного отчета.
Статистика эффективности рекламных кампаний SAPE DSP. Включает пять типов данных, выбираемых параметром «Тип данных»: расширенная статистика (statistics_extended), по объявлениям (statistics_ads), по группам объявлений (statistics_groups), аукцион (statistics_bidding), охват аудитории (statistics_coverage). Набор полей ответа зависит от выбранного типа. Для statistics_ads требуется указать параметры «Поля» и «Группировка». Для statistics_coverage требуется указать параметр «Группировка». Для statistics_bidding требуется указать «ID кампании».
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата (день) | Date | Дата показа — group_by: dateDay |
clientId | ID клиента | Int32 | Идентификатор клиента — group_by: clientId |
groupId | ID группы | Int32 | Идентификатор группы объявлений — group_by: groupId |
campaignId | ID кампании | Int32 | Идентификатор кампании — group_by: campaignId |
campaignName | Название кампании | String | Название кампании — group_by: campaignName |
campaignType | Тип кампании | Int32 | Тип кампании — group_by: campaignType |
campaignStatus | Статус кампании | Int32 | Статус кампании — group_by: campaignStatus |
adId | ID объявления | Int32 | Идентификатор объявления — group_by: adId |
adName | Название объявления | String | Название объявления — group_by: adName |
adTitle | Заголовок объявления | String | Заголовок объявления — group_by: adTitle |
adDescription | Описание объявления | String | Описание объявления — group_by: adDescription |
creativeId | ID креатива | Int32 | Идентификатор креатива — group_by: creativeId |
creativeName | Название креатива | String | Название креатива — group_by: creativeName |
creativeSizeX | Ширина креатива | Int32 | Ширина баннера в пикселях — group_by: creativeSizeX |
creativeSizeY | Высота креатива | Int32 | Высота баннера в пикселях — group_by: creativeSizeY |
nofImps | Показы | Int64 | Количество показов — fields: nofImps |
nofClicks | Клики | Int64 | Количество кликов — fields: nofClicks |
amountSpent | Расходы | Decimal(18, 2) | Сумма расходов (валюта аккаунта) — fields: amountSpent |
amountClient | Расходы клиента | Decimal(18, 2) | Сумма расходов на стороне клиента — fields: amountClient |
ctr | CTR | Float64 | Кликабельность (клики / показы) — fields: ctr |
vtr | VTR | Float64 | Досматриваемость видео — fields: vtr |
cpm | CPM | Decimal(18, 2) | Стоимость за тысячу показов — fields: cpm |
cpc | CPC | Decimal(18, 2) | Стоимость за клик — fields: cpc |
cpv | CPV | Decimal(18, 2) | Стоимость за просмотр видео — fields: cpv |
cpmv | CPMV | Decimal(18, 2) | Стоимость за тысячу просмотров видео — fields: cpmv |
coverage | Охват | Int64 | Уникальные пользователи — fields: coverage |
frequency | Частота | Float64 | Средняя частота показов — fields: frequency |
vastStart | VAST Start | Int64 | Запуски видеоролика — fields: vastStart |
vast1stQuartile | VAST 1st Quartile | Int64 | Досмотры до 25% — fields: vast1stQuartile |
vastMidpoint | VAST Midpoint | Int64 | Досмотры до 50% — fields: vastMidpoint |
vast3rdQuartile | VAST 3rd Quartile | Int64 | Досмотры до 75% — fields: vast3rdQuartile |
vastComplete | VAST Complete | Int64 | Полные досмотры — fields: vastComplete |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
eventDate | Дата | Date | Дата события |
campaignId | ID кампании | Int32 | Идентификатор кампании |
shows | Показы | Int64 | Количество показов |
clicks | Клики | Int64 | Количество кликов |
cpm | CPM | Decimal(18, 2) | Стоимость за тысячу показов |
cpc | CPC | Decimal(18, 2) | Стоимость за клик |
amount | Расходы | Decimal(18, 2) | Сумма расходов |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
groupId | ID группы | Int32 | Идентификатор группы объявлений |
nofCampaigns | Кампаний всего | Int32 | Общее количество кампаний в группе |
nofActiveCampaigns | Кампаний активных | Int32 | Количество активных кампаний в группе |
nofClicks | Клики | Int64 | Количество кликов по группе |
nofImps | Показы | Int64 | Количество показов по группе |
amountSpent | Расходы | Decimal(18, 2) | Сумма расходов по группе |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
id | ID | Int32 | Идентификатор строки аукционных данных |
title | Метка | String | Название показателя аукциона |
value | Значение | Float64 | Значение показателя аукциона |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
dateView | Дата | Date | Дата показа — group_by: dateView |
campaignId | ID кампании | Int32 | Идентификатор кампании — group_by: campaignId |
adId | ID объявления | Int32 | Идентификатор объявления — group_by: adId |
coverage | Охват | Int64 | Количество уникальных пользователей |
frequency | Частота | Float64 | Средняя частота показов на одного пользователя |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Расходы по проектам через XML-RPC sape.get_projects_money_stats(). API возвращает все данные за всё время; фильтрация по выбранному периоду выполняется на стороне коннектора. report_type: financials_projects.
| Поле | Название | Тип | Описание |
|---|---|---|---|
date_logged | Дата | Date | Дата транзакции |
project_id | ID проекта | Int32 | Идентификатор проекта/сайта |
sum | Сумма | Decimal(18, 2) | Сумма расходов по проекту |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Справочные данные аккаунта SAPE DSP без фильтрации по дате — загружаются полностью. Включает кампании, объявления, креативы, сегменты аудитории и справочник средних цен. Тип выбирается параметром «Тип данных».
| Поле | Название | Тип | Описание |
|---|---|---|---|
id | ID | Int32 | Идентификатор объекта |
name | Название | String | Название объекта (кампании, объявления, креатива, сегмента) |
status | Статус | Int32 | Статус объекта (доступен для: Кампании, Объявления, Сегменты) |
type | Тип | Int32 | Тип объекта (доступен для: Кампании, Объявления, Креативы) |
campaignId | ID кампании | Int32 | Идентификатор родительской кампании (доступен для: Объявления) |
pricingType | Тип ценообразования | Int32 | Модель оплаты: CPM, CPC и др. (доступен для: Кампании) |
budget | Бюджет | Decimal(18, 2) | Бюджет кампании (доступен для: Кампании) |
sizeX | Ширина | Int32 | Ширина баннера в пикселях (доступен для: Креативы) |
sizeY | Высота | Int32 | Высота баннера в пикселях (доступен для: Креативы) |
dateCreated | Дата создания | DateTime | Дата создания объекта (доступен для: Креативы) |
size | Размер сегмента | — | Количество пользователей в сегменте (доступен для: Сегменты) |
level | Уровень сайта | Int32 | Уровень сайта-площадки (доступен для: Средние цены) |
pr | PR | Int32 | PageRank сайта-площадки (доступен для: Средние цены) |
price | Средняя цена | Float64 | Средняя цена размещения (доступен для: Средние цены) |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
