Custom Website Integration Guidelines

Integrating your Incentivit referral program with your custom website is simple. Here is a step-by-step tutorial to setup and integrate Incentivit into your website and track referrals.

 

Scripts Integration

Setting up your referral program

If not already done, setup your referral program through your Incentivit account. Incentivit has an easy-to-use step-by-step wizard to facilitate your referral program configuration.
When integrating your Incentivit referral program to your custom website, you need to implement the following 3 different scripts.

 

1. The ambassador dashboard script

This script allows you to display our widget on your website so your customers can register to your referral program and share with their friends. Note that you can bypass the Register/Login widget page and automatically redirect users to the widget ambassador’s dashboard page, see this widget auto sign-in tutorial for details.

 

Scenario #1 – widget displayed as an iframe on a dedicated page

  • Add a new page to your website where you will display our widget. You will need someone with programming skill to add a new page to your website as it is a general good practice to have a dedicated page for your referral program.
  • Copy and paste the “iframe” script located in your Incentivit account under Integration tab (Advocates Widget script) of your referral program on the dedicated page you will have added. We recommend adding a page within the customer’s account especially if you want to automatically sign-in your customers to the referral program.

Scenario #2 – widget displayed as a popup site wide

  • If you want your referral program to be accessible from one specific page, locate the specific page file within your website source code. Copy and paste the “popup” script located in your Incentivit account under Integration tab (Advocates Widget script) of your referral program in the footer section of your website right before the closing body tag .
  • If you want your referral program to be accessible from every pages, locate a page or a section that will be loaded throughout your website i.e. footer section. Copy and paste the “popup” script located in your Incentivit account under Integration tab (Advocates Widget script) of your referral program in the file you located.

2. Referrals tracking script

This script keeps track of referrals landing on your website after clicking a url shared by your ambassadors.

Copy and paste the javascript tracking code located in your Incentivit account under Integration tab (Referrals Widget script) of your referral program on the Referral redirect url of your website. You can find the Referral redirect url under the referral page located under the Configuration tab of your referral program.

3. Conversion Tracking script

This script tracks conversion (purchases) of customers referred by your ambassadors. This script should be placed in the purchase confirmation page. You can find the Conversion Tracking script in your Incentivit account under Integration tab (Advocates Widget script) of your referral program.

Append the script code anywhere towards the end of the file. Your tracking conversion script already contains your [YOUR PROGRAM_ID] and [YOUR KEY] so just make sure to replace the {{TO BE PROVIDED BY YOU}} with information from the current customer on your website.