Skip to content

Latest commit

 

History

History
340 lines (203 loc) · 20.4 KB

NEWS.md

File metadata and controls

340 lines (203 loc) · 20.4 KB
Raw

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