rfacebookstat 2.10.0

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

rfacebookstat 2.9.2

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

rfacebookstat 2.9.0

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

rfacebookstat 2.8.1

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

rfacebookstat 2.7.0

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

Миграция на Facebook Marketing API v11.0

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 (Facebook Marketing API v10.0)

Change log

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

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

Пример использования fetch_by.

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

# один запрос
stat <- fbGetMarketingStat(
  accounts_id = 594412220755782,
  level       = 'campaign',
  date_start  = '2020-01-01', 
  date_stop   = '2020-12-30'
)

Результат: Please reduce the amount of data you're asking for, then retry your request

Получив эту ошибку вы можете разбить ваш большой запрос на части, по временному признаку, дням, неделям, месяцам, кварталам и годам, с помощью аргумента fetch_by:

# разбиваем запрос по месяцам
stat <- fbGetMarketingStat(
  accounts_id = 594412220755782, 
  level       = 'campaign',
  date_start  = '2020-08-01', 
  date_stop   = '2020-10-01', 
  fetch_by    = 'month'
  )

Миграция на API v8.0 и другие улучшения

Главные обновления:

1. Миграция на API v8.0
2. Ускорение функции fbGetMarketingStat() за счёт того, что теперь она не отправляет отдельный запрос на каждый день.

Подробнее смотрите в файле NEWS:

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().

Миграция на API v7.0 и загрузка данных о расходах из Facebook в Google Analytics

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