jkogara/swrve

View on GitHub
README.md

Summary

Maintainability
Test Coverage
The Swrve Ruby Gem
=====
[![Coverage Status](https://coveralls.io/repos/johnogara/swrve/badge.png?branch=master)](https://coveralls.io/r/johnogara/swrve?branch=master) 
[![Build Status](https://travis-ci.org/jkogara/swrve.png)](https://travis-ci.org/jkogara/swrve) 
[![Code Climate](https://codeclimate.com/github/jkogara/swrve.png)](https://codeclimate.com/github/jkogara/swrve)
[![Gem Version](https://badge.fury.io/rb/swrve.png)](http://badge.fury.io/rb/swrve)

A Ruby interface to the Swrve AB Testing API.

## Installation
    gem install swrve

## Quick Start Guide
Once your account is set up at Swrve.com use the following to configure Swrve

```ruby
Swrve.configure do |config|
  config.api_key = YOUR_API_KEY
  config.game_id = YOUR_GAME_ID
end
```

### Events
```ruby
Swrve.session_start('user uuid')
Swrve.create_event('user uuid', "custom.event.name.that.occurred")
Swrve.purchase('user uuid', 'Item Id', 5)
...
...
Swrve.session_end('user uuid')
```

### Resources 
```ruby
json_resource = Swrve.resource('user uuid', "ab_test_name")
```

[Usage Examples]: #usage-examples

## Documentation
[http://rdoc.info/gems/swrve][documentation]

[documentation]: http://rdoc.info/gems/swrve