Работа с объявлениями

Список объявлений

INFO

GET v2/advertisement/?period=today

Пример использования

INFO

https://client.adstat.pro/api/v2/advertisement/?period=today

Описание query

INFO

Параметр	Тип	Описание
period	Строка	Параметр для ограничения выдачи по времени создания объявления. Значения могут быть - today ( За сегодня ) , all ( За весь период ), yesterday (За вчера) , starts_month ( За текущий месяц ).

Пример ответа

INFO

{
  "data": [
    {
      "id": 1364756,
      "account_name": "SOME_test",
      "campaign_name": "Default",
      "advertisement_title": "example title",
      "status": "stopped",
      "object": "t.me/example",
      "ad_text": "example text",
      "cpm": 3.0,
      "target_topics": [],
      "balance": 0.0,
      "cps": 0,
      "created_dt": "09.01.1998 09:04:26",
      "status_updated_dt": "1998-01-09T09:29:27.311931+00:00",
      "ad_type": "target_channels",
      "goals": 0,
      "impressions": 0,
      "cpc": 0,
      "ctr": 0,
      "spent": 0,
      "clicks": 0
    }
  ]
}

Описание параметров ответа

INFO

Поле	Тип	Описание
id	Число	Уникальный идентификатор объявления.
account_name	Строка	Название аккаунта, которому принадлежит объявление.
campaign_name	Строка	Название кампании, к которой относится объявление.
advertisement_title	Строка	Название объявления.
status	Строка	Текущий статус объявления.
object	Строка	Объект рекламирования.
ad_text	Строка	Текст креатива объявления.
cpm	Число	Стоимость тысячи показов (CPM).
target_topics	Массив строк	Список топиков, на которые таргетируется объявление.
balance	Число	Баланс объявлением.
cps	Число	Стоимость за цель (CPS).
created_dt	Строка	Дата и время создания объявления в формате строки.
status_updated_dt	Строка	Дата и время последнего обновления статуса объявления в формате ISO 8601.
ad_type	Строка	Тип объявления (например, "target_channels", target_users).
goals	Число	Количество достигнутых целей.
impressions	Число	Количество показов объявления.
cpc	Число	Стоимость за клик (CPC).
ctr	Число	Коэффициент кликабельности (CTR).
spent	Число	Сумма потраченных средств.
clicks	Число	Количество кликов по объявлению.
successfully_created_ad_ids	Число	Cписок id созданых объявлений