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_insights
method 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
#consumptions
method for posts - [REMOVAL] Remove
#fan_reach
method for posts - [FEATURE] Add
#clicks
method for posts
- [FEATURE] Add
:since
and:until
option toPage#videos
method.
- [FEATURE] Add
:without_lifetime_metrics
option toPage#videos
method.
- [FEATURE] Add
consumptions
,engaged_fan
,fan_reach
and 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
nil
for empty metric value inweekly_insights
.
- [FEATURE] Add
backdated_time
,total_impressions
,total_impressions_unique
,total_complete_views
andtotal_complete_views_unique
toFb::Video
.
- [REMOVAL] Remove
Fb::Page#insights_with_date_range
method.
- [FEATURE] Add
Fb::Page#insights_with_date_range
andFb::Page#posts_with_time_range
.
- [FEATURE] Add
video_avg_time_watched
toFb::Post
for length of average time watched.
- [FEATURE] Add
impressions
toFb::Post
for number of impressions of a post.
- [ENHANCEMENT] Fix and use Page Access Token when request page insights.
- [FEATURE] Add
Fb::Video
andFb::Page#videos
- [FEATURE] Add fields of "/videos" endpoint such as
comment_count
,length
etc toFb::Video
- [FEATURE] Add metrics from "/video_insights" endpoint such as
total_views
toFb::Video
- [FEATURE] Add
share_count
toFb::Post
for number of shares of a post.
- [FEATURE] Add
comment_count
,like_count
, andreaction_count
toFb::Post
for 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