В релизе версии 2.5.4 была ошибка, полям reach и impressions присваивалось значение кликов, ошибка уже исправлена в версии 2.5.5.

Так же убрали доработку из прошлого патча -

в формирование датафреймов в добавил 0 вместо NA на параметры spent, clicks, impressions, reach

Поскольку при расчетет среднего обычно не учитываются ячейки с NULL, в случае с 0 это повлияет на расчёты.

За данный релиз спасибо Эдуарду Горху (@grkhr).

И так, доработки коснулись функции vkGetAdStatisctics.

• Прописано разбиение на несколько запросов, если количество входных айдишников больше 400 (вк ругается на длинные урлы);
• Прописан обработчик ошибки Flood Control;
• В консоль-лог выводится остаток запросов и время обновления лимитов + прописан обработчик этого (если лимит кончился, то ждет до обновления);
• В формирование датафреймов вместо NA выводится 0 на параметры spent, clicks, impressions, reach и join_rate.

rvkstat 2.5.0

Обновить пакет до актуальной версии можно с помощью следующего кода:

if (require(devtools)) install.packages("devtools")
devtools::install_github("selesnow/rvkstat")

1. Исправлена ошибка в функции vkGetUserWall

1.1. Исправлена ошибка в функции vkGetUserWall,теперь она корректно обращается как к старой версии API, т.е. до 5ой, так и с новой версией 5.x. - #4

1.2. Так же помимо статистики по количеству комментариев, репостов и лайков теперь vkGetUserWall возвращает количество просмотров сообщения.

2. В добавлена функция vkGetGroupStatPostReach

Данная функция даёт возможность получить расширенную статистику по сообщениям со стены группы.

Ограничения по работе с функцией vkGetGroupStatPostReach

• Функция работает с методом API stats.getPostReach, который в свою очередь работает только с сообществами с количеством участников от 5000 и выше, а также официальных сообществ.

• Получить статистику можно только для 300 последних (самых свежих) записей на стене сообщества.

Пример работы с функцией vkGetGroupStatPostReach

## Авторизация в вк
my_tok <- vkAuth(app_id = 1, app_secret = "H2Pk8htyFD8024mZaPHm")

## Получаем список сообщений сообщества
my_vk_wall  <- vkGetUserWall(user_id = -111111,
                             access_token = my_tok$access_token) 
							 
## Получаем подрубную статистику по последним 300 записям сообщества							 
post_reach <- vkGetGroupStatPostReach(owner_id = -2222222,
                                      post_ids = my_vk_wall$id,
                                      access_token = my_tok$access_token)

В rvkstat добавлены 2 функции:

1. vkGetGroupToken - Для получения ключа доступа к сообществам.
2. vkGetUserDialogs - Для загрузки списка диалогов.

Подробную справку по работе функций можно получить при помощи команды help:

1. help("vkGetGroupToken")
2. help("vkGetUserDialogs")

Данные возвращаемые функцией vkGetUserDialogs

1. id - идентификатор сообщения (не возвращается для пересланных сообщений).
2. date - дата отправки сообщения.
3. out - тип сообщения (0 — полученное, 1 — отправленное, не возвращается для пересланных сообщений).
4. user_id - идентификатор пользователя, в диалоге с которым находится сообщение.
5. read_state - статус сообщения (0 — не прочитано, 1 — прочитано, не возвращается для пересланных сообщений).
6. title - заголовок сообщения или беседы.
7. body - текст сообщения.
8. random_id - идентификатор, используемый при отправке сообщения. Возвращается только для исходящих сообщений.

Пример кода для загрузки списка диалогов сообществ:

library(rvkstat)
# Получаем ключ доступа для сообщества
group_token <- vkGetGroupToken(app_id = 111111, group_ids = 123456)

# Получаем список диалогов
message <- vkGetUserDialogs(access_token = group_token, count = 200)

Если надо получить список диалогов пользователя используйте ключ доступа пользователя, который можно получить с помощью функции vkGetToken.

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 к который вы будете обращаться, список актуальных версий доступен по ссылке.

Доработана функция vkGetAdPostsReach, теперь она может обрабатывать неограниченное количество ids кампаний или объявлений.

Ранее при попытке получить статистику более чем по 100 объектам (кампаниям или объявлениям) возвращалась ошибка.

Новая версия rvkstat 2.1.0 теперь поддерживается на Linux и Mac, для установки на одну из этих ОС воспользуйтесь кодом:

if(!"devtools" %in% installed.packages()[,1]){install.packages("devtools")}
devtools::install_github('selesnow/rvkstat', subdir = "en")

В версии 2.0.2 был доработан процесс прохождения авторазации в API Вконтакте, в связи с чем перед обновлением пакета необходимо внести следующие корректировки в настройке вашего приложения.

Войдите в настройки приложения и внесите изменения в блок Open API.

Адрес сайта: https://selesnow.github.io/rvkstat/getCode/get_code.html
Базовый домен: selesnow.github.io
Доверенные redirect URI:
https://selesnow.github.io/rvkstat/getCode/get_code.html
https://selesnow.github.io/rvkstat/getCode/get_token.html

Версия 2.0.0 состоит из 26 функций для работы с API социальной сети Вконтакте.

Все функции пакета разделены на блоки, определить к какому блоку относится функция можно из её названия, название блока к которому относится функция идёт сразу после префикса vk:

• Блок функция GetGroupStat предназначен для загрузки статистики по сообществам Вконтакте.
• Блок функций GetAd направлен на загрузку данных из рекламного кабинета Вконтакте.
• Блок функций GetDb даёт возможность загрузки справочной информации из Вконтакте.
• Блок функций GetUser используется для загрузки данных о конкретном пользователе Вконтакте.