Метод: GET /advertiser/listStats
Описание: Вы можете получить статистику по рекламным кампаниям, созданным в вашем рекламном аккаунте HilltopAds.
Параметры:
имя | описание | пример | комментарий |
key | Уникальный ключ API, который вы можете сгенерировать в разделе API вашего аккаунта HilltopAds | nXzgO3Bc | Это обязательный параметр в запросе. |
Date | День, за который необходимо получить данные статистики. | 2023-01-01 | По умолчанию в ответе будет представлена статистика за вчерашний день. |
Date2 | Укажите этот параметр, если вам нужна статистика за определенный период. | 2023-01-31 | Эта дата будет считаться последним днем периода, а параметр date - первым днем. |
GEO | Укажите этот параметр, если вам нужна статистика по конкретным странам.
| Великобритания | Чтобы получить данные по нескольким странам, перечислите их через запятую.
|
ZoneID | Укажите этот параметр, если вам нужна статистика для определенных зон. | 4OACSGAI8 | Чтобы получить данные для нескольких зон, перечислите их через запятую. |
campaignID | Укажите этот параметр, если вам нужна статистика по конкретным кампаниям. | 123456 | Чтобы получить данные по нескольким кампаниям, перечислите их через запятую. |
adID | Укажите этот параметр, если вам нужна статистика по конкретным объявлениям. | 123456 | Чтобы получить данные по нескольким объявлениям, перечислите их через запятую. |
group | Укажите этот параметр, чтобы сгруппировать данные. | дата | Вы можете группировать по: дате, часам, ГЕО, ID зоны, ID кампании, ID объявления. |
Пример запроса:
Чтобы получить статистику по кампании 123456 за период с 1 февраля по 31 марта 2023 года, сгруппированную по дате, необходимо написать следующий запрос:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date