rfacebookstat 2.13.1

• Небольшие правки документации пакета для отправки на CRAN.

rfacebookstat 2.13.0

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

rfacebookstat 2.12.1

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

rfacebookstat 2.12.0

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

rfacebookstat 2.11.0

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

rfacebookstat 2.10.0

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

rfacebookstat 2.9.9

• 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

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

rfacebookstat 2.9.2

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

rfacebookstat 2.9.1

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

rfacebookstat 2.9.0

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

rfacebookstat 2.8.1

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

rfacebookstat 2.8.0

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

rfacebookstat 2.7.0

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

rfacebookstat 2.6.2

Дата релиза: 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-15

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

rfacebookstat 2.4.0

Дата релиза: 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

• Пакет переведён на работу с 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

Мелкие правки ссылок в документации для публикации новой версии пакета на 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-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

• Исправлены ссылки в документации
• Ещё сильнее снижен лимит на количество объектов запрашиваемыхв одном запросе в функции 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

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

rfacebookstat 2.1.0

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

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

rfacebookstat 2.0.3

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

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

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

rfacebookstat 2.0.2

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

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

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

rfacebookstat 2.0.1

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

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

rfacebookstat 2.0.0

Дата релиза: 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

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

rfacebookstat 1.9.1

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

rfacebookstat 1.9.0

Дата релиза: 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 с данными по дочерним ссылкам из кольцевой галереи.