fb-core 1.0.0.beta7 → 1.0.0.beta8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4d853e976631a35311183b0d8f28bae65b4d90cc
-  data.tar.gz: a32067114ea8e9ccaf76b2a9cf7333bc8d0d1282
+  metadata.gz: 62b3639b2d53365cf9fcf89ac1520aad9bed5e2b
+  data.tar.gz: 8348719c7b2f4f12ecf4622b5888dd106a0d1d29
 SHA512:
-  metadata.gz: 1c9bb54f6c5790fd0fcdc1aa14192c0aec44d91450f66a938fb3391d366bb982c10a04ede5f502757d0f0248a07bc583935a559e82aadcf14313797696647d9d
-  data.tar.gz: a9cd5b24460099063284245405a713d360ea8400729613631e9cefa19f93f3e8c8e8d8260e6648e2176422e01312aa518983f991194f0800c3775828179d45be
+  metadata.gz: db7576ae42ffbb4fb4c068372f687212605b049971925dae88e710f7a1218ca3c9eb8106f69dc769ee5188b870149bf15b8e4ede228180b1c86853ed7b4921af
+  data.tar.gz: 4ff564d72a423c75cf5984c0da7dd75ede0ae6204e65517f57fdf25523974df155a710e403c91c50bd97cfe7d7e889b36a48a861cb60407db1daa86a438566db

data/CHANGELOG.md

@@ -6,6 +6,10 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 1.0.0.beta8  - 2018/04/20
+
+* [FEATURE] Add `consumptions`, `engaged_fan`, `fan_reach` and many more metrics to `Fb::Post`.
+
 ## 1.0.0.beta7  - 2018/04/09
 
 **How to upgrade**

data/lib/fb/core/version.rb

@@ -3,6 +3,6 @@ module Fb
   class Core
     # @return [String] the SemVer-compatible gem version.
     # @see http://semver.org
-    VERSION = '1.0.0.beta7'
+    VERSION = '1.0.0.beta8'
   end
 end

data/lib/fb/page.rb

@@ -153,8 +153,24 @@ module Fb
 
     # https://developers.facebook.com/docs/graph-api/reference/v2.10/insights
     def post_metrics
-      %i(post_engaged_users post_video_views_organic post_video_views_paid post_video_views post_video_view_time
-      post_impressions post_video_avg_time_watched)
+      %i(post_video_complete_views_30s_autoplayed post_video_complete_views_30s_clicked_to_play
+      post_video_complete_views_30s_organic post_video_complete_views_30s_paid
+      post_video_complete_views_30s_unique post_impressions post_impressions_unique
+      post_impressions_paid post_impressions_paid_unique post_impressions_fan
+      post_impressions_fan_unique post_impressions_fan_paid post_impressions_fan_paid_unique
+      post_impressions_organic post_impressions_organic_unique post_impressions_viral
+      post_consumptions post_engaged_users post_negative_feedback post_engaged_fan
+      post_fan_reach post_reactions_like_total post_reactions_love_total
+      post_reactions_wow_total post_reactions_haha_total post_reactions_sorry_total
+      post_reactions_anger_total post_video_avg_time_watched post_video_complete_views_organic
+      post_video_complete_views_organic_unique post_video_complete_views_paid
+      post_video_complete_views_paid_unique post_video_views_organic
+      post_video_views_organic_unique post_video_views_paid post_video_views_paid_unique
+      post_video_length post_video_views post_video_views_unique post_video_views_autoplayed
+      post_video_views_clicked_to_play post_video_views_10s post_video_views_10s_unique
+      post_video_views_10s_autoplayed post_video_views_10s_clicked_to_play
+      post_video_views_10s_organic post_video_views_10s_paid post_video_views_10s_sound_on
+      post_video_views_sound_on post_video_view_time post_video_view_time_organic)
     end
 
     def videos_with_metrics_from(data)

data/lib/fb/post.rb

@@ -3,7 +3,7 @@
 module Fb
   # Fb::Post reprensents a Facebook post. Post provides getters for:
   #   :id, :url, :created_at, :type, :message, :length, engaged_users,
-  #   video_views, video_views_organic, video_views_paid, and video_view_time.
+  #   video_views, video_views_organic, video_views_paid, and so on.
   # @see https://developers.facebook.com/docs/graph-api/reference/v2.10/post
   class Post
 
@@ -25,39 +25,200 @@ module Fb
     # @option [String] the attached video's length or n/a.
     attr_reader :length
 
+    # @return [Integer] the number of comments of the post.
+    attr_reader :comment_count
+
+    # @return [Integer] the number of likes of the post.
+    attr_reader :like_count
+
+    # @return [Integer] the number of reactions of the post.
+    attr_reader :reaction_count
+
+    # @return [Integer] the number of shares of the post.
+    attr_reader :share_count
+
+    # @option [Integer] number of times your video started automatically playing
+    #   and people viewed it for 30 seconds or to the end, whichever came first.
+    attr_reader :video_complete_views_30s_autoplayed
+
+    # @option [Integer] number of times people clicked to play your video and
+    #   viewed it for 30 seconds or to the end, whichever came first.
+    attr_reader :video_complete_views_30s_clicked_to_play
+
+    # @option [Integer] number of times your video was viewed for 30 seconds
+    #   or viewed to the end, whichever came first, without a paid promotion.
+    attr_reader :video_complete_views_30s_organic
+
+    # @option [Integer] number of times your video was viewed for 30 seconds or
+    #   viewed to the end, whichever came first, after a paid promotion.
+    attr_reader :video_complete_views_30s_paid
+
+    # @option [Integer] total number of times page's videos have been viewed
+    #   for more than 30 seconds by unique users.
+    attr_reader :video_complete_views_30s_unique
+
+    # @option [Integer] the number of times your Page's post entered a person's screen.
+    attr_reader :impressions
+
+    # @option [Integer] the number of people who had your Page's post enter
+    #   their screen.
+    attr_reader :impressions_unique
+
+    # @option [Integer] the number of times your Page's post entered a person's
+    #   screen through paid distribution such as an ad.
+    attr_reader :impressions_paid
+
+    # @option [Integer] the number of people who had your Page's post enter
+    #   their screen through paid distribution such as an ad.
+    attr_reader :impressions_paid_unique
+
+    # @option [Integer] the number of impressions for your Page post by people
+    #   who have liked your Page.
+    attr_reader :impressions_fan
+
+    # @option [Integer] the number of people who have like your Page who saw your Page post.
+    attr_reader :impressions_fan_unique
+
+    # @option [Integer] the number of impressions for your Page post by people
+    #   who like your Page in an Ad or Sponsored Story.
+    attr_reader :impressions_fan_paid
+
+    # @option [Integer] the number of people who have like your Page and saw
+    #   your Page post in an Ad or Sponsored Story.
+    attr_reader :impressions_fan_paid_unique
+
+    # @option [Integer] the number of times your Page's post entered a person's screen.
+    attr_reader :impressions_organic
+
+    # @option [Integer] the number of people who had your Page's post enter their screen.
+    attr_reader :impressions_organic_unique
+
+    # @option [Integer] the number of times your Page's post entered a person's
+    #   screen with social information attached.
+    attr_reader :impressions_viral
+
+    # @option [Integer] the number of times people clicked on anywhere
+    #   in your posts without generating a story.
+    attr_reader :consumptions
+
     # @option [Integer] the number of people who clicked anywhere on the post.
     attr_reader :engaged_users
 
-    # @option [Integer] video views of 3 seconds or more.
-    attr_reader :video_views
+    # @option [Integer] the number of times people took a negative action in your post (e.g. hid it).
+    attr_reader :negative_feedback
+
+    # @option [Integer] people who have liked your page and engaged with your post.
+    attr_reader :engaged_fan
+
+    # @option [Integer] post reach by people who like your page.
+    attr_reader :fan_reach
+
+    # @option [Integer] total "like" reactions of a post.
+    attr_reader :reactions_like_total
+
+    # @option [Integer] total "love" reactions of a post.
+    attr_reader :reactions_love_total
+
+    # @option [Integer] total "wow" reactions of a post.
+    attr_reader :reactions_wow_total
+
+    # @option [Integer] total "haha" reactions of a post.
+    attr_reader :reactions_haha_total
+
+    # @option [Integer] total "sorry" reactions of a post.
+    attr_reader :reactions_sorry_total
+
+    # @option [Integer] total "anger" reactions of a post.
+    attr_reader :reactions_anger_total
+
+    # @option [Integer] the average length of time people spent viewing
+    #   your video, in milliseconds.
+    attr_reader :video_avg_time_watched
+
+    # @option [Integer] the number of times your video was organically viewed
+    #   from the beginning to 95% of its length.
+    attr_reader :video_complete_views_organic
+
+    # @option [Integer] the number of people who viewed your video organically
+    #   from the beginning to 95% of its length.
+    attr_reader :video_complete_views_organic_unique
+
+    # @option [Integer] the number of times your video was viewed via paid
+    #   impression from the beginning to 95% of its length.
+    attr_reader :video_complete_views_paid
+
+    # @option [Integer] the number of people who viewed your video via
+    #   paid impression from the beginning to 95% of its length.
+    attr_reader :video_complete_views_paid_unique
 
     # @option [Integer] organic video views of 3 seconds or more.
     attr_reader :video_views_organic
 
+    # @option [Integer] the number of people who viewed at least 3 seconds
+    #   of your video organically.
+    attr_reader :video_views_organic_unique
+
     # @option [Integer] paid video views of 3 seconds or more.
     attr_reader :video_views_paid
 
-    # @option [Integer] the total number of milliseconds your video was watched.
-    attr_reader :video_view_time
+    # @option [Integer] the number of people who viewed at least 3 seconds
+    #   of your video via paid impression.
+    attr_reader :video_views_paid_unique
 
-    # @option [Integer] The number of times your Page's post entered a person's screen.
-    attr_reader :impressions
+    # @option [Integer] length of a video post (in milliseconds).
+    attr_reader :video_length
 
-    # @option [Integer] The average length of time people spent viewing
-    #   your video, in milliseconds.
-    attr_reader :video_avg_time_watched
+    # @option [Integer] video views of 3 seconds or more.
+    attr_reader :video_views
 
-    # @return [Integer] the number of comments of the post.
-    attr_reader :comment_count
+    # @option [Integer] the number of distinct people who viewed your video at least once.
+    attr_reader :video_views_unique
 
-    # @return [Integer] the number of likes of the post.
-    attr_reader :like_count
+    # @option [Integer] number of times your video started automatically
+    #   playing and people viewed it for more than 3 seconds.
+    attr_reader :video_views_autoplayed
 
-    # @return [Integer] the number of reactions of the post.
-    attr_reader :reaction_count
+    # @option [Integer] number of times people clicked to play your video
+    #   and viewed it more than 3 seconds.
+    attr_reader :video_views_clicked_to_play
 
-    # @return [Integer] the number of shares of the post.
-    attr_reader :share_count
+    # @option [Integer] the number of times your video was watched for an aggregate of
+    #   at least 10 seconds, or for nearly its total length, whichever happened first.
+    attr_reader :video_views_10s
+
+    # @option [Integer] number of unique viewers who watched your video for
+    #   10 seconds or to the end, whichever happened first.
+    attr_reader :video_views_10s_unique
+
+    # @option [Integer] number of times your video started playing automatically
+    #   and people viewed it for 10 seconds or to the end, whichever happened first.
+    attr_reader :video_views_10s_autoplayed
+
+    # @option [Integer] number of times people clicked to play your video and
+    #   viewed it for 10 seconds or to the end, whichever happened first.
+    attr_reader :video_views_10s_clicked_to_play
+
+    # @option [Integer] number of times your video was viewed for 10 seconds or
+    #   viewed to the end (whichever happened first) without paid promotion.
+    attr_reader :video_views_10s_organic
+
+    # @option [Integer] number of times your video was viewed for 10 seconds or
+    #   viewed to the end (whichever happened first) with paid promotion.
+    attr_reader :video_views_10s_paid
+
+    # @option [Integer] number of times your video was viewed with sound on
+    #   for 10 seconds or viewed to the end, whichever happened first.
+    attr_reader :video_views_10s_sound_on
+
+    # @option [Integer] number of times your video was viewed with sound on
+    #   for 3 seconds or viewed to the end, whichever happened first.
+    attr_reader :video_views_sound_on
+
+    # @option [Integer] the total number of milliseconds your video was watched.
+    attr_reader :video_view_time
+
+    # @option [Integer] total time (in milliseconds) video has been viewed without paid promotion.
+    attr_reader :video_view_time_organic
 
     # @param [Hash] options the options to initialize an instance of Fb::Post.
     # @option [String] :id The post id.
@@ -80,18 +241,62 @@ module Fb
       @length = options.fetch(:properties, []).find(-> { {'text' => 'n/a'} }) do |property|
         property['name'] == 'Length'
       end['text']
-      @engaged_users = options[:post_engaged_users]
-      @video_views = options[:post_video_views]
-      @video_views_organic = options[:post_video_views_organic]
-      @video_views_paid = options[:post_video_views_paid]
-      @video_view_time = options[:post_video_view_time]
-      @impressions = options[:post_impressions]
-      @video_avg_time_watched = options[:post_video_avg_time_watched]
-
       @share_count = options[:shares] ? options[:shares]["count"] : 0
       @comment_count = options[:comments]['summary']['total_count'] if options[:comments]
       @reaction_count = options[:reactions]['summary']['total_count'] if options[:reactions]
       @like_count = options[:likes]['summary']['total_count'] if options[:likes]
+
+      @video_complete_views_30s_autoplayed = options[:post_video_complete_views_30s_autoplayed]
+      @video_complete_views_30s_clicked_to_play = options[:post_video_complete_views_30s_clicked_to_play]
+      @video_complete_views_30s_organic = options[:post_video_complete_views_30s_organic]
+      @video_complete_views_30s_paid = options[:post_video_complete_views_30s_paid]
+      @video_complete_views_30s_unique = options[:post_video_complete_views_30s_unique]
+      @impressions = options[:post_impressions]
+      @impressions_unique = options[:post_impressions_unique]
+      @impressions_paid = options[:post_impressions_paid]
+      @impressions_paid_unique = options[:post_impressions_paid_unique]
+      @impressions_fan = options[:post_impressions_fan]
+      @impressions_fan_unique = options[:post_impressions_fan_unique]
+      @impressions_fan_paid = options[:post_impressions_fan_paid]
+      @impressions_fan_paid_unique = options[:post_impressions_fan_paid_unique]
+      @impressions_organic = options[:post_impressions_organic]
+      @impressions_organic_unique = options[:post_impressions_organic_unique]
+      @impressions_viral = options[:post_impressions_viral]
+      @consumptions = options[:post_consumptions]
+      @engaged_users = options[:post_engaged_users]
+      @negative_feedback = options[:post_negative_feedback]
+      @engaged_fan = options[:post_engaged_fan]
+      @fan_reach = options[:post_fan_reach]
+      @reactions_like_total = options[:post_reactions_like_total]
+      @reactions_love_total = options[:post_reactions_love_total]
+      @reactions_wow_total = options[:post_reactions_wow_total]
+      @reactions_haha_total = options[:post_reactions_haha_total]
+      @reactions_sorry_total = options[:post_reactions_sorry_total]
+      @reactions_anger_total = options[:post_reactions_anger_total]
+      @video_avg_time_watched = options[:post_video_avg_time_watched]
+      @video_complete_views_organic = options[:post_video_complete_views_organic]
+      @video_complete_views_organic_unique = options[:post_video_complete_views_organic_unique]
+      @video_complete_views_paid = options[:post_video_complete_views_paid]
+      @video_complete_views_paid_unique = options[:post_video_complete_views_paid_unique]
+      @video_views_organic = options[:post_video_views_organic]
+      @video_views_organic_unique = options[:post_video_views_organic_unique]
+      @video_views_paid = options[:post_video_views_paid]
+      @video_views_paid_unique = options[:post_video_views_paid_unique]
+      @video_length = options[:post_video_length]
+      @video_views = options[:post_video_views]
+      @video_views_unique = options[:post_video_views_unique]
+      @video_views_autoplayed = options[:post_video_views_autoplayed]
+      @video_views_clicked_to_play = options[:post_video_views_clicked_to_play]
+      @video_views_10s = options[:post_video_views_10s]
+      @video_views_10s_unique = options[:post_video_views_10s_unique]
+      @video_views_10s_autoplayed = options[:post_video_views_10s_autoplayed]
+      @video_views_10s_clicked_to_play = options[:post_video_views_10s_clicked_to_play]
+      @video_views_10s_organic = options[:post_video_views_10s_organic]
+      @video_views_10s_paid = options[:post_video_views_10s_paid]
+      @video_views_10s_sound_on = options[:post_video_views_10s_sound_on]
+      @video_views_sound_on = options[:post_video_views_sound_on]
+      @video_view_time = options[:post_video_view_time]
+      @video_view_time_organic = options[:post_video_view_time_organic]
     end
 
     # @return [String] the representation of the post.

data/lib/fb/video.rb

@@ -36,51 +36,51 @@ module Fb
     # @option [Float] the video’s length.
     attr_reader :length
 
-    # @option [Time] The time the video was initially published.
+    # @option [Time] the time the video was initially published.
     attr_reader :created_at
 
-    # @option [Time] The time when the video post was created.
+    # @option [Time] the time when the video post was created.
     attr_reader :backdated_time
 
-    # @option [Integer] Total number of times the video was viewed for 3 seconds
+    # @option [Integer] total number of times the video was viewed for 3 seconds
     # or viewed to the end, whichever happened first. total_video_views.
     # @see https://developers.facebook.com/docs/graph-api/reference/video/video_insights/
     attr_reader :total_views
 
-    # @option [Integer] The total_video_views_unique of the video.
+    # @option [Integer] the total_video_views_unique of the video.
     attr_reader :total_views_unique
 
-    # @option [Integer] The total_video_avg_time_watched of the video.
+    # @option [Integer] the total_video_avg_time_watched of the video.
     attr_reader :total_avg_time_watched
 
-    # @option [Integer] The total_video_views_autoplayed of the video.
+    # @option [Integer] the total_video_views_autoplayed of the video.
     attr_reader :total_views_autoplayed
 
-    # @option [Integer] The total_video_views_clicked_to_play of the video.
+    # @option [Integer] the total_video_views_clicked_to_play of the video.
     attr_reader :total_views_clicked_to_play
 
-    # @option [Integer] The total_video_complete_views_auto_played of the video.
+    # @option [Integer] the total_video_complete_views_auto_played of the video.
     attr_reader :total_complete_views_auto_played
 
-    # @option [Integer] The total_video_complete_views_clicked_to_play of the video.
+    # @option [Integer] the total_video_complete_views_clicked_to_play of the video.
     attr_reader :total_complete_views_clicked_to_play
 
-    # @option [Integer] The total_video_views_sound_on of the video.
+    # @option [Integer] the total_video_views_sound_on of the video.
     attr_reader :total_views_sound_on
 
-    # @option [Integer] The total_video_10s_views_auto_played of the video.
+    # @option [Integer] the total_video_10s_views_auto_played of the video.
     attr_reader :total_10s_views_sound_on
 
-    # @option [Integer] The number of impressions of the video.
+    # @option [Integer] the number of impressions of the video.
     attr_reader :total_impressions
 
-    # @option [Integer] Number of people your video was served to.
+    # @option [Integer] number of people your video was served to.
     attr_reader :total_impressions_unique
 
-    # @option [Integer] Number of times your video was viewed for 95% or complete.
+    # @option [Integer] number of times your video was viewed for 95% or complete.
     attr_reader :total_complete_views
 
-    # @option [Integer] Number of unique viewers who watched for 95% or complete.
+    # @option [Integer] number of unique viewers who watched for 95% or complete.
     attr_reader :total_complete_views_unique
 
     # @param [Hash] options the options to initialize an instance of Fb::Video.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fb-core
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta7
+  version: 1.0.0.beta8
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-10 00:00:00.000000000 Z
+date: 2018-04-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fb-support