multipost.send-commercial rest api

Добавляет таргетированную рекламную запись в группу.

Метод может быть использован только администратором или владельцем группы. Группа должна иметь статус коммерческой.

Параметры

Имя Тип Описание
uid2intдлинный идентификатор группы, от имени которой будет сделан пост; обязательный параметр
urlstringURL, на который пользователь будет направлен при клике; обязательный параметр
subjectstringзаголовок поста; обязательный параметр
textstringтекст поста; обязательный параметр
photostringиндефикатор изображения, прикрепленного к посту в виде "auid:pid (идентификатор юзера и идентификатор фото)"; обязательный параметр
priorityintприоритет - число от 0 до 9, определяет вес данного поста по отношению к остальным. показ будет осуществлятся на основе алгоритма равномерной весовой балансировки.
countryintгео идентификаторы страны (см ниже)
genderintпол. 1 - мужчина, 2 - женщина
ageintиндефикатор диапазона возраста. см. ниже

Должен быть указан хотя бы один параметр из "subject", "text" и "photo".

Диапазоны возрастов:

1 - до 11 лет
2 - от 11 до 15 лет
3 - от 16 до 20 лет
4 - от 21 до 25 лет
5 - от 26 до 30 лет
6 - от 31 до 35 лет
7 - от 36 до 40 лет
8 - от 41 до 45 лет
9 - от 46 до 50 лет
10 - 50+ лет

Гео идентификаторы

Можно указать гео идентификатор региона для таргетирования.
Список регионов: http://rb.mail.ru/export/regions.csv
Первые два значения в строке обозначают код региона и код родительского региона. Если родительский регион равен 0, то это страна. В параметре к методу можно указывать только код страны, вложенные регионы работать не будут.

Результат

{
   "id": 366141,
   "sent": 1
}

Коды ошибок

КодОписание
1Unknown error: Please resubmit the request.
2Unknown method called.
3Service Unavailable. Please try again later.
4Method is deprecated.
100One of the parameters specified is missing or invalid.
102User authorization failed: the session key or uid is incorrect.
103Application lookup failed: the application id is not correct.
104Incorrect signature.
105Application is not installed for this user.
200Permission error: the application does not have permission to perform this action.

См. также

Использование REST API

Функции REST API