rvkstat v2.6.3

0

Monthly downloads

0th

Percentile

Interface to API 'vk.com'

Load data from vk.com api about your communiti users and views, ads performance, post on user wall and etc. For more detail see <https://vk.com/dev/first_guide>.

Readme

rvkstat - пакет для работы с API Вконтакте.

Краткое описание.

Пакет rvkstat является R клиентом для работы с API социальной сети Вконтакте. С помощью функций данного пакета можно получить статистику из рекламного кабинета Вконтакте, а так же данные о посетителях сообществ вконтакте по дням, в разрезе возрастных групп, пола и геолокации посетителей.

Все функции входящие в пакет rvkstat имеюи префикс vk.

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

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

Функции rvkstat

Ниже приведено описание всех функций входящих в пакет rvkstat:

  • Авторизация и получение токена
    • vkAuth - Прохождение процесса авторизации с помощью метода Authorization Code Flow, токен полученный с помощью данной функции будет работать с любого IP.
    • vkGetToken - Упрощённая авторизация по методу Implicit Flow, токен доступа пользователя выдаётся с привязкой к IP адресу, в связи с чем при смене IP адреса прийдётся проходить процедуру авторизации. Такой ключ требуется для работы почти со всеми методами нашего API, за исключением методов секции secure. Некоторые методы (как, например, users.get) можно вызывать и без access_token, но часть данных в таком случае может быть недоступна, поскольку имеет значение, для какого пользователя их нужно получить.
    • vkGetGroupToken - Упрощённая авторизация по методу Implicit Flow, токен доступа сообщества выдаётся с привязкой к IP адресу, в связи с чем при смене IP адреса прийдётся проходить процедуру авторизации. Такой ключ позволяет работать с API от имени группы, встречи или публичной страницы. Например, с его помощью Вы можете отвечать подписчикам сообщества на сообщения, поступившие в его адрес. С ключом доступа сообщества можно вызывать те методы, которые имеют специальную пометку в общем списке.
  • Функции для загрузки данных из рекламного кабинета Вконтакте
    • vkGetAdCategories - Получить возможные тематики рекламных объявлений и их подразделы.
    • vkGetAdAccounts - Получить список доступных рекламных кабинетов
    • vkGetAdClient - Получить список клиентов из агентского аккаунта
    • vkGetAds - Получить список объявлений
    • vkGetAdsLayout - Возвращает описания внешнего вида рекламных объявлений.
    • vkGetAdCampaigns - Получить список рекламных кампаний
    • vkGetAdStatistics - Получить статистику показателей эффективности по рекламным объявлениям, кампаниям, клиентам или всему кабинету
    • vkGetAdCityStats - Получить статистику по охвату аудитории по рекламным кампаним или объявления в разрезе городов
    • vkGetAdGenderStats - Получить статистику по охвату аудитории по рекламным кампаним или объявления в разрезе пола
    • vkGetAdAgeStats - Получить статистику по охвату аудитории по рекламным кампаним или объявления в разрезе возраста
    • vkGetAdGenderAgeStats - Получить статистику по охвату аудитории по рекламным кампаним или объявления в разрезе пола и возраста
    • vkGetAdBudget - Получить остаток средств из рекламного кабинета
    • vkGetAdPostsReach - Получить подробную статистику по охвату рекламных записей из объявлений и кампаний для продвижения записей сообщества
  • Функции для загрузки данных из сообществ Вконтакте
    • vkGetGroupStat - Получить общую статистику по сообществу
    • vkGetGroupStatAge - Получить данные о посетителях сообщества по возрасту
    • vkGetGroupStatCity - Получить данные о посетителях сообщества по городам
    • vkGetGroupStatCountries - Получить данные о посетителях сообщества по странам
    • vkGetGroupStatGender - Получить данные о посетителях сообщества по полу
    • vkGetGroupStatGenderAge - Получить данные о посетителях сообщества по полу и возрасту
    • vkGetGroupStatPostReach - Получить детальные данные по охвату по записяписям сообществ
  • Функции для загрузки справочной инормации из Вконтакте
    • vkGetDbCountries - Получить id и название стран
    • vkGetDbCities - Получить справочник городов
    • vkGetDbRegions - Получить справочник регионов
  • Функции для загрузки инормации о пользователе Вконтакте
    • vkGetUserFriends - Получить список друзей пользователя Вконтакте
    • vkGetUserDialogs - Получить список диалогов текущего пользователя или сообщества
    • vkGetUserGroups - Получить список групп и сообществ в которых состоит пользователь Вконтакте
    • vkGetUserWall - Получить сообщения со стены пользователя с количеством комментариев, лайков и рипостов

Как получить подробную справку по функциям пакета rvkstat

Все функции пакета имеют подробное описание, получить детальную справку по любой функции пакета rvkstat можно с помощь команды help, если вы работаете в RStudio справку так же можно получить указав ? перед названием комапнды:

help("vkGetAdStatistics")

?vkGetAdStatistics

Установка пакета vkstat.

Установка пакета осуществляется из репозитория CRAN

install.packages("rvkstat")

или GitHub, для этого сначала требуется установить и подключить пакет devtools.

install.packages("devtools")

library(devtools)

После чего можно устанавливать dev версию пакета rvkstat.

install_github('selesnow/rvkstat')

Ссылки

  1. Документация по работе с пакетом rvkstat.
  2. Баг репорты, предложения по доработке и улучшению функционала ryandexdirect оставлять тут.
  3. Список релизов.
  4. Телеграмм канал R4marketing.
  5. Группа в Вконтакте.

Автор пакета

Алексей Селезнёв, Head of analytics dept. at Netpeak


email: selesnow@gmail.com


skype: selesnow


facebook: facebook.com/selesnow


blog: alexeyseleznev.wordpress.com

Бейджи

Rdoc

Functions in rvkstat

Name Description
vkGetAdCampaigns Campaign list
vkGetGroupStat Statistics on visiting the community in 'Vkontakte'.
vkGetGroupStatAge Community Statistics by User Age Bucket
vkGetAdsLayout Appearance of Advertisements.
vkGetAdGenderAgeStats Statistics on Audience Coverage by Age and Gender.
vkGetDbCities City Dictionary.
vkGetGroupStatGenderAge Statistics on Age Groups And Gender of The 'VKontakte' Community.
vkGetGroupStatGender Loading data by gender of the community visitors
rvkstat-package rvkstat
vkAuth Authorization in 'Vkontakte'
vkGetAdGenderStats Statistics on Audience Coverage by Gender.
vkGetAdCategories List of Possible Subjects of Advertisements
vkGetAds List of Ads From 'Vkontakte'.
vkGetAdStatistics Statistics of advertising in 'VKontakte'.
vkGetAdPostsReach Statistics on The Coverage of Advertising Entries 'Vkontakte'.
vkGetGroupStatCity Statistics of the Vkontakte community visitors by cities.
vkGetGroupStatCountries Statistics of The Vkontakte Community Visitors By Country.
vkGetDbCountries Country Dictionary.
vkGetAdCityStats Statistics on Audience Coverage in The Context of Cities.
vkGetDbRegions Regions list.
vkGetUserDialogs Returns The List of Conversations of The Current User or Community.
vkGetToken Get vkontakte developer token
vkGetGroupToken Get the Access Key of Community 'Vkontakte'.
vkGetGroupStatPostReach Statistics of Posts on The Community Wall.
vkGetUserFriends Frend List in 'Vkontakte'
vkGetUserGroups List of 'Vkontakte' communities.
vkGetUserWall Get Posts From Userwall.
vkGetAdBudget Budget of Advertising Cabinet 'Vkontakte'.
vkGetAdClients Client list.
vkGetAdAccounts List of Advertising Account
vkGetAdAgeStats Statistics on Audience Coverage by Age.
No Results!

Last month downloads

Details

Type Package
Date 2019-12-11
License GPL-2
Language ru
Encoding UTF-8
BugReports https://github.com/selesnow/rvkstat/issues
URL http://selesnow.github.io/rvkstat
NeedsCompilation no
Packaged 2019-12-11 10:29:33 UTC; Alsey
Repository CRAN
Date/Publication 2019-12-11 10:50:02 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/rvkstat)](http://www.rdocumentation.org/packages/rvkstat)