Installation Guide

Integrate Refgrow into your website or application

Overview

Integrating Refgrow into your website or application is straightforward. This guide walks you through the process of adding the necessary code to set up your affiliate program.

The installation consists of two main parts:

  1. Adding the Affiliate Dashboard to your website
  2. Setting up conversion tracking

Adding the Affiliate Dashboard

The affiliate dashboard is where your affiliates will track their referrals, get their links, and access promotional materials.

Option 1: With User Authentication

If your website has user authentication, use this code to automatically associate the dashboard with the logged-in user:

<div id="refgrow" data-program-id="YOUR_PROGRAM_ID" data-program-email="user@example.com"></div>
<script src="https://refgrow.com/js/page.js"></script>

Parameters:

  • data-program-id: Your unique program ID (find this in your Refgrow dashboard)
  • data-program-email: The email of the currently logged-in user (should be dynamically populated with your user's email)

Option 2: Without User Authentication

If you don't have user authentication or want to use Refgrow's built-in authentication, use this simpler code:

<div id="refgrow" data-program-id="YOUR_PROGRAM_ID"></div>
<script src="https://refgrow.com/js/page.js"></script>

Parameters:

  • data-program-id: Your unique program ID (find this in your Refgrow dashboard)

With this option, users will need to sign in or register through the Refgrow interface.

Complete Page Example

Here's a complete HTML page example that includes the Refgrow dashboard:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Affiliate Program</title>
</head>
<body>
    <h1>Our Affiliate Program</h1>
    
    <!-- Refgrow Dashboard Integration -->
    <div id="refgrow" data-program-id="YOUR_PROGRAM_ID"></div>
    <script src="https://refgrow.com/js/page.js"></script>
</body>
</html>

Setting Up Conversion Tracking

To attribute conversions to your affiliates, you need to add tracking code to your website. Refgrow offers several methods for tracking conversions:

1. Basic Tracking Script

Add this script to all pages of your website, ideally in the <head> section:

<script src="https://refgrow.com/js/tracking.js" data-program-id="YOUR_PROGRAM_ID"></script>

This script handles referral link detection and cookie placement for proper attribution.

2. Manual Conversion Tracking

After adding the basic tracking script, you can manually track conversions by calling the Refgrow function:

// Track a signup (no monetary value)
Refgrow(0, 'signup', 'user@example.com');

// Track a purchase with a monetary value
Refgrow(99.99, 'purchase', 'user@example.com');

Parameters:

  1. value: The monetary value of the conversion (use 0 for non-monetary conversions like signups)
  2. type: The type of conversion ('signup' or 'purchase')
  3. email: The email of the user who completed the conversion

Place this code on your thank you page, after successful checkout, or whenever a conversion happens.

3. Stripe Integration

For automatic tracking of Stripe payments:

  1. Go to your program settings in Refgrow dashboard
  2. Navigate to the "Integrations" tab
  3. Select "Stripe" as your conversion tracking method
  4. Follow the instructions to connect your Stripe account

Once connected, Refgrow will automatically track purchases made through Stripe.

4. LemonSqueezy Integration

For LemonSqueezy integration:

  1. Go to your program settings in Refgrow dashboard
  2. Navigate to the "Integrations" tab
  3. Select "LemonSqueezy" as your conversion tracking method
  4. Enter your LemonSqueezy API key
  5. Set up a webhook in your LemonSqueezy dashboard pointing to:
    https://refgrow.com/api/webhook/lemonsqueezy/YOUR_PROGRAM_ID

Testing Your Installation

After setting up Refgrow, you should test that everything is working correctly:

  1. Create a test affiliate account
  2. Generate a referral link
  3. Click the referral link and verify that the cookie is set (you can check your browser cookies)
  4. Complete a test purchase or signup
  5. Verify that the conversion appears in your Refgrow dashboard

Troubleshooting

Common Issues

Referrals Not Being Tracked
  1. Ensure the tracking script is added to all pages
  2. Check that your program ID is correct
  3. Verify that third-party cookies are not blocked by the user's browser
  4. Ensure the conversion tracking code is properly implemented
Dashboard Not Loading
  1. Check that the program ID is correct
  2. Ensure there are no JavaScript errors on your page
  3. Verify that the page.js script is loading properly

Next Steps

After completing installation:

  1. Configure your program settings to match your requirements
  2. Set up your commission structure
  3. Customize the affiliate dashboard
  4. Set up your payout preferences
Quick Start Programs