Коннектор Buzzoola

Коннектор для работы с API статистики Buzzoola - платформы нативной и видеорекламы. Buzzoola держит четыре изолированных кабинета: рекламодатель, паблишер, SSP и DSP. Тип кабинета выбирается при подключении, от него зависит список доступных отчётов. Рекламодатель, паблишер и DSP подключаются логином и паролем, bearer-токен платформа выпускает сама; для SSP токен выдаёт менеджер площадки, его нужно вставить вручную.

Доступные отчёты

Рекламодатель: статистика по кампаниямСтатистика рекламодателя по дням в разрезе кампаний, лайнайтемов, креативов и рекламных форматов. Названия и кликовые ссылки приходят прямо в ответе. Buzzoola отдаёт не больше восьми дней за один запрос, поэтому период коннектор режет на окна сам.22 полейПодробнее
Рекламодатель: детальная статистикаТот же разрез, что и в статистике по кампаниям, но собранный через актуальный метод API Stat v2. Метрики приходят по идентификаторам, названия коннектор подмешивает из справочника. Единственный отчёт рекламодателя, где Buzzoola может отдать охват. Период режется на окна не больше восьми дней.21 полейПодробнее
Рекламодатель: справочник размещенийКампании, лайнайтемы и креативы, доступные кабинету, одной таблицей. Buzzoola отдаёт справочник срезом на день выгрузки, период на него не влияет.7 полейПодробнее
Паблишер: статистика по площадкамСтатистика паблишера по дням в разрезе площадок, плейсментов и источников спроса. Состав метрик у каждого кабинета свой, поэтому коннектор сначала спрашивает справочник и запрашивает только то, что кабинет реально отдаёт: недоступные колонки останутся пустыми. Разбивка по меткам eid в отчёт не идёт, она разносит выгрузку в десятки раз. По умолчанию Buzzoola показывает только прямую рекламу; чтобы попала и непрямая, доступ открывает менеджер площадки. Данные считаются в UTC.20 полейПодробнее
Паблишер: справочник площадокПлощадки и размещения кабинета одной таблицей: сайт и его плейсменты идут отдельными строками. Отдаётся срезом на день выгрузки, период на него не влияет.7 полейПодробнее
Паблишер: медиацияСтатистика от платформ медиации Яндекса и myTarget по размещениям паблишера. Метод требует перечислить размещения, поэтому коннектор берёт их все из справочника кабинета и запрашивает порциями. В отличие от остальной статистики медиация считается в UTC+3, а не в UTC.11 полейПодробнее
SSP: доходДоход паблишера или SSP по OpenRTB в разбивке по дням. Разбивки, кроме даты, у метода нет. Часовой пояс коннектор задаёт явно как UTC, чтобы цифры не зависели от настроек кабинета. Токен для этого кабинета выдаёт менеджер Buzzoola.6 полейПодробнее
DSP: расходРасход рекламодателя или DSP по OpenRTB в разбивке по дням. Разбивки, кроме даты, у метода нет. Часовой пояс коннектор задаёт явно как UTC. Логин и пароль для этого кабинета выдаёт менеджер Buzzoola.4 полейПодробнее

Доступные данные

Поля, которые доступны в рамках выбранного отчета.

Рекламодатель: статистика по кампаниям

22 полей

Статистика рекламодателя по дням в разрезе кампаний, лайнайтемов, креативов и рекламных форматов. Названия и кликовые ссылки приходят прямо в ответе. Buzzoola отдаёт не больше восьми дней за один запрос, поэтому период коннектор режет на окна сам.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`platform_name`	Платформа	`String`	Название платформы размещения
`client_name`	Бренд	`String`	Наименование бренда рекламодателя
`campaign_id`	ID кампании	`Int64`	Идентификатор рекламной кампании
`campaign_title`	Кампания	`String`	Название рекламной кампании
`line_item_id`	ID лайнайтема	`Int64`	Идентификатор лайнайтема - строки размещения внутри кампании
`line_item_title`	Лайнайтем	`String`	Название лайнайтема
`creative_id`	ID креатива	`Int64`	Идентификатор креатива
`creative_title`	Креатив	`String`	Название креатива
`creative_click_url`	Кликовая ссылка	`String`	Кликовая ссылка креатива с макросами площадки
`creative_erir_click_url`	Ссылка для ЕРИР	`String`	Конечная кликовая ссылка, ведущая на сайт, для отчётности ЕРИР
`ad_format`	Формат	`String`	Рекламный формат размещения, например preroll
`impressions`	Показы	`Int64`	Количество показов
`clicks`	Клики	`Int64`	Количество кликов
`starts`	Старты	`Int64`	Количество запусков воспроизведения ролика
`first_quartiles`	Досмотры 25%	`Int64`	Количество досмотров до 25% ролика
`midpoints`	Досмотры 50%	`Int64`	Количество досмотров до 50% ролика
`third_quartiles`	Досмотры 75%	`Int64`	Количество досмотров до 75% ролика
`completes`	Полные досмотры	`Int64`	Количество полных досмотров ролика
`spent`	Расход	`Float64`	Расход за день. Отдаётся только кабинетам с доступом к финансовой статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»
`cost`	Стоимость размещения	`Float64`	Стоимость размещения. Отдаётся только кабинетам с доступом к финансовой статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»
`reach`	Охват	`Int64`	Количество уникальных пользователей за день, между днями не суммируется. Отдаётся только кабинетам с доступом к охватной статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»

Рекламодатель: детальная статистика

21 полей

Тот же разрез, что и в статистике по кампаниям, но собранный через актуальный метод API Stat v2. Метрики приходят по идентификаторам, названия коннектор подмешивает из справочника. Единственный отчёт рекламодателя, где Buzzoola может отдать охват. Период режется на окна не больше восьми дней.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`client_name`	Бренд	`String`	Наименование бренда рекламодателя из справочника кампаний
`campaign_id`	ID кампании	`Int64`	Идентификатор рекламной кампании
`campaign_title`	Кампания	`String`	Название рекламной кампании из справочника
`line_item_id`	ID лайнайтема	`Int64`	Идентификатор лайнайтема
`line_item_title`	Лайнайтем	`String`	Название лайнайтема из справочника
`cpe`	Стоимость события	`Float64`	Стоимость события лайнайтема. Отдаётся только кабинетам с доступом к финансовой статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»
`creative_id`	ID креатива	`Int64`	Идентификатор креатива
`creative_title`	Креатив	`String`	Название креатива
`creative_click_url`	Кликовая ссылка	`String`	Кликовая ссылка креатива с макросами площадки
`creative_erir_click_url`	Ссылка для ЕРИР	`String`	Конечная кликовая ссылка, ведущая на сайт, для отчётности ЕРИР
`ad_format`	Формат	`String`	Рекламный формат размещения, например preroll
`impressions`	Показы	`Int64`	Количество показов
`clicks`	Клики	`Int64`	Количество кликов
`starts`	Старты	`Int64`	Количество запусков воспроизведения ролика
`first_quartiles`	Досмотры 25%	`Int64`	Количество досмотров до 25% ролика
`midpoints`	Досмотры 50%	`Int64`	Количество досмотров до 50% ролика
`third_quartiles`	Досмотры 75%	`Int64`	Количество досмотров до 75% ролика
`completes`	Полные досмотры	`Int64`	Количество полных досмотров ролика
`spent`	Расход	`Float64`	Расход за день. Отдаётся только кабинетам с доступом к финансовой статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»
`reach`	Охват	`Int64`	Количество уникальных пользователей за день, между днями не суммируется. Отдаётся только кабинетам с доступом к охватной статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»

Рекламодатель: справочник размещений

7 полей

Кампании, лайнайтемы и креативы, доступные кабинету, одной таблицей. Buzzoola отдаёт справочник срезом на день выгрузки, период на него не влияет.

Поле	Название	Тип	Описание
`entity_type`	Тип объекта	`String`	Тип записи справочника: campaign, line_item или creative
`entity_id`	ID объекта	`Int64`	Идентификатор кампании, лайнайтема или креатива
`entity_title`	Название объекта	`String`	Название кампании, лайнайтема или креатива
`client_name`	Бренд	`String`	Наименование бренда, заполнено у кампаний
`cpe`	Стоимость события	`Float64`	Стоимость события лайнайтема. Отдаётся только кабинетам с доступом к финансовой статистике. У остальных Buzzoola это поле не присылает, и в витрине оно будет нулевым: ноль здесь означает «данных нет», а не «нулевое значение»
`creative_click_url`	Кликовая ссылка	`String`	Кликовая ссылка креатива с макросами площадки
`creative_erir_click_url`	Ссылка для ЕРИР	`String`	Конечная кликовая ссылка креатива для отчётности ЕРИР

Паблишер: статистика по площадкам

20 полей

Статистика паблишера по дням в разрезе площадок, плейсментов и источников спроса. Состав метрик у каждого кабинета свой, поэтому коннектор сначала спрашивает справочник и запрашивает только то, что кабинет реально отдаёт: недоступные колонки останутся пустыми. Разбивка по меткам eid в отчёт не идёт, она разносит выгрузку в десятки раз. По умолчанию Buzzoola показывает только прямую рекламу; чтобы попала и непрямая, доступ открывает менеджер площадки. Данные считаются в UTC.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`site_id`	ID сайта	`Int64`	Идентификатор площадки паблишера
`site_title`	Сайт	`String`	Название площадки из настроек кабинета
`site_url`	URL сайта	`String`	Адрес площадки из настроек кабинета
`site_platform`	Тип платформы	`String`	Тип окружения площадки: web, in-app или smart-tv
`placement_id`	ID плейсмента	`Int64`	Идентификатор размещения на площадке
`placement_title`	Плейсмент	`String`	Название размещения из настроек кабинета
`placement_unit_type`	Тип плейсмента	`String`	Тип размещения: instream, inread, fullscreen, banner, flyroll, native и другие
`source`	Источник	`String`	Источник спроса. Приходит, если кабинет отдаёт группировку source
`loads`	Загрузки	`Int64`	Количество загрузок рекламы
`impressions`	Показы	`Int64`	Количество показов рекламы
`clicks`	Клики	`Int64`	Количество нажатий на объявление
`starts`	Старты	`Int64`	Количество запусков воспроизведения ролика
`first_quartiles`	Досмотры 25%	`Int64`	Количество досмотров до 25% ролика
`midpoints`	Досмотры 50%	`Int64`	Количество досмотров до 50% ролика
`third_quartiles`	Досмотры 75%	`Int64`	Количество досмотров до 75% ролика
`completes`	Полные досмотры	`Int64`	Количество полных досмотров ролика
`paids`	Оплачиваемые события	`Int64`	Количество оплачиваемых событий
`requests`	Запросы	`Int64`	Количество запросов рекламы
`revenue`	Доход	`Float64`	Заработок паблишера за день

Паблишер: справочник площадок

7 полей

Площадки и размещения кабинета одной таблицей: сайт и его плейсменты идут отдельными строками. Отдаётся срезом на день выгрузки, период на него не влияет.

Поле	Название	Тип	Описание
`entity_type`	Тип объекта	`String`	Тип записи справочника: site или placement
`entity_id`	ID объекта	`Int64`	Идентификатор площадки или размещения
`entity_title`	Название объекта	`String`	Название площадки или размещения
`site_id`	ID сайта	`Int64`	Идентификатор площадки. У плейсмента это площадка-владелец
`site_url`	URL сайта	`String`	Адрес площадки из настроек кабинета
`site_platform`	Тип платформы	`String`	Тип окружения площадки: web, in-app или smart-tv
`placement_unit_type`	Тип плейсмента	`String`	Тип размещения. У записей типа site пустой

Паблишер: медиация

11 полей

Статистика от платформ медиации Яндекса и myTarget по размещениям паблишера. Метод требует перечислить размещения, поэтому коннектор берёт их все из справочника кабинета и запрашивает порциями. В отличие от остальной статистики медиация считается в UTC+3, а не в UTC.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`mediator_id`	Медиатор	`String`	Платформа медиации: yandex или mytarget
`site_id`	ID сайта	`Int64`	Идентификатор площадки, к которой относится размещение
`placement_id`	ID плейсмента	`Int64`	Идентификатор размещения
`placement_title`	Плейсмент	`String`	Название размещения из справочника
`impressions`	Показы	`Int64`	Количество показов
`clicks`	Клики	`Int64`	Количество кликов
`requests`	Запросы	`Int64`	Количество запросов рекламы
`ads`	Ответы с рекламой	`Int64`	Количество запросов, для которых реклама была подобрана
`noads`	Ответы без рекламы	`Int64`	Количество запросов, для которых реклама не подобралась
`revenue`	Доход	`Float64`	Заработок за день

SSP: доход

6 полей

Доход паблишера или SSP по OpenRTB в разбивке по дням. Разбивки, кроме даты, у метода нет. Часовой пояс коннектор задаёт явно как UTC, чтобы цифры не зависели от настроек кабинета. Токен для этого кабинета выдаёт менеджер Buzzoola.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`loads`	Загрузки	`Int64`	Количество загрузок рекламы
`impressions`	Показы	`Int64`	Количество показов рекламы
`paids`	Оплачиваемые события	`Int64`	Количество оплачиваемых событий
`revenue`	Доход	`Float64`	Заработок за день в рублях
`revenue_usd`	Доход в долларах	`Float64`	Заработок за день в долларах

DSP: расход

4 полей

Расход рекламодателя или DSP по OpenRTB в разбивке по дням. Разбивки, кроме даты, у метода нет. Часовой пояс коннектор задаёт явно как UTC. Логин и пароль для этого кабинета выдаёт менеджер Buzzoola.

Поле	Название	Тип	Описание
`date`	Дата	`Date`	Дата, за которую получена статистика
`paids`	Оплачиваемые события	`Int64`	Количество оплачиваемых событий
`spent`	Расход	`Float64`	Расход за день в рублях
`spent_usd`	Расход в долларах	`Float64`	Расход за день в долларах