talkable 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85ca74c86aaaea53adef7d531ac81e669245683507ad1077bfa3113e95c48f4c
-  data.tar.gz: 1f846f63f097e27030fc5f55deca20674e4eaf6f1a3b6a0b53fde728deddb9d8
+  metadata.gz: e3fbd60d272672f462b414e27367089db71bb4a9aaad907cfcaa8f54051c22ad
+  data.tar.gz: a4883171c255a0b69fd381378c5a4b83cee47904f971dbacd53c4caf73bc8e97
 SHA512:
-  metadata.gz: 5a29bbe1f0812a95e3255ae66fc956d76819ff134eb630ea6b0c8005d763d974dbaf21bcb15a08e7990dcb8da604ae35c4b9f5663bbe71b6fffae971817980d5
-  data.tar.gz: 9b38ec27c7bba78cb0db4f5cbed0064fc795b00aa3ea7703d3165a4c716d8931157297ea52c7975a2e0b1cf77ee2aec882968b2b40032944edb11df9e97bb456
+  metadata.gz: 6d47cdd3cfd41cc753be0b37300e227ca59b7a9b8c8a4819f4eef7868abaced41f02e90b82a196336c4d3f824cf61992bedcd84c2e6f9f913baea2b6e4f4f837
+  data.tar.gz: cde0da734dd43e88f74d75dcd25b98a4e5fc20f58a15d8b07c3d3984e8c504725526309470024d0174e597ad5dd9e268540702a11418798906d7a6d4fd29eec9

data/README.md

@@ -3,6 +3,8 @@
 
 Referral marketing is one of the most powerful strategies for ecommerce sales growth. [Talkable]( https://www.talkable.com) provides a rich platform for referral marketing. You can integrate sophisticated referral marketing into your own ecommerce site using the Talkable Ruby gem for a Rails or Sinatra application.
 
+Here you can create Talkable account https://admin.talkable.com/register?self_serve
+
 ## Demo
 
 See an example application at http://github.com/talkable/talkable-spree-example.
@@ -272,7 +274,7 @@ Talkable::API::Person.update(email, unsubscribed: true)
 Talkable::API::Reward.find(visitor_uuid: '8fdf75ac-92b4-479d-9974-2f9c64eb2e09')
 ```
 
-For more information see the tests. 
+For more information see the tests.
 
 ## Questions? Need Help? Found a bug?
 

data/TUTORIAL.md

@@ -2,47 +2,21 @@
 
 ## Introduction
 
-This is the third of three tutorials that introduce referral marketing with [Talkable](https://www.talkable.com/). Referral marketing is a powerful sales driver for SaaS and ecommerce sites. Talkable is a referral marketing platform that supports the complex requirements of the largest and most sophisticated SaaS and ecommerce sites. The [first tutorial](https://railsapps.github.io/talkable-referral-marketing-basics/) introduces basic concepts using the Talkable JavaScript integration library. This tutorial introduces the Talkable API and the Talkable Ruby gem.
-
-Read the [first tutorial](https://railsapps.github.io/talkable-referral-marketing-basics/) to grasp the basic concepts you'll need to know to use the Talkable platform. This tutorial shows how to build an application with the same functionality as the first tutorial application, but instead of using the JavaScript integration library you'll use the Ruby gem and the Talkable API.
-
-The [second tutorial](https://railsapps.github.io/talkable-referral-marketing-gem/) is an older version of this one before we added an example campaign on account creation and corresponding generators in the gem. The second tutorial has more details about what happens under the hood and could still be interesting for this reason.
-
-This third tutorial will mature partly into self-serve users landing page and partly into our documentation in a course of several next releases.
+You may read the [first tutorial](https://railsapps.github.io/talkable-referral-marketing-basics/) to grasp the basic concepts you'll need to know to use the Talkable platform. This tutorial shows how to build an application with the same functionality as the first tutorial application, but instead of using the JavaScript integration library you'll use the Ruby gem and the Talkable API.
 
 ## Requirements
 
-You'll need Ruby 2.3+ and Rails 5.0+. You can integrate Talkable in your existing project right away, but a fresh Rails 5 app will also do just fine.
-You'll need only beginner skills as a Rails developer to follow this tutorial.
+Ruby 2.3+ and Rails 5.0+ (if you're using Rails).
 
 ## Create an Account
 
-First you'll need to [set up an account at Talkable](https://admin.talkable.com/register?self_serve).
-
-When asked to choose a platform, choose "other" for Rails integration. Then you can provide details such as email address and password.
-
-Your site name can be the name of your website, brand or company. You'll be able to add additional sites to your account after you create the first site.
-
-For this tutorial, set the Site URL to `http://localhost:3000/` so you can develop and test the application locally.
+First [create a Talkable account](https://admin.talkable.com/register?self_serve).
+When asked to choose a platform, choose "Other" for plain Rails integration. In order to be able to develop and test the application locally set the Site URL to `http://localhost:3000/`.
 
 ![talkable-create-account](tutorial_images/talkable-create-account.png)
 
 **An example campaign is created automatically for you.**
 
-## Fraud Settings
-
-This part of the tutorial won't be needed in a few days as we will be setting different default fraud settings, but it is needed for now.
-
-Talkable prevents common (and not-so-common) referral fraud like self-referrals. For example, for product sales sites, referral marketing isn't profitable if shoppers can give themselves discounts by entering their own alternative email addresses.
-
-For our tutorial, we'll want to enter our own alternative email addresses and visit the application using the same web browser and the same IP address. We'll change the Fraud Settings to allow this.
-
-![talkable-menu-fraud](tutorial_images/talkable-menu-fraud.png)
-
-Set the "Fraud Profiles" (in the upper left corner) to "Low." Then set each individual fraud rule for Advocate and Friend to "Skip," specifically "Matching Email or Cookie on Friend Purchase" and "Matching Cookie on Friend Claim Page." This will allow self-referrals for testing the tutorial application in your local development environment.
-
-Be sure to click the "Save Changes" button to save the fraud settings.
-
 ## Launch the Campaign
 
 You are done with the Talkable administrative interface for now and can launch your example campaign, even though your web application isn't ready yet.
@@ -61,7 +35,7 @@ Ignore any warnings, accept the defaults, and click the orange "Launch campaign"
 
 You'll see a warning, "No Integration Found." Ignore the warning. Talkable checks if an Integration script is present on a production site but our development site is not running or accessible to Talkable. Click the green "Launch Now" button.
 
-You campaign will be live and waiting for events triggered by advocates (recommendations) or friends (claiming rewards). All events generated by the Talkable JavaScript integration library will be tracked and captured by Talkable for analysis and optimization. Talkable is designed to gather all data so there is no option to erase or reset campaign data once the campaign is live. However, you can create a new campaign when you are done with experimenting and ready to deploy to production.
+Your campaign will be live and waiting for events triggered by advocates (recommendations) or friends (claiming rewards). All events generated by the Talkable JavaScript integration library will be tracked and captured by Talkable for analysis and optimization.
 
 Next, we will set up the tutorial application to use the Talkable campaign. After that, we can return to the Talkable site to see reports of all activity.
 
@@ -71,15 +45,11 @@ You can use the [Talkable Ruby Gem](https://github.com/talkable/talkable-ruby) t
 
 Add the gem to the project *Gemfile* and run `bundle install`.
 
-`gem 'talkable', github: 'talkable/talkable-ruby'`
-
-`$ bundle install`
-
-Your gem is installed. Let's configure your application.
+`gem 'talkable'`
 
 ## Get Your Site Slug and API Key
 
-The Talkable gem provides a Ruby On Rails generator for basic configuration of the gem. You'll need to know your "site slug" (a site identifier). The "site slug" can differ from your account name. The "site slug" is the alphanumeric identifier Talkable uses for your website. Your account can support multiple sites and and each has its own "site slug."
+The Talkable gem provides a Rails generator for basic configuration of the gem.
 
 ### Site Slug
 

data/lib/talkable/generators/install_generator.rb

@@ -9,6 +9,7 @@ module Talkable
     class_option :slim, type: :boolean, default: false
 
     def ask_config_values
+      puts "If you don't have Talkable account yet, create one here: \e]8;;https://admin.talkable.com/register?self_serve\ahttps://admin.talkable.com/register?self_serve\e]8;;\a"
       @site_slug  = ask("Your Talkable site slug:")
       @api_key    = ask("Your Talkable API Key:")
       if yes?('Do you have a custom domain? [Y/n]')

data/lib/talkable/version.rb

@@ -1,3 +1,3 @@
 module Talkable
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: talkable
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Talkable
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-18 00:00:00.000000000 Z
+date: 2018-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack