Skip to content

В пакет rvkstat добавлена функция vkGetAdsLayout

Compare
Choose a tag to compare
@selesnow selesnow released this 27 Feb 16:07
· 169 commits to master since this release
66e4ddf

1. Новая функция vkGetAdsLayout

Возвращает описания внешнего вида рекламных объявлений.

Аргументы

  • account_id - Идентификатор рекламного кабинета, список всех доступных рекламных кабинетов можно получить с помщью функции vkGetAdAccounts.
  • client_id - Идентификатор клиента, у которого запрашиваются рекламные объявления. Доступно и обязательно для рекламных агентств.
  • include_deleted - Логическое TRUE или FALSE, флаг, задающий необходимость вывода архивных объявлений.
  • campaign_ids - Числовой вектор, фильтр по рекламным кампаниям.
  • ad_ids - Числовой вектор, фильтр по рекламным объявлениям.
  • status_names - Логическое TRUE или FALSE, если значение TRUE то формат объявления и тип оплаты будут возвращены в виде строковых значений, если передать в аргумент status_names значение FALSE то перечисленные значения будут возвращены в виде их ID.
  • api_version - Версия API к который вы будете обращаться, список актуальных версий доступен по ссылке.
  • access_token - Токен доступа к API, полученный с помощью функций vkAuth или vkGetToken

Пример кода для получения описания внешнего вида рекламных объявлений

##Авторизация в вконтакте
my_tok <- vkAuth(app_id = 11111111,app_secret = "H2Pk8htyFD8024mZaPHm")
#Получаем список объявлений с описанием их внешнего вида
my_vk_ads <- vkGetAdsLayout(account_id = 11111111, 
                            access_token = my_tok$access_token)

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

  • id - идентификатор объявления.
  • campaign_id - идентификатор кампании.
  • ad_format - формат объявления
  • cost_type - тип оплаты (0 — оплата за переходы, 1 — оплата за показы)
  • video - 1 — объявление является видеорекламой.
  • title - заголовок объявления.
  • description - описание объявления.
  • link_url - ссылка на рекламируемый объект.
  • link_domain - домен рекламируемого сайта.
  • preview_link - ссылка, перейдя по которой можно просмотреть рекламное объявление так, как оно выглядит на сайте. Ссылка доступна в течение 30 минут после выполнения метода ads.getAdsLayout функции.
  • image_src - url изображения объявления.

2. Во все функции добавлен необязательный аргумент api_version - Версия API к который вы будете обращаться, список актуальных версий доступен по ссылке.