simple_abs 0.0.1 → 0.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YzQ4MjgxYWI3ZGQwYWUwMWVjM2YyZGUxNDkyOTYyM2NkNmYxYzEyOA==
+  data.tar.gz: !binary |-
+    MGUyM2Q2ZGRmY2I2MjBjOWRlNTJjYjQ5NWRhOTEwZGFmOWRmN2JiOA==
+SHA512:
+  metadata.gz: !binary |-
+    NWFjZDIwOGRjYmQ5M2Y3NmJmMDBjZmY4MzQ4YTUxNzE3ODY1MDE5OGUyYzIw
+    NjJhNGNiYjM4MjFkN2Y0ZTU0Y2FhOWVkM2Q4ZWNmYzg1ODU4ODdkOGY3MzMy
+    OTlhMzEwZGJhNWRhZjdmZjk1ZjFhNGFhOTNmODIzNGE3NDc2NTY=
+  data.tar.gz: !binary |-
+    NWEyOWJhNTIxNjE4ODE0MDk1YzE1MGY0OTVhNmM2MjJlZjVjMWVjMjljOTcy
+    ZTg0OWI3MzY5NDYzNzgxMWQ4ZDE4MGRlZjM2NzU0YjViMzMzMjEwMTkxNDY0
+    ZTQzOWY0ZTM1YzU4YjgzYTYyNDRkMWE1NTliZWQ0YjIzYTliZTM=

data/README.md

@@ -1,11 +1,14 @@
-# SimpleAbs
+# Rails AB Testing - Simple Abs
 
-A super super simple way to do AB tests in Rails. 
+I recently turned on paid subscriptions to [Draft, the writing software](https://draftin.com) I've created. And I wanted a really simple way to test a few alternatives of the payment page in Rails without needing to use a separate service.
+ 
+But the solutions out there get too complicated. Even the "simplest" ones require things like Redis. They do that because somewhere the AB testing library needs to remember what variation of a test a user has already seen, so it knows what to show them on subsequent visits. 
 
-I made this because everything else seemed overly complicated. You don't need to install Redis or anything like that. 
+But I don't want to install Redis just to have my AB tests be performant. That's still an extra network call to Redis for this simple operation, not to mention the added complexity of adding Redis to my software stack when I don't need it right now. 
 
-Definitely inspired by other AB testing libraris like AB Bingo from patio11. 
+Why can't the AB testing library just store what variation a user has already seen in the user's cookies? 
 
+That's what SimpleAbs does. 
 
 ## Installation
 
@@ -32,29 +35,77 @@ Run the migrations:
 
 ## Usage
 
-You can use simple_abs to figure out an "alternative" to show your users. You can get ahold of an alternative from a View or from a Controller. 
+Use simple_abs to figure out an "alternative" to show your users. You can get ahold of an alternative from either a Rails View or a Controller. 
 
-Here's an example where I might have a short and long version of a buy page. simple_abs will randomly pick which version this user should see.
+```ruby
+ab_test(experiment name, [variation name 1, variation name 2, etc.])
+```
 
-    def buy
-      @buy_page = ab_test("buy_page", ["short", "long"])
+Here's an example where I might have three different versions of a buy page. simple_abs will randomly pick which version this user should see.
 
-      render template: 'site/buy', layout: 'write'
-    end
+```ruby
+def buy
+  @buy_page = ab_test("buy_page", ["short", "medium", "long"])
 
-If they've already seen one of the alternatives, simple_abs figures that out from the permanent cookies of the user. 
+  render action: 'buy'
+end
+```
 
-Once your user converts you can call: 
+Then, in your template, you can use an if statement to show them that version of the @buy_page:
 
-    converted!("buy_page")
+```erb
+<% if @buy_page == "long" %>
+  Lots of extra information
+<% end %>
+```
 
+If they've already seen one of the alternatives, simple_abs figures that out from the permanent cookies of the user. In other words, if on the first visit, this method:
 
+```ruby
+ab_test("buy_page", ["short", "long"])
+```
 
+Returns "short". On subsequent visits to the page from this same user, you will also get the value "short" from the ab_test method.
 
-## Contributing
+Once your user converts you can call "converted!(experiment name)" from a View or Controller: 
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+```ruby
+converted!("buy_page")
+```
+
+You can also force someone to a specific alternative of your page by using the query paramater "test_value" in your url: 
+
+    http://draftin.com/buy_things?test_value=long
+
+When you get some data you can look at it from a Rails console. 
+
+```ruby
+irb(main):011:0> pp SimpleAbs::Alternative.where("experiment = 'buy_page'").all
+  SimpleAbs::Alternative Load (55.1ms)  SELECT "alternatives".* FROM "alternatives" WHERE (experiment = 'buy_page')
+[#<SimpleAbs::Alternative id: 2, which: "short", participants: 16, conversions: 1, experiment: "buy_page", created_at: "2013-04-16 05:14:13", updated_at: "2013-04-16 13:39:14">,
+ #<SimpleAbs::Alternative id: 1, which: "long", participants: 20, conversions: 1, experiment: "buy_page", created_at: "2013-04-16 05:11:12", updated_at: "2013-04-16 14:30:01">]
+```
+
+And then you can plug the participants and conversions into a calculator like that found here: 
+
+[http://tools.seobook.com/ppc-tools/calculators/split-test.html](http://tools.seobook.com/ppc-tools/calculators/split-test.html) 
+
+    Trials        = simple_abs' participants
+    Successes     = simple_abs' conversions    
+
+
+
+Feedback
+--------
+[Source code available on Github](https://github.com/n8/simple_abs). Feedback and pull requests are greatly appreciated.  
+
+Credit
+--------
+This library is very much inspired by the other AB testing libraries out there. Not the least of which is A/Bingo from [Patrick McKenzie](https://twitter.com/patio11). 
+
+
+
+<hr/>
+
+**P.S. [It would be awesome to meet you on Twitter](http://twitter.com/natekontny).**
+<br/>

data/lib/simple_abs/version.rb

@@ -1,3 +1,3 @@
 module SimpleAbs
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/simple_abs.rb

@@ -30,7 +30,7 @@ module SimpleAbs
       test_value = tests[rand(tests.size)]
       cookies.permanent[name] = test_value
       
-      Alternative.find_or_create_by_experiment_and_which(name, test_value).increment!(:participants)
+      find_or_create_by_experiment_and_which_method(name, test_value).increment!(:participants)
     end
     
     return test_value
@@ -41,12 +41,26 @@ module SimpleAbs
     if !is_bot?
       test_value = cookies[name]
       if test_value && cookies[name.to_s + "_converted"].blank?
-        Alternative.find_or_create_by_experiment_and_which(name, test_value).increment!(:conversions)
+        find_or_create_by_experiment_and_which_method(name, test_value).increment!(:conversions)
         cookies.permanent[name.to_s + "_converted"] = true
       end
     end
   end
 
+  def find_or_create_by_experiment_and_which_method(experiment, which)
+    alternative = Alternative.where(experiment: experiment, which: which).first
+
+    if alternative.nil?
+      alternative = Alternative.new
+      alternative.experiment = experiment
+      alternative.which = which
+      alternative.save
+    end
+
+    return alternative
+
+  end
+
 
   class Railtie < Rails::Railtie
     initializer "simple_abs.initialize" do 
@@ -57,6 +71,16 @@ module SimpleAbs
 
   class Alternative < ActiveRecord::Base
 
+    def conversion
+      if participants.present? && conversions.present?
+        (participants.to_f/conversions.to_f).round(2)
+      end
+    end
+
+    # 90 percent error
+    def error
+
+    end
   end
 
 

metadata

@@ -1,20 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: simple_abs
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.0.2
 platform: ruby
 authors:
 - nate
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-16 00:00:00.000000000 Z
+date: 2014-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -22,7 +20,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -30,7 +27,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -38,7 +34,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -63,26 +58,25 @@ files:
 homepage: ''
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Really simple way to do AB tests in Rails
 test_files: []