rfacebookstat v2.1.7

0

Monthly downloads

0th

Percentile

Load Data from Facebook API Marketing

Load data by campaigns, ads, ad sets and insights, ad account and business manager from Facebook Marketing API into R. For more details see official documents by Facebook Marketing API <https://developers.facebook.com/docs/marketing-apis/>.

Readme

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

CRAN

Rdoc rpackages.io rank

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

Functions in rfacebookstat

Name Description
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
No Results!

Vignettes of rfacebookstat

Name
rfacebookstat-authorization.Rmd
rfacebookstat-cost-data.Rmd
rfacebookstat-get-statistics.Rmd
No Results!

Last month downloads

Details

Type Package
Date 2020-08-27
BugReports https://github.com/selesnow/rfacebookstat/issues
URL https://selesnow.github.io/rfacebookstat/, https://www.youtube.com/playlist?list=PLD2LDq8edf4pItOb-vZTG5AXZK2niJ8_R
License MIT + file LICENSE
VignetteBuilder knitr
Encoding UTF-8
Language ru
NeedsCompilation no
Packaged 2020-08-27 10:30:16 UTC; Alsey
Repository CRAN
Date/Publication 2020-08-27 18:40:02 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/rfacebookstat)](http://www.rdocumentation.org/packages/rfacebookstat)