Описание

RTB.Sape.ru Xml-Rpc

Наш xml-rpc интерфейс доступен по адресу http://api.sape.ru/xmlrpc/?rtb=1. Обращаться нужно по 80-му порту, тело xml-запроса класть в POST_DATA. Всё общение происходит полностью в кодировке UTF-8. Кроме того, можно работать по https по адресу https://api.sape.ru/xmlrpc/?rtb=1.

Если Вы ещё ничего не знаете про XML-RPC, то рекомендуем почитать на сайте www.xmlrpc.com:

  1. Реализация протокола для Вашего любимого языка программирования.
  2. Для любителей PHP рекомендуем Zend Framework

Важно: перед вызовом функций необходимо залогиниться в системе в с помощью функции: sape.login

Фильтр по категориям Скрыть фильтр
Выберите роль:
Выбрать категорию

Функции

(array) rtb.get_site_categories()

Описание

Получение категорий.

Возвращаемое значение

Тип Описание
array Список, каждый элемент которого содержит:
  • (int) id - Идентификатор категории
  • (string) title - Название категории
(array) rtb.get_sites( [(string) url = null] )

Описание

Получение списка площадок пользователя.

Аргументы

Имя Тип Обязательно По умолчанию Описание
url string Нет null УРЛ площадки

Возвращаемое значение

Тип Описание
array список площадок пользователя:
  • (int) id - Идентификатор площадки
  • (string) url - УРЛ
  • (string) status - Статус
  • (int) show_mobile_ad - Признак показа на мобильных устройствах
  • (date) date_created - Дата и время создания
(array) rtb.get_ads_txt()

Описание

Получения строк ads.txt для сайта.

Возвращаемое значение

Тип Описание
array список строк для ads.txt
(array) rtb.site_add( (string) url, (int) showMobileAd, (int|string) categoryId[, (array) blDomainIds = array()[, (boolean) flagTest = true]] )

Описание

Добавление площадки.

Аргументы

Имя Тип Обязательно По умолчанию Описание
url string Да - УРЛ площадки
showMobileAd int Да - признак показа на мобильных устройствах
categoryId int|string Да - ID категории (целое число - ID из справочника rtb.get_site_categories; строка - iab категория вида IABxxx)
blDomainIds array Нет array() список доменов в черном списке
flagTest boolean Нет true эксперименты по увеличению дохода

Возвращаемое значение

Тип Описание
array Информация по домену:
  • (int) id - Идентификатор площадки
  • (string) url - УРЛ
  • (string) status - Статус
  • (int) category_id - Категория
  • (array) bl_domains - Список доменов в черном списке
  • (date) date_created - Дата и время создания
(array) rtb.site_update( (int) siteId, (int) showMobileAd, (int|string) categoryId[, (array) blDomainIds = array()[, (boolean) flagTest = true]] )

Описание

Редактирование площадки.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
showMobileAd int Да - признак показа на мобильных устройствах
categoryId int|string Да - ID категории (целое число - ID из справочника rtb.get_site_categories; строка - iab категория вида IABxxx)
blDomainIds array Нет array() список доменов в черном списке
flagTest boolean Нет true эксперименты по увеличению дохода

Возвращаемое значение

Тип Описание
array Содержит следующие значения:
  • (int) id - Идентификатор площадки
  • (string) url - УРЛ
  • (string) status - Статус
  • (int) category_id - Категория
  • (array) bl_domains - Список доменов в черном списке
  • (date) date_created - Дата и время создания
(array) rtb.get_places( [(array) siteIds = null[, (int) placeType = null[, (boolean) showAllFields = false]]] )

Описание

Получение списка рекламных мест.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteIds array Нет null ID интересующих площадок
placeType int Нет null Тип места
showAllFields boolean Нет false Показывать все поля

Возвращаемое значение

Тип Описание
array Площадки:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (int) * type - Тип
  • (string) size - Размер
  • (int) size_x - Размер (ширина)
  • (int) size_y - Размер (высота)
  • (string) code - Код
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (float) * min_cpm - Минимальный CPM
  • (boolean) * ibv - IBV (in-banner видео)
  • (boolean) * multiformat - Мультиформат
  • (date) date_created - Дата и время создания
(array) rtb.banner_place_add( (int) siteId, (string) placeName, (int) popup, (int) size[, (float) minCpm = 2[, (string) html = null[, (boolean) async = true[, (array) options = null]]]] )

Описание

Добавление банерного рекламного места.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места
popup int Да - попап
size int Да - размер
minCpm float Нет 2 минимальный CPM
html string Нет null html-код
async boolean Нет true признак асинхронности
options array Нет null Содержит следующие значения:
  • (boolean) ibv - IBV (in-banner видео)
  • (boolean) multiformat - Мультиформат

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.banner_place_update( (int) placeId, (string) placeName, (int) popup[, (float) minCpm = 2[, (string) html = null[, (boolean) async = true[, (array) options = null]]]] )

Описание

Изменение банерного рекламного места.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID площадки
placeName string Да - название рекламного места
popup int Да - попап
minCpm float Нет 2 минимальный CPM
html string Нет null html-код
async boolean Нет true признак асинхронности
options array Нет null Содержит следующие значения:
  • (boolean) ibv - IBV (in-banner видео)
  • (boolean) multiformat - Мультиформат

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.video_place_add( (int) siteId, (string) placeName[, (string) html = null[, (boolean) async = true]] )

Описание

Добавление места с видео рекламой.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.video_place_update( (int) placeId, (string) placeName[, (string) html = null[, (boolean) async = true]] )

Описание

Изменение места с видео рекламой.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID рекламного места
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности

Возвращаемое значение

Тип Описание
array результирующий массив измененного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.inpage_place_add( (int) siteId, (string) placeName[, (string) html = null[, (boolean) async = true]] )

Описание

Добавление рекламного места для видео в контенте страницы.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.inpage_place_update( (int) placeId, (string) placeName[, (string) html = null[, (boolean) async = true]] )

Описание

Изменение рекламного места для видео в контенте страницы.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID рекламного места
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности

Возвращаемое значение

Тип Описание
array результирующий массив измененного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.float_place_add( (int) siteId, (string) placeName[, (int) timeout = 15[, (string) background = rgba(255,255,255,0.5)[, (string) color = rgba(0,0,0,1)]]] )

Описание

Добавление рекламного места - растяжки.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного метса
timeout int Нет 15 таймаут
background string Нет rgba(255,255,255,0.5) цвет фона
color string Нет rgba(0,0,0,1) цвет текста

Возвращаемое значение

Тип Описание
array массив с информацией о добавленном рекламном месте:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.float_place_update( (int) placeId, (string) placeName[, (int) timeout = 15[, (string) background = rgba(255,255,255,0.5)[, (string) color = rgba(0,0,0,1)]]] )

Описание

Изменение рекламного места - растяжки.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID рекламного места
placeName string Да - название рекламного места
timeout int Нет 15 таймаут
background string Нет rgba(255,255,255,0.5) цвет фона
color string Нет rgba(0,0,0,1) цвет текста

Возвращаемое значение

Тип Описание
array результирующий массив измененного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.native_place_add( (int) siteId, (string) placeName[, (string) html = null[, (boolean) async = true[, (array) template = null]]] )

Описание

Добавление места с нативным баннером.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности
template array Нет null настройки отображения:
  • (int) template_id = 1 - шаблон:
    • 1 - Картинка сверху
    • 2 - Картинка сбоку
    • 3 - Заголовок сверху
    • 4 - Текст без картинки
  • (int) global_font = Arial - шрифт текста:
    • Arial
    • Sans-Serif
    • Times New Roman
    • Verdana
  • (string) global_bg = rgb(255,255,255) - цвет фона
  • (string) global_border_color = rgb(128,128,128) - цвет рамки
  • (int) global_border_width = 0 - ширина рамки (px)
  • (int) global_padding_top = 0 - отступ сверху (px)
  • (int) global_padding_right = 0 - отступ справа (px)
  • (int) global_padding_bottom = 0 - отступ снизу (px)
  • (int) global_padding_left = 0 - отступ слева (px)
  • (string) image_aspect_ratio = wide - соотношение сторон изображения:
    • square - 1:1
    • wide - 1:1.94
  • (int) image_width = 100 - ширина изображения (%)
  • (int) image_padding_top = 0 - отступ от изображения сверху (px)
  • (int) image_padding_right = 0 - отступ от изображения справа (px)
  • (int) image_padding_bottom = 0 - отступ от изображения снизу (px)
  • (int) image_padding_left = 0 - отступ от изображения слева (px)
  • (string) headline_length = short - длина заголовка:
    • short - Короткий
    • long - Длинный
  • (int) headline_font_size = 14 - размер шрифта заголовка (px)
  • (string) headline_align = left - выранивание текста в заголовке:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) headline_weight = bold - насыщенность заголовка:
    • normal - Обычная
    • bold - Жирная
  • (string) headline_font_color = rgb(33,33,33) - цвет шрифта заголовка
  • (int) headline_padding_top = 10 - отступ от заголовка сверху (px)
  • (int) headline_padding_right = 10 - отступ от заголовка справа (px)
  • (int) headline_padding_bottom = 0 - отступ от заголовка снизу (px)
  • (int) headline_padding_left = 10 - отступ от заголовка слева (px)
  • (boolean) description_show = 1 - показывать описание
  • (int) description_font_size = 12 - размер шрифта описания (px)
  • (string) description_align = left - выранивание текста в описании:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) description_weight = normal - насыщенность описания:
    • normal - Обычная
    • bold - Жирная
  • (string) description_font_color = rgb(117,117,117) - цвет шрифта описания
  • (int) description_padding_top = 10 - отступ от описния сверху (px)
  • (int) description_padding_right = 10 - отступ от описния справа (px)
  • (int) description_padding_bottom = 10 - отступ от описния снизу (px)
  • (int) description_padding_left = 10 - отступ от описния слева (px)
  • (int) url_font_size = 11 - размер шрифта ссылки (px)
  • (string) url_align = left - выранивание текста в ссылке:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) url_weight = normal - насыщенность ссылки:
    • normal - Обычная
    • bold - Жирная
  • (string) url_font_color = rgb(140,140,140) - цвет шрифта ссылки
  • (int) url_padding_top = 3 - отступ от ссылки сверху (px)
  • (int) url_padding_right = 10 - отступ от ссылки справа (px)
  • (int) url_padding_bottom = 0 - отступ от ссылки снизу (px)
  • (int) url_padding_left = 10 - отступ от ссылки слева (px)
  • (string) button_bg = rgb(255,255,255) - цвет фона
  • (string) button_font_color = rgb(117,117,117) - цвет шрифта ссылки
  • (string) button_border_color = rgb(153,153,153) - цвет рамки ссылки

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.native_place_update( (int) placeId, (string) placeName[, (string) html = null[, (boolean) async = true[, (array) template = null]]] )

Описание

Изменение места для нативного баннера.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID места
placeName string Да - название рекламного места
html string Нет null html-код
async boolean Нет true признак асинхронности
template array Нет null настройки отображения:
  • (int) template_id = 1 - шаблон:
    • 1 - Картинка сверху
    • 2 - Картинка сбоку
    • 3 - Заголовок сверху
    • 4 - Текст без картинки
  • (int) global_font = Arial - шрифт текста:
    • Arial
    • Sans-Serif
    • Times New Roman
    • Verdana
  • (string) global_bg = rgb(255,255,255) - цвет фона
  • (string) global_border_color = rgb(128,128,128) - цвет рамки
  • (int) global_border_width = 0 - ширина рамки (px)
  • (int) global_padding_top = 0 - отступ сверху (px)
  • (int) global_padding_right = 0 - отступ справа (px)
  • (int) global_padding_bottom = 0 - отступ снизу (px)
  • (int) global_padding_left = 0 - отступ слева (px)
  • (string) image_aspect_ratio = wide - соотношение сторон изображения:
    • square - 1:1
    • wide - 1:1.94
  • (int) image_width = 100 - ширина изображения (%)
  • (int) image_padding_top = 0 - отступ от изображения сверху (px)
  • (int) image_padding_right = 0 - отступ от изображения справа (px)
  • (int) image_padding_bottom = 0 - отступ от изображения снизу (px)
  • (int) image_padding_left = 0 - отступ от изображения слева (px)
  • (string) headline_length = short - длина заголовка:
    • short - Короткий
    • long - Длинный
  • (int) headline_font_size = 14 - размер шрифта заголовка (px)
  • (string) headline_align = left - выранивание текста в заголовке:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) headline_weight = bold - насыщенность заголовка:
    • normal - Обычная
    • bold - Жирная
  • (string) headline_font_color = rgb(33,33,33) - цвет шрифта заголовка
  • (int) headline_padding_top = 10 - отступ от заголовка сверху (px)
  • (int) headline_padding_right = 10 - отступ от заголовка справа (px)
  • (int) headline_padding_bottom = 0 - отступ от заголовка снизу (px)
  • (int) headline_padding_left = 10 - отступ от заголовка слева (px)
  • (boolean) description_show = 1 - показывать описание
  • (int) description_font_size = 12 - размер шрифта описания (px)
  • (string) description_align = left - выранивание текста в описании:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) description_weight = normal - насыщенность описания:
    • normal - Обычная
    • bold - Жирная
  • (string) description_font_color = rgb(117,117,117) - цвет шрифта описания
  • (int) description_padding_top = 10 - отступ от описния сверху (px)
  • (int) description_padding_right = 10 - отступ от описния справа (px)
  • (int) description_padding_bottom = 10 - отступ от описния снизу (px)
  • (int) description_padding_left = 10 - отступ от описния слева (px)
  • (int) url_font_size = 11 - размер шрифта ссылки (px)
  • (string) url_align = left - выранивание текста в ссылке:
    • left - Слева
    • center - По центру
    • justify - По ширине
    • right - Справа
  • (int) url_weight = normal - насыщенность ссылки:
    • normal - Обычная
    • bold - Жирная
  • (string) url_font_color = rgb(140,140,140) - цвет шрифта ссылки
  • (int) url_padding_top = 3 - отступ от ссылки сверху (px)
  • (int) url_padding_right = 10 - отступ от ссылки справа (px)
  • (int) url_padding_bottom = 0 - отступ от ссылки снизу (px)
  • (int) url_padding_left = 10 - отступ от ссылки слева (px)
  • (string) button_bg = rgb(255,255,255) - цвет фона
  • (string) button_font_color = rgb(117,117,117) - цвет шрифта ссылки
  • (string) button_border_color = rgb(153,153,153) - цвет рамки ссылки

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (string) * background - Цвет фона
  • (string) * color - Цвет шрифта
  • (int) * timeout - Таймаут
  • (string) * html - HTML-код
  • (boolean) * async - Признак асинхронности
  • (int) * popup - Всплывающее окно
  • (int) * size - Идентификатор размера
  • (int) * min_cpm - Минимальный CPM
(array) rtb.vast_place_add( (int) siteId, (string) placeName )

Описание

Добавление VAST места.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
(array) rtb.hb_place_add( (int) siteId, (string) placeName[, (boolean) allowIbn = false[, (int) creativeType]] )

Описание

Добавление Header Bidding места.

Аргументы

Имя Тип Обязательно По умолчанию Описание
siteId int Да - ID площадки
placeName string Да - название рекламного места
allowIbn boolean Нет false разрешить IBV
creativeType int Нет 0 тип креатива:
  • 0 - Задано hb-кодом
  • 1 - Fullscreen от sape
  • 2 - Fullscreen от adfox

Возвращаемое значение

Тип Описание
array результирующий массив добавленного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (boolean) allow_ibn - Разрешить IBV
  • (int) creative_type - Тип креатива
(array) rtb.hb_place_update( (int) placeId, (string) placeName[, (boolean) allowIbn = false[, (int) creativeType]] )

Описание

Изменение Header Bidding места.

Аргументы

Имя Тип Обязательно По умолчанию Описание
placeId int Да - ID рекламного места
placeName string Да - название рекламного места
allowIbn boolean Нет false разрешить IBV
creativeType int Нет 0 тип креатива:
  • 0 - Задано hb-кодом
  • 1 - Fullscreen от sape
  • 2 - Fullscreen от adfox

Возвращаемое значение

Тип Описание
array результирующий массив измененного рекламного места:
  • (int) id - Идентификатор рекламного места
  • (int) site_id - Идентификатор площадки
  • (string) name - Название
  • (string) type - Тип рекламного места
  • (boolean) allow_ibn - Разрешить IBV
  • (int) creative_type - Тип креатива
(array) rtb.get_stats( (timestamp) dateFrom, (timestamp) dateTo[, (string) groupBy = site[, (array) siteIds = array()[, (array) placeIds = array()]]] )

Описание

Получение подневной статистки показов. Максимальный диапазон дат составляет 31 день

Аргументы

Имя Тип Обязательно По умолчанию Описание
dateFrom timestamp Да - дата с..
dateTo timestamp Да - дата по..
groupBy string Нет site группировка (place|site|user)
siteIds array Нет array() список ID площадок
placeIds array Нет array() список ID рекламных мест

Возвращаемое значение

Тип Описание
array таблица статистики:
  • (date) date_view - Дата показа
  • (int) site_id - Идентификатор площадки
  • (int) place_id - Идентификатор рекламного места
  • (float) price_wm - Заработано
  • (float) price_wait - Ожидает начисления
  • (int) imps_total - Всего показов
  • (int) imps_billed - RTB-показов оплаченных
  • (int) imps_unbilled - RTB-показов неоплаченных
  • (float) rtb_cpm - Коэффициент CPM
  • (float) ctr - Коэффициент CTR
(array) rtb.get_stat_changes( (timestamp) dateFrom )

Описание

Получение списка дат, измененных после запрашиваемой.

Аргументы

Имя Тип Обязательно По умолчанию Описание
dateFrom timestamp Да - дата последнего изменения

Возвращаемое значение

Тип Описание
array Содержит следующие значения:
  • (array) data - список измененных дат
  • (date) last - дата последнего изменения

Коды ошибок

Код
Сообщение
Описание
100
SAPE.RU: Not enough params :o(
Не достаточно параметров
101
SAPE.RU: Internal error :o(
Внутренняя ошибка
102
SAPE.RU: Bad or unknown ID :o(
Неверный ID
110
SAPE.RU: User registration failed :o(
Пользователь не зарегистрирован
111
SAPE.RU: Bad login :o(
Неверный логин или пароль
112
SAPE.RU: Login already in use :o(
Данный логин уже есть в системе
113
SAPE.RU: Email already in use :o(
Данный e-mail уже есть в системе
114
SAPE.RU: Password too short :o(
Пароль слишком короткий
115
SAPE.RU: Bad email :o(
Невалидный e-mail
116
SAPE.RU: Bad username :o(
Некорректное имя пользователя
117
SAPE.RU: Bad refid :o(
Неверный ID реферала
118
SAPE.RU: Bad user id :o(
Неверный ID пользователя
119
SAPE.RU: User not auth :o(
Пользователь не авторизован
120
SAPE.RU: Bad external system ID :o(
Неправильный ID внешней системы
121
SAPE.RU: Method is restricted for current user :o(
Метод не разрешается вызывать для этого пользователя
122
SAPE.RU: User does not exist :o(
Пользователь не существует
123
SAPE.RU: User does not have a phone :o(
У пользователя нету телефона
140
SAPE.RU: Billing in progress :o(
Идёт биллинг
141
SAPE.RU: Afterbilling aggregations building in progress :o(
Идёт послебиллинговое построение аггрегаций
150
SAPE.RU: Bad subscribe type :o(
Неверный тип подписки
151
SAPE.RU: Bad template id :o(
Неверный id шаблона
210
SAPE.RU: Anchor add failed :o(
Анкор не добавлен
211
SAPE.RU: Anchor delete failed :o(
Анкор не удален
310
SAPE.RU: Project create failed :o(
Проект не создан
311
SAPE.RU: Project bad name :o(
Некорректное название прокта
320
SAPE.RU: URL Add failed :o(
URL не добавлен
321
SAPE.RU: URL is banned :o(
URL забанен
322
SAPE.RU: Bad URL length :o(
Неверная длина URLа
323
SAPE.RU: URL is malformed :o(
Неправильно сформированный URL
324
SAPE.RU: Bad URL domain :o(
Неверный домен URLа
325
SAPE.RU: Url contains quote :o(
URL содержит кавычки
330
SAPE.RU: Site add failed :o(
Сайт не добавлен
331
SAPE.RU: Bad url :o(
Неверный URL
332
SAPE.RU: Site already exists :o(
Сайт уже есть в системе
333
SAPE.RU: No code on front page :o(
Отсутствует код системы на главной странице
334
SAPE.RU: No code on page :o(
Отсутствует код системы на странице
335
SAPE.RU: No connection to site :o(
Ошибка связи с сервером
336
SAPE.RU: Site cannot be reindexed now :o(
В данный момент переиндексация сайта запрещена
337
SAPE.RU: Site is already bought out :o(
Сайт уже выкуплен
338
SAPE.RU: Site reindex is already started :o(
Ошибка, задание в очереди или уже выполняется.
410
SAPE.RU: Placement create failed :o(
Ссылка не создана
420
SAPE.RU: Placement delete failed :o(
Ссылка не удалена
430
SAPE.RU: Placement update text failed :o(
Текст ссылки не изменен
432
SAPE.RU: Placement update price failed :o(
Цена ссылки не изменена
435
SAPE.RU: Placement update url failed :o(
URL ссылки не изменен
440
SAPE.RU: Placement accept SEO failed :o(
Ссылка не подтверждена оптимизатором
450
SAPE.RU: Placement unsleep failed :o(
Ссылка не восстановлена
460
SAPE.RU: Placement accept WM failed :o(
Ссылка не подтверждена вебмастером
465
SAPE.RU: Placement new price accept failed :o(
Ошибка подтверждения новых цен
466
SAPE.RU: Placement new price reject failed :o(
Ошибка отклонения новых цен
470
SAPE.RU: Autofilter create failed, no texts on url
Автофильтр не создан, для URLа не создано ни одного текста
471
SAPE.RU: Autofilter create failed, already exist
Автофильтр не создан, уже существует
500
SAPE.RU: Bad Project ID
Неверный ID проекта
501
SAPE.RU: Bad Site ID
Неверный ID сайта
502
SAPE.RU: Bad URL ID
Неверный ID URLа
503
SAPE.RU: Bad Placement ID
Неверный ID ссылки
504
SAPE.RU: Bad Placement Text
Неверный текст ссылки
505
SAPE.RU: Bad date in params
Неверный формат даты в параметрах
506
SAPE.RU: Bad Page ID
Неверный ID страницы
507
SAPE.RU: Bad Project ID - No URLs
Неверный ID проекта - отсутствуют URLы
508
SAPE.RU: Bad category id
Неверный ID категории
509
SAPE.RU: Bad filter id
Неверный ID фильтра
510
SAPE.RU: Bad whitelist id
Неверный ID раздела в избранном
511
SAPE.RU: Bad keyword
Неверное ключевое слово
512
SAPE.RU: Bad stop-words list ID
Неверное ID списка стоп-слов
513
SAPE.RU: Bad Project blacklist ID
Не задан black-лист проекта
514
SAPE.RU: Bad date interval
Неверный интервал дат
515
SAPE.RU: Bad domain id
Неверный ID домена
521
SAPE.RU: Bad placement anchor ID
Неверный ID анкора
522
SAPE.RU: Empty placement anchor
Пустой анкор
523
SAPE.RU: Malformed placement anchor
Некорректный анкор
524
SAPE.RU: Spammed placement anchor
Заспамленный анкор
525
SAPE.RU: Anchor too long
Анкор слишком длинный
526
SAPE.RU: Anchor exist
Анкор существует
650
SAPE.RU: Empty login :o(
Пустой логин
651
SAPE.RU: User is not activated :o(
Пользователь не активирован
652
SAPE.RU: Quantity of attempts of authentication for current IP is exceeded :o(
Количество попыток авторизации для текущего IP исчерпано
653
SAPE.RU: Login does not exist :o(
Пользователь не существует
654
SAPE.RU: Invalid authorization cookie :o(
Неверная авторизационная cookie
655
SAPE.RU: User is banned :o(
Пользователь забанен
656
SAPE.RU: User is blocked - need to change password :o(
Пользователь заблокирован - должен сменить пароль
657
SAPE.RU: Invalid authorization ticket :o(
Неверный авторизационный тикет
660
SAPE.RU: Access restricted for current IP :o(
Доступ с текущего IP запрещен
661
SAPE.RU: No partner contract :o(
Нет договора партнерской программы
662
SAPE.RU: No WM contract :o(
Нет договора вебмастера
663
SAPE.RU: No SEO contract :o(
Нет договора оптимизатора
664
SAPE.RU: Extended mode denied :o(
Доступ к дополнительным функциям закрыт
665
SAPE.RU: Not wizard account
Это не визард аккаунт
666
SAPE.RU: Invalid login or password :o(
Неверный логин или пароль
667
SAPE.RU: Please, login
Пожалуйста авторизуйтесь в системе
668
SAPE.RU: Quantity of attempts of authentication is exceeded
Количество попыток авторизации исчерпано
669
SAPE.RU: TEMPORARY UNAVAILABLE
Временно не доступно
670
SAPE.RU: Empty array!
Пустой массив
671
SAPE.RU: Input array empty!
Входной массив данных пустой
672
SAPE.RU: Return array empty!
Выходной массив данных пустой
673
SAPE.RU: Search result empty!
Поиск вернул пустой результат
680
SAPE.RU: Request processing error!
Ошибка во время обработки запроса)
681
SAPE.RU: Request already exist!
Запрос уже существует
711
SAPE.RU: Bill amount too small :o(
Сумма счета слишком мала
800
SAPE.RU: Bad handle :o(
Неверный указатель
801
SAPE.RU: Get task status failed :o(
Ошибка получения статуса по переданному указателю
802
SAPE.RU: Cannot get factor status :o(
Невозможно получить статус фактора
900
SAPE.RU: OAuth error :o(
Ошибка OAuth
1000
SAPE.RU: Elama error :o(
Ошибка Elama
1100
SAPE.RU: RT error :o(
Ошибка RT
1200
SAPE.RU: RTB error :o(
Ошибка RTB
1400
SAPE.RU: Wizard error :o(
Ошибка Wizard
1500
SAPE.RU: Archiving in PR failed :o(
Архивирвоание проекта в PR закончилось неудачей
2101
SAPE.RU: Anchor add_failed, bad name :o(
Анкор не добавлен, некорректное название
2201
SAPE.RU: Teaser upload failed, maximum allowed size for file 1.95MB :o(
Файл с картинкой должен быть меньше 1.95MB
2202
SAPE.RU: Teaser upload failed, file must be jpg, gif or png :o(
Файл с картинкой должен быть в формате jpg, gif или png
2203
SAPE.RU: Teaser upload failed, file broken:o(
Файл с картинкой не читается
4101
SAPE.RU: Placement create failed, undefined page
Ссылка не создана, страница не определена
4102
SAPE.RU: Placement create failed, big price
Ссылка не создана, слишком высокая цена
4103
SAPE.RU: Placement create failed, undefined site
Ссылка не создана, сайт не определен
4104
SAPE.RU: Placement create failed, links limit reached
Ссылка не создана, достигнут предел размещенией
4105
SAPE.RU: Placement create failed, page is not active
Ссылка не создана, страница не активирована
4106
SAPE.RU: Placement create failed, site is not active
Ссылка не создана, сайт не активирован
4107
SAPE.RU: Placement create failed, self link (anchor_url==site_url)
Ссылка не создана, является внутренней
4108
SAPE.RU: Placement create failed, link already exists
Ссылка не создана, данная ссылка уже существует
4109
SAPE.RU: Placement create failed, IN WM BL
Ссылка не создана, URL в блэклисте вебмастера
4110
SAPE.RU: Placement create failed, IN SEO BL
Ссылка не создана, сайт в блэклисте оптимизатора
4111
SAPE.RU: Placement create failed, text error
Ссылка не создана, ошибка текста
4112
SAPE.RU: Placement create failed, not enough money for 2 days
Ссылка не создана, не достаточно средств на 2 дня размещения
4113
SAPE.RU: Placement context create failed, anchor text error
Контекстная ссылка не создана, ошибка в тексте анкора
4114
SAPE.RU: Placement context create failed, sql error
Контекстная ссылка не создана, SQL-ошибка
4116
SAPE.RU: Placement context create failed, no snippet
Контекстная ссылка не создана, отсутствует сниппет
4117
SAPE.RU: Placement get good text failed, there are stop words
Текст не подобран, присутствуют стоп-слова
4118
SAPE.RU: Placement get good text failed, there are russian chars
Текст не подобран, присутствуют русские буквы
4119
SAPE.RU: Placement get good text failed
Текст не подобран
4120
SAPE.RU: Placement get good text failed, no active anchor texts
Текст не подобран, нет активных текстов
4510
SAPE.RU: URL unsleep failed :o(
URL не восстановлен
4511
SAPE.RU: URL unsleep failed, no money :o(
URL не восстановлен, не хватает денег
4512
SAPE.RU: URL unsleep failed, no links to unsleep :o(
URL не восстановлен, нет ссылок для восстановления
6651
SAPE.RU: Not wizard user account
Этот аккаунт не пользуется визардом
6661
SAPE.RU: Authorization by password or md5 is prohibited. Please use token instead (Details: https://help.sape.ru/sape/faq/1685). To generate token visit https://passport.sape.ru/security/token/.
Авторизация по паролю или md5 запрещена. Пожалуйста, используйте токен (Подробнее: https://help.sape.ru/sape/faq/1685). Сгенерировать токен можно в вашем аккаунте: https://passport.sape.ru/security/token/
7000
SAPE.RU: Too deep :o(
Уточните условия поиска
7001
SAPE.RU: Too short word :o(
Слишком короткое слово
7002
SAPE.RU: Quantity of calls to a method is exceeded
Количество обращений к методу исчерпано
7003
SAPE.RU: Search result is too big :o(
Слишком много данных в результате поиска, уточните условия
41021
SAPE.RU: Placement create failed, zero price
Ссылка не создана, цена нулевая
41031
SAPE.RU: Placement create failed, site is not saling
Ссылка не создана, на сайте отключена продажа ссылок
41181
SAPE.RU: Placement get good text failed, there are not russian chars
Текст не подобран, отсутствуют русские буквы
41301
SAPE.RU: Placement create failed, undefined teaser page
Ссылка не создана, тизерная страница не определена
41302
SAPE.RU: Placement create failed, not enough traffic
Ссылка не создана, недостаточно трафика на странице
41304
SAPE.RU: Placement create failed, not enough traffic on site
Ссылка не создана, недостаточно трафика на сайте
41305
SAPE.RU: Placement create failed, teaser blocks limit reached
Ссылка не создана, превышен лимит тизерных блоков