Add this line to your application's Gemfile:
And then execute:
Or install it yourself:
$ gem install customerio
- You're not planning on triggering emails based on how customers interact with your website (e.g. users who haven't visited the site in X days)
If you're using Rails, create an initializer
$customerio = Customerio::Client.new("YOUR SITE ID", "YOUR API SECRET KEY")
If you'd like to send complex data to associate to a user as json, pass a json option:
customerio = Customerio::Client.new("YOUR SITE ID", "YOUR API SECRET KEY", :json => true)
Identify logged in customers
Tracking data of logged in customers is a key part of Customer.io. In order to send triggered emails, we must know the email address of the customer. You can also specify any number of customer attributes which help tailor Customer.io to your business.
Attributes you specify are useful in several ways:
As customer variables in your triggered emails. For instance, if you specify the customer's name, you can personalize the triggered email by using it in the subject or body.
As a way to filter who should receive a triggered email. For instance, if you pass along the current subscription plan (free / basic / premium) for your customers, you can set up triggers which are only sent to customers who have subscribed to a particular plan (e.g. "premium").
You'll want to indentify your customers when they sign up for your app and any time their key information changes. This keeps Customer.io up to date with your customer information.
# Arguments # attributes (required) - a hash of information about the customer. You can pass any # information that would be useful in your triggers. You # must at least pass in an id, email, and created_at timestamp. $customerio.identify( :id => 5, :email => "firstname.lastname@example.org", :created_at => customer.created_at.to_i, :first_name => "Bob", :plan => "basic" )
# Arguments # customer_id (required) - a unique identifier for the customer. This # should be the same id you'd pass into the # `identify` command above. $customerio.delete(5)
Tracking a custom event
Now that you're identifying your customers with Customer.io, you can now send events like "purchased" or "watchedIntroVideo". These allow you to more specifically target your users with automated emails, and track conversions when you're sending automated emails to encourage your customers to perform an action.
# Arguments # customer_id (required) - the id of the customer who you want to associate with the event. # name (required) - the name of the event you want to track. # attributes (optional) - any related information you'd like to attach to this # event. These attributes can be used in your triggers to control who should # receive the triggered email. You can set any number of data values. $customerio.track(5, "purchase", :type => "socks", :price => "13.99")
Note: If you'd like to track events which occurred in the past, you can include a
(in seconds since the epoch), and we'll use that as the date the event occurred.
$customerio.track(5, "purchase", :type => "socks", :price => "13.99", :timestamp => 1365436200)
Tracking anonymous events
You can also send anonymous events, for situations where you don't yet have a customer record but still want to trigger a campaign:
$customerio.anonymous_track("help_enquiry", :recipient => 'email@example.com')
recipient attribute to specify the email address to send the messages to. See our documentation on how to use anonymous events for more details.
- Fork it
- Clone your fork (
git clone firstname.lastname@example.org:MY_USERNAME/customerio-ruby.git && cd customerio-ruby)
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request