rfacebookstat - R пакет для работы с рекламным кабинетом Facebook
CRAN
For English speaking users
For use inside package manual run: help( package = "rfacebookstat")
Краткое описание.
Пакет для загрузки данных из Marketing API Facebook в R, а так же с помощью пакета вы можете управлять доступами пользователей к рекламный аккаунтам на Facebook.
Достижения
- rfacebookstat попал в top 40 пакетов, опубликованных на CRAN в августе 2018 года.
Видео уроки по работе с пакетом rfacebookstat
Для того, что бы вам было проще понять как работать с пакетом я записал 6 коротких видео уроков, все они доступны на YouTube в этом плейлисте.
- Простая авторизация
- Авторизация через собственное приложение
- Автоматическая авторизация через файл .Renviron
- Автоматическая авторизация через переменные среды на Windows
- Опции пакета и загрузка объектов из рекламных кабинетов.
- Загрузка статистики рекламы из рекламных кабинетов Facebook в R и визуализация данных.
Установка пакета rfacebookstat
Для установки пакета запустите приведённый ниже код в RStudio или R консоли. Установка из главного репозитория CRAN:
install.packages("rfacebookstat")
Устновка наиболее актульной dev версии пакета:
if(!"devtools" %in% installed.packages()[,1]){install.packages("devtools")}
devtools::install_github('selesnow/rfacebookstat')
Пример кода
# переменные среды для авторизации
Sys.setenv("RFB_USER" = "selesnow",
"RFB_TOKEN_PATH" = "C:/Users/Alsey/fb_authdata")
# подключение пакета
library(rfacebookstat)
# опции
options(rfacebookstat.accounts_id = c("act_000000000", "act_1111111111),
rfacebookstat.business_id = 0000000000)
# авторизация в API
# краткосрочный токен
fbAuth()
# Загрузка объектов API
# бизнес менеджеры
my_fb_bm <- fbGetBusinessManagers()
# рекламные аккаунты
my_fb_acs <- fbGetAdAccounts()
# Объекты рекламного аккаунта
# кампании
my_fb_camp <- fbGetCampaigns()
# группы объявлений
my_fb_adsets <- fbGetAdSets()
# объявления
my_fb_ads <- fbGetAds()
# контент объявлений
my_fb_ad_content <- fbGetAdCreative()
# страницы связанные с рекламными аккаунтами
my_fb_page <- fbGetPages()
# приложения связанные с рекламными аккаунтами
my_fb_apps <- fbGetApps()
# ###################
# загрузка статистики
# ###################
my_fb_stats <- fbGetMarketingStat(level = "campaign",
fields = "account_name,campaign_name,impressions,clicks",
breakdowns = "device_platform",
date_start = "2018-08-01",
date_stop = "2018-08-07",
interval = "day")
Переменные среды
Как правило в rfacebookstat
переменные среды используются для автоматизации процесса авторизации.
- RFB_TOKEN_PATH - Путь к папке в которой у вас хранится файл с раширением .rfb_auth.rds, в котором хранятся учётные данные;
- RFB_USER - Имя пользователя Facebook, который вы указали в аргументе username при прохождении авторизации с помощью функции
fbAuth()
; - RFB_API_TOKEN - Полученный с помощью функции
fbAuth()
токен доступа к API.
Опции
Опции используются для минимизации дублирования кода, и позволяют регулировать поведение пакета в ходе конкретной R сессии или одного скрипта. Как правила с помощью опций регулируют список рекламных аккаунтов и бизнес менеджеров с которыми будет вестись работа в ходе скрипта.
- rfacebookstat.api_version - Версия API к которой пакет будет направлять запросы, не рекомендуется изменять эту опцию;
- rfacebookstat.access_token - Ваш токен доступа, также не рекомендуется хранить его текстом в ваших скриптах;
- rfacebookstat.accounts_id - ID аккаунтов которые вы используете в скрипте по умолчанию, можно задавать вектором;
- rfacebookstat.business_id - ID бизнес менеджера который вы планируете использовать в скрипте по умолчанию
- rfacebookstat.token_path - Путь к папке, где хранятся файлы с учётными данными;
- rfacebookstat.username - Имя пользователя facebook;
- rfacebookstat.app_id - ID созданного вами приложения в Facebook для авторизации;
- rfacebookstat.app_secret - Секрет созданного вами приложения в Facebook.
Виньетки
- ВИньетка про авторизацию в Facebook API:
vignette('rfacebookstat-authorization', package = 'rfacebookstat')
- Виньетка посвящённая загрузке статистическим данных из рекламных аккаунтов:
vignette('rfacebookstat-get-statistics', package = 'rfacebookstat')
Статьи
- Как загрузить статистику рекламных кампаний из API Facebook с помощью языка R
- Как загрузить статистику из рекламных систем в Google BigQuery
- Импорт данных о расходах в Google Analytics с помощью R
Ссылки
- Документация по работе с пакетом rfacebookstat.
- Баг репорты, предложения по доработке и улучшению функционала rfacebookstat оставлять тут.
- Видео уроки по работе с пакетом rfacebookstat
- Список релизов.
- Группа в Вконтакте.
Автор пакета
Алексей Селезнёв, Head of analytics dept. at Netpeak Telegram Channel: R4marketing email: selesnow@gmail.com skype: selesnow facebook: facebook.com/selesnow blog: alexeyseleznev.wordpress.com