All notable changes to this project will be documented in this file.
For more information about changelogs, check Keep a Changelog and Vandamme.
- [IMPROVEMENT] Return UTC time for String value of
created_time,backdated_time,end_time, etc from Facebook to have exact time. - [FEATURE] Add
Fb::Post#lifetime_insightsmethod to get metrics of each post. - [BUGFIX] Return empty hash instead of nil when a metric returns empty array.
How to upgrade
If your code calls .consumptions then you must replace that code with .clicks
since those metrics will no longer be supported by Facebook API as of
August 1, 2018.
If your code calls fan_reach from a Fb::Post then you must remove that code
because Facebook removed that metric from version 3.0 and they already applied the change to v2.9 the version currently
fb-core uses.
- [REMOVAL] Remove
#consumptionsmethod for posts - [REMOVAL] Remove
#fan_reachmethod for posts - [FEATURE] Add
#clicksmethod for posts
- [FEATURE] Add
:sinceand:untiloption toPage#videosmethod.
- [FEATURE] Add
:without_lifetime_metricsoption toPage#videosmethod.
- [FEATURE] Add
consumptions,engaged_fan,fan_reachand many more metrics toFb::Post.
How to upgrade
If your code is expecting Page#weekly_insights method to return 0 value
when response is empty, now it returns nil. This is a breaking change.
- [IMPROVEMENT] Return
nilfor empty metric value inweekly_insights.
- [FEATURE] Add
backdated_time,total_impressions,total_impressions_unique,total_complete_viewsandtotal_complete_views_uniquetoFb::Video.
- [REMOVAL] Remove
Fb::Page#insights_with_date_rangemethod.
- [FEATURE] Add
Fb::Page#insights_with_date_rangeandFb::Page#posts_with_time_range.
- [FEATURE] Add
video_avg_time_watchedtoFb::Postfor length of average time watched.
- [FEATURE] Add
impressionstoFb::Postfor number of impressions of a post.
- [ENHANCEMENT] Fix and use Page Access Token when request page insights.
- [FEATURE] Add
Fb::VideoandFb::Page#videos - [FEATURE] Add fields of "/videos" endpoint such as
comment_count,lengthetc toFb::Video - [FEATURE] Add metrics from "/video_insights" endpoint such as
total_viewstoFb::Video
- [FEATURE] Add
share_counttoFb::Postfor number of shares of a post.
- [FEATURE] Add
comment_count,like_count, andreaction_counttoFb::Postfor number of comments, number of likes, and number of reactions of a post.
- [FEATURE] Added
Fb::User - [FEATURE] Added
Fb::Page - [FEATURE] Added
Fb::Page#posts - [FEATURE] Added
Fb::Page#like_count - [FEATURE] Added
Fb::Page#view_count - [FEATURE] Added
Fb::Page#weekly_insights - [FEATURE] Added
Fb::Page#metric_insights