session_logger 1.0.1 → 1.0.2

data/README.rdoc

@@ -30,21 +30,44 @@ And/or add it to your Gemfile
 Then create the initializer:
   rails generate session_logger:initializer
 
-As a performance optimization you can add the list of models to observe in the initializer:
-  config.session_logger.logged_models = [MODEL_CONSTANTS,...]
-
 Finally add 'enable_session_logger' to Application controller (or any controller you want logging to occur)
   ApplicationController < ActionController::Base
-    enable_session_logger
+    enable_session_logging
   end
 
 
 == Usage
 
-1. Create metadata columns on the models you want metadata recorded on
-2. Be sure to prefix metadata columns with the model prefix ("sl_" by default)
-3. Simply set that same prefixed name in the session and that metadata will be stored anytime a observed record is created during that session.
-   
+1 Create metadata columns on the models you want metadata recorded on
+
+  add_column :users :sl_campaign
+  add_column :users :sl_source
+  add_column :users :sl_medium
+  add_column :users :sl_landing_page
+  add_column :users :sl_session_id
+
+2 Be sure to prefix metadata columns with the model prefix ("sl_" by default)
+
+  SessionLogger.configure do |config|
+  config.model_prefix = "sl_" # means columns are like: sl_XXXX
+  end
+3 Simply set that same prefixed name in the session and that metadata will be stored anytime a observed record is created during that session.
+
+  ApplicationController < ActionController::Base
+  enable_session_logging
+  before_filter :pull_campaign_data
+
+  def pull_campaign_data
+    session[:sl_campaign] = params[:sl_campaign]
+    ...
+  end
+
+  end
+
+4 Later segment your data naturally using the columns you defined
+
+  User.where(:sl_campaign => "facebook_ads_1").count
+  ...
 
 == How it works
 
@@ -58,6 +81,7 @@ appending the metadata for that users session.
 
 == Gotchas
 
+
 If you start monitoring a ton of metadata around the user you have to switch
 to db sessions instead of cookie store.
 
@@ -92,5 +116,11 @@ this will give you a bad taste in your mouth but it seems like a better
 solution overall.
 
 
+== Optimizations
+
+As a performance optimization you can reduce the list of models to observe in the initializer:
+  config.session_logger.logged_models = [MODEL_CONSTANTS,...]
+
+
 == License
 This project rocks and uses MIT-LICENSE.

data/lib/session_logger/session_logging.rb

@@ -60,9 +60,6 @@ module SessionLogger
 
     private
     def set_if_present(obj, key, val)
-      pp obj
-      pp key
-      pp val
       obj.send("#{key}=", val) if val.present?
     end
   end

data/lib/session_logger/version.rb

@@ -1,3 +1,3 @@
 module SessionLogger
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

metadata

@@ -2,7 +2,7 @@
 name: session_logger
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors: 
 - Timothy Cardenas
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-11-05 00:00:00 Z
+date: 2011-11-08 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rails