ppc 2.0.2 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 770db96f31a2d738d9f4918852017a4d9f2a6c30
-  data.tar.gz: 6f4da699a833ac12ba58d62dfe9afffacf2be467
+  metadata.gz: 644d36e63a1131b4c40e51a9774a8fc3fcdce623
+  data.tar.gz: ec46a7efe0d2740a765e9bc2a13f6417bff8a439
 SHA512:
-  metadata.gz: 0078aa233faf95529606a806343bdc53172e0feea53d090cac35553d2ea39a6083d36eacaa3407b64e829dee479564e01256a29b2a8bbb905f29738d3262ed16
-  data.tar.gz: 8bdb1364278a17a5b313ce3a69761adef394140591848b4003d0ef3ff19bc68d4a136d307dd54cdf3f6fab08b30bbc6d87bdd2a2ab9951a6391e2886f9fc764e
+  metadata.gz: 9126d0b364445da25d82be3ae6fb14a4c1741d90f461d8d1826ff299d0d225f4f61c6f3291e3a0b91159c52ccbe6691ed913fa1294d352e5fcaf514be54134ee
+  data.tar.gz: 4097196b9a88796223fe0f830053630fdbb284941f2c4f060999840daaad1959571c0ee7fd64979c2ad979843e938ac21de029d13977ecd835d367ee5d7a91a6

data/README.md

@@ -10,7 +10,7 @@ ppc
 #How to use it ?
 
 ### Create an objects:
-
+```ruby
     param = {
         se:         'baidu',        # baidu,qihu,sogou,sm
         username:   'username',
@@ -32,17 +32,18 @@ ppc
     group    = ::PPC::Operaion::Group.new(param)
     creative = ::PPC::Operaion::Creative.new(param)
     keyword  = ::PPC::Operaion::Keyword.new(param)
-    
+```
 ###Get objects info:
-
+```ruby
     # get info
     account.info[:result]
     plan.info[:result]
     group.info[:result]
     creative.info[:result]
     keyword.info[:result]
-    
+```
 ###Add keywords:
+```ruby
     keyword1 = { keyword: 'ppc1', group_id: 123, price:0.6, match_type:'wide'}
     keyword2 = { keyword: 'ppc2', group_id: 123, price:0.6, match_type:'phrase'}
     keyword3 = { keyword: 'ppc3', group_id: 123, price:0.6, match_type:'exact'}
@@ -50,19 +51,20 @@ ppc
     account.add_keyword( [keyword1, keyword2, keyword3] )
     plan.add_keyword( [keyword1, keyword2, keyword3] )
     group.add_keyword( [keyword1, keyword2, keyword3] )
-
+```
 ###Delete keywords
+```ruby
     account.delete_keyword( [123, 234, 345] )
     plan.delete_keyword( [123, 234, 345] )
     adgroup.delete_keyword( [123, 234, 345] )
-    
+```
 -----------------------------------------------
     
 #API:
 
 ### Return values:
 All mehtods return a hash:
-    
+
     {
         succ: boolean,          # true if operation success else false
         failure: Array,         # failures info if operation false, else nil
@@ -74,7 +76,7 @@ All mehtods return a hash:
 ###API casting:
 In each service class ::PPC::API::#{SE}::#{Service} there is a member map casting PPC API to Search engine Service API, 
 For example:
-
+```ruby
     ::PPC::API::Baidu::Keyword.map  = [
             [:id,:keywordId],
             [:group_id,:adgroupId],
@@ -87,7 +89,7 @@ For example:
             [:status,:status],
             [:pause,:pause]
          ]
-
+```
 ppc API keys are at the left side while search engine API keys are at the right side. 
 
 For more info please have a look into files in /ppc/api/  

data/lib/ppc/api/baidu/account.rb

@@ -25,6 +25,7 @@ module PPC
           reg_domain:           :regDomain,
           offline_time:         :budgetOfflineTime,
           weekly_budget:        :weeklyBudget,
+          user_level:           :userLevel,
         }
         @map = AccountInfoType
 

data/lib/ppc/api/baidu/report.rb

@@ -65,6 +65,7 @@ module PPC
           requesttype[:idOnly]            =     param[:id_only] || false
           requesttype[:startDate]         =     Time.parse( param[:startDate] ) rescue Time.now - 86400
           requesttype[:endDate]           =     Time.parse( param[:endDate] )   rescue Time.now - 86400
+          requesttype[:statIds]           =     param[:statIds]               if param[:statIds]
           requesttype
         end
 
@@ -97,7 +98,31 @@ module PPC
           param[:unit]   ||= 'day'
           download_report( auth, param, debug )
         end
-   
+
+        def self.account_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'account'
+          param[:fields] ||=  %w(impression click cpc cost ctr cpm conversion)
+          param[:level]  ||= 'account'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
+        def self.plan_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'plan'
+          param[:fields] ||=  %w(impression click cpc cost ctr cpm conversion)
+          param[:level]  ||= 'plan'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
+        def self.group_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'group'
+          param[:fields] ||=  %w(impression click cpc cost ctr cpm conversion)
+          param[:level]  ||= 'group'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
         def self.download_report( auth, param, debug = false )
           p param
           response = get_id( auth, param )

data/lib/ppc/api/sm/report.rb

@@ -94,6 +94,30 @@ module PPC
           download_report( auth, param, debug )
         end
 
+        def self.account_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'account'
+          param[:fields] ||=  %w(click impression cost cpc ctr)
+          param[:range]  ||= 'account'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
+        def self.plan_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'plan'
+          param[:fields] ||=  %w(click impression cost cpc ctr)
+          param[:range]  ||= 'plan'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
+        def self.group_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'group'
+          param[:fields] ||=  %w(click impression cost cpc ctr)
+          param[:range]  ||= 'group'
+          param[:unit]   ||= 'day'
+          download_report( auth, param, debug )
+        end
+
         def self.download_report( auth, param, debug = false )
           response = get_id( auth, param )
           if response[:succ]

data/lib/ppc/api/sogou/report.rb

@@ -57,6 +57,7 @@ module PPC
           requesttype[:idOnly]             =     param[:id_only]                 if param[:id_only]!=nil
           requesttype[:startDate]          =     (Time.parse( param[:startDate] ) rescue Time.now - 86400).utc.iso8601
           requesttype[:endDate]            =     (Time.parse( param[:endDate] ) rescue Time.now - 86400).utc.iso8601
+          requesttype[:statIds]            =     param[:statIds]                 if param[:statIds]
           return requesttype
         end
 
@@ -105,6 +106,27 @@ module PPC
           download_report( auth, param, debug )
         end
 
+        def self.account_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'account'
+          param[:fields] ||=  %w( cost cpc click impression ctr )
+          param[:range]  ||= 'account'
+          download_report( auth, param, debug )
+        end
+
+        def self.plan_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'plan'
+          param[:fields] ||=  %w( cost cpc click impression ctr )
+          param[:range]  ||= 'plan'
+          download_report( auth, param, debug )
+        end
+
+        def self.group_report( auth, param = {}, debug = false )
+          param[:type]   ||= 'group'
+          param[:fields] ||=  %w( cost cpc click impression ctr)
+          param[:range]  ||= 'group'
+          download_report( auth, param, debug )
+        end
+
       end # Repost
     end # Baidu
   end # API

data/lib/ppc/operation/report.rb

@@ -18,6 +18,18 @@ module PPC
         call( "report" ).keyword_report( @auth, param, debug )
       end
 
+      def account_report( param = {}, debug = false )
+        call( "report" ).account_report( @auth, param, debug )
+      end
+
+      def plan_report( param = {}, debug = false )
+        call( "report" ).plan_report( @auth, param, debug )
+      end
+
+      def group_report( param = {}, debug = false )
+        call( "report" ).group_report( @auth, param, debug )
+      end
+
       def rank_report( device = 0, debug = false )
         call( "bulk" ).rank_report( @auth, device, debug)
       end

data/lib/ppc.rb

@@ -3,7 +3,7 @@ require 'ppc/operation'
 require 'ppc/ext'
 module PPC
 
-  VERSION = "2.0.2"
+  VERSION = "2.0.3"
 
   protected
   def print_debug(var,varname=nil)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ppc
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.3
 platform: ruby
 authors:
 - Chienli Ma
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-20 00:00:00.000000000 Z
+date: 2016-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty