devise_marketable 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDE2ZWYxNTdkOWQ1MzBkODkyMjZhN2YzZWEzYTZjYTI4NjE0ODIyOA==
+    NDkwZDc4YmY2NjY5MDM4MGE5NjI5ODAyNTc1Y2FmM2NmMWY5NzQ2NQ==
   data.tar.gz: !binary |-
-    M2JkMjJjNjg4MjMxNGQ0ZmEwOGZjZGZhOTkyYmEzZjBiZGY4NTliZQ==
+    ZDk1MGMyNDRmMDgzNjRmNDk3NDY3MjRmMTNkOTQzMWU4MzZhZDljYw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    NGUyNGUwYWY0NzM4ZjJkNzcxMTAyYzRjZGM2NDkyYWRiMTk1YjMzZDM4NjA0
-    MGFiNmFmYjY5OWZjNThlMTFiZjRjMTVlYjRkMjQ1YmUzMDk3ZTg3NWJkMmJh
-    M2I3YWFiMTc0NDgwMWU1NTJhOGI0ZjMzZjRiMjhiODNlZWRhYzQ=
+    MDg4YjM5MjE0NzRkYTQ0YjVhNjQwMTZkOWE1ZDJjM2ZiYmE1YTBhZWE5NWQ0
+    NmFiNDBmM2RhZjJiYWZlMWZjMjI3MDBiNDFjN2Q4YWY1OWFhNGE2ODVkMjE2
+    NWFiNzkyMjRiZWNjMjNhN2JiNWJjZThjMTg2NTJlNjgzZDFiOGY=
   data.tar.gz: !binary |-
-    OWMyNWQ3MTNlNzAyMzJkNTcwYzlhMWE1NzE2ZTM0NTZiNTE0MzgwZGQ5NzU1
-    ODhlODRlYTgzM2U1MGU5ZDQwODdiYzVlYmE2MjY3ZGY4YjZhYjFiZWZjNTZl
-    YWI0MzJlZDFiYmY0ZDE2ZThlOTkyY2Q4NDQwYjZjNDcxMWZlNTQ=
+    N2Y1YTNmMDEzNjMzZjYxNmIxOGFkZjBkM2MzYWI2YjMwZGVjZWViOWViODM2
+    ZWZhOTI4MWMxMmEyZWM5OGZlYWNkMDA3NDZmNTgxZmIyYTBjMWIwZGIyN2Vm
+    ZDU3NWRmYTE2ZmU3YmI4Mjk1NTY5MmJiZjZjYjAwZGNiOGU5YjE=

data/README.md

@@ -1,24 +1,81 @@
-Devise Marketable
-===========
+Marketable for Devise
+===================
 
-An easy way to store the common marketing data you need to judge the performance of marketing campaigns (e.g. referring_url and landing_url)
+> If this person turns out to be our best customer, we want to know where they came from. 
+
+> **Mike McDerment**, CEO of FreshBooks 
+
+Marketable lets [Devise](https://github.com/plataformatec/devise) users easily store where your user came from and where they were going in your Rails app.
 
 
 ## Background
 
+Mike McDerment is part of that small handful of entrepreneurs who have tremendously inspired my work. He started a web app, and even past 30 years old, was cranking away at in his parents' basement for 3 years. Plenty of smart people told him what he was working on was stupid and would fail. And, yet, he continued. Today, FreshBooks is a very successful company. 
+
+Mike is a huge proponent of tracking where your customers came from and where they were going. With this data, you can figure out what kind of marketing is working and what's not. 
+
+By "marketing", I'm referring to everything related to getting customers, not just spending money on advertising. If you get an influx of new users, wouldn't you want to know if they came from a blog post you wrote, or someone mentioned you on Reddit? If you found out Reddit is your best source of new paying customers, then you've figured out where to best allocate your resources to get even more customers. 
+
+It's super easy to capture this data, but most of us don't, because it's even more friction to getting features done for our customers. Or we rely on 3rd party analytics tools. Some are great, but what happens when you want to switch analytics tools or do something custom they can't do.
+
+I created Marketable to automatically track the most basic and important marketing data we should be tracking alongside our User data (using Devise) in our own database. (And so that I could add it to [**Draft**](http://draftin.com), a tool I've created to help people [**write better**](http://draftin.com).)
+
+ 
+## Installation
+
+
+1) Add 'devise_marketable' to your Gemfile. 
+
+```
+gem 'devise_marketable'
+```
+
+2) Run `bundle install`
+3) Add the marketing fields to your user table: 
 
+```
+rails g devise_marketable YOUR_USER_MODEL
+```
 
+YOUR_USER_MODEL is probably User. It's what you attach Devise to. (e.g. User, Admin, Account)
+
+```
+rails g devise_marketable User
+```
+
+4) Run your migration
+
+```
+rake db:migrate
+```
+
+5) Make your devise model "marketable"
+
+```
+devise :database_authenticatable, ..., :marketable
+```
+
+6) Restart your server
 
-Installation
 ------------
 
-1)
+Devise will now automatically create 2 cookies for your users, the referring_url (where they came from) and the landing_url (where they were going). When the user registers with your application, the values in those cookies are stored alongside your user data. 
 
+That's it. You now have some very powerful data: where your best customers come from, what traffic sources are your most lucrative, what on your website converts the best, what people are most interested in, etc. 
+
+P.S. [**I'd love to meet you on Twitter: here**](http://twitter.com/natekontny). 
+
+<iframe src="https://draftin.com/share_buttons/new.html?url=http%3A%2F%2Fninjasandrobots.com%2Fmarketable_for_devise&title=Marketable%20for%20Devise" scrolling="no" frameborder="0" style="border:none; overflow:hidden;width:800px; height:21px; padding-left:50px" allowtransparency="true" ></iframe>
+
+
+---------------
 
 Feedback
 --------
 [Source code available on Github](https://github.com/n8/devise_marketable). Feedback and pull requests are greatly appreciated.  Let me know if I can improve this.
 
------------
+---------------
+
+[Here's a great short presentation from Mike on tracking user metrics](http://vimeo.com/10733370).
 
-P.S. [**I'd love to meet you on Twitter: here**](http://twitter.com/natekontny). 
+<iframe src="//player.vimeo.com/video/10733370" width="500" height="281" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>

data/devise_marketable.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["nate@cityposh.com"]
   spec.description   = %q{A simple way to have Devise capture important marketing data.}
   spec.summary       = %q{A simple way to have Devise capture important marketing data.}
-  spec.homepage      = ""
+  spec.homepage      = "http://ninjasandrobots.com/marketable_for_devise"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files`.split($/)

data/lib/devise_marketable/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: devise_marketable
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - nate
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-08 00:00:00.000000000 Z
+date: 2013-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,7 +70,7 @@ files:
 - lib/devise_marketable/version.rb
 - lib/generators/devise_marketable/devise_marketable_generator.rb
 - lib/generators/devise_marketable/templates/migration.rb
-homepage: ''
+homepage: http://ninjasandrobots.com/marketable_for_devise
 licenses:
 - MIT
 metadata: {}