mitamirri 0.13.8

data/script/destroy

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/destroy'

data/script/generate

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/generate'

data/script/performance/benchmarker

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../../config/boot',  __FILE__)
+require 'commands/performance/benchmarker'

data/script/performance/profiler

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../../config/boot',  __FILE__)
+require 'commands/performance/profiler'

data/script/plugin

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/plugin'

data/script/runner

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/runner'

data/script/server

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path('../../config/boot',  __FILE__)
+require 'commands/server'

data/spec/controllers/trackable_actions_controller_spec.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+# describe TrackableActionsController do
+# 
+# end

data/spec/controllers/trackable_sessions_controller_spec.rb

@@ -0,0 +1,5 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+# describe TrackableSessionsController do
+# 
+# end

data/spec/custom_matchers.rb

@@ -0,0 +1,23 @@
+module CustomMatcher  
+  def set_cell(row, column, value)
+    value = "'#{value}'" if value.is_a?(String)
+    
+    simple_matcher("setCell(#{row}, #{column}, #{value})") do |actual|
+      actual =~ /data\.setCell\(#{row},\s*#{column},\s*#{value}\)/
+    end
+  end  
+  
+  def set_value(row, column, value)
+    value = "'#{value}'" if value.is_a?(String)
+    
+    simple_matcher("setValue(#{row}, #{column}, #{value})") do |actual|
+      actual =~ /data\.setValue\(#{row},\s*#{column},\s*#{value}\)/
+    end
+  end  
+  
+  def add_column(column_type, value)
+    simple_matcher("addColumn('#{column_type}', '#{value}')") do |actual|
+      actual =~ /data\.addColumn\('#{column_type}',\s*'#{value}'\)/
+    end
+  end
+end

data/spec/helpers/application_helper_spec.rb

@@ -0,0 +1,57 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+include Mitamirri::Helper
+
+describe "application helper methods" do
+  
+  describe 'track action' do
+  
+    it 'creates a trackable action object from view tracking invocation' do
+      request = Object.new
+      request.stubs(:referrer).returns('/')
+      request.stubs(:remote_ip).returns('123.123.123.123')
+      request.stubs(:url).returns('http://www.elizium.com/opiates')
+      session = Object.new
+      session.stubs(:session_id).returns('1234ab')
+      lambda{
+        track_action('view', :label => 'Some Label')
+      }.should change(TrackableAction, :count).by(1)
+    end
+
+    it 'returns track click code for click tracking invocation' do
+      request = Object.new
+      request.stubs(:referrer).returns('/')
+      request.stubs(:remote_ip).returns('123.123.123.123')
+      request.stubs(:url).returns('http://www.elizium.com/opiates')
+      session = Object.new
+      session.stubs(:session_id).returns('1234ab')
+      track_action('click').should_not be_nil      
+    end
+    
+    it 'needs more robust tests for this method'
+    
+  end
+  
+  it 'returns appropriate track_click_code' do
+    expected = %{<script type="text/javascript">
+          Event.observe(window, 'load', function() {
+            Event.observe('my_button', 'mousedown', track_mousedown_my_button_event);
+          });
+          function track_mousedown_my_button_event() {
+            new Ajax.Updater('tracking', '/trackable_actions/', {asynchronous:true, evalScripts:true, parameters:'action=create&kind=click&label=my_action&referrer=/&remote_ip=123.123.123.123&site=www.seologic.com&url=/&session_id=asdf&destination='})
+            Event.stopObserving('my_button', 'mousedown', track_mousedown_my_button_event);
+          }
+        </script>}
+    track_event_code('click', 'mousedown', 'my_button', 'my_action', '/', '123.123.123.123', 'www.seologic.com', '/', 'asdf').should == expected
+  end
+  
+  it 'returns a legend tag' do
+    legend_tag('Foo', {:id => 'foo'}).should == %{<div id="foo" class="faux_legend">Foo</div>\r}
+  end
+  
+  it 'returns page break code' do
+    page_break.should == %{<div class="page_break" /><p>(Continued on next page)</p></div>}
+  end
+  
+  
+end

data/spec/lib/content_report_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "ContentReport" do
+
+  before :all do
+    @args = {
+      :site => 'www.foo.com',
+      :time_period => 'past 3 months',
+      :visit_kind => 'search'
+    }
+    TrackableSession.stubs(:search).returns([])
+    @report = Mitamirri::ContentReport.new(@args)
+  
+  end
+  
+  it 'initializes with arguments' do
+    @report.site.should == @args[:site]
+    @report.time_period.should == @args[:time_period]
+    @report.visit_kind.should == @args[:visit_kind]
+  end
+
+  it 'calculates its dates' do
+    @report.dates.should == [
+      (Time.zone.now - 2.months).beginning_of_month,
+      (Time.zone.now - 1.months).beginning_of_month,
+      (Time.zone.now).end_of_month,
+    ]
+  end
+  
+  it 'creates a ContentStat object from arguments' do
+    _stat = Mitamirri::ContentReport::ContentStat.new(:url => '/', :views => 3)
+    _stat.views.should == 3
+    _stat.url.should == '/'
+  end
+  
+end

data/spec/lib/intersite_traffic_report_spec.rb

@@ -0,0 +1,51 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "IntersiteTrafficReport" do
+
+  before :all do
+    @args = {
+      :site => 'www.foo.com',
+      :time_period => 'past month',
+      :visit_kind => 'search'
+    }
+    TrackableSession.stubs(:search).returns([])
+    @report = Mitamirri::IntersiteTrafficReport.new(@args)
+  
+  end
+  
+  it 'initializes with arguments' do
+    @report.site.should == @args[:site]
+    @report.time_period.should == @args[:time_period]
+    @report.visit_kind.should == @args[:visit_kind]
+  end
+
+  it 'calculates its dates' do
+    @report.dates.should == [
+      (Time.zone.now - 4.weeks).end_of_week,
+      (Time.zone.now - 3.weeks).end_of_week,
+      (Time.zone.now - 2.weeks).end_of_week,
+      (Time.zone.now - 1.weeks).end_of_week,
+      (Time.zone.now).end_of_week,
+    ]
+  end
+  
+  it 'creates a Destination object from arguments' do
+    _stat = Mitamirri::IntersiteTrafficReport::Destination.new(:site => 'www.foo.com', :clickthroughs => 3)
+    _stat.clickthroughs.should == 3
+    _stat.site.should == 'www.foo.com'
+  end
+  
+  it 'creates a Visit object from arguments' do
+    _stat = Mitamirri::IntersiteTrafficReport::Visit.new(:site => 'www.foo.com', :stats => [])
+    _stat.site.should == 'www.foo.com'
+    _stat.stats.should == []
+  end
+  
+  it 'creates a VisitStat object from arguments' do
+    _stat = Mitamirri::IntersiteTrafficReport::VisitStat.new(:date => Time.zone.now.beginning_of_month, :clickthroughs => 3)
+    _stat.clickthroughs.should == 3
+    _stat.date.should == Time.zone.now.beginning_of_month
+  end
+  
+end

data/spec/lib/leads_report_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "LeadsReport" do
+
+  before :all do
+    @args = {
+      :site => 'www.foo.com',
+      :time_period => 'past month',
+    }
+    TrackableSession.stubs(:search).returns([])
+    @report = Mitamirri::LeadsReport.new(@args)
+  
+  end
+  
+  it 'initializes with arguments' do
+    @report.site.should == @args[:site]
+    @report.time_period.should == @args[:time_period]
+    @report.start_date.should == (Time.zone.now - 4.weeks).beginning_of_week
+    @report.end_date.to_s(:concise).should == Time.zone.now.to_s(:concise)
+  end
+
+  it 'calculates its dates' do
+    @report.dates.map{|d| d.to_s(:concise)}.should == [
+      (Time.zone.now - 4.weeks).beginning_of_week.to_s(:concise),
+      (Time.zone.now - 3.weeks).beginning_of_week.to_s(:concise),
+      (Time.zone.now - 2.weeks).beginning_of_week.to_s(:concise),
+      (Time.zone.now - 1.weeks).beginning_of_week.to_s(:concise),
+      Time.zone.now.to_s(:concise),
+    ]
+  end
+  
+  it 'creates a Lead object from arguments' do
+    _lead = Mitamirri::LeadsReport::Lead.new(:stats => ['foo'])
+    _lead.stats.should == ['foo']
+  end
+  
+  it 'creates a LeadStats object from arguments' do
+    _stat = Mitamirri::LeadsReport::LeadStat.new(:date => Time.zone.now.end_of_week, :leads => 3, :conversion_rate => 50.0)
+    _stat.date.should == Time.zone.now.end_of_week
+    _stat.leads.should == 3
+    _stat.conversion_rate.should == 50.0
+    _stat.short_date.should == Time.zone.now.end_of_week.to_s(:concise)
+  end
+  
+end

data/spec/lib/session_report_spec.rb

@@ -0,0 +1,107 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "SessionReport" do
+
+  before :all do
+    @args = {
+      :site => 'www.foo.com',
+      :time_period => 'past 3 months',
+      :action_kind => 'clickthrough',
+      :visit_kind => 'search'
+    }
+    TrackableSession.stubs(:search).returns([])
+    @report = Mitamirri::SessionReport.new(@args)
+    @report.stubs(:total_bounces).returns(5)
+    @report.stubs(:total_clickthroughs).returns(10)
+    @report.stubs(:total_conversions).returns(20)
+    @report.stubs(:total_direct_visits).returns(10)
+    @report.stubs(:total_duration).returns(18000.0)
+    @report.stubs(:total_new_visits).returns(20)
+    @report.stubs(:total_organic_visits).returns(30)
+    @report.stubs(:total_pageviews).returns(100)
+    @report.stubs(:total_ppc_visits).returns(10)
+    @report.stubs(:total_return_visits).returns(90)
+    @report.stubs(:total_search_visits).returns(30)
+    @report.stubs(:total_visits).returns(100)
+    @report.stubs(:total_conversions).returns(20)
+  end
+  
+  it 'initializes with arguments' do
+    @report.site.should == @args[:site]
+    @report.time_period.should == @args[:time_period]
+    @report.action_kind.should == 'clickthrough'
+    @report.visit_kind.should == 'search'
+  end
+
+  it 'calculates its dates' do
+    @report.dates.should == [
+      (Time.zone.now - 2.months).beginning_of_month,
+      (Time.zone.now - 1.months).beginning_of_month,
+      (Time.zone.now).end_of_month,
+    ]
+  end
+  
+  it 'calculates average pages per visit' do
+    @report.average_pages_per_visit.should == "1.0"
+  end
+  
+  it 'calculates average time on site' do
+    @report.average_time_on_site.should == "3.0 minutes"
+  end
+  
+  it 'calculates the bounce rate' do
+    @report.bounce_rate.should == "5.0%"
+  end
+  
+  it 'calculates the conversion rate' do
+    @report.conversion_rate.should == "20.0%"
+  end
+  
+  it 'calculates the total direct visits percentage' do
+    @report.total_direct_visits_percentage.should == "10.0%"
+  end
+  
+  it 'calculates the total new visits percentage' do
+    @report.total_new_visits_percentage.should == "20.0%"
+  end
+  
+  it 'calculates the total return visits percentage' do
+    @report.total_return_visits_percentage.should == "90.0%"
+  end
+  
+  it 'calculates the total organic visits percentage' do
+    @report.total_organic_visits_percentage.should == "30.0%"
+  end
+  
+  it 'calculates the total ppc visits percentage' do
+    @report.total_ppc_visits_percentage.should == "10.0%"
+  end
+  
+  it 'creates a KeywordStat object from arguments' do
+    _stat = Mitamirri::SessionReport::KeywordStat.new(:keyword => 'foo', :count => 3)
+    _stat.count.should == 3
+    _stat.keyword.should == 'foo'
+  end
+  
+  it 'creates a ReferrerStat object from arguments' do
+    _stat = Mitamirri::SessionReport::ReferrerStat.new(:referrer => 'www.foo.com', :count => 3)
+    _stat.count.should == 3
+    _stat.referrer.should == 'www.foo.com'
+  end
+  
+  it 'creates a Visit object from arguments' do
+    _visit = Mitamirri::SessionReport::Visit.new(:kind => 'search', :date => Time.zone.now.to_s(:concise), :stats => [])
+    _visit.kind.should == "search"
+    _visit.date.should == Time.zone.now.to_s(:concise)
+    _visit.stats.should == []
+  end
+  
+  it 'creates a VisitStat object from arguments' do
+    _stat = Mitamirri::SessionReport::VisitStat.new(:date => Time.zone.now, :visits => 3)
+    _stat.visits.should == 3
+    _stat.date.to_s(:concise).should == Time.zone.now.to_s(:concise)
+    _stat.short_date.should == Time.zone.now.to_s(:month_year)
+  end
+  
+end

data/spec/lib/stat_report_spec.rb

@@ -0,0 +1,106 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "StatReport" do
+
+  before :all do
+    @args = {
+      :site => 'www.foo.com',
+      :time_period => 'past 3 months',
+      :action_kind => 'clickthrough',
+      :visit_kind => 'search'
+    }
+    TrackableSession.stubs(:search).returns([])
+    @report = Mitamirri::StatReport.new(@args)
+    @report.stubs(:total_bounces).returns(5)
+    @report.stubs(:total_clickthroughs).returns(10)
+    @report.stubs(:total_conversions).returns(20)
+    @report.stubs(:total_direct_visits).returns(10)
+    @report.stubs(:total_duration).returns(18000.0)
+    @report.stubs(:total_new_visits).returns(20)
+    @report.stubs(:total_organic_visits).returns(30)
+    @report.stubs(:total_pageviews).returns(100)
+    @report.stubs(:total_ppc_visits).returns(10)
+    @report.stubs(:total_return_visits).returns(90)
+    @report.stubs(:total_search_visits).returns(30)
+    @report.stubs(:total_visits).returns(100)
+  end
+  
+  it 'initializes with arguments' do
+    @report.site.should == @args[:site]
+    @report.time_period.should == @args[:time_period]
+    @report.action_kind.should == 'clickthrough'
+    @report.visit_kind.should == 'search'
+  end
+
+  it 'calculates its dates' do
+    @report.dates.should == [
+      (Time.zone.now - 2.months).beginning_of_month,
+      (Time.zone.now - 1.months).beginning_of_month,
+      (Time.zone.now).end_of_month,
+    ]
+  end
+  
+  it 'calculates average pages per visit' do
+    @report.average_pages_per_visit.should == "1.0"
+  end
+  
+  it 'calculates average time on site' do
+    @report.average_time_on_site.should == "3.0 minutes"
+  end
+  
+  it 'calculates the bounce rate' do
+    @report.bounce_rate.should == "5.0%"
+  end
+  
+  it 'calculates the conversion rate' do
+    @report.conversion_rate.should == "20.0%"
+  end
+  
+  it 'calculates the total direct visits percentage' do
+    @report.total_direct_visits_percentage.should == "10.0%"
+  end
+  
+  it 'calculates the total new visits percentage' do
+    @report.total_new_visits_percentage.should == "20.0%"
+  end
+  
+  it 'calculates the total return visits percentage' do
+    @report.total_return_visits_percentage.should == "90.0%"
+  end
+  
+  it 'calculates the total organic visits percentage' do
+    @report.total_organic_visits_percentage.should == "30.0%"
+  end
+  
+  it 'calculates the total ppc visits percentage' do
+    @report.total_ppc_visits_percentage.should == "10.0%"
+  end
+  
+  it 'creates a KeywordStat object from arguments' do
+    _stat = Mitamirri::StatReport::KeywordStat.new(:keyword => 'foo', :count => 3)
+    _stat.count.should == 3
+    _stat.keyword.should == 'foo'
+  end
+  
+  it 'creates a ReferrerStat object from arguments' do
+    _stat = Mitamirri::StatReport::ReferrerStat.new(:referrer => 'www.foo.com', :count => 3)
+    _stat.count.should == 3
+    _stat.referrer.should == 'www.foo.com'
+  end
+  
+  it 'creates a Visit object from arguments' do
+    _visit = Mitamirri::StatReport::Visit.new(:kind => 'search', :date => Time.zone.now.to_s(:concise), :stats => [])
+    _visit.kind.should == "search"
+    _visit.date.should == Time.zone.now.to_s(:concise)
+    _visit.stats.should == []
+  end
+  
+  it 'creates a VisitStat object from arguments' do
+    _stat = Mitamirri::StatReport::VisitStat.new(:date => Time.zone.now, :visits => 3)
+    _stat.visits.should == 3
+    _stat.date.to_s(:concise).should == Time.zone.now.to_s(:concise)
+    _stat.short_date.should == Time.zone.now.to_s(:month_year)
+  end
+  
+end

data/spec/models/trackable_action_spec.rb

@@ -0,0 +1,42 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'mitamirri'
+
+describe "TrackableAction" do
+  
+  describe 'creates a new object from parameters' do
+  
+    before :all do
+      @new = TrackableAction.create_from_params(
+        :session_id => 123456,
+        :referrer => '/',
+        :ip_address => '123.123.123.1',
+        :site => 'www.seologic.com',
+        :kind => 'click',
+        :label => 'Some Random Click',
+        :url => 'http://www.seologic.com/foo/bar/'
+      )
+    end
+    
+    it 'with a kind' do
+      @new.kind.should == 'click'
+    end
+    
+    it 'with a label' do 
+      @new.label.should == 'Some Random Click'
+    end
+    
+    it 'with a referrer' do
+      @new.referrer.should == '/'
+    end
+    
+    it 'with a URL' do
+      @new.url.should == 'http://www.seologic.com/foo/bar/'
+    end
+    
+    it 'with an associated trackable session' do
+      @new.trackable_session_id.should_not be_nil
+    end
+    
+  end
+  
+end

data/spec/models/trackable_session_spec.rb

@@ -0,0 +1,154 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "TrackableSession" do
+
+  describe 'class methods' do
+  
+    it 'calculates conversion rates' do
+      TrackableSession.stubs(:search).returns(TrackableSession.new)
+      TrackableSession.any_instance.stubs(:with_conversions).returns(TrackableSession.new(:has_conversions => true))
+      TrackableSession.any_instance.stubs(:count).returns(1)
+      
+      TrackableSession.conversion_rate({}).should == 100
+    end
+    
+    it 'returns kinds suitably formatted for a select' do
+      TrackableSession.kinds_for_select.should == [["All", "all"], ["Direct", "direct"], ["Natural", "natural"], ["Paid", "paid"], ["Search", "search"]]
+        
+    end
+  
+  end
+
+  describe 'instance methods' do
+  
+    describe 'initializes' do
+    
+      it 'defaulting its new_visit flag to true' do
+        TrackableSession.stubs(:find_by_ip_address).returns(nil)
+        _new_session = TrackableSession.new(:ip_address => '192.1.1.5')
+        _new_session.init
+        _new_session.new_visit.should be_true
+      end
+      
+      it 'detecting a return visit' do
+        TrackableSession.stubs(:find_by_ip_address).returns(['a record'])
+        _new_session = TrackableSession.new(:ip_address => '192.1.1.5')
+        _new_session.init
+        _new_session.new_visit.should be_false
+      end
+      
+      it 'detecting a visit from a spider' do
+        # Human user agents
+        [
+          "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-GB; rv:1.8.1.6) Gecko/20070725 Firefox/2.0.0", 
+          "Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1)",
+          "Opera/9.20 (Windows NT 6.0; U; en)",
+          "Macintosh; U; Intel Mac OS X 10_6_4; en-us) AppleWebKit/533.17.8 (KHTML, like Gecko) Version/5.0.1 Safari/533.17.8"
+        ].each do |ua| 
+          _session = TrackableSession.new(:user_agent => ua)
+          _session.init
+          _session.spider?.should be_false
+        end
+        # Bots
+        [
+          "Googlebot/2.1 ( http://www.googlebot.com/bot.html) ", 
+          "msnbot-Products/1.0 (+http://search.msn.com/msnbot.htm)", 
+        ].each do |ua| 
+          _session = TrackableSession.new(:user_agent => ua)
+          _session.init
+          _session.spider?.should be_true
+        end
+      end
+      
+      it 'setting its kind' do
+        _new_session = TrackableSession.new
+        _new_session.init
+        _new_session.kind.should_not be_nil
+      end
+  
+    end
+    
+    it 'calculates its duration in seconds' do
+      TrackableSession.new(:duration => 30).hr_duration.should == '30.0 seconds'
+    end
+    
+    it 'calculates its duration in minutes' do
+      TrackableSession.new(:duration => 90).hr_duration.should == '1.5 minutes'
+    end
+    
+    it 'it sanitizes referring keywords' do
+      _session = TrackableSession.new(:referring_keywords => 'some+keywords+here')
+      _session.sanitize_referring_keywords.should == 'some keywords here'
+    end
+    
+    it 'returns the date of the last previous visit' do
+      _first = TrackableSession.create(:ip_address => '90.1.2.3', :created_at => Time.zone.now - 2.months)
+      _second = TrackableSession.create(:ip_address => '90.1.2.3', :created_at => Time.zone.now - 1.months)
+      _third = TrackableSession.create(:ip_address => '90.1.2.3', :created_at => Time.zone.now)
+      _third.last_visit_date.should == _second.created_at.to_s(:concise)
+    end
+    
+    it 'updates its timestamp' do
+      _then = Time.zone.now - 30.seconds
+      _session = TrackableSession.new(:created_at => _then)
+      _session.stubs(:save).returns(true)
+      _session.stubs(:touch_stat).returns(true)
+      sleep(1)
+      _session.touch
+      (_session.updated_at > _then).should be_true
+    end
+    
+    it "returns visit_type of 'New' if it's a new visit" do
+      TrackableSession.new(:new_visit => true).visit_type.should == 'New'
+    end
+    
+    it "returns visit_type of 'Returning' if it's not a new visit" do
+      TrackableSession.new(:new_visit => nil).visit_type.should == 'Returning'
+    end
+    
+    describe 'sets its kind by referrer' do
+    
+      it 'with a search engine referrer' do
+        TrackableSession.new(:referrer => 'http://www.google.com/search/').kind_by_referrer.should == 'search'
+      end
+      
+      it 'with an organic referrer' do
+        TrackableSession.new(:referrer => 'http://www.seologic.com/foo.htm').kind_by_referrer.should == 'natural'
+      end
+      
+      it 'with a PPC referrer' do
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?gclid=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?keyword=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?adid=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?matchtype=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?ppc=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+        TrackableSession.new(
+          :initial_request_url => 'http://www.seologic.com/foo.htm?cpc=1234', 
+          :referrer => 'http://www.foo.com/'
+        ).kind_by_referrer.should == 'paid'
+      end
+      
+      it 'with no referrer' do
+        TrackableSession.new(:referrer => nil).kind_by_referrer.should == 'direct'
+      end
+    
+    end
+    
+  end
+  
+end