Learn R Programming

⚠️There's a newer version (2.12.0) of this package.Take me there.

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

Copy Link

Version

Install

install.packages('rfacebookstat')

Monthly Downloads

370

Version

2.1.7

License

MIT + file LICENSE

Maintainer

Alexey Seleznev

Last Published

August 27th, 2020

Functions in rfacebookstat (2.1.7)

fbGetAds

Get ads list from facebook marketing API
fbGetAdAccountsConversions

Get list of custom conversion from ad accounts.
fbGetAdVideos

Get videos list from ad accounts
fbGetAdAccountUsersPermissions

Get ad account user list with him permissions.
fbGetAdAccounts

Get avable ad account list.
fbGetAdAccountUsers

Get User List From Account
fbDeleteAdAccountUsers

Delete users from ad accounts.
fbAuth

Authorization in Facebook.
fbGetAdSets

Get creative list from facebook marketing API
fbGetAdCreative

Get creative list from facebook marketing API
fbGetCatalogs

Get catalogs
fbGetLongTimeToken

Get API facebook long time token.
fbGetMarketingStat

Get statistic by ad accounts.
fbGetCostData

Get facebook ads cost data.
fbGetBusinessManagers

Get avable business Managers.
fbGetApps

Get all the apps under a project
fbGetBusinessUserAdAccounts

Get a list of accounts for a business manager user
fbGetToken

Get API facebook token.
fbGetCampaigns

Get campaign list from facebook marketing API
fbGetUserAdAccounts

User's ad account list.
fbGetSettings

Get settings.
fbGetPages

Get pages list
fbUpdateAdAccountUsers

Add users and update permission list.
rfacebookstat-package

rfacebookstat