rfacebookstat - R пакет для работы с рекламным кабинетом Facebook

CRAN

For English speaking users

For use inside package manual run: help( package = "rfacebookstat")

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

Пакет для загрузки данных из Marketing API Facebook в R, а так же с помощью пакета вы можете управлять доступами пользователей к рекламный аккаунтам на Facebook.

Достижения

1. rfacebookstat попал в top 40 пакетов, опубликованных на CRAN в августе 2018 года.

Видео уроки по работе с пакетом rfacebookstat

Для того, что бы вам было проще понять как работать с пакетом я записал 6 коротких видео уроков, все они доступны на YouTube в этом плейлисте.

1. Простая авторизация
2. Авторизация через собственное приложение
3. Автоматическая авторизация через файл .Renviron
4. Автоматическая авторизация через переменные среды на Windows
5. Опции пакета и загрузка объектов из рекламных кабинетов.
6. Загрузка статистики рекламы из рекламных кабинетов 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.

Виньетки

1. ВИньетка про авторизацию в Facebook API: vignette('rfacebookstat-authorization', package = 'rfacebookstat')
2. Виньетка посвящённая загрузке статистическим данных из рекламных аккаунтов: vignette('rfacebookstat-get-statistics', package = 'rfacebookstat')

Статьи

1. Как загрузить статистику рекламных кампаний из API Facebook с помощью языка R
2. Как загрузить статистику из рекламных систем в Google BigQuery
3. Импорт данных о расходах в Google Analytics с помощью R

Ссылки

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

Автор пакета

Алексей Селезнёв, Head of analytics dept. at Netpeak
Telegram Channel: R4marketing
email: selesnow@gmail.com
skype: selesnow
facebook: facebook.com/selesnow
blog: alexeyseleznev.wordpress.com