Visit www.talkable.com

SaaS Integrations

Note

We offer separate integration script for each Enterprise site. This allows us to better support integration individually.

Please contact us if you are planning to integrate your Enterprise site.

SaaS integration is abstracted from E-Commerce since you need to create referrals based on your specific business logics while E-Commerce can work only with store purchases. With such abstraction you can register Talkable Event with just a few parameters:

  • Event Category to describe what type of action was made. For example: “User Registered”. All Events appear inside Events Report where you can sort/filter/segment them based on the Event Category or based on any other data you pass along.
  • Event Number. This is a unique action ID that will be stored in Talkable.

1. Add Talkable to Your Site

In order to integrate Talkable campaign(s) on your site you need to set the following script into HEAD tag inside your main layout which is used on every page. This is initialization of the Talkable JS integration library:

<!-- Begin Talkable integration code -->
<script>
  window._talkableq = window._talkableq || [];
  _talkableq.push(['init', {
    site_id: 'YOUR-TALKABLE-SITE-ID' // Required - Talkable Site ID, you can find it on the Dashboard inside Talkable upon login
  }]);

  _talkableq.push(['authenticate_customer', {
    email: 'customer@example.com', // Optional - Customer email, it is recommended to always pass it when available
    first_name: 'Name', // Optional - Customer first name
    last_name: 'Surname' // Optional - Customer last name
  }]);
</script>
<script src="//d2jjzw81hqbuqv.cloudfront.net/integration/talkable-3.0.6.min.js" type="text/javascript"></script>
<!-- End Talkable integration code -->

2. Add Talkable Campaigns

Below is an example of registering an Event and showing Campaign for Post Purchase Placement as a result:

<!-- Begin Talkable integration code -->
<div id="talkable-offer"></div>

<script>
  var _talkable_data = {
    event: {
      event_number: '100011', // Required - unique Event id
      event_category: 'signups' // Required - Event category
    },
    campaign_tags: ['post-purchase'] // Loads Post Purchase campaign with tag "post-purchase"
  };

  // Passing Event to Talkable
  _talkableq.push(['register_event', _talkable_data]);
</script>

The code above registers an Event and shows Advocate Signup Page as a result.
When the Event is registered successfully it appears inside Events Report.


Showing Different Campaign

In the example above we show Campaign for Post Purchase Placement as a result of Event registration. However you can show any other Talkable Campaign instead since there are many of them. Here is an example how to show Campaign for Standalone Placement

<!-- Begin Talkable integration code -->
<div id="talkable-offer"></div>

<script>
  var _talkable_data = {
    event: {
      event_number: '100011', // Required - unique Event id
      event_category: 'signups' // Required - Event category
    },
    campaign_tags: ['invite'] // Loads Invite campaign with tag "invite"
  };

  // Passing Event to Talkable
  _talkableq.push(['register_event', _talkable_data]);
</script>

Note

Talkable JS integration library inserts the iframe into a container DIV with id=”talkable-offer”. Campaign Tags are show either on Campaigns listing page below each campaign’s name or right on Details page of any campaign, inside “Integration” area.

Advanced Features

Here is a full list of Advanced Talkable features.