Changes in version 2.15.0 - Добавлена функция fbGetBusinessInvoices() для загрузки счетов из Бизнес-менеджера. - Добавлена функция fbDownloadBusinessInvoices() для векторизированного скачивания PDF-счетов. - Исправлен баг в функции fbGetMarketingStat(), из-за которого списки экшенов, отличные от стандартных (например, метрики удержания видео video_p25_watched_actions - video_p100_watched_actions или запуски video_play_actions), отбрасывались и удалялись из итоговой таблицы при парсинге. Теперь любые списки результатов, оканчивающиеся на _actions, корректно парсятся и возвращаются. Changes in version 2.14.0 (2026-04-17) - Пакет переведён на работу с Facebook Marketing API v25.0. - В функцию fbGetAdSets() добавлено новое поле is_adset_budget_sharing_enabled. - Улучшена обработка ошибок в функции fbGetMarketingStat(), теперь выводятся более подробные сообщения error_user_title и error_user_msg. - В функцию fbGetAdAccounts() добавлен аргумент limit. Значение по умолчанию снижено со 100 до 50 для избежания ошибки An unexpected error has occurred. Please retry your request later. на больших бизнес-менеджерах. Changes in version 2.13.1 (2025-08-20) - Небольшие правки документации пакета для отправки на CRAN. Changes in version 2.13.0 - Доработал функцию fbGetAds(), теперь она работает более стабильно в случае ошибок 429, 500 и 503, за счёт 25 кратной повторной отправки запросов к API. - Функция fbGetAds() переписана на httr2. - Убрал на данный момент не нужный фильтр из функции fbGetAds(). - Пакет переведён на работу с Facebook Marketing API v.23. Changes in version 2.12.1 - Исправил некоторые ссылки в документации. Changes in version 2.12.0 (2025-01-13) - Пакет переведён на работу с Facebook Marketing API v.21. Changes in version 2.11.0 (2024-07-11) - Исправлена ошибка, при которой в функции fbGetMarketingStat() не работал аргумент use_unified_attribution_setting если не использовался аргумент fetch_by. - Пакет переведён на работу с Facebook Marketing API v.20. Changes in version 2.10.0 (2024-01-25) - В функцию fbGetMarketingStat() добавлен аргумент use_unified_attribution_setting. Если для этого параметра установлено значение TRUE, результаты вашей рекламы будут показываться с использованием унифицированных настроек атрибуции, определенных на уровне группы объявлений, а параметр use_account_attribution_setting будет игнорироваться. - Пакет переведён на работу с Facebook Marketing API v.19. Changes in version 2.9.9 (2024-01-15) - Cran fixing Changes in version 2.9.8 - Cran fixing Changes in version 2.9.7 - Исправление ссылок для документации. Changes in version 2.9.6 - Исправление ссылок для документации. Changes in version 2.9.5 - Пакет переведён на работу с Facebook Marketing API v.18. - Исправлены некоторые устаревшие ссылки в документации. Changes in version 2.9.4 - В функции fbGetAccounts() снизил лимит на количество запрашиваемых аккаунтов в одном запросе с 300 до 150, связано с ошибкой Please reduce the amount of data you're asking for, then retry your request. Changes in version 2.9.3 (2023-05-16) - Пересборка для CRAN Changes in version 2.9.2 (2023-04-20) - Исправил аргументы в функции fbAction(), для согласованности с fbAction.default(). Changes in version 2.9.1 - Добавил в NAMESPACE регистрацию S3 методов. Changes in version 2.9.0 - Пакет переведён на работу с Facebook API Marketing v16.0 Changes in version 2.8.1 (2023-03-17) - Убрал все манипуляции с опцией stringsAsFactors согласно требованиям CRAN. Changes in version 2.8.0 (2022-09-29) - Пакет переведён на работу с Facebook Marketing API v15.0 Changes in version 2.7.0 (2022-06-09) - В результат функции fbGetAdAccounts() добавленоо поле spend_cap, в котором содержится информация об установленном в аккаунте лимите затрат. - Пакет переведён на работу с Facebook Marketing API v14.0. - Вернул виньетки. Changes in version 2.6.2 (2022-05-23) Дата релиза: 2022-05-23 - Временно удалил виньетки т.к. их не пропускал CRAN изза русского языка. Changes in version 2.6.1 Дата релиза: 2022-05-23 - Обновления для CRAN. Changes in version 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. Changes in version 2.5.0 (2021-12-16) Дата релиза: 2021-12-15 - Пакет переведён на работу с API v12.0 - Исправлена работа аргумента interval в функции fbGetMarketingStat(). - В функции fbAuth() и fbGetToken() отдельным аргументом выделен scopes, который позволяет по необходимости исключать неиспользуемые разрешения, например business_management. Более подробно о разрешениях можно почитать в справоке. Changes in version 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. Changes in version 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 месяцев. - Актуализирована виньетка по авторизации. Changes in version 2.2.2 (2021-01-04) Дата релиза: 2021-01-04 Мелкие правки ссылок в документации для публикации новой версии пакета на CRAN. Changes in version 2.2.1 Дата релиза: 2020-12-28 - Исправлена ошибка атрибута interval в функции fbGetMarketingStat(), ранее он просто игнорировался, и отдавал результат по дням. - Пакет переведён на работу с API v9.0 - В функцию fbGetMarketingStat() добавлен аргумент fetch_by, который позволяет разбить запрос а длительный период на подзапросы по неделе, месяцу, кварталу, году и так далее. Видео обзор релиза: https://youtu.be/ZN9-aYqq2tQ Changes in version 2.2.0 Дата релиза: 2020-09-23 - В пакет добавлена функция fbGetBusinessManagersUsers(), которая позволяет запросить список пользователей бизнес менедрежа Facebook. Changes in version 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, в котором хранится дата и время создания аккаунта. Changes in version 2.1.8 Дата релиза: 2020-08-27 - В результат возвращаемый функцией fbGetCampaings(), добавлена полz start_time и stop_time. Changes in version 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. Changes in version 2.1.6 Дата релиза: 2020-08-26 - В функциях fbGetAds(), fbGetAdCreative(), fbGetCampaings(), fbGetAdSets() изменил повоедение при ошибках обращения к API, теперь данные функции в случае ошибки, будут остановлены с ошибкой, а не просто выведут уведомление. Changes in version 2.1.5 Дата релиза: 2020-08-21 - Пакет переведён на работу с Facebook Marketing API версией v8.0. - Ещё сильнее урезал лимит на 1 запрос по количеству креативов получаемых с помощью функции fbGetAdCreative(), т.к. всё равно на больших аккаунтах возникала ошибка. Changes in version 2.1.4 Дата релиза: 2020-08-05 - Исправил ошибку, которая возникала при автоматическом обновлении токена Error: object 'st_token' not found. Changes in version 2.1.3 Дата релиза: 2020-07-17 - Исправление в технической функции fbAction(), теперь она корректно парсит поле video_thruplay_watched_actions. Changes in version 2.1.2 Дата релиза: 2020-06-12 - Исправление функции fbGetAdCreative(), ранее возникала ошибка ели в аккаунте более 1000 креативов. Changes in version 2.1.1 (2020-05-29) Дата релиза: 2020-05-29 - Исправление функции fbGetCostData(). Changes in version 2.1.0 (2020-05-27) Дата релиза: 2020-05-26 - В пакет добавлена функция fbGetCostData(), которая запрашивает и преобразует данные о расходах на facebook, для загрузки в Google Analytics. - Миграция на API v.7.0 Changes in version 2.0.3 (2020-05-06) Дата релиза: 2020-05-06 Исправлена ошибка в функции fbGetAdCreative(), ранее не парсились ссылки, хеши миниатюр и сообщения в видео креативах. Также в результат возвращаемый данной функцией добавлены поляЖ - object_type - Тип объекта - video_id - Идентификатор видео Changes in version 2.0.2 (2020-03-24) Дата релиза: 2020-03-24 Исправлены некоторые проблемы которые возникали у пользоваталей при авторизации через стандартное приложение. Добавлена скритая функция fbRevokeAppPrivilegies(), с помощью которой вы можете отозвать выданные приложению разрешения. Changes in version 2.0.1 (2020-02-07) Дата релиза: 2020-02-07 Пакет переведён на работу с API версии v6.0. Фактически на стороне Facebook Marketing API никаких изменений не было, единственное, что изменилось это значение опции rfacebookstat.api_version по умолчанию. Changes in version 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. Changes in version 1.10.0 (2019-09-10) Дата релиза: 2019-09-10 - Пакет переведён на работу с API V4.0 - Добавлена новая функция fbGetBusinessUserAdAccounts(), позволяющая загрузить по пользователю бизнесс менеджера список аккаунтов к которому ему предоставлен доступ. Changes in version 1.9.1 (2019-06-19) Исправлена виньетка Changes in version 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 с данными по дочерним ссылкам из кольцевой галереи.