Integrating Sailthru JavaScript with Google Tag Manager

If you use Google Tag Manager to manage the third-party JavaScript embedded on your site, it is easy to configure Sailthru’s script tags and the associated functions you wish to include. For example, you can capture user-signup data from forms, log a purchase or cart update, or send a custom event to Sailthru, initiating a Lifecycle Optimizer flow.

For a list of all available functions, see the Sailthru JavaScript API Library.

The instructions on this page require that you have already configured a Google Tag Manager container for Sailthru JavaScript on your site. Then, no matter which Sailthru functions you choose to use, you’ll start by adding Sailthru’s JavaScript tag in Google Tag Manager as described below.

Note that these instructions include the same Sailthru JavaScript tag that is typically used to track user pageviews and spider your content. Ensure that this is the only instance of the Sailthru JavaScript that you have embedded. For more information on the Sailthru JavaScript see Personalization Engine Setup and the additional functions listed in the Sailthru JavaScript API Library. Google Tag Manager is not recommended if you are using Sailthru’s Site Personalization Manager.

For more information on how Google Tag Manager works, see Google’s Quick Start Guide.

Add the Sailthru JavaScript Tag

No matter which JS API functions you will include, you will need to create a tag that includes the external Sailthru JavaScript.

  1. In Google Tag Manager, click New Tag, then change the tag’s name from “Untitled Tag” to “Sailthru JS”.
  2. Click Tag Configuration, then select the tag type Custom HTML, which allows HTML and/or JavaScript code.
    • If you intend to use all of the default functionality–no additional functions to manually track pageviews, add tags to content, or exclude content from being spidered–then copy the default code below and paste it into the HTML box.

      <script src="https://ak.sail-horizon.com/spm/spm.v1.min.js"></script>
      <script>
      Sailthru.init({"customerId":'<Your Customer ID>'});
      </script>
    • If you require any of the non-default “configured behaviors” specified in the Personalization Engine Setup page, you may need to add additional parameters to the object you are passing in Sailthru.init, along with some additional functions covered on that page. For example, if you will want to manually track pageviews, you can disable automatic pageview tracking by pasting the following code into the HTML box, instead.

      <script src="https://ak.sail-horizon.com/spm/spm.v1.min.js"></script>
      <script>
      Sailthru.init({"customerId":'<Your Customer ID>', "autoTrackPageview":false});
      </script>

      You would then need to follow our instructions for the additional required Sailthru.track tag on the Manually Track Pageviews page.

  3. In the newly pasted code, replace <your customer id> with your Sailthru Customer ID, which you can find on the API and Postbacks Settings page in My Sailthru.
  4. Click Save.
  5. Select the Add Trigger option and click the default All Pages trigger.
    gtm all pages, page view
    The tag will load on all pages across your site that contain the Google Tag Manager tag.
  6. At the top-right, click Save.

That’s it, you’re all set up and ready with the Sailthru JS Tag and you now have access to all the JavaScript functions as well as tracking of pageviews and building interest profiles for your users. For complete details about the Sailthru JS Tag review the documentation.

Additional Configuration for Function Examples

To run the examples in this section using Google Tag Manager, we have created a simple JS function to capture button clicks for forms that contain a CSS class called ajax. The code will load jQuery and some additional code to fun the functions used in the examples. Note that all the Sailthru JS functions support onSuccess and onError methods so that you can validate the tags are working as expected. We have included a simple displayMessage function that will log these messages to the console.

Code to Capture Button Clicks

Using the instructions below, add this code to your site to enable testing with Sailthru’s examples. On your own web site you may have an existing JavaScript library or event handler. You may adjust all examples accordingly to meet your needs.

  1. In Google Tag Manager, click New Tag, then change the tag’s name from “Untitled Tag” to “Sailthru JS”.
  2. Click Tag Configuration, then select the tag type Custom HTML, which allows HTML and/or JavaScript code.
  3. Copy the code sample below and paste it into the HTML box.
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
    <script type="text/javascript">
      
        function displayMessage(title, message) 
              console.log(title + message);
            }
      
            $(function() {
                
                /* ---------------------------------------------------------
                 * For this demo every example uses a button to fire the test
                 * to define if a button should make an ajax request add a 
                 * css class "ajax" to the button. 
                 */
    
                $("button").click(function(e){
    
                    // check the button has an Id
                    if (e.target.id.length > 0) {
                        
                        var btn = '#'+e.target.id;
    
                        if ($(btn).hasClass('ajax')) {
                            e.preventDefault();
                            console.log('Ajax Request');
    
                            var req = $.ajax( "/gtm/form" )
                            .done(function() {
                                console.log("Form submitted for a 200 response");
                            });
                        } 
                    }
                });
    
            });
        </script>
  4. Click Save.
  5. Select the Add Trigger option and click the default All Pages trigger.
    gtm all pages, page view
    The tag will load on all pages across your site that contain the Google Tag Manager tag.
  6. At the top-right, click Save.

Enable Additional Variable Types

When you configure the Google Tag Manager triggers (such as button clicks), you will need to select variable types that are hidden, by default. To ensure that the necessary variable options are displayed:

  1. From your Workspace screen, click Variables in the navigation menu on the left.
  2. Click the Configure button.
  3. Scroll down to the Clicks section and ensure that Click ID is selected.
    Screen Shot 2017-05-08 at 6.23.39 PM

Examples

The following examples can help you get started implementing Sailthru’s JavaScript functions in Google Tag Manager.

Manually Track Pageviews

Record User Signups

Record User Signups and Send Confirmed Opt-In Emails

Add an Item to a Cart

Record a Purchase

Fire a Custom Event to Start a Lifecycle Optimizer Flow

 

Top