REST APIs for campaign management and reporting 3.0
Получение токена
POST
https://api.hybrid.ai/token
Время жизни токена — сутки.
Headers
Request Body
Получение нового токена
POST
https://api.hybrid.ai/token
Headers
Request Body
Получение списка рекламодателей по указанному агентству
GET
https://api.hybrid.ai/v3.0/agency/advertisers
Headers
Получение списка кампаний по указанному рекламодателю
GET
https://api.hybrid.ai/v3.0/advertiser/campaigns?advertiserId={advertiserId}
advertiserId — id рекламодателя
Headers
Получение списка баннеров по указанной кампании
GET
https://api.hybrid.ai/v3.0/campaign/banners?campaignId={campaignId}
campaignId — id кампании
Headers
Получение статистики по указанному агентству
GET
https://api.hybrid.ai/v3.0/agency/{split}?from={from}&to={to}&page={page}&limit={limit}
split — поле группировки, смотреть в разделе описание группировок и полей (обязательный параметр) from — нижний порог даты статистики (обязательный параметр) to - верхний порог даты статистики (обязательный параметр) page — номер страницы начиная с 0 (по умолчанию 0) limit — количество строк на странице (по умолчанию 100)
Headers
Получение статистики по указанному рекламодателю
GET
https://api.hybrid.ai/v3.0/advertiser/{split}?from={from}&to={to}&advertiserId={advertiserId}&page={page}&limit={limit}
split — поле группировки, смотреть в разделе "описание группировок и полей" (является обязательным параметром если токен имеет тип "агентство", если токен является типом "рекламодатель", параметр НЕ является обязательным) advertiserId — id рекламодателя (обязательный параметр) from — нижний порог даты статистики (обязательный параметр) to — верхний порог даты статистики (обязательный параметр) page — номер страницы начиная с 0 (по умолчанию 0) limit — количество строк на странице (по умолчанию 100)
Headers
Получение статистики по указанной кампании
GET
https://api.hybrid.ai/v3.0/campaign/{split}?from={from}&to={to}&campaignId={campaignId}&page={page}&limit={limit}
split — поле группировки, смотреть в разделе описание группировок и полей (обязательный параметр) campaignId — id кампании (обязательный параметр) from — нижний порог даты статистики (обязательный параметр) to — верхний порог даты статистики (обязательный параметр) page — номер страницы начиная с 0 (по умолчанию 0) limit — количество строк на странице (по умолчанию 100)
Headers
Описание группировок и полей
Группировки (splits):
Day — по дням Advertiser — по id рекламодателя Country — по стране Region — по региону (области) Ssp — по имени рекламной сети Folder — по папкам кампаний
Получаемые поля статистики (fields):
ImpressionCount — Количество показов ViewCount — Количество просмотров ClickCount — Количество кликов PostClickConversionsCount — Количество Post-click конверсий PostViewConversionsCount — Количество Post-view конверсий FirstQuartileEventsCount — Просмотры видео на 25% MidpointEventsCount — Просмотры видео на 50% ThirdQuartileEventsCount — Просмотры видео на 75% CompleteEventsCount — Просмотры видео на 100% Reach — Охват CTR — Процент кликабельности Viewability — процент видимости рекламного объявления Frequency — Частота показа
Для получения дополнительных группировок и полей обратитесь к вашему менеджеру или напишите на support@hybrid.ai
Last updated