NEWS

rfacebookstat 2.12.1.9000

Доработал функцию fbGetAds(), теперь она работает более стабильно в случае ошибок 429, 500 и 503, за счёт 25 кратной повторной отправки запросов к API.
Функция fbGetAds() переписана на httr2.
Убрал на данный момент не нужный фильтр из функции fbGetAds().

rfacebookstat 2.12.1

Исправил некоторые ссылки в документации.

rfacebookstat 2.12.0 (2025-01-13)

Пакет переведён на работу с Facebook Marketing API v.21.

rfacebookstat 2.11.0 (2024-07-11)

Исправлена ошибка, при которой в функции fbGetMarketingStat() не работал аргумент use_unified_attribution_setting если не использовался аргумент fetch_by.
Пакет переведён на работу с Facebook Marketing API v.20.

rfacebookstat 2.10.0 (2024-01-25)

В функцию fbGetMarketingStat() добавлен аргумент use_unified_attribution_setting. Если для этого параметра установлено значение TRUE, результаты вашей рекламы будут показываться с использованием унифицированных настроек атрибуции, определенных на уровне группы объявлений, а параметр use_account_attribution_setting будет игнорироваться.
Пакет переведён на работу с Facebook Marketing API v.19.

rfacebookstat 2.9.9 (2024-01-15)

Cran fixing

rfacebookstat 2.9.8

Cran fixing

rfacebookstat 2.9.7

Исправление ссылок для документации.

rfacebookstat 2.9.6

Исправление ссылок для документации.

rfacebookstat 2.9.5

Пакет переведён на работу с Facebook Marketing API v.18.
Исправлены некоторые устаревшие ссылки в документации.

rfacebookstat 2.9.4

В функции fbGetAccounts() снизил лимит на количество запрашиваемых аккаунтов в одном запросе с 300 до 150, связано с ошибкой Please reduce the amount of data you're asking for, then retry your request.

rfacebookstat 2.9.3 (2023-05-16)

Пересборка для CRAN

rfacebookstat 2.9.2 (2023-04-20)

Исправил аргументы в функции fbAction(), для согласованности с fbAction.default().

rfacebookstat 2.9.1

Добавил в NAMESPACE регистрацию S3 методов.

rfacebookstat 2.9.0

Пакет переведён на работу с Facebook API Marketing v16.0

rfacebookstat 2.8.1 (2023-03-17)

Убрал все манипуляции с опцией stringsAsFactors согласно требованиям CRAN.

rfacebookstat 2.8.0 (2022-09-29)

Пакет переведён на работу с Facebook Marketing API v15.0

rfacebookstat 2.7.0 (2022-06-09)

В результат функции fbGetAdAccounts() добавленоо поле spend_cap, в котором содержится информация об установленном в аккаунте лимите затрат.
Пакет переведён на работу с Facebook Marketing API v14.0.
Вернул виньетки.

rfacebookstat 2.6.2 (2022-05-23)

Дата релиза: 2022-05-23

Временно удалил виньетки т.к. их не пропускал CRAN изза русского языка.

rfacebookstat 2.6.1

Дата релиза: 2022-05-23

Обновления для CRAN.

rfacebookstat 2.6.0

Дата релиза: 2022-05-23

Доработал парсинг ответа функцией fbGetMarketingStat(), теперь она так же парсит поле conversions.
В функции fbGetAdAccounts() снижен лимит с 1000 до 300 строк за один запрос, связано с ошибкой Please reduce the amount of data you're asking for, then retry your request.
Пакет переведён на работу с Facebook Marketing API v13.0.

rfacebookstat 2.5.0 (2021-12-16)

Дата релиза: 2021-12-15

Пакет переведён на работу с API v12.0
Исправлена работа аргумента interval в функции fbGetMarketingStat().
В функции fbAuth() и fbGetToken() отдельным аргументом выделен scopes, который позволяет по необходимости исключать неиспользуемые разрешения, например business_management. Более подробно о разрешениях можно почитать в справоке.

rfacebookstat 2.4.0 (2021-07-27)

Дата релиза: 2021-07-27

Пакет переведён на работу с API v11.0
Добавлена функция fbGetAdAccountCustomAudiences(), предназначенная для запроса кастомных аудиторий.
В функции fbGetAdCreative(), limit выведен как пользовательский параметр, теперь вы можете снизить к-во строк на запрос, если столкнулись с ошибкой Please reduce the amount of data you're asking for, then retry your request. Значение по умолчанию снижено до 50, ранее было 150.

rfacebookstat 2.3.0 (2021-04-16)

Дата релиза: 2021-04-16

Пакет переведён на работу с Facebook Markketing API v10.0
Добавил в результат возвращаемый функцией fbGetAdCreative() поле image_url.
Внесены изменения в парсинг ответа от API в функции fbGetAdSets(), т.к. старый парсер сбивался если поле pacing_type содержало сразу несколько значений.
Внесены изменения в парсинг ответа от API в функции fbGetPages(), так же к ответу данной функции добавлено поле account_id, с информацией о том, из какого рекламного аккаунта данная страница получена.
В пакет добавлена функция fbGetLogins(), которая выводит список всех логинов под которыми вы проходили авторизацию, и позволяет изменять логин выбрав его номер.
В пакет добавлено 5 функций для удобной установки и изменения опций пакета: fbSetUsername(), fbSetAccount(), fbSetBusinessId(), fbSetTokenPath(), fbSetApiVersion().
В связи с изменениями в Facebook Marketing API теперь нельзя с помощью функции fbGetMarketingStat() запрашивать данные старше 37 месяцев. В date_preset теперь нельзя указать 'lifetime', вместо него используйте 'maximum' который вернёт данные за послдение 37 месяцев.
Актуализирована виньетка по авторизации.

rfacebookstat 2.2.2 (2021-01-04)

Дата релиза: 2021-01-04

Мелкие правки ссылок в документации для публикации новой версии пакета на CRAN.

rfacebookstat 2.2.1

Дата релиза: 2020-12-28

Исправлена ошибка атрибута interval в функции fbGetMarketingStat(), ранее он просто игнорировался, и отдавал результат по дням.
Пакет переведён на работу с API v9.0
В функцию fbGetMarketingStat() добавлен аргумент fetch_by, который позволяет разбить запрос а длительный период на подзапросы по неделе, месяцу, кварталу, году и так далее.

Видео обзор релиза: https://youtu.be/ZN9-aYqq2tQ

rfacebookstat 2.2.0

Дата релиза: 2020-09-23

В пакет добавлена функция fbGetBusinessManagersUsers(), которая позволяет запросить список пользователей бизнес менедрежа Facebook.

rfacebookstat 2.1.9 (2020-10-01)

Дата релиза: 2020-09-24

Значительное ускорение функции fbGetMarketingStat(), ранее при запросе данных в разбивке по дням, функция отправляла на каждый день новый запрос, с версии 2.1.9 данные за весь период будут запрашиваться в одном запросе, если в результате вы получите более 5000 строк то будет запущен постраничный сбор данных, который в любом случае будет значительно быстрее чем, запрос данных отдельно за каждый день.
В функцию добавлен fbGetMarketingStat() добавлен аргумент date_preset, с помощью которого можно задавать условный временной диапазон. Возможные значения: today, yesterday, this_month, last_month, this_quarter, lifetime, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year.
В функцию добавлен fbGetMarketingStat() добавлен аргумент use_account_attribution_setting. Если для этого параметра установлено значение true, результаты ваших объявлений будут отображаться с использованием настроек атрибуции, определенных для рекламного аккаунта.
В результат возвращаемый функцией fbGetAdAccounts() добавлено поле created_time, в котором хранится дата и время создания аккаунта.

rfacebookstat 2.1.8

Дата релиза: 2020-08-27

В результат возвращаемый функцией fbGetCampaings(), добавлена полz start_time и stop_time.

rfacebookstat 2.1.7 (2020-08-27)

Дата релиза: 2020-08-27

Исправлены ссылки в документации
Ещё сильнее снижен лимит на количество объектов запрашиваемыхв одном запросе в функции fbGetAdCreative(), теперь за раз функция запрашивает всего 250 креативов, связано с ошибкой Please reduce the amount of data you're asking for, then retry your request.

rfacebookstat 2.1.6

Дата релиза: 2020-08-26

В функциях fbGetAds(), fbGetAdCreative(), fbGetCampaings(), fbGetAdSets() изменил повоедение при ошибках обращения к API, теперь данные функции в случае ошибки, будут остановлены с ошибкой, а не просто выведут уведомление.

rfacebookstat 2.1.5

Дата релиза: 2020-08-21

Пакет переведён на работу с Facebook Marketing API версией v8.0.
Ещё сильнее урезал лимит на 1 запрос по количеству креативов получаемых с помощью функции fbGetAdCreative(), т.к. всё равно на больших аккаунтах возникала ошибка.

rfacebookstat 2.1.4

Дата релиза: 2020-08-05

Исправил ошибку, которая возникала при автоматическом обновлении токена Error: object 'st_token' not found.

rfacebookstat 2.1.3

Дата релиза: 2020-07-17

Исправление в технической функции fbAction(), теперь она корректно парсит поле video_thruplay_watched_actions.

rfacebookstat 2.1.2

Дата релиза: 2020-06-12

Исправление функции fbGetAdCreative(), ранее возникала ошибка ели в аккаунте более 1000 креативов.

rfacebookstat 2.1.1 (2020-05-29)

Дата релиза: 2020-05-29

Исправление функции fbGetCostData().

rfacebookstat 2.1.0 (2020-05-27)

Дата релиза: 2020-05-26

В пакет добавлена функция fbGetCostData(), которая запрашивает и преобразует данные о расходах на facebook, для загрузки в Google Analytics.
Миграция на API v.7.0

rfacebookstat 2.0.3 (2020-05-06)

Дата релиза: 2020-05-06

Исправлена ошибка в функции fbGetAdCreative(), ранее не парсились ссылки, хеши миниатюр и сообщения в видео креативах. Также в результат возвращаемый данной функцией добавлены поляЖ

object_type - Тип объекта
video_id - Идентификатор видео

rfacebookstat 2.0.2 (2020-03-24)

Дата релиза: 2020-03-24

Исправлены некоторые проблемы которые возникали у пользоваталей при авторизации через стандартное приложение.

Добавлена скритая функция fbRevokeAppPrivilegies(), с помощью которой вы можете отозвать выданные приложению разрешения.

rfacebookstat 2.0.1 (2020-02-07)

Дата релиза: 2020-02-07

Пакет переведён на работу с API версии v6.0. Фактически на стороне Facebook Marketing API никаких изменений не было, единственное, что изменилось это значение опции rfacebookstat.api_version по умолчанию.

rfacebookstat 2.0.0 (2019-12-17)

Дата релиза: 2019-12-17

Новые функции
- fbAuth() - Новая функция авторизации, подробности в разеле Авторизация.
- fbGetUserAdAccounts() - Загрузка списка аккаунтов к которым есть доступ у определённого пользователя facebook.
- fbGetAdAccountsConversions() - Получить список конвесий настроенных в рекламной аккаунте.
- fbGetAdVideos() - Загрузка списка видео из рекламного аккаунта
- fbGetSettings() - Вывести в консоль все применённые в пакете настройки.
Доработанные функции
- В функцию fbGetMarketingStat() добавлен аргумент attribution_window с помощью которого вы можете запрашивать поле actions и применять к нему различные окна атрибуции.
- Так же был полностью переписан процесс разворачивания вложенных полей типа actions, и прочих. Теперь функция fbGetMarketingStat() работает с ними более стабильно.
- Изменения в функциях fbGetApps() и fbGetPages() теперь вы можете запрашивать список продвигаемых страниц и приложений непосредственно из рекламных аккаунтов.
  - Теперь вы можете запрашивать список страниц и приложений из конкретного аккаунта, используя аргумент accounts_id. Это новый аргумент который был добавлен вместо устаревшего projects_id.
  - В обеих функциях значительно расширен список полей которые они возвращают.
- В большинстве функций аргумент accounts_id больше не является обязательным, и по умолчанию запрашивает данные по всем рекламным аккаунтам к которым у вас есть доступ, эта доработка коснулась следующих функций:
  - fbGetCampaigns()
  - fbGetAdSets()
  - fbGetAds()
  - fbGetAdCreative()
  - fbGetApps()
  - fbGetPages()
  - fbGetAdAccountUsersPermissions()
  - fbGetAdAccountUsers()
Удалённые функции
- Из пакета полностью удалена функция fbGetProjects(), в связи с тем, что в Facebook больше не существует проектов.
Авторизация
- Был значительно улучшен процесс авторизации, теперь помимо опций вы можете использовать переменные среды.
- Так же при авторизации начиная с версии 2.0.0 учётные данные сохраняются в локальный файл, и по умолчанию вы получаете долгосрочный токен.
- В пакет встроено собственное приложение, теперь нет необходимости регистрировать собственное приложение и запрашивать стандартнй доступ к API, он уже по умолчанию вшит в пакет.
Документация
- В виньетку по загрузке статистики добавлена информация про окна атрибуции: vignette('rfacebookstat-get-statistics', package = 'rfacebookstat')
- В пакет добавлена новая виньетка посвящённая процессу авторизации и его автоматизации: vignette('rfacebookstat-authorization', package = 'rfacebookstat')
Прочее
- Пакет переведён на работу с версией API v5.0.

rfacebookstat 1.10.0 (2019-09-10)

Дата релиза: 2019-09-10

Пакет переведён на работу с API V4.0
Добавлена новая функция fbGetBusinessUserAdAccounts(), позволяющая загрузить по пользователю бизнесс менеджера список аккаунтов к которому ему предоставлен доступ.

rfacebookstat 1.9.1 (2019-06-19)

Исправлена виньетка

rfacebookstat 1.9.0 (2019-05-21)

Дата релиза: 2019-05-21

CСсылка на подробное описание релиза: Link

Что нового

Новая функция fbGetCatalogs предназначенная для загрузки каталогов;
Опции, для упрощения и компактности синтаксиса в пакет добавлены 4 опции
- rfacebookstat.api_version - Версия API, по умолчанию v3.3
- rfacebookstat.access_token - Токен доступа к API
- rfacebookstat.accounts_id - ID рекламного аккаунта
- rfacebookstat.business_id - ID бизнес менеджера
Упрощённый формат фильтрации данных, пример "impressions LESS_THAN 5000";
Исправлена ошибка возникающая при загрузке action и применения action_breakdowns;
В пакет добавлена виньетка посвящённая загрузки статистики из рекламных аккаунтов Facebook: vignette('rfacebookstat-get-statistics', package = 'rfacebookstat');
Добавлен обработчик лимитов API;
В результат возвращаемый функцией fbGetAdCreative добавлено поле link_nested с данными по дочерним ссылкам из кольцевой галереи.