rfacebookstat

Загрузка статистики по рекламных кампаниям из Facebook в R.


Project maintained by selesnow Hosted on GitHub Pages — Theme by mattgraham

Menu:


rfacebookstat - Пакет для загрузки данных из Marketing API Facebook в R.

Ссылки

CRAN

Rdoc rpackages.io rank

Содержание README

Начало работы с API Facebook

Для начала работы с API Facebook необходимо создать приложение:

  1. Перейдите в левое меню и в разделе «Разработчик» выберите команду «Управление приложениями».

  1. В кабинете разработчика нажмите кнопку «+ Добавить новое приложение».

Заполните поля «Отображаемое название приложения»,«Эл. адрес для связи», «Категория» и нажмите «Создайте ID приложения».

  1. Далее вы попадете в меню «Установка и настройка продукта». Кликните на кнопку «Начать» напротив пункта «Вход через Facebook».

  1. Перейдите в настройки приложения. Во вкладке «Основное» находится информация по ID и секрету приложения, которая понадобится для работы с API.

На этой вкладке также заполните поля:

Можно указать произвольное название приложение, а остальные поля заполнить как на примере ниже.

  1. В нижней части окна нажмите «Добавить платформу».

Из списка предложенных платформ выберите веб-сайт.

В поле «URL-адрес сайта» введите «https://github.com/selesnow/rfacebookstat» и нажмите «Сохранить изменения».

  1. В меню приложения перейдите в раздел «Вход через Facebook». В поле «Действительные URL-адреса для перенаправления OAuth» введите «https://selesnow.github.io/rfacebookstat/getToken/get_token.html».

  1. Далее нужно выбрать, из каких рекламных аккаунтов вы будете получать статистику через API и скопировать их ID (Чтобы получить ID аккаунта, перейдите в рекламный кабинет и скопируйте цифры из параметра act в URL.).

Перейдите в раздел «Настройки» —> «Дополнительно» и в блоке «Рекламные аккаунты» нажмите кнопку «API Ads».

В открывшемся окне введите ID выбранных рекламных аккаунтов.

На данном этапе вы получили уровень доступа к API «Development» и можете работать максимум с пятью рекламными аккаунтами. Если вам понадобится полный доступ к API, подробная инструкция находится здесь

Установка пакета rfacebookstat

Для установки пакета запустите приведённый ниже код в RStudio или R консоли. Установка из главного репозитория CRAN:

install.packages("rfacebookstat")

Устновка наиболее актульной dev версии пакета:

if(!"devtools" %in% installed.packages()[,1]){install.packages("devtools")}
devtools::install_github('selesnow/rfacebookstat')

Пример кода для работы с rfacebookstat

# Установка и подключение пакета rfacebookstat
devtools::install_github("selesnow/ryandexdirect")
library(rfacebookstat)

# авторизация в API
# краткосрочный токен
my_st_token <- fbGetToken(app_id = 5546236457236574327)

# долгосрочный токен
fb_token    <- fbGetLongTimeToken(client_id = 5546236457236574327,
                                  client_secret = "uhcninh3y98nfyy49r8y98fy938",
                                  fb_exchange_token = my_st_token)

# Загрузка объектов API
# бизнес менеджеры
my_fb_bm   <- fbGetBusinessManagers(access_token = fb_token)

# проекты из бизнес менеджера
my_fb_proj <- fbGetProjects(bussiness_id = my_fb_bm$id,
                            access_token = fb_token)
# рекламные аккаунты
my_fb_acc  <- fbGetAdAccounts(source_id = my_fb_bm$id,
                              access_token = fb_token)
# страницы
my_fb_page <- fbGetPages(projects_id = my_fb_proj$id, access_token = fb_token)
# приложения
my_fb_apps <- fbGetApps(projects_id = my_fb_proj$id, access_token = fb_token)

# Объекты рекламного аккаунта
# кампании
my_fb_camp <- fbGetCampaigns(accounts_id = "act_262115113",
                             access_token = fb_token)

# группы объявлений
my_fb_adsets <- fbGetAdSets(accounts_id = "act_262115113",
                            access_token = fb_token)
# объявления
my_fb_ads    <- fbGetAds(accounts_id = my_fb_acc$id[7],
                         access_token = fb_token)

# контент объявлений
my_fb_ad_content <- fbGetAdCreative(accounts_id = "act_262115113",
                                    access_token = fb_token)

# загрузка статистики
my_fb_stats <- fbGetMarketingStat(accounts_id = "act_262115113",
                                  level = "campaign",
                                  fields = "account_name,campaign_name,impressions,clicks",
                                  breakdowns = "device_platform",
                                  date_start = "2018-08-01",
                                  date_stop = "2018-08-07",
                                  interval = "day",
                                  access_token = fb_token)


# управление пользователями
# получить список пользователей
fb_acc_user <- fbGetAdAccountUsers(accounts_id  =  "act_262115113",
                                   access_token = fb_token,
                                   console_type = "message")

# удалить пользователя из рекламного аккаунта
fbDeleteAdAccountUsers(user_ids = "823041644481205",
                       accounts_id  =  "act_262115113",
                       access_token = fb_token,
                       api_version = "v3.1")

# добавить пользователя в рекламный аккаунт
fb_acc_user2 <- fbGetAdAccountUsers(accounts_id  =  "act_262115113",
                                    access_token = fb_token,
                                    console_type = "message")

Безопасность использования rfacebookstat

Вся работа с API Facebook Marketing происходит через зарегистрированное вами приложение. О том, как устроен процесс аутентификации в Facebook Marketing API подробно описано тут.

Для прохождения авторизации в пакете rfacebookstat есть функция fbGetToken, реализуется через одноэтапную аутентификацию. Никакой опасности в том, что ваш токен будет перехвачен через отчёты Google Analytics нет, скрин того, как в Google Analytics выглядит посещение страницы генерации токена.

Пакет rfacebookstat был опубликован в официальном хранилище пакетов для языка R - CRAN, перед публикаций в котором все пакеты проходят модерацию командой профессионалов, поэтому это так же может являться дополнительной гарантией того, что использование пакета является безопасным.

К тому же код пакета rfacebookstat открыт, и находится в свободном доступе на GitHub, в связи с чем перед его использованием, вы можете посмотреть код любой его функции.

ВАЖНО никому не передавайте полученные с помощью пакета rfacebookstat авторизационные токены, т.к. передав токен вы предоставите доступ к управлению вашеми рекламными матеариалами, при этом доступ к аккаунту вы в любом случае не потеряете, но ваши объявления сможет редактировать человек завладевший токеном.

Политика конфиденциальности

Этот раздел должен быть подробно описан по требованиям Facebook.

При авторизации, вы соглашаетесь предоставить пакету rfacebookstat следующие разрешения:

При этом пакет rfacebookstat не передаёт третим лицам, включая автора пакета, собираемые им данные, и доступы к рекламным и прочим источникам. Вся информация и доступы полученные rfacebookstat используется только вами, и людьми которым вы сами её предоставили.

Функции пакета rfacebookstat

На данный момент в пакете rfacebookstat доступно 16 функций, с помощью которых вы можете получить любой объект из бизнес менеджера или рекламного кабинета, а так же загрузить статистику по эффективности ведения рекламы на Facebook.

Функция
Описание
fbGetToken
Получает окен для доступа к API Facebook
fbGetLongTimeToken
Меняет краткосрочный на долгосрочный токен
fbGetBusinessManagers
Загружает список доступных бизнес менеджеров
fbGetAdAccountUsers
Загружает список пользователей из рекламных аккаунтов
fbGetAdAccountUsersPermissions
Загружает список пользователей из рекламных аккаунтов с их привилегиями и ролью, по смыслу очень схожа с fbGetAdAccountUsers
fbUpdateAdAccountUsers
Добавить пользователей в рекламные аккаунты Facebook
fbDeleteAdAccountUsers
Удалить пользователей из рекламных аккаутов в Facebook
fbGetApps
Получает список рекламируемых приложений
fbGetPages
Получает список рекламируемых страниц
fbGetProjects
Получает список проектов доступных в бизнес менеджере
fbGetAdAccounts
Получает список доступных рекламных аккаунтов
fbGetCampaigns
Получает список всех рекламных кампаний из рекламного аккаунтов Facebook
fbGetAdSets
Получает список всех групп объявлений из рекламных аккаунтов
fbGetAds
Получает список всех объявлений из рекламных аккаунтов
fbGetAdCreative
Получает список контента всех объявлений из рекламных аккаунтов
fbGetMarketingStat
Получает статистику из рекламного кабинета

Авторизация для доступа к API Facebook

Для работы с функциями пакета rfacebookstat и доступа к API Facebook вам понадобится токет (маркер), получить его можно либо с помощью представленой ниже формы, или функции fbGetToken

Форма для генерации маркера доступа к API Facebook:

ID приложения в Facebook:


fbGetToken

Описание

Функция предназначена для получения краткосрочного токена для доступа к API Facebook.

Синтаксис

fbGetToken(app_id = 000000000)

Аргументы

app_id - ID вашего приложени в Facebook

Пример прохождения процесса аутентификации

MyFBToken <- fbGetToken(app_id = 1111111111111111)

После запуска приведённого выше кода при первом запуске функции наиболее вероятно что вы попадёте на страницу предупреждения:

Пропустите это предупреждение с помощью кнопки «Продолжить как, …».

Далее откроется окно в котором приложение запрос разрешение на доступ к данным.

После того как вы подтвердите доступ, нажав ОК вы попадаете на страницу https://selesnow.github.io/rfacebookstat/getToken/get_token.html, на которой будет сгенерирован токен доступа к API Facebook.

fbGetLongTimeToken

Описание

Данная функция меняет краткосрочный токен с сроком 2 часа на долгосрочный токен который действителен на протяжении двух месяцев.

Синтаксис

fbGetLongTimeToken(client_id,client_secret,fb_exchange_token)

Аругменты

client_id - ID вашего приложени в Facebook

client_secret - Секрет вашего приложения в Facebook

fb_exchange_token - Значение краткосрочного токена полученного с помощью функции fbGetToken

fbGetBusinessManagers

Описание

Данная функция загружает список доступных бизнес менеджеров с некоторыми их параметрами.

Синтаксис

fbGetBusinessManagers(api_version = “v2.10”, access_token = NULL)

Аругменты

api_version - Версия API Facebook в формате v., например v2.10

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeTokenn

fbGetAdAccountUsers

Описание

Данная функция загружает список пользователей рекламных аккаунтов.

Синтаксис

fbGetAdAccountUsers(accounts_id = NULL ,api_version = “v2.10”, access_token = NULL)

Аругменты

accounts_id - Вектор ID рекламных аккаунтов с префиксом act_, получить список всех доступны рекламных аккаунтов можно с помощью функции fbGetAdAccounts

api_version - Версия API Facebook в формате v., например v2.10

console_type - тип ответов в консоли, принимает одно из двух значений: + “progressbar” (по умолчанию) - для вывода в консоли прогресс бара, отображающего % загруженных даных. + “message” - для вывода информационных сообщений о процессе загрузки, например вывод сообщений о том, какой аккаунт обрабатывается, и сколько пользователей по нему загружено.

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbGetAdAccountUsersPermissions

Описание

Данная функция загружает список пользователей рекламных аккаунтов с их привилегиями и ролью.

Расшифровка привилегий:
1: ACCOUNT_ADMIN: Имеет права на изменение списка пользователей рекламного аккаунта и привелегий пользователей.
2: ADMANAGER_READ: Имеет права просмотра рекламных кампаний и объявлений.
3: ADMANAGER_WRITE: Имеет права вносить изменения в рекламные аккаунты.
4: BILLING_READ: Право просмотра информации о платежах
5: BILLING_WRITE: Права внесения изменений в платёжные данные
7: REPORTS: Просмотр отчётов
9, 10 - Право подать заявку на некоторые управляемые аккаунты. В настоящее время не требуется для вызовов API маркетинга.

Расшифровка роли
1001 = Администратор
1002 = Рекламодатель
1003 = Аналитик
1004 = Прямой доступ к продажам. Для ограниченных управляемых учетных записей.

Синтаксис

fbUpdateAdAccountUsers(accounts_id = NULL ,api_version = “v2.12”, access_token = NULL)

Аругменты

accounts_id - Вектор ID рекламных аккаунтов с префиксом act_, получить список всех доступны рекламных аккаунтов можно с помощью функции fbGetAdAccounts

api_version - Версия API Facebook в формате v., например v2.10

console_type - тип ответов в консоли, принимает одно из двух значений:

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbUpdateAdAccountUsers

Описание

Добавляет пользователей в рекламные аккаунты Facebook с определённым набором прав. Для того, что бы добавить пользователей в аккаунт вы должны быть админисратором данного аккаунта.

Синтаксис

fbUpdateAdAccountUsers(user_ids = NULL, role = “advertiser”, accounts_id = NULL, api_version = “v2.12”, access_token = NULL)

Аругменты

user_ids - Вектор ID пользователей коорых вы хотите добавить в рекламные аккаунты.

accounts_id - Вектор ID рекламных аккаунтов с префиксом act_ в которые вы хотите добавить пользователей, получить список всех доступны рекламных аккаунтов можно с помощью функции fbGetAdAccounts

api_version - Версия API Facebook в формате v., например v2.10

role - Роль пользователя который будет добалвен в аккаунт, каждая роль имеет свой набор привилегий, допустимые значения:

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbDeleteAdAccountUsers

Описание

Удаляет пользователей из рекламных аккаунтов Facebook с определённым набором прав. Для того, что бы удалить пользователей из аккаунта вы должны быть админисратором данного аккаунта.

Синтаксис

fbDeleteAdAccountUsers(user_ids = NULL, accounts_id = NULL, api_version = “v2.12”, access_token = NULL)

Аругменты

user_ids - Вектор ID пользователей которых вы хотите удалить из рекламные аккаунты.

accounts_id - Вектор ID рекламных аккаунтов с префиксом act_ из которых вы хотите удалить пользователей, получить список всех доступны рекламных аккаунтов можно с помощью функции fbGetAdAccounts

api_version - Версия API Facebook в формате v., например v2.12

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbGetProjects

Описание

Данная функция загружает список доступных в вашем бизнес менеджере проектов

Синтаксис

fbGetProjects(bussiness_id, api_version, access_token)

Аругменты

bussiness_id - ID вашего бизнес менеджера, посмотреть ID можно перейдя в основном меню бизнес менеджера в “Настройки Business Manager” на вкладку “Информация о компании”.

api_version - Версия API Facebook в формате v., например v2.8

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbGetApps

Описание

Данная функция возвращает набор данных со списком аккаунтов в вашем бизнес менеджере.

Синтаксис

fbGetApps(projects_id, api_version, access_token)

Аругменты

projects_id - ID проекта в котором ведётся реклама приложени, список ID всех доступных вам проектов можно получить с помощью функции fbGetProjects

api_version - Версия API Facebook в формате v., например v2.8

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbGetPages

Описание

Функция возвращает список всех страниц по конкретному проекту бизнес менеджера.

Синтаксис

fbGetPages(projects_id, api_version, access_token)

Аругменты

projects_id - ID проекта в котором ведётся реклама приложени, список ID всех доступных вам проектов можно получить с помощью функции fbGetProjects

api_version - Версия API Facebook в формате v., например v2.8

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

fbGetAdAccounts

Описание

Функция возвращает список всех рекламных аккаунтов по конкретному проекту бизнес менеджера.

Синтаксис

fbGetAdAccounts(source_id, api_version, access_token )

Аругменты

source_id - ID проекта или бизнес менеджера в котором ведётся реклама приложени, список ID всех доступных вам проектов можно получить с помощью функции fbGetProjects, если не указать никакое значение в аргументе source_id функция вернёт список всех доступных вам рекламных аккаунтов.

api_version - Версия API Facebook в формате v., например v2.8

console_type - тип ответов в консоли, принимает одно из двух значений:

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

Структура возвращаемого дата фрейма

</tr>
Поле
Описание
name
Имя учетной записи. Если имя учетной записи не установлено, будет возвращено имя первого администратора, видимого пользователю.
id
ID рекламного аккаунта с префиксом "act_"
account_id
ЗID рекламного аккаунта
account_status
Статус аккаунта, возможные значения 1 = ACTIVE, 2 = DISABLED, 3 = UNSETTLED, 7 = PENDING_RISK_REVIEW, 9 = IN_GRACE_PERIOD, 100 = PENDING_CLOSURE, 101 = CLOSED, 102 = PENDING_SETTLEMENT, 201 = ANY_ACTIVE, 202 = ANY_CLOSED
amount_spent
Сумма потраченных средств, этот параметр можно сбрасывать в настройках аккаунта
balance
Остаток средств аккаунта
currency
Валюта аккаунта
business_city
Город указанный в настройках бизнес менеджера
business_country_code
Страна указанная в настройках бизнес менеджера
age
Количество дней после активации рекламного аккаунта
spend_cap
Лимит средств который может быть потрачен в рекламном аккаунта, после чего рекламные кампании будут остановлены, если установлено значения 0 то лимита нет.
business.id
ID бизнес менеджера к которому приклеплён аккаунт
business.name
Название бизнес менеджера к которому приклеплён аккаунт
owner.id
ID владельца рекламного аккаунта
owner.name
Имя владельца рекламного аккаунта

fbGetCampaigns

Описание

Функция возвращает список всех рекламных кампаний из рекламного аккаунта Facebook.

Синтаксис

fbGetCampaigns(accounts_id, api_version, access_token)

Аругменты

accounts_id — ID рекламного аккаунта. Это обязательный аргумент. Вы можете получить его из URL, если перейдете в нужный рекламный аккаунт Facebook, или же с помощью функции fbGetAccounts указывайте ID аккаунта с приставкой «act_», как в примере: accounts_id = “act_000000000000”.

api_version - Версия API Facebook в формате v., например v3.0

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

Структура возвращаемого дата фрейма

Поле
Описание
id
Идентификатор кампании.
name
Название кампании.
created_time
Время создания.
budget_remaining
Оставшийся бюджет.
buying_type
Тип покупки, возможные значения AUCTION (по умолчанию), RESERVED (для объявлений с охватом и частотой)
status
Статус рекламной кампании, возможные значения ACTIVE, PAUSED, DELETED, ARCHIVED, Если этот статус PAUSED, все его активные рекламные блоки и объявления будут приостановлены и будут иметь effective_status CAMPAIGN_PAUSED. Поле возвращает то же значение, что и configure_status.
configured_status
Статус рекламной кампании, возможные значения ACTIVE, PAUSED, DELETED, ARCHIVED, Если этот статус PAUSED, все его активные рекламные блоки и объявления будут приостановлены и будут иметь effective_status CAMPAIGN_PAUSED. Рекомендуется использовать поле status.
account_id
Идентификатор рекламного аккаунта к которому принадлежит данная рекламная кампания.
source_campaign_id
Идентификатор исходной рекламной кампании, из которой была скопирована текущая рекламная кампания.
spend_cap
Лимит бюджета для рекламной кампании.

fbGetAdSets

Описание

Функция возвращает список всех групп объявленйий из рекламного аккаунта Facebook.

Синтаксис

fbGetAdSets(accounts_id, api_version, access_token)

Аругменты

accounts_id — ID рекламного аккаунта. Это обязательный аргумент. Вы можете получить его из URL, если перейдете в нужный рекламный аккаунт Facebook, или же с помощью функции fbGetAccounts указывайте ID аккаунта с приставкой «act_», как в примере: accounts_id = “act_000000000000”.

api_version - Версия API Facebook в формате v., например v3.0

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

Структура возвращаемого дата фрейма

Поле
Описание
id
Идентификатор группы объявлений.
name
Название группы объявлений.
account_id
ID рекламного аккаунта.
budget_remaining
Оставшийся бюджет.
configured_status
Статус установленный на уровне группы объявлений. Он может отличаться от фактического статуса из-за его родительской кампании. Предпочитаете вместо этого использовать «статус».
effective_status
Статус группы объявлений, который может быть либо его собственным статусом, либо вызван его родительской кампанией.
status
Статус установленый на уровне группы объявлений. Он может отличаться от фактического статуса из-за его родительской кампании. Поле возвращает то же значение, что и 'configure_status'.
created_time
Время создания группы объявлений.
bid_strategy
Стратегия назначения ставок для группы объявления.
pacing_type
Тип показа объявлений, стандартный или планированные показы.

fbGetAds

Описание

Функция возвращает список всех объявленйий из рекламного аккаунта Facebook.

Синтаксис

fbGetAds(accounts_id, api_version, access_token)

Аругменты

accounts_id — ID рекламного аккаунта. Это обязательный аргумент. Вы можете получить его из URL, если перейдете в нужный рекламный аккаунт Facebook, или же с помощью функции fbGetAccounts указывайте ID аккаунта с приставкой «act_», как в примере: accounts_id = “act_000000000000”.

api_version - Версия API Facebook в формате v., например v3.0

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

Структура возвращаемого дата фрейма

Поле
Описание
id
Идентификатор объявления.
creative_id
Идентификатор креатива который будет использоваться этим объявлением.
adset_id
ID группы объявлений.
campaign_id
ID рекламной кампании.
account_id
ID рекламного аккаунта.
account_id
ID рекламного аккаунта.
bid_amount
Ставка для данного объявления, которая будет использоваться в аукционе.
bid_type
Тип ставки, возможные значения:CPC, CPM, MULTI_PREMIUM, ABSOLUTE_OCPM, CPA.
configured_status
Статус установленный для данного объявления, в данном статусе не учитывается статус родительской группы объявлений или рекламной кампании.
effective_status
Актуальный статус объявления, данный статус учитывает статус родительской группы объявлений и рекламной кампании. Возможные значения: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED

fbGetAdCreative

Описание

Функция возвращает список контента объявлений из рекламного аккаунта Facebook.

Синтаксис

fbGetAdCreative(accounts_id, api_version, access_token)

Аругменты

accounts_id — ID рекламного аккаунта. Это обязательный аргумент. Вы можете получить его из URL, если перейдете в нужный рекламный аккаунт Facebook, или же с помощью функции fbGetAccounts указывайте ID аккаунта с приставкой «act_», как в примере: accounts_id = “act_000000000000”.

api_version - Версия API Facebook в формате v., например v3.0

access_token - Токен достепа полученный с помощью функции fbGetToken или fbGetLongTimeToken

Структура возвращаемого дата фрейма

</tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr> </tr>
Поле
Описание
id
Идентификатор креатива.
name
Название креатива.
status
Статус креатива.
url_tags
Набор GET параметров, включая все UTM метки которые добавляются к URL объявления.
account_id
ID рекламного аккаунта.
page_id
ID страницы в Facebook на которое будет перенаправлены пользователи кликнувшие на рекламное объявление.
link
URL на который перенапрапралвтся пользователи кликнувшие по объявлению.
message
Основной текст объявления.
caption
Подпись к ссылке.
caption
Подпись к ссылке.
attachment_style
Стиль креатива, возможные значения: link, default.
description
Описание.
image_hash
Хеш изображения прикреплённого к объявлению.

fbGetMarketingStat

Описание

Основная функция пакета с помощью который вы можете получить статистику по своим рекламным аккаунтам.

Синтаксис

fbGetMarketingStat(accounts_id, sorting, level, breakdowns, action_breakdowns, fields, filtering, date_start, date_stop, interval, console_type, request_speed, api_version, access_token)

Аругменты

accounts_id — ID рекламного аккаунта. Это обязательный аргумент. Вы можете получить его из URL, если перейдете в нужный рекламный аккаунт Facebook, указывайте ID аккаунта с приставкой «act_», как в примере: accounts_id = “act_000000000000”.

sorting — cортировка данных. Необязательный аргумент. На входе принимает список полей и направление сортировки (по возрастанию или по убыванию). Пример: reach_descending, impressions_ascending.

level — уровень детализации данных. Обязательный аргумент. Принимает значения ad, adset, campaign, account. Пример — level = “account”.

fields — список полей, по которым вы планируете получить данные. Обязательный аргумент. Пример: fields = “account_id,account_name,campaign_name,impressions,unique_impressions,clicks,unique_clicks,reach,spend”. Актуальный список всех доступных полей можно посмотреть в официальной документации к API по ссылке.

filtering — фильтр данных. Необязательный аргумент. Фильтры задаются в виде JSON объектов «ключ:значение». Необходимо прописать три свойства:

breakdowns — аргумент, с помощью которого можно получить данные в разбивке на различные сегменты. Список доступных срезов информации, а так же информацию о том как они могут друг с другом сочитаться можно посмотреть в официальной документации к API по ссылке.

date_start — начальная дата отчетного периода в формате YYYY-MM-DDD.

date_stop — конечная дата отчетного периода в формате YYYY-MM-DDD.

interval - временная разбивка, допустимые значения “day”, “week”, “month”, “quarter”, “year”, “overall”

console_type - текстовое значение, тип ответов в консоли, принимает одно из двух значений:

request_speed - скорость оправки запросов к API, в зависимости от уровня доступа вашего приложения установите следующее значение:

api_version — версия API Facebook, в формате v., например “v2.11”

access_token — токен доступа.

Пример работы с пакетом rfacebookstat

Перед тем как запускать описанные ниже примеры, необходимо получить API-токен и сохраните его в объект token. token <- fbGetToken(app_id = 00000000000000)

Чтобы получить статистику о количестве показов, кликов и затрат на рекламу на уровне аккаунта и в разрезе регионов, введите следующий код:

AccStat <- fbGetMarketingStat(accounts_id = «act_0000000000»,
                              level = "account",
                              fields = "account_id,account_name,impressions,clicks,spend",
                              breakdowns = "region",
                              date_start = "2016-11-01",
                              date_stop = "2016-11-30",
                              access_token = token)

Получите статистику по количеству уникальных показов и уникальных кликов, с фильтром по возрастным группам «18-24», «25-34» и сортировкой данных в порядке убывания количества уникальных показов (поле unique_impressions).

CampStat <-     fbGetMarketingStat(accounts_id = "act_0000000000",
                                   level = "campaign",
                                   fields = "campaign_name,impressions,clicks",
                                   breakdowns = "age",
                                   sorting = "unique_impressions_descending",
                                   filtering = "[{'field':'age','operator':'IN','value':['18-24','25-34']}]",
                                   date_start = "2016-10-01",
                                   date_stop = "2016-10-10",
                                   access_token = token)

Автор пакета: Алексей Селезнёв, Head of Analytics Dept. at Netpeak

Контакты
email: selesnow@gmail.com
skype: selesnow
telegram: @AlexeySeleznev
Facebook Vkontakte Linkedin Blog GitHub Stepic