blurb 0.4.11 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59cbfa18a906ad112e395e90863307cba7a8a9f17a026dbfa570d05b465d5455
-  data.tar.gz: 470cf50b215a94e0e7931536ffb0bd39bd4f781b855c173cea34b5693cee00ad
+  metadata.gz: 4618b7c8855b5f057941a3c3ef45907a6313cb9e8c12b975409fd4ff9b09cb14
+  data.tar.gz: 9a77aecf9a59176cb552136384c3c40c8fe5566cacc605b389b40bf2136ba81f
 SHA512:
-  metadata.gz: 0f3e692778788cba4ea980aecefcf00845a4bdfdda3c3f53ff7f753ec01a2075a3ea64efe82e8a71b1a30aeecaeacda72b316166a56f2ce1602ea51463d096da
-  data.tar.gz: d69904e7775f70493fabcf9d329d9a2f57389016097703e7634ed46d28719cc28baf6fc9f7f337f06fa2515af3f7c11d3c56211c01b0708f05caee20e7894938
+  metadata.gz: c587760d7fceecb127dcf78d38e7a79a995cae27e54de8eec5d94df4a580b65dbb1fbfe1b76b4004ba31e8e9757e7bf14086caddb6b373423bddb3414b933a03
+  data.tar.gz: 23450706c810ca6a79493c7da1e8d08ba8b503475c6af81cb15cf48154505add0cb88327cf0d596e62f4b3f0e7d7c2c7a0aadc43dea86981183e6c1d8cacc395

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.6"
   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

@@ -28,13 +28,17 @@ class Blurb
       when :post, :put
         request_config[:payload] = @payload if @payload
       end
-
+      log("request type", @request_type)
+      log("request url", @url)
+      log("headers", @headers)
+      log("payload", @payload) if @payload
       return request_config
     end
 
     def make_request
       begin
         resp = RestClient::Request.execute(request_config())
+        log("response", resp)
       rescue RestClient::TooManyRequests => err
         raise RequestThrottled.new(JSON.parse(err.response.body))
       rescue RestClient::TemporaryRedirect => err
@@ -83,6 +87,7 @@ class Blurb
       end
 
       def camelcase_key(k)
+        return k if k.to_s == k.to_s.upcase
         k.to_s.camelize(:lower)
       end
 
@@ -101,5 +106,14 @@ class Blurb
         k.to_s.underscore.to_sym
       end
 
+      def log(header, message)
+        if ENV["BLURB_LOGGING"]
+          puts "\n"
+          puts header.upcase
+          puts message
+          puts "\n"
+        end
+      end
+
   end
 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.6
 platform: ruby
 authors:
 - dlbunker
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-02-11 00:00:00.000000000 Z
+date: 2021-01-06 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