analytical 0.16.0 → 1.0.0

data/VERSION

@@ -1 +1 @@
-0.16.0
+1.0.0

data/analytical.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{analytical}
-  s.version = "0.16.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Joshua Krall"]
-  s.date = %q{2010-06-17}
+  s.date = %q{2010-06-25}
   s.description = %q{Gem for managing multiple analytics services in your rails app.}
   s.email = %q{josh@transfs.com}
   s.extra_rdoc_files = [
@@ -99,7 +99,7 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://github.com/jkrall/analytical}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Gem for managing multiple analytics services in your rails app.}
   s.test_files = [
     "spec/analytical/api_spec.rb",
@@ -115,7 +115,7 @@ Gem::Specification.new do |s|
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
       s.add_runtime_dependency(%q<activesupport>, [">= 0"])
     else

data/lib/analytical/base.rb

@@ -11,9 +11,24 @@ module Analytical
         @commands = []
       end
 
+      # This is used to record page-view events, where you want to pass a URL to an analytics service
       def track(*args); ''; end
+
+      # Identify provides a unique identifier to an analytics service to keep track of the current user
+      # id should be a unique string (depending on which service you use), and some services also
+      # make use of a data hash as a second parameters, containing :email=>'test@test.com', for instance
       def identify(id, *args); ''; end
+
+      # Event is meant to track important funnel conversions in your app, or other important events
+      # that you want to inform a funnel analytics service about.  You can pass optional data to this method as well.
       def event(name, *args); ''; end
+
+      # Set passes some data to the analytics service that should be attached to the current user identity
+      # It can be used to set AB-testing choices and other unique data, so that split testing results can be
+      # reported by an analytics service
+      def set(data, *args); ''; end
+
+      # This method generates the initialization javascript that an analytics service uses to track your site
       def init_javascript(location); {}; end
 
       def queue(*args)

data/lib/analytical/kiss_metrics.rb

@@ -33,6 +33,11 @@ module Analytical
         "_kmq.push([\"record\", \"#{name}\", #{data.to_json}]);"
       end
 
+      def set(data, *args)
+        return '' if data.blank?
+        "_kmq.push([\"set\", #{data.to_json}]);"
+      end
+
     end
   end
 end

data/spec/analytical/kiss_metrics_spec.rb

@@ -21,17 +21,23 @@ describe "Analytical::KissMetrics::Api" do
     end
   end
   describe '#identify' do
-    it 'should return an empty string' do
+    it 'should return a js string' do
       @api = Analytical::KissMetrics::Api.new @parent, {:key=>'abcdef'}
       @api.identify('id', {:email=>'test@test.com'}).should == "_kmq.push([\"identify\", \"test@test.com\"]);"
     end
   end
   describe '#event' do
-    it 'should return an empty string' do
+    it 'should return a js string' do
       @api = Analytical::KissMetrics::Api.new @parent, {:key=>'abcdef'}
       @api.event('Big Deal', {:something=>'good'}).should == "_kmq.push([\"record\", \"Big Deal\", #{{:something=>'good'}.to_json}]);"
     end
   end
+  describe '#set' do
+    it 'should return a js string' do
+      @api = Analytical::KissMetrics::Api.new @parent, {:key=>'abcdef'}
+      @api.set({:something=>'good', :b=>2}).should == "_kmq.push([\"set\", {\"something\":\"good\",\"b\":2}]);"
+    end
+  end
   describe '#init_javascript' do
     it 'should return the init javascript' do
       @api = Analytical::KissMetrics::Api.new @parent, {:key=>'abcdef'}

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: analytical
 version: !ruby/object:Gem::Version 
+  hash: 23
   prerelease: false
   segments: 
+  - 1
   - 0
-  - 16
   - 0
-  version: 0.16.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Joshua Krall
@@ -14,16 +15,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-17 00:00:00 -05:00
+date: 2010-06-25 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 13
         segments: 
         - 1
         - 2
@@ -35,9 +38,11 @@ dependencies:
   name: activesupport
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
         - 0
         version: "0"
@@ -141,23 +146,27 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Gem for managing multiple analytics services in your rails app.