Пакет ryandexdirect предназначен для загрузки данных из Яндекс Директ в R, с помощью функций данного пакета вы можете работать с перечисленными ниже сервисами и службами API Яндекса с помощью готовых функций, не углубляясь при этом в документацию по работе с этими API сервисами.
Пакет позволяет вам выполнять следующие действия:
У ryandexdirect
есть официальный обучающий плейлист на YouTube, все видео доступны по ссылке.
Установка пакета осуществляется из репозитория CRAN
install.packages("ryandexdirect")
или GitHub, для этого сначала требуется установить и подключить пакет devtools.
install.packages("devtools")
library(devtools)
После чего можно устанавливать пакет ryandexdirect.
install_github('selesnow/ryandexdirect')
# Установка пакетов
install.packages("ryandexdirect")
# Подключение пакета
library(ryandexdirect)
# Авторизация
yadirAuth(Login = "my_yandex_login", # логин пользователя Яндекс.Директ
TokenPath = "C:/direct/tokens") # путь к папаке в которой будет храниться файл с учётными данными
# ###################################################
# Загрузка различных объектов из рекламного аккаунта
# ###################################################
# Список рекламных кампаний
camp <- yadirGetCampaign(Logins = "my_yandex_login",
TokenPath = "C:/direct/tokens",
States = "ON",
Types = "TEXT_CAMPAIGN")
# Список ключевых слов
kw <- yadirGetKeyWords(Login = "my_yandex_login",
TokenPath = "C:/direct/tokens",
CampaignIds = camp$Id[1:5],
States = "ON")
# Список групп объявлений
adgroups <- yadirGetAdGroups(Login = "my_yandex_login",
TokenPath = "C:/direct/tokens",
CampaignIds = camp$Id[c(1,2)],
Types = "TEXT_AD_GROUP",
Statuses = c("ACCEPTED", "MODERATION"))
# Список объявлений
ads <- yadirGetAds(Login = "my_yandex_login",
TokenPath = "C:/direct/tokens",
CampaignIds = camp$Id[c(1,2)])
# Список быстрых ссылок
links <- yadirGetSiteLinks(Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# ###################################################
# Загрузка справочной информации
# ###################################################
# Справочник валют
currency <- yadirGetDictionary(DictionaryName = "Currencies",
Language = "en",
Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# Георгафический справочник
regions <- yadirGetDictionary(DictionaryName = "GeoRegions",
Language = "ru",
Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# ###################################################
# Загрузка статистики
# ###################################################
# простейший отчёт за прошлый месяц
simple_report <- yadirGetReport(DateRangeType = "LAST_MONTH", # относительный период
FieldNames = c("Date", "Clicks", "Impressions"),
Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# отчёт по конверсиям с моделью аттрибуции за статичный период
attribution_report <- yadirGetReport(DateFrom = "2018-11-15", # статичный период, дата начала
DateTo = "2018-11-20", # статичный период, дата завершения
FieldNames = c("Date",
"Conversions"),
Goals = c(27475434, 38234732),
AttributionModels = c("LC", "FC"),
Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# отчёт с применением фильтрации
filtring_report <- yadirGetReport(DateRangeType = "LAST_30_DAYS",
FieldNames = c("Date", "Clicks", "Impressions"),
FilterList = c("Conversions GREATER_THAN 1",
"Impressions LESS_THAN 3500"),
Login = "my_yandex_login",
TokenPath = "C:/direct/tokens")
# ###################################################
# Управление ставками
# ###################################################
# запрашиваем ставки
bids <- yadirGetKeyWordsBids(kw$Id)
# запрашиваем ставки и данные торго на поиске
bids_search <- yadirGetKeyWordsBids(kw$Id,
AuctionBids = "search")
# запрашиваем ставки и данные торго в сетях
network_bids <- yadirGetKeyWordsBids(kw$Id,
AuctionBids = "network")
# запрашиваем список рекламных кампаний
camp <- yadirGetCampaign()
# меняем ставки
setbid <- yadirSetKeyWordsBids(CampaignIds = camp$Id[1],
SearchBid = 9)
# меняем ставки
autosetbids <- yadirSetAutoKeyWordsBids(KeywordIds = kw$Id,
TargetTrafficVolume = 50)
Пакет имеет подробные виньетки отдельно по каждой из своих возможностей, в которой наиболее подробно описаны детали работы с его функционалом. На данный момент в пакете ryandexdirect
доступны 3 виньетки.
vignette("yandex-direct-get-statistic", package = "ryandexdirect")
vignette("yandex-direct-auth", package = "ryandexdirect")
vignette("yandex-direct-keyword-bids", package = "ryandexdirect")
vignette("yandex-direct-get-wordstat-forecast", package = "ryandexdirect")
vignette("yandex-direct-cost-data", package = "ryandexdirect")
Алексей Селезнёв, Head of analytics dept. at Netpeak
email: selesnow@gmail.com
skype: selesnow
facebook: facebook.com/selesnow
blog: alexeyseleznev.wordpress.com