FirstPromoter Integration Overview

FirstPromoter Introduction:

Spiffy now directly integrates with FirstPromoter as one of our options for affiliate programs. You will be able to connect your FirstPromoter account using your FirstPrmoter Account ID & API key, and our integration found in your Spiffy Account Settings>Integrations. You will then be able to create "Campaigns" in your FirstPromoter account, using Spiffy checkout URLs, and add your affiliates to these campaigns.

This article will go over the following:

  • Installing FirstPromoter's 'Main Tracking Code" on all of your site pages (This will be used if affiliate traffic is being sent to a sales page on your site, or if you are using embedded checkouts)
  • Connecting your FirstPromoter account to your Spiffy account
  • Setting offers to 'Commissionable' in Spiffy

Install FirstPromoter's Main Tracking Code on ALL of your site pages

If you are using embedded checkouts, or directing traffic to a sales page that has redirects, you will want to ensure that you install tracking code from FirstPromoter on all of your site's pages. This will ensure that FirstPromoter can create tracking cookies for your visitors who come via referral traffic.

Head to your FirstPromoter account, click on 'Settings' and click the 'Integrations' tab. Then, click on the 'Setup Instructions and Testing' button

Grab the code from the section labeled 'Adding the main tracking script'. If you have already set up your first promoter integration, just click the 'Go Back' button until you reach this section, and can copy the code.

Copy the 'Main Tracking Script' and paste it on ALL pages of your site. This will ensure that FirstPromoter can create the tracking cookie, when referral traffic comes to your site. If this code is missing from a page that a referral visits, this could cause a disconnect in tracking, meaning your affiliate will not get credit for a sale

Next, we will cover setting up the FirstPromoter integration in Spiffy.

Connecting your FirstPromoter account to Spiffy:

You will need to have your FirstPromoter 'Account ID' and 'API Key' from your Settings>Integrations in FirstPromoter. Head to your FirstPromoter account, click on 'Settings' and click on the 'Integrations' tab to obtain this information.

From the Spiffy Dashboard, click on the Profile icon, and select 'Integrations'

Find and click on 'FirstPromoter' from the list of available integrations

Enter your FirstPromoter 'Account ID' and 'API Key' that you obtained from your FirstPromoter account settings.

Click 'Connect FirstPromoter'. You should see a confirmation at the top of the page, letting you know that FirstPromoter has been successfully connected.

Marking Subscriptions, Line Items, and Upsells as Commissionable:

A big part of setting up your affiliate program is setting products to commissionable in Spiffy. In this section, we will show you how to set these products to be tracked for affiliate commissions.

Standard Checkout offers, and Upsells will be able to be set to commissionable from within your Spiffy Checkout editors, but Subscriptions will need to be set to commissionable in the account level 'Subscriptions' tab found on the Spiffy Dashboard. 

After you enable commissions on a Checkout Item, Subscription, or Upsell, you will see an indicator, letting you know that this is enabled.

(Order summary edit / Preview)

Here is a quick overview on marking your offers as commissionable

Setting Subscriptions to Commisionable:

From the Spiffy Dashboard, click on the 'Subscriptions' tab

Find and click on the Subscription product that you would like to mark as commisionable

Click on the 'Settings' icon in the Subscription dashboard and just tick the 'Is this product on commission?' checkbox and 'Save'.

Now, all plans for this subscription product will be set to commissionable. This will automatically update any checkouts that these subscription plans may be a part of. If you create any new plans for this specific subscription product, they will automatically be marked as commissionable, as well.


Setting Standard Checkout Items & Add-on Offer Bumps to Commissionable:

After setting up your checkout, click on the Order Summary in the editor

To the right of your standard offers, click the settings '. . .' and select 'Commission'. (This option will be available in the order summary, for your standard offers and add-on offer bumps)

Republish your checkout to save your changes

Setting an Upsell Item to Commissionable:

In the Upsell editor of your checkout, click to expand your Upsell product, in the sidebar.

Check the 'Is item on commission?' checkbox. 

Click 'Save' at the top of the settings sidebar.

Republish your checkout, so that the changes will take effect


Questions? Let us know at Support@Spiffy.co