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 и визуализация данных.
  7. Как загрузить статистику рекламных кампаний из Facebook в Power BI.
  8. Как загрузить данные о расходах на рекламу из Facebook в Google Analytics
  9. Как загрузить данные о расходах и кликах из Facebook в Яндекс.Метрику.
  10. Как запрашивать данные из бизнес менеджера Facebook.
  11. Как разбить запрос статистики по рекламе Facebook на подзапросы по временным интервалам.

Установка пакета 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 facebook: facebook.com/selesnow blog: alexeyseleznev.wordpress.com

Copy Link

Version

Down Chevron

Install

install.packages('rfacebookstat')

Monthly Downloads

810

Version

2.4.0

License

MIT + file LICENSE

Maintainer

Last Published

July 27th, 2021

Functions in rfacebookstat (2.4.0)