facebook_ads 0.6.4 → 0.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 35a61cb9e965397a7e50da136ce697ed6ea3437e
-  data.tar.gz: ce5c09cf7acd43f39b0aa8f82d87d3a21962d50e
+  metadata.gz: 2950d5afaedd6ff1eae3cc4c1748af994352f8c4
+  data.tar.gz: 45974dfe4489e421034063073afc60ff0da626ab
 SHA512:
-  metadata.gz: 1ad4ac70297f77209589c34323fd9af60d5721e8824cd2b3380e9a320c89de7124b45dd7a1133be489a362a631d35a873e00f059e10c2b9835231eae7f41f9c1
-  data.tar.gz: 365dda2ba4b84cdc4d7d86ca95ba1ccfdfd399dbc34664c2aa800cbba44b2cd41d3e181989653b03dc7821a9071dda4ef96f1b25f947aa71b7fd3861e1d8c236
+  metadata.gz: feb0abb421b099bac74ce6d4c2435b5e89ed5e130ac09b69fbcb27e8d3a3119c3996d3bcdaa41c80e499b7c1ea2e53094929145129b3bfb74b75101f801a8553
+  data.tar.gz: 5232f32b4a0db618c112eee2f6ed81290aaf9b39abce48e0800e8e947595cd375ad8d95380de8a2bbe7add8c4f9e31bfe2eb87d859ee1b15be1c6a640d6e1afb

data/README.md

@@ -341,6 +341,25 @@ ad_set.destroy
 
 ___
 
+### [Ad Set Activities](https://developers.facebook.com/docs/marketing-api/reference/ad-activity) (Fetch)
+
+You interact with activities via an ad set:
+```ruby
+ad_set = account.ad_sets(effective_status: nil).first
+```
+
+Fetch all activities in last 24 hours for an ad set:
+```ruby
+activities = ad_set.activities
+```
+
+Fetch all activities in last 48 hours for an ad set:
+```ruby
+activities = ad_set.activities(since: 2.days.ago)
+```
+
+___
+
 ### [Ads](https://developers.facebook.com/docs/marketing-api/reference/adgroup) (Fetch, Find, Create, Update, Destroy)
 
 You interact with ads via an ad set:

data/facebook_ads.gemspec

@@ -6,7 +6,7 @@
 # gem push facebook_ads-0.6.4.gem
 Gem::Specification.new do |s|
   s.name        = 'facebook_ads'
-  s.version     = '0.6.4'
+  s.version     = '0.6.5'
   s.platform    = Gem::Platform::RUBY
   s.licenses    = ['MIT']
   s.authors     = ['Chris Estreich']

data/lib/facebook_ads/ad_set.rb

@@ -108,5 +108,10 @@ module FacebookAds
 
       AdInsight.paginate("/#{id}/insights", query: query)
     end
+
+    # Retrieves activities for ad set (in last 24 hours by default)
+    def activities(since: 1.day.ago)
+      AdSetActivity.get("/#{id}/activities", objectify: true).select { |activity| activity['event_time'] > since }
+    end
   end
 end

data/lib/facebook_ads/ad_set_activity.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module FacebookAds
+  # https://developers.facebook.com/docs/marketing-api/reference/ad-activity/
+  class AdSetActivity < Base
+    FIELDS = %w[
+      actor_id
+      actor_name
+      event_time
+      event_type
+      extra_data
+    ].freeze
+
+    CATEGORIES = %w[
+      ACCOUNT
+      AD
+      AD_SET
+      AUDIENCE
+      BID
+      BUDGET
+      CAMPAIGN
+      DATE
+      STATUS
+      TARGETING
+    ].freeze
+
+    EVENT_TYPES = %w[
+      ad_account_update
+      spend_limit
+      ad_account_reset_spend_limit
+      ad_account_remove_spend_limit
+      ad_account_set_business_information
+      ad_account_update_status
+      ad_account_add_user_to_role
+      ad_account_remove_user_from_role
+      add_images
+      edit_images
+      delete_images
+      ad_account_billing_charge
+      ad_account_billing_charge_failed
+      ad_account_billing_chargeback
+      ad_account_billing_chargeback_reversal
+      ad_account_billing_decline
+      ad_account_billing_refund
+      billing_event
+      add_funding_source
+      remove_funding_source
+      create_campaign_group
+      update_campaign_name
+      update_campaign_run_status
+      update_campaign_group_spend_cap
+      create_campaign_legacy
+      update_campaign_budget
+      update_campaign_duration
+      campaign_ended
+      create_ad_set
+      update_ad_set_bidding
+      update_ad_set_bid_strategy
+      update_ad_set_budget
+      update_ad_set_duration
+      update_ad_set_run_status
+      update_ad_set_name
+      update_ad_set_optimization_goal
+      update_ad_set_target_spec
+      update_ad_set_bid_adjustments
+      create_ad
+      ad_review_approved
+      ad_review_declined
+      update_ad_creative
+      edit_and_update_ad_creative
+      update_ad_bid_info
+      update_ad_bid_type
+      update_ad_run_status
+      update_ad_run_status_to_be_set_after_review
+      update_ad_friendly_name
+      update_ad_targets_spec
+      update_adgroup_stop_delivery
+      first_delivery_event
+      create_audience
+      update_audience
+      delete_audience
+      share_audience
+      receive_audience
+      unshare_audience
+      remove_shared_audience
+      unknown
+      account_spending_limit_reached
+      campaign_spending_limit_reached
+      lifetime_budget_spent
+      funding_event_initiated
+      funding_event_successful
+      update_ad_labels
+      di_ad_set_learning_stage_exit
+    ].freeze
+
+    # belongs_to ad_set
+
+    def ad_set
+      @ad_set ||= AdSet.find(ad_set_id)
+    end
+  end
+end

data/spec/facebook_ads/ad_set_activity_spec.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe FacebookAds::AdSetActivity do
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebook_ads
 version: !ruby/object:Gem::Version
-  version: 0.6.4
+  version: 0.6.5
 platform: ruby
 authors:
 - Chris Estreich
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-03 00:00:00.000000000 Z
+date: 2018-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -74,6 +74,7 @@ files:
 - lib/facebook_ads/ad_product_feed.rb
 - lib/facebook_ads/ad_product_set.rb
 - lib/facebook_ads/ad_set.rb
+- lib/facebook_ads/ad_set_activity.rb
 - lib/facebook_ads/ad_targeting.rb
 - lib/facebook_ads/ad_user.rb
 - lib/facebook_ads/advertisable_application.rb
@@ -87,6 +88,7 @@ files:
 - spec/facebook_ads/ad_product_feed_spec.rb
 - spec/facebook_ads/ad_product_set_spec.rb
 - spec/facebook_ads/ad_product_spec.rb
+- spec/facebook_ads/ad_set_activity_spec.rb
 - spec/facebook_ads/ad_set_spec.rb
 - spec/facebook_ads/ad_spec.rb
 - spec/facebook_ads/ad_targeting_spec.rb
@@ -153,6 +155,7 @@ test_files:
 - spec/facebook_ads/ad_product_feed_spec.rb
 - spec/facebook_ads/ad_product_set_spec.rb
 - spec/facebook_ads/ad_product_spec.rb
+- spec/facebook_ads/ad_set_activity_spec.rb
 - spec/facebook_ads/ad_set_spec.rb
 - spec/facebook_ads/ad_spec.rb
 - spec/facebook_ads/ad_targeting_spec.rb