adzerk 0.14 → 0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfcb33e06a66b4728d0a27e69c41a240a3d3f73ce3af93056fdbb794e6b1361c
-  data.tar.gz: d6b9c3113f6120d074a517643a56fb4cb1fc2b98b98abe016cb31cbebcadad32
+  metadata.gz: 50824b8af7ba3980d0c4c4d7efe9a3ab2abf581c3707f110dc5d2abd5c11bd90
+  data.tar.gz: e898b5d79bceeddedd7aadcae625b27eb863d73767bb0790291244ef5e88c440
 SHA512:
-  metadata.gz: f549e8160c19e563cdb4aa4c54b085a833b62b6588227c2540f7e58471805ed88f79680f3d3a32c125639e98a7502b55fe9dee2b4736c560322a10ef5aa5aa61
-  data.tar.gz: 2be8a73fb39675f73bd02e13ddd6165f2402005b561b03ab94cf546fd4702c8fcf5105b1240cd7b0a8b71dcb214064764e6d7ce249bee12f2e87d7947533ceaa
+  metadata.gz: 713844e36ce3b5d0472599321cbf8b068d2f8b1d1b2507d17586f7a140bc3602eaf698bcd12ba24a3eb45011af18973919ed45358c7fcb89fbcc811e47930820
+  data.tar.gz: 9642fc67837970c0c4aa9865f2e97d1188184cc956aea590d1ba099042d1b838e9385c6285d1248784397fb0de01f8f8cbd364b11574234425b00c05e629c44b

data/lib/adzerk.rb

@@ -13,8 +13,15 @@ require "adzerk/publisher"
 require "adzerk/invitation"
 require "adzerk/reporting"
 require "adzerk/channel_site_map"
+require "adzerk/channel"
 require "adzerk/geo_targeting"
 require "adzerk/site_zone_targeting"
 require "adzerk/category"
 require "adzerk/client"
 require "adzerk/priority"
+require "adzerk/campaign"
+require "adzerk/instant_count"
+require "adzerk/creative_template"
+require "adzerk/scheduled_reporting"
+require "adzerk/day_parting"
+require "adzerk/distance_targeting"

data/lib/adzerk/advertiser.rb

@@ -5,5 +5,16 @@ module Adzerk
       data = { 'advertiserName' => advertiser_name }
       parse_response(client.post_request(url, data))
     end
+
+    def instant_counts(advertiser_id, data={})
+      query_string = URI.encode_www_form(data)
+      url = "instantcounts/#{endpoint}/#{advertiser_id}?#{query_string}"
+      parse_response(client.get_request(url))
+    end
+
+    def list_creatives(advertiser_id, page: 1, pageSize: 500)
+      url = "advertiser/#{advertiser_id}/creatives?page=#{page}&pageSize=#{pageSize}"
+      parse_response(@client.get_request(url))
+    end
   end
 end

data/lib/adzerk/api_endpoint.rb

@@ -14,8 +14,8 @@ module Adzerk
 
     def create(opts={}, subid=nil)
       e = (subid && subendpoint) ? "#{subendpoint}/#{subid}/#{endpoint}" : endpoint
-      data = { datakey => camelize_data(opts).to_json }
-      response = @client.post_request(e, data)
+      data = camelize_data(opts)
+      response = @client.post_json_request(e, data)
       parse_response(response)
     end
 
@@ -24,16 +24,17 @@ module Adzerk
       parse_response(response)
     end
 
-    def list(subid=nil)
+    def list(subid=nil, page: 1, pageSize: 500)
       e = (subid && subendpoint) ? "#{subendpoint}/#{subid}/#{endpoint}" : endpoint
+      e = "#{e}?page=#{page}&pageSize=#{pageSize}"
       response = @client.get_request(e)
       parse_response(response)
     end
 
     def update(opts={})
       id = opts[:id].to_s
-      data = { datakey => camelize_data(opts).to_json }
-      response = @client.put_request("#{endpoint}/#{id}", data)
+      data = camelize_data(opts)
+      response = @client.put_json_request("#{endpoint}/#{id}", data)
       parse_response(response)
     end
 

data/lib/adzerk/campaign.rb

@@ -0,0 +1,15 @@
+module Adzerk
+  class Campaign < ApiEndpoint
+    def instant_counts(campaign_id, data={})
+      query_string = URI.encode_www_form(data)
+      url = "instantcounts/#{endpoint}/#{campaign_id}?#{query_string}"
+      parse_response(client.get_request(url))
+    end
+
+    def search(campaign_name)
+      url = 'campaign/search'
+      data = { 'campaignName' => campaign_name }
+      parse_response(client.post_request(url, data))
+    end
+  end
+end

data/lib/adzerk/category.rb

@@ -20,13 +20,13 @@ module Adzerk
       @client.get_request(url)
     end
 
-    def listAll
+    def listAll(page: 1, pageSize: 500)
       response = client.get_request('categories')
       parse_response(response)
     end
 
-    def list(flight_id)
-      url = "flight/#{flight_id}/categories"
+    def list(flight_id, page: 1, pageSize: 500)
+      url = "flight/#{flight_id}/categories?page=#{page}&pageSize=#{pageSize}"
       response = client.get_request(url)
       parse_response(response)
     end

data/lib/adzerk/channel.rb

@@ -0,0 +1,9 @@
+module Adzerk
+    class Channel < ApiEndpoint
+        def get_priorities(channel_id)
+            url = "channel/#{channel_id}/priorities"
+            response = client.get_request(url)
+            parse_response(response)
+        end
+    end
+end

data/lib/adzerk/channel_site_map.rb

@@ -21,7 +21,7 @@ module Adzerk
       response = parse_response(response)
     end
 
-    def list
+    def list(page: 1, pageSize: 500)
       response = client.get_request('channelSite')
       parse_response(response)
     end

data/lib/adzerk/client.rb

@@ -6,11 +6,21 @@ module Adzerk
     attr_reader :sites, :ad_types, :zones, :campaigns, :channels, :priorities,
                 :advertisers, :flights, :creatives, :creative_maps,
                 :publishers, :invitations, :reports, :channel_site_maps,
-                :logins, :geotargetings, :sitezonetargetings, :categories
+                :logins, :geotargetings, :sitezonetargetings, :categories,
+                :instant_counts, :ads, :creative_templates, :scheduled_reports, 
+                :day_parts, :distance_targetings
+
+    VERSION = Gem.loaded_specs['adzerk'].version.to_s
+    SDK_HEADER_NAME = 'X-Adzerk-Sdk-Version'
+    SDK_HEADER_VALUE = "adzerk-management-sdk-ruby:#{VERSION}"
+    BASE_SLEEP = 0.25
+    MAX_SLEEP = 5
+    MAX_ATTEMPTS = 10
 
     DEFAULTS = {
-      :host => ENV["ADZERK_API_HOST"] || 'https://api.adzerk.net/v1/',
-      :header => 'X-Adzerk-ApiKey'
+      :host => ENV["ADZERK_API_HOST"] || 'https://api.adzerk.net/',
+      :header => 'X-Adzerk-ApiKey',
+      :include_creative_templates => true
     }
 
     def initialize(key, opts = {})
@@ -19,75 +29,138 @@ module Adzerk
       @logins = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'login')
       @sites = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'site')
       @ad_types = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'adtypes', :subendpoint => 'channel', :datakey => 'adtype')
-      @flights = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'flight')
+      @flights = Adzerk::Flight.new(:client => self, :endpoint => 'flight')
       @zones = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'zone')
-      @campaigns = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'campaign')
-      @channels = Adzerk::ApiEndpoint.new(:client => self, :endpoint => 'channel')
+      @campaigns = Adzerk::Campaign.new(:client => self, :endpoint => 'campaign')
+      @channels = Adzerk::Channel.new(:client => self, :endpoint => 'channel')
       @priorities = Adzerk::Priority.new(:client => self, :endpoint => 'priority')
       @advertisers = Adzerk::Advertiser.new(:client => self, :endpoint => 'advertiser')
       @publishers = Adzerk::Publisher.new(:client => self, :endpoint => 'publisher')
       @creatives = Adzerk::Creative.new(:client => self, :endpoint => 'creative')
       @creative_maps = Adzerk::CreativeMap.new(:client => self)
+      @ads = @creative_maps
       @invitations = Adzerk::Invitation.new(:client => self)
       @reports = Adzerk::Reporting.new(:client => self)
       @channel_site_maps = Adzerk::ChannelSiteMap.new(:client => self)
       @geotargetings = Adzerk::GeoTargeting.new(:client => self, :endpoint => 'geotargeting')
       @sitezonetargetings = Adzerk::SiteZoneTargeting.new(:client => self, :endpoint => 'sitezone')
       @categories = Adzerk::Category.new(:client => self, :endpoint => 'category')
-
+      @instant_counts = Adzerk::InstantCount.new(:client => self)
+      @creative_templates = Adzerk::CreativeTemplate.new(:client => self)
+      @scheduled_reports = Adzerk::ScheduledReporting.new(:client => self, :endpoint => 'report')
+      @day_parts = Adzerk::DayParting.new(:client => self, :endpoint => 'dayparting')
+      @distance_targetings = Adzerk::DistanceTargeting.new(:client => self, :endpoint => 'distancetargeting')
     end
 
-    def get_request(url)
-      uri = URI.parse(@config[:host] + url)
+    def get_request(url, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
       request = Net::HTTP::Get.new(uri.request_uri)
       request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
+      send_request(request, uri)
+    end
+
+    def delete_request(url, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
+      request = Net::HTTP::Delete.new(uri.request_uri)
+      request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
       send_request(request, uri)
     end
 
-    def post_request(url, data)
-      uri = URI.parse(@config[:host] + url)
+    def post_request(url, data, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
       request = Net::HTTP::Post.new(uri.request_uri)
       request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
       request.set_form_data(data)
       send_request(request, uri)
     end
 
-    def put_request(url, data)
-      uri = URI.parse(@config[:host] + url)
+    def post_json_request(url, data, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
+      request = Net::HTTP::Post.new(uri.request_uri, 'Content-Type' => 'application/json')
+      request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
+      request.body = data.to_json
+      send_request(request, uri)
+    end
+
+    def put_request(url, data, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
       request = Net::HTTP::Put.new(uri.request_uri)
       request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
       request.set_form_data(data)
       send_request(request, uri)
     end
 
-    def create_creative(data={}, image_path='')
-      response = RestClient.post(@config[:host] + 'creative',
-                                 {:creative => camelize_data(data).to_json},
-                                  :X_Adzerk_ApiKey => @api_key,
-                                  :accept => :json)
+    def put_json_request(url, data, version: 'v1')
+      uri = URI.parse("#{@config[:host]}#{version}/#{url}")
+      request = Net::HTTP::Put.new(uri.request_uri, 'Content-Type' => 'application/json')
+      request.add_field(@config[:header], @api_key)
+      request.add_field(SDK_HEADER_NAME, SDK_HEADER_VALUE)
+      request.body = data.to_json
+      send_request(request, uri)
+    end
+
+    def create_creative(data={}, image_path='', version: 'v1')
+      response = nil
+      attempt = 0
+
+      loop do
+        response = RestClient.post(@config[:host] + version + '/creative',
+                                  {:creative => camelize_data(data).to_json},
+                                    :X_Adzerk_ApiKey => @api_key,
+                                    :X_Adzerk_Sdk_Version => SDK_HEADER_VALUE,
+                                    :accept => :json)
+        break if response.code != 429 or attempt >= (@config[:max_attempts] || MAX_ATTEMPTS)
+        sleep(rand(0.0..[MAX_SLEEP, BASE_SLEEP * 2 ** attempt].min()))
+        attempt += 1
+      end
       response = upload_creative(JSON.parse(response)["Id"], image_path) unless image_path.empty?
       response
     end
 
-    def upload_creative(id, image_path, size_override: false)
+    def upload_creative(id, image_path, size_override: false, version: 'v1')
+      response = nil
+      attempt = 0
       image = File.new(image_path, 'rb')
-      url = @config[:host] + 'creative/' + id.to_s + '/upload'
+      url = @config[:host] + version + '/creative/' + id.to_s + '/upload'
       url += '?sizeOverride=true' if size_override
-      RestClient.post(url,
-      {:image => image},
-      "X-Adzerk-ApiKey" => @api_key,
-      :accept => :mime)
+      loop do
+        response = RestClient.post(url,
+        {:image => image},
+        "X-Adzerk-ApiKey" => @api_key,
+        SDK_HEADER_NAME => SDK_HEADER_VALUE,
+        :accept => :mime)
+
+        break if response.code != 429 or attempt >= (@config[:max_attempts] || MAX_ATTEMPTS)
+        sleep(rand(0.0..[MAX_SLEEP, BASE_SLEEP * 2 ** attempt].min()))
+        attempt += 1
+      end
+      response
     end
 
     def send_request(request, uri)
+      response = nil
+      attempt = 0
       http = Net::HTTP.new(uri.host, uri.port)
       http.use_ssl = uri.scheme == 'https'
-      response = http.request(request)
+
+      loop do
+        response = http.request(request)
+        break if response.code != "429" or attempt >= (@config[:max_attempts] || MAX_ATTEMPTS)
+        sleep(rand(0.0..[MAX_SLEEP, BASE_SLEEP * 2 ** attempt].min()))
+        attempt += 1
+      end
+
       if response.kind_of? Net::HTTPClientError or response.kind_of? Net::HTTPServerError
         error_response = JSON.parse(response.body)
-        msg = error_response["message"] || error_response["Error"]
+        msg = error_response["message"] || error_response["Error"] || response.body
         raise Adzerk::ApiError.new(msg)
       end
+
       response
     end
 

data/lib/adzerk/creative.rb

@@ -8,8 +8,8 @@ module Adzerk
       uncamelize_data(JSON.parse(response))
     end
 
-    def list(advertiserId)
-      url = 'advertiser/' + advertiserId.to_s + "/creatives"
+    def list(advertiserId, page: 1, pageSize: 500)
+      url = "advertiser/#{advertiserId}/creatives?page=#{page}&pageSize=#{pageSize}"
       parse_response(@client.get_request(url))
     end
 

data/lib/adzerk/creative_map.rb

@@ -18,8 +18,8 @@ module Adzerk
       parse_response(@client.get_request(url))
     end
 
-    def list(flight_id)
-      url = "flight/#{flight_id}/creatives"
+    def list(flight_id, page: 1, pageSize: 500)
+      url = "flight/#{flight_id}/creatives?page=#{page}&#pageSize=#{pageSize}"
       parse_response(@client.get_request(url))
     end
 
@@ -34,5 +34,10 @@ module Adzerk
       @client.get_request(url)
     end
 
+    def instant_counts(creative_map_id, data={})
+      query_string = URI.encode_www_form(data)
+      url = "instantcounts/ad/#{creative_map_id}?#{query_string}"
+      parse_response(@client.get_request(url))
+    end
   end
 end

data/lib/adzerk/creative_template.rb

@@ -0,0 +1,30 @@
+module Adzerk
+  class CreativeTemplate
+
+    include Adzerk::Util
+
+    attr_reader :client
+
+    def initialize(args={})
+      @client = args[:client]
+    end
+
+    def create(data={})
+      parse_response(@client.post_json_request("creative-templates", camelize_data(data), version: 'v2'))
+    end
+
+    def update(id, data={})
+      url = "creative-templates/#{id}/update"
+      parse_response(@client.post_json_request(url, camelize_data(data), version: 'v2'))
+    end
+
+    def get(id)
+      parse_response(@client.get_request("creative-templates/#{id}", version: 'v2'))
+    end
+
+    def list(page: 1, pageSize: 100)
+      url = "creative-templates?page=#{page}&pageSize=#{pageSize}"
+      parse_response(@client.get_request(url, version: 'v2'))
+    end
+  end
+end

data/lib/adzerk/day_parting.rb

@@ -0,0 +1,23 @@
+module Adzerk
+    class DayParting < ApiEndpoint
+        def create(flight_id, data={})
+            url = "flight/#{flight_id}/dayparting"
+            parse_response(@client.post_json_request(url, camelize_data(data)))
+        end
+
+        def get(flight_id, timepart_id)
+            url = "flight/#{flight_id}/dayparting/#{timepart_id}"
+            parse_response(@client.get_request(url))
+        end
+
+        def list(flight_id)
+            url = "flight/#{flight_id}/dayparting"
+            parse_response(@client.get_request(url))
+        end
+
+        def delete(flight_id, timepart_id)
+            url = "flight/#{flight_id}/dayparting/#{timepart_id}/delete"
+            @client.post_request(url, data={})
+        end
+    end
+end

data/lib/adzerk/distance_targeting.rb

@@ -0,0 +1,33 @@
+module Adzerk
+    class DistanceTargeting < ApiEndpoint
+        def create(flight_id, data={})
+            url = "flight/#{flight_id}/distance"
+            parse_response(@client.post_json_request(url, camelize_data(data)))
+        end
+
+        def batch_upload(flight_id, data={})
+            url = "flight/#{flight_id}/distance/batch"
+            parse_response(@client.post_json_request(url, camelize_data(data)))
+        end
+
+        def update(flight_id, geometry_id, data={})
+            url = "flight/#{flight_id}/distance/#{geometry_id}"
+            parse_response(@client.put_json_request(url, camelize_data(data)))
+        end
+
+        def get(flight_id, geometry_id)
+            url = "flight/#{flight_id}/distance/#{geometry_id}"
+            parse_response(@client.get_request(url))
+        end
+
+        def list(flight_id)
+            url = "flight/#{flight_id}/distance"
+            parse_response(@client.get_request(url))
+        end
+
+        def delete(flight_id, geometry_id)
+            url = "flight/#{flight_id}/distance/#{geometry_id}"
+            @client.delete_request(url)
+        end
+    end
+end