SaaSquatch Help Center

The guide will show you how to leverage your existing Marketo Forms to automatically add referred signups into your referral program.

πŸ”— Include SaaSquatch Library on the Page

The SaaSquatch squatch.js library is used to power the referral program tracking script. Load this library by adding the SaaSquatch Library code snippet to the <body> tag page you have the Marketo form on:

<script>!function(a,b){a("squatch","https://d2rcp9ak152ke1.cloudfront.net/assets/javascripts/v2/squatch.min.js",b)}(function(a,b,c){var d,e,f;c["_"+a]={},c[a]={},c[a].ready=function(b){c["_" + a].ready =  c["_" + a].ready || [];c["_" + a].ready.push(b);},e=document.createElement("script"),e.async=1,e.src=b,f=document.getElementsByTagName("script")[0],f.parentNode.insertBefore(e,f)},this);</script>

πŸ”— Configure Code Snippet

As the Marketo form and SaaSquatch code snippets are each unique to you there will be certain customizations that need to be made to make sure all the correct form fields get picked up and passed in to the SaaSquatch system.

πŸ”— Marketo Snippet

Marketo will provide you with a JavaScript code snippet to drop on the page where you would like the form to be displayed. We will be adding some SaaSquatch code into this snippet Marketo has provided to enable you to identify users to the SaaSquatch system right from the form.

Example Marketo Snippet:

<script src="//app-sjst.marketo.com/js/forms2/js/forms2.js"></script>
<form id="mktoForm_1057"></form>
<script>
  MktoForms2.loadForm("//app-sjst.marketo.com", "785-UHP-775", 1057, function(form){
  
  //SaaSquatch code will go here
    
  });
</script>

πŸ”— Configure Form Field Names

Depending on the names of the fields in your form the SaaSquatch code you will configure might be slightly different from the following example. In our example form we have fields named First Name, Last Name, Email. The variables for these form fields are in upper camelCase, and so will look like:

  • First Name -> FirstName
  • Last Name -> LastName
  • Email -> Email

You can easily include other fields you want to pass to the SaaSquatch system (like account ID if you collect that value) by following the camelCase naming convention: TwoWords or FirstSecond

Example form field variables:

initObj.user.id = vals.Email;
initObj.user.accountId = vals.Email;
initObj.user.email = vals.Email;
initObj.user.firstName = vals.FirstName;
initObj.user.lastName = vals.LastName;

πŸ”— Configure SaaSquatch Tenant Alias

The tenant alias for you referral program determines which of the live or test tenant of your referral program your Marketo form will be sending data to. We recommend making use of your test tenant right up until you are ready to expose your referral program to your customers. More information on when to use which tenant alias can be found in our Testing Best Practices article.

The following example shows configuring your Marketo code snippet with an example test tenant alias.

squatch.init({
  tenantAlias: 'test_ae7bygqkh9gag'
});

πŸ”— Add SaaSquatch Snippet into Marketo Form Code

The form variables and SaaSquatch tenant alias can now be substituted into the SaaSquatch code snippet:

form.onSuccess(function(values, followUpUrl) {

  //get the form field values
  var vals = form.vals();
  window.squatch.ready(function(){

    //configure squatch.js for the tenant you are using
    squatch.init({
      tenantAlias: 'test_ae7bygqkh9gag'
    });

    //object containing the init parameters for squatch.js
    var initObj = { user: { } };
    
    initObj.user.id = vals.Email;
    initObj.user.accountId = vals.Email;
    initObj.user.email = vals.Email;
    initObj.user.firstName = vals.FirstName;
    initObj.user.lastName = vals.LastName;

    squatch.api().upsertUser(initObj).then(function(response) {
      user = response.user;
    }).catch(function(error){
      console.log(error);
    })
  });
  
  setTimeout(function() { waitForSquatch(); }, 1500);

  function waitForSquatch(){
    location.href = followUpUrl;
  }

  return false;
  
});

Now drop the configured SaaSquatch code snippet into your Marketo form code snippet:


  <script src="//app-sjst.marketo.com/js/forms2/js/forms2.js"></script>
<form id="mktoForm_1057"></form>
<script>
  MktoForms2.loadForm("//app-sjst.marketo.com", "785-UHP-775", 1057, function(form){
  
  //SaaSquatch code goes here
    
  });
</script>

πŸ”— Configure Tenant Security Settings

From the SaaSquatch Admin Portal, navigate to the install page. Change the Secure mode to β€œCustom” and make sure that the β€œCreate/Update User” option is disabled.

This will allow you to submit user information from the Marketo from to the SaaSquatch system without your website having to sign the request using a JWT generated from your SaaSquatch API key. More information about Secure Mode can be found on our Signed Requests page in our docs.

Highlighted Disable Upsert Method

πŸ”— What's next?

Congratulations on connecting up your marketo form to your Referral Program! For further details about how to go about installing your referral program please check out our Quickstart Referral Program Install Guide.

Explore more of the configuration options available in the SaaSquatch Portal in our Using Referral SaaSquatch article.