Категории

API: Рекламодатель

В данном разделе представлено описание и методов api раздела рекламодатель. Запросы к API и их описание. Так же в данном разделе вы найдёте всю необходимую информацию для работы с  API раздела "Рекламодатель".

 

Метод: advertiser.updateCompanyById

 

Описание: Изменяет параметры рекламной компании

Параметры:

  • access_token - (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • field_name (Название компании)
  • field_url (Ссылка)
  • field_auto_balance (Автопополнение баланса 1 = Включен, 0 = Выключен)
  • field_autoblance_val (Минимальная сумма автополнения, 100р)
  • field_limit (Лимит Бюджета)
  • field_balance (Пополнения баланса рекламной компании, если field_balance > 0)

 

Метод: advertiser.updateCompanyByIdLogo

 

Описание: Изменяет логотип рекламной компании

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • photo_id (Идентификатор загруженного изображения)

 

Метод: advertiser.getCompanyByIdViewDays

 

Описание: Возвращает список исключений показов рекламной компании по дням

Параметр:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)

 

Метод: advertiser.updateCompanyByIdViewDay

 

Описание: Изменяет исключение показа рекламы по дням

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • ield_days (Список дней: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)

 

Метод: advertiser.getCompanyByIdViewHours

 

Описание: Возвращает список исключений показов рекламной компании по часам

Параметр:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • advertiser_company_disenable_day (Часы: 1,2,3,4,5,6,7,8 и тд до 24)

 

Метод: advertiser.updateCompanyByIdViewHours

 

Описание: Изменяет исключения показа рекламы по часам

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • field_hours (Часы: 1,2,3,4,5,6,7,8 и тд до 24)

 

Метод: advertiser.getCompanyByIdViewRegion

 

Описание: Возвращает список регионов которым будет показана реклама

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)

 

Метод: advertiser.updateCompanyByIdViewRegion (Только POST)

 

Описание: Изменяет показы по регионам, которым будет показываться реклама

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)
  • field_region

 

Метод: advertiser.getBlocksBanner

 

Описание: Возвращает список арендованнх баннеров

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)

 

Метод: advertiser.getBlocks (Контекстная, Фоновая)

 

Описание: Возвращает список рекламных блоков компании

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)

 

Метод: advertiser.getCompanyStatisticTotal

 

Описание: Возвращает общую статистику компании

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор компаии)

 

Метод: advertiser.updateBlockById

 

Описание: Изменяет параметры рекламного блока

Парметры:

  • access_token (Обязательный)
  • advertiser_block_id (Идентификатор блока)
  • advertiser_company_id (Идентификатор компаии)
  • field_title (Название блока)
  • field_url (Ссылка)
  • field_description (Описание)
  • prise_shop (Цена товара)
  • field_price_vid (Покупка за 0 => Просмотры, 1 => За клики)
  • field_price (цена оплаты за field_price_vid)

 

Метод: advertiser.getBlockById

 

Описание: Возвращае данные по запрашиваемому блоку

Параметры:

  • access_token (Обязательный)
  • advertiser_block_id (Идентификатор блока)
  • advertiser_company_id (Идентификатор компаии)

 

Метод: advertiser.savePhotoBlock

 

Описание: Прикрепляет загруженное изображение к рекламному блоку компании

Параметр:

  • access_token (Обязательный)
  • advertiser_block_id (Идентификатор блока)
  • photo_id (Идентификатор загружаемого фото)

 

Метод: advertiser.getCompanyById

 

Описание: Возвращает данные по заданной рекламной компании

Параметр:

  • access_token (Обязательный)
  • advertiser_company_id (Идентификатор рекламной компании)

 

Метод: advertiser.getCompany

 

Описание: Возвращает список компаний рекламодателя

Параметры:

  • access_token (Обязательный)

 

Поля:

 

  • id - идентификатор компании
  • uid - идентификатор пользователя
  • name - название компании
  • logo - логотип компании
  • tid - тематика
  • url - ссылка на компанию
  • country - страна
  • limit - Лимит по балансу
  • limit_period - Лимит по времени
  • balance - текущий баланс компании
  • date - дата добавления
  • статус - статус
  • type_ad - тип рекламной компании (Контекстная, банерная, фоновая)
  • auto_balance - Включен или выключен
  • autoblance_val - Сумма автобаланса

 

Метод: advertiser.deleteBlockByCompany

 

Описание: Удаляет рекламный блок компании

Результат: При успешно удаление блока возвращает response = 1

Парметры:

  • access_token (Обязательный)
  • advertiser_company_id (Обязательно)
  • advertiser_block_id (Обязательно)

 

Метод: advertiser.getStatisticBlockTotal

 

Описание: Возвращает статистику блока, view, click, amount

Парметры:

  • access_token (Обязательный)
  • advertiser_company_id (Обязательно)
  • advertiser_block_id (Обязательно)

 

Метод: advertiser.getCompanyStatistic

 

Описание: Возвращает статистику рекламной компании

Параметры:

  • access_token (Обязательный)
  • advertiser_company_id (Обязательно)
  • date_start - начальная дата статистики
  • date_end - конечная дата статистики
Понравилась наша статья?
Нет
Похожие статьи