Описание

Создает рекламную кампанию. В случае успешного выполнения вернет ответ с ID созданной кампании.

Пример запроса:

https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&status=on

Пример запроса с указанием нескольких значений городов и семейного положения:

https://vkserfing.ru/api/campaign.add?token=a56a7e1rwr358ee0c14c0e58d992da436&link=http://vk.com/club31231231&type=vk_community&relation[]=1&relation[]=2&city[]=1&city[]=2

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

{
    status: 'success',
    data: { id: 23432 }
}
Параметры
Название Описание
name Название
type
обязательный параметр
Тип задания.
Может принимать следующие значения:
  • vk_community - ВК: Вступить в сообщество
  • vk_share - ВК: Рассказать друзьям (+ лайк)
  • vk_like - ВК: Поставить лайк
  • vk_friends - ВК: Добавить в друзья
  • vk_automatic_share - ВК: Автоматические репосты + лайки
  • vk_automatic_like - ВК: Автоматические лайки
project_id ID папки
link
обязательный параметр
Ссылка на задание.
status
обязательный параметр
Статус кампании.
Может принимать следующие значения:
  • on - запустить
  • pause - на паузу
insurance Страховка.
При включении данной опции, в случаях санкций со стороны ВКонтакте к вашему сообществу, мы обязуемся компенсировать потраченные средства.
Может принимать следующие значения:
  • on - включена
  • off - выключена
По умолчанию - off.
adult Материалы для взрослых (18+).
Может принимать следующие значения:
  • on - содержит
  • off - не содержит
По умолчанию - off.
amount_users_limit
обязательный параметр
Количество исполнителей.
amount_users_limit_of_day Лимит исполнителей в сутки.
По умолчанию - 480
amount_users_limit_random Варьировать количество исполнителей
По умолчанию - on
Допустимые значения:
  • on - включено
  • off - выключено
Только для типов заданий vk_automatic_share и vk_automatic_like
amount_automatic_records_limit Количество новых постов (лимит, определяющий сколько заданий будет создано)
0 - без ограничений
Только для типов заданий vk_automatic_share и vk_automatic_like
sex Пол аудитории.
Может принимать следующие значения:
  • 0 - любой
  • 1 - женский
  • 2 - мужской
По умолчанию - 0
relation Семейное положение. Передается в виде массива.
Может принимать следующие значения:
  • 0 - любое
  • 1 - не женат / не замужем
  • 2 - есть друг / есть подруга
  • 3 - помолвлен / помолвлена
  • 4 - женат / замужем
  • 5 - все сложно
  • 6 - в активном поиске
  • 7 - влюблен / влюблена
По умолчанию - 0
Можно указать несколько значений
age_from Минимальный возраст исполнителя
По умолчанию - 0
age_to Максимальный возраст исполнителя
По умолчанию - 999
friends_from Минимальное количество друзей у исполнителя
По умолчанию - 0
friends_to Максимальное количество друзей у исполнителя
По умолчанию - 9999
photos_profile_from Минимальное количество фотографий профиля у исполнителя
По умолчанию - 0
photos_profile_to Максимальное количество фотографий профиля у исполнителя
По умолчанию - 999
wall_items_from Минимальное количество записей на странице исполнителя
По умолчанию - 0
wall_items_to Максимальное количество записей на странице исполнителя
По умолчанию - 99999
from_time_reg_vk_month Минимальное количество месяцев с момента регистрации исполнителя
По умолчанию - 0
country ID страны исполнителя
Список ID стран можно получить методом util.getCountries
city ID городов исполнителя. Передается в виде массива
Список ID городов можно получить на util.getCities
Можно указать до 50 городов
Ошибки
Название Описание
NOT_AVAILABLE Недостаточно прав для проведения операции. Возможно, вам была отключена возможность создавать кампании
INCORRECT_LINK Некорректная ссылка кампании. Ссылка должна начинаться с https://vk.com и соотвествовать выбранному типу задания
EXIST_CAMPAIGN Такая кампания уже существует
BANNED_CAMPAIGN Такая кампания заблокирована
MODERATE_CAMPAIGNS У вас есть кампании на модерации, для создания новых необходимо дождаться их рассмотрения
USER_THIS_CAMPAIGN_ON У вас уже имеется такая же запущенная кампания
ALL_THIS_CAMPAIGN_ON В базе всех кампаний уже имеется такая же запущенная кампания
NOT_EXIST_COMMUNITY Такого сообщества не существует
DELETED_COMMUNITY Такого сообщества не существует или удалено
REQUIRED_PUBLIC_COMMUNITY Сообщество должно быть открытым
REQUIRED_PHOTO_COMMUNITY У сообщества должна быть установлена главная фотография (аватарка)
REQUIRED_WALL_ITEMS_COMMUNITY В сообществе должно быть не менее 5 записей
NOT_EXIST_USER Такого пользователя не существует
DELETED_USER Такого пользователя не существует либо он удален или заблокирован
NOT_AVAILABLE_WALL_ITEM Чтобы создать задание, в настройках приватности страницы https://vk.com/settings?act=privacy (страницы, относящейся к указываемой записи) в параметре "Кому в интернете видна моя страница" установите значение "Всем"
NOT_AVAILABLE_PHOTO_ITEM Фото не существует или скрыто настройками приватности или находится в папке "Сохраненные фотографии"
USERS_LIMIT Достигнут лимит исполнителей для этой кампании
NEW_RECORDS_LIMIT Достигнут лимит количества новых записей
WRONG_CITY Один из передаваемых городов не найден либо не соответствует указанной стране. Все города должны быть из соответствующей страны