В rfacebookstat более полугода не было обновлений и наконец у меня добрались руки до перевода пакета на работу с API Facebook v3.3, и других доработок которые были достаточно давно запланированы.
Сразу скажу, что rfacebookstat 1.9.0 полностью совместим с предыдущей версией, и от вас в целом не понадобится проверять или переписывать старые скрипты, но в пакет было добавлено много новых возможностей.
Новая функция
В пакет добавлена функция fbGetCatalogs, предназначенная для загрузки каталогов
Опции
В предыдущих версиях пакетов в каждой функции необходимо было прописывать аргумент access_token, и некоторые другие аргументы так же дублировались в большинстве функций. В связи с чем я добавил в пакет возможность передачи этих значений через опции.
Для использования опций достаточно передать в начале скрипта им необходимые значения, и более не потребуется отдельно дублировать их во всех функция, сделать это можно следующим образом:
library(rfacebookstat)
options(rfacebookstat.api_version = "v3.3",
rfacebookstat.access_token = "ваш токен",
rfacebookstat.accounts_id = "act_0000000",
rfacebookstat.business_id = 0000000)Далее все функции будут запрашивать эти значение непосредственно из опций.
Упрощённый синтаксис фильтрации данных при загрузке статистики
Ранее для фильтрации данных полученных с помощью функции fbGetMarketingStat необходимо было передавать достаточно громоздкие JSON конструкции, для совместимости с предыдущими версиями я
оставил эту возможность, но теперь вы можете использовать так же упрощенный синтаксис.
Примеры синтаксиса фильтрации:
- Получить строки в которых менее 5000 показов:
"impressions LESS_THAN 5000" - Получить строки в которых значения поля publisher_platform будет instagram или facebook:
"publisher_platform IN instagram,facebook" - Получить строки в которых менее 500 кликов и более 1000 показов:
c("clicks LESS_THAN 500", "impressions GREATER_THAN 1000")
Загрузка action и применения action_breakdowns
После перехода API Facebook на версию 3.1 пакет перестал загружать данные поля actions и работать с параметром action_breakdowns в связи с изменением структуры возвращаемых от API данных.
В версии 1.9.0 ' эта проблема была исправлена.
Новый аргумент в функции fbGetMarketingStat
action_report_time - Допустимые значения: impression, conversion. Определяет отчет о времени действия статистики. Например, если человек видел объявление 1 января, но совершил конверсию 2 января, при запросе API с action_report_time = "impression", вы увидите конверсию 1 января. Когда вы запросите API с помощью action_report_time = "conversion", вы увидите преобразование 2 января.
Виньетка посвящённая загрузке статистики из API Facebook
Для упрощения понимания основной функции пакета fbGetMarketingStat я написал подробную виньетку, открыть её можно с помощью команды vignette('rfacebookstat-get-statistics', package = 'rfacebookstat').
Содержание виньетки:
- Аргументы
- Разбивки
- Разбивки по событиям
- Применить одновременно несколько разбивок
- Фильтрация данных
- Лимиты API и аргумент request_speed
Обработчик лимитов API
В Facebook API v3.3 поменялись лимиты на количество возможных запросов, в пакет был дописан обработчик лимитов, но пока сам API по лимитам работает не корректно поэтому при запросе статистики по дням за длительный период используйте аргумент request_speed.
Новое поле возвращаемое функцией fbGetAdCreative
Ранее fbGetAdCreative возвращала только поля link и url_tags на уровне объявления, в которых хранились основная ссылка и параметры URL соответственно. Теперь, благодаря доработке Эдуарда Горха появилось поле link_nested, которое хранит данные по ссылкам и меткам, если они стоят на уровень ниже в иерархии объявления (например, в кольцевой галерее). Если таких параметров несколько, то они записывается в одну ячейку через точку с запятой. Это позволит выгружать полные данные по ссылкам и UTM-меткам рекламы.