blurb 0.4.11 → 0.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59cbfa18a906ad112e395e90863307cba7a8a9f17a026dbfa570d05b465d5455
-  data.tar.gz: 470cf50b215a94e0e7931536ffb0bd39bd4f781b855c173cea34b5693cee00ad
+  metadata.gz: d8c1e6e5df9e2b5f7878db65270a0b8b973c9e6d65697bad8a0f9f411daa9ada
+  data.tar.gz: e43f0cf156463c8686dde6ab72180f1b375e060686e6b637bb37841de17c8564
 SHA512:
-  metadata.gz: 0f3e692778788cba4ea980aecefcf00845a4bdfdda3c3f53ff7f753ec01a2075a3ea64efe82e8a71b1a30aeecaeacda72b316166a56f2ce1602ea51463d096da
-  data.tar.gz: d69904e7775f70493fabcf9d329d9a2f57389016097703e7634ed46d28719cc28baf6fc9f7f337f06fa2515af3f7c11d3c56211c01b0708f05caee20e7894938
+  metadata.gz: e4ed702e079d45d45adeb3d39cca5d082dca710b364b3671c81714ab61af4f55869dab4ead9a67bbc1a2aaa78b2ba34efdc307a6c7d0a9325bdaad574fc1414b
+  data.tar.gz: 7954d319885066c0a21ae990e4ff3af68596783683609d4016fbb15018b54549d6cd95d0d6bac1aa9300a33df590aa50c19856cc7d87d27ed3ccb67aa58f2676

data/blurb.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = "blurb"
-  spec.version       = "0.4.11"
+  spec.version       = "0.5.5"
   spec.authors       = ["dlbunker", "eamigo13", "smithworx"]
   spec.email         = ["evan@pattern.com"]
 

data/lib/blurb/base_class.rb

@@ -2,7 +2,8 @@ class Blurb
   class BaseClass
     CAMPAIGN_TYPE_CODES = {
       sp: 'sp',
-      sb: 'hsa'
+      sb: 'hsa',
+      sd: 'sd'
     }.freeze
   end
 end 

data/lib/blurb/campaign_requests.rb

@@ -0,0 +1,24 @@
+require 'blurb/request_collection_with_campaign_type'
+
+class Blurb
+  class CampaignRequests < RequestCollectionWithCampaignType
+    def create_bulk(create_array)
+      create_array = map_campaign_payload(create_array)
+      super(create_array)
+    end
+
+    def update_bulk(update_array)
+      update_array = map_campaign_payload(update_array)
+      super(update_array)
+    end
+
+    private
+
+      def map_campaign_payload(payload)
+        campaign_type_string = "sponsoredProducts" if @campaign_type == CAMPAIGN_TYPE_CODES[:sp]
+        campaign_type_string = "sponsoredBrands" if @campaign_type == CAMPAIGN_TYPE_CODES[:sb]
+        campaign_type_string = "sponsoredDisplays" if @campaign_type == CAMPAIGN_TYPE_CODES[:sd]
+        payload.each{ |p| p[:campaign_type] = campaign_type_string }
+      end
+  end
+end

data/lib/blurb/errors/base_exception.rb

@@ -0,0 +1,3 @@
+class Blurb
+  class BaseException < StandardError; end
+end

data/lib/blurb/errors/failed_request.rb

@@ -1,3 +1,4 @@
+require "blurb/errors/base_exception"
 class Blurb
   class FailedRequest < StandardError; end
 end

data/lib/blurb/errors/invalid_report_request.rb

@@ -1,3 +1,4 @@
+require "blurb/errors/base_exception"
 class Blurb
   class InvalidReportRequest < StandardError; end
 end

data/lib/blurb/errors/request_throttled.rb

@@ -1,3 +1,4 @@
+require "blurb/errors/base_exception"
 class Blurb
   class RequestThrottled < StandardError; end
 end 

data/lib/blurb/history_request.rb

@@ -0,0 +1,54 @@
+require 'blurb/request_collection'
+
+class Blurb
+  class HistoryRequest < RequestCollection
+    FROM_DATE = (DateTime.now - 30).strftime('%Q')
+    TO_DATE = DateTime.now.strftime('%Q')
+    MAX_COUNT = 200.freeze
+    MIN_COUNT = 50.freeze
+    FILTERS = []
+    PARENT_CAMPAIGN_ID = nil
+
+    def initialize(base_url:, headers:)
+      @base_url = base_url
+      @headers = headers
+    end
+
+    def retrieve(
+      from_date: FROM_DATE,
+      to_date: TO_DATE,
+      campaign_ids:,
+      filters: FILTERS,
+      parent_campaign_id: PARENT_CAMPAIGN_ID,
+      count: MAX_COUNT
+    )
+
+      count = MIN_COUNT if count < MIN_COUNT
+      count = MAX_COUNT if count > MAX_COUNT
+
+      payload = {
+        sort: {
+          key: 'DATE',
+          direction: 'ASC'
+        },
+        fromDate: from_date.to_i,
+        toDate: to_date.to_i,
+        eventTypes: {
+          CAMPAIGN: {
+            eventTypeIds: campaign_ids
+          }
+        },
+        count: count
+      }
+
+      payload[:eventTypes][:CAMPAIGN].merge!({ filters: filters }) if filters.present?
+      payload[:eventTypes][:CAMPAIGN].merge!({ parents: [{ campaignId: parent_campaign_id }] }) if parent_campaign_id.present?
+
+      execute_request(
+        api_path: "/history",
+        request_type: :post,
+        payload: payload
+      )
+    end
+  end
+end

data/lib/blurb/profile.rb

@@ -1,9 +1,11 @@
 require "blurb/account"
+require "blurb/campaign_requests"
 require "blurb/snapshot_requests"
 require "blurb/report_requests"
 require "blurb/request_collection"
 require "blurb/request_collection_with_campaign_type"
 require "blurb/suggested_keyword_requests"
+require "blurb/history_request"
 
 class Blurb
   class Profile < BaseClass
@@ -11,31 +13,41 @@ class Blurb
     attr_accessor(
       :account,
       :ad_groups,
+      :sd_ad_groups,
       :campaign_negative_keywords,
       :portfolios,
       :product_ads,
+      :sd_product_ads,
       :profile_id,
       :suggested_keywords,
-      :targets
+      :targets,
+      :history
     )
 
     def initialize(profile_id:, account:)
       @profile_id = profile_id
       @account = account
 
-      @sp_campaigns = RequestCollectionWithCampaignType.new(
+      @sp_campaigns = CampaignRequests.new(
         headers: headers_hash,
         base_url: @account.api_url,
         resource: "campaigns",
         campaign_type: CAMPAIGN_TYPE_CODES[:sp]
       )
-      @sb_campaigns = RequestCollectionWithCampaignType.new(
+      @sb_campaigns = CampaignRequests.new(
         headers: headers_hash,
         base_url: @account.api_url,
         resource: "campaigns",
         campaign_type: CAMPAIGN_TYPE_CODES[:sb],
         bulk_api_limit: 10
       )
+      @sd_campaigns = CampaignRequests.new(
+        headers: headers_hash,
+        base_url: @account.api_url,
+        resource: "campaigns",
+        campaign_type: CAMPAIGN_TYPE_CODES[:sd],
+        bulk_api_limit: 10
+      )
       @sp_keywords = RequestCollectionWithCampaignType.new(
         headers: headers_hash,
         base_url: @account.api_url,
@@ -63,6 +75,11 @@ class Blurb
         base_url: @account.api_url,
         campaign_type: CAMPAIGN_TYPE_CODES[:sp]
       )
+      @sd_reports = ReportRequests.new(
+        headers: headers_hash,
+        base_url: @account.api_url,
+        campaign_type: CAMPAIGN_TYPE_CODES[:sd]
+      )
       @sb_reports = ReportRequests.new(
         headers: headers_hash,
         base_url: @account.api_url,
@@ -72,10 +89,18 @@ class Blurb
         headers: headers_hash,
         base_url: "#{@account.api_url}/v2/sp/adGroups"
       )
+      @sd_ad_groups = RequestCollection.new(
+        headers: headers_hash,
+        base_url: "#{@account.api_url}/sd/adGroups"
+      )
       @product_ads = RequestCollection.new(
         headers: headers_hash,
         base_url: "#{account.api_url}/v2/sp/productAds"
       )
+      @sd_product_ads = RequestCollection.new(
+        headers: headers_hash,
+        base_url: "#{account.api_url}/sd/productAds"
+      )
       @sp_negative_keywords = RequestCollectionWithCampaignType.new(
         headers: headers_hash,
         base_url: @account.api_url,
@@ -104,11 +129,16 @@ class Blurb
         headers: headers_hash,
         base_url: "#{@account.api_url}/v2/sp"
       )
+      @history = HistoryRequest.new(
+        headers: headers_hash,
+        base_url: @account.api_url
+      )
     end
 
     def campaigns(campaign_type)
       return @sp_campaigns if campaign_type == :sp
       return @sb_campaigns if campaign_type == :sb || campaign_type == :hsa
+      return @sd_campaigns if campaign_type == :sd
     end
 
     def keywords(campaign_type)
@@ -129,6 +159,7 @@ class Blurb
     def reports(campaign_type)
       return @sp_reports if campaign_type == :sp
       return @sb_reports if campaign_type == :sb || campaign_type == :hsa
+      return @sd_reports if campaign_type == :sd
     end
 
     def request(api_path: "",request_type: :get, payload: nil, url_params: nil, headers: headers_hash)

data/lib/blurb/report_requests.rb

@@ -2,6 +2,8 @@ require 'blurb/request_collection_with_campaign_type'
 
 class Blurb
   class ReportRequests < RequestCollectionWithCampaignType
+    SD_TACTIC = 'T00020'.freeze
+
     def initialize(campaign_type:, base_url:, headers:)
       @campaign_type = campaign_type
       @base_url = "#{base_url}/v2/#{@campaign_type}"
@@ -15,12 +17,13 @@ class Blurb
       segment: nil
     )
       # create payload
-      metrics = get_default_metrics(record_type.to_s.underscore.to_sym) if metrics.nil?
+      metrics = get_default_metrics(record_type.to_s.underscore.to_sym, segment) if metrics.nil?
       payload = {
         metrics: metrics.map{ |m| m.to_s.camelize(:lower) }.join(","),
         report_date: report_date
       }
       payload[:segment] = segment if segment
+      payload[:tactic] = SD_TACTIC if @campaign_type.to_sym == :sd
 
       execute_request(
         api_path: "/#{record_type.to_s.camelize(:lower)}/report",
@@ -45,7 +48,7 @@ class Blurb
 
     private
 
-    def get_default_metrics(record_type)
+    def get_default_metrics(record_type, segment = nil)
       if @campaign_type == CAMPAIGN_TYPE_CODES[:sb]
         return [
           "campaignId",
@@ -79,7 +82,16 @@ class Blurb
           "attributedSales14dSameSKU",
           "attributedConversions14d",
           "attributedConversions14dSameSKU"
-        ] if record_type == :keywords
+        ] if record_type == :keywords && segment.nil?
+        return [
+          "adGroupId",
+          "campaignId",
+          "impressions",
+          "clicks",
+          "cost",
+          "attributedSales14d",
+          "attributedConversions14d",
+        ] if record_type == :keywords && segment.present?
       elsif @campaign_type == CAMPAIGN_TYPE_CODES[:sp]
         return [
           "campaignId",
@@ -242,6 +254,118 @@ class Blurb
           "attributedSales14dSameSKU",
           "attributedSales30dSameSKU"
         ] if record_type == :portfolios
+      elsif @campaign_type == CAMPAIGN_TYPE_CODES[:sd]
+        return [
+          "campaignId",
+          "impressions",
+          "clicks",
+          "cost",
+          "currency",
+          "attributedConversions1d",
+          "attributedConversions7d",
+          "attributedConversions14d",
+          "attributedConversions30d",
+          "attributedConversions1dSameSKU",
+          "attributedConversions7dSameSKU",
+          "attributedConversions14dSameSKU",
+          "attributedConversions30dSameSKU",
+          "attributedUnitsOrdered1d",
+          "attributedUnitsOrdered7d",
+          "attributedUnitsOrdered14d",
+          "attributedUnitsOrdered30d",
+          "attributedSales1d",
+          "attributedSales7d",
+          "attributedSales14d",
+          "attributedSales30d",
+          "attributedSales1dSameSKU",
+          "attributedSales7dSameSKU",
+          "attributedSales14dSameSKU",
+          "attributedSales30dSameSKU"
+        ] if record_type == :campaigns
+        return [
+          "campaignId",
+          "adGroupId",
+          "impressions",
+          "clicks",
+          "cost",
+          "currency",
+          "attributedConversions1d",
+          "attributedConversions7d",
+          "attributedConversions14d",
+          "attributedConversions30d",
+          "attributedConversions1dSameSKU",
+          "attributedConversions7dSameSKU",
+          "attributedConversions14dSameSKU",
+          "attributedConversions30dSameSKU",
+          "attributedUnitsOrdered1d",
+          "attributedUnitsOrdered7d",
+          "attributedUnitsOrdered14d",
+          "attributedUnitsOrdered30d",
+          "attributedSales1d",
+          "attributedSales7d",
+          "attributedSales14d",
+          "attributedSales30d",
+          "attributedSales1dSameSKU",
+          "attributedSales7dSameSKU",
+          "attributedSales14dSameSKU",
+          "attributedSales30dSameSKU"
+        ] if record_type == :ad_groups
+        return [
+          "campaignId",
+          "adGroupId",
+          "impressions",
+          "clicks",
+          "cost",
+          "currency",
+          "attributedConversions1d",
+          "attributedConversions7d",
+          "attributedConversions14d",
+          "attributedConversions30d",
+          "attributedConversions1dSameSKU",
+          "attributedConversions7dSameSKU",
+          "attributedConversions14dSameSKU",
+          "attributedConversions30dSameSKU",
+          "attributedUnitsOrdered1d",
+          "attributedUnitsOrdered7d",
+          "attributedUnitsOrdered14d",
+          "attributedUnitsOrdered30d",
+          "attributedSales1d",
+          "attributedSales7d",
+          "attributedSales14d",
+          "attributedSales30d",
+          "attributedSales1dSameSKU",
+          "attributedSales7dSameSKU",
+          "attributedSales14dSameSKU",
+          "attributedSales30dSameSKU"
+        ] if record_type == :product_ads
+        return [
+          "campaignId",
+          "targetId",
+          "impressions",
+          "clicks",
+          "cost",
+          "currency",
+          "attributedConversions1d",
+          "attributedConversions7d",
+          "attributedConversions14d",
+          "attributedConversions30d",
+          "attributedConversions1dSameSKU",
+          "attributedConversions7dSameSKU",
+          "attributedConversions14dSameSKU",
+          "attributedConversions30dSameSKU",
+          "attributedUnitsOrdered1d",
+          "attributedUnitsOrdered7d",
+          "attributedUnitsOrdered14d",
+          "attributedUnitsOrdered30d",
+          "attributedSales1d",
+          "attributedSales7d",
+          "attributedSales14d",
+          "attributedSales30d",
+          "attributedSales1dSameSKU",
+          "attributedSales7dSameSKU",
+          "attributedSales14dSameSKU",
+          "attributedSales30dSameSKU"
+        ] if record_type == :targets
       end
     end
   end

data/lib/blurb/request.rb

@@ -83,6 +83,7 @@ class Blurb
       end
 
       def camelcase_key(k)
+        return k if k.to_s == k.to_s.upcase
         k.to_s.camelize(:lower)
       end
 

data/lib/blurb/request_collection.rb

@@ -72,6 +72,7 @@ class Blurb
 
       def execute_request(api_path: "", request_type:, payload: nil, url_params: nil)
         url = "#{@base_url}#{api_path}"
+        url.sub!('/sd/', '/') if request_type == :get && url.include?('sd/reports') && url_params.nil?
 
         request = Request.new(
           url: url,

data/lib/blurb/request_collection_with_campaign_type.rb

@@ -5,9 +5,10 @@ class Blurb
 
     def initialize(campaign_type:, resource:, base_url:, headers:, bulk_api_limit: 100)
       @campaign_type = campaign_type
-      @base_url = "#{base_url}/v2/#{@campaign_type}/#{resource}"
+      base_url = campaign_type.to_s == 'sd' ? base_url : "#{base_url}/v2"
+      @base_url = "#{base_url}/#{@campaign_type}/#{resource}"
       @headers = headers
       @api_limit = bulk_api_limit
     end
   end
-end 
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blurb
 version: !ruby/object:Gem::Version
-  version: 0.4.11
+  version: 0.5.5
 platform: ruby
 authors:
 - dlbunker
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-02-11 00:00:00.000000000 Z
+date: 2020-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -175,10 +175,13 @@ files:
 - lib/blurb.rb
 - lib/blurb/account.rb
 - lib/blurb/base_class.rb
+- lib/blurb/campaign_requests.rb
 - lib/blurb/client.rb
+- lib/blurb/errors/base_exception.rb
 - lib/blurb/errors/failed_request.rb
 - lib/blurb/errors/invalid_report_request.rb
 - lib/blurb/errors/request_throttled.rb
+- lib/blurb/history_request.rb
 - lib/blurb/profile.rb
 - lib/blurb/report_requests.rb
 - lib/blurb/request.rb