Tracking Setup

Learn how to track referrals and conversions with Refgrow

How Tracking Works

Refgrow uses a combination of URL parameters and cookies to track referrals and attribute conversions accurately. Here's how it works:

1. Referral Link

Affiliate shares their unique referral link with the ref parameter.

2. Click Tracking

When someone clicks the link, Refgrow records the click and sets a tracking cookie.

3. Conversion

When the user converts (signs up, makes a purchase), the conversion is tracked.

4. Attribution

The conversion is attributed to the affiliate based on the tracking cookie.

Setting Up Basic Tracking

1. Add Tracking Script

First, add the Refgrow tracking script to your website:

<!-- Add this before the closing body tag -->
<script src="https://refgrow.com/js/tracking.js"></script>

2. Track Conversions

There are several ways to track conversions with Refgrow:

Manual Tracking

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

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

Parameters:

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

Integration with Payment Processors

Stripe Integration

To integrate with Stripe:

  1. Go to your project settings
  2. Click "Create Stripe API Key" button
  3. Copy the generated API key
  4. Paste it back in the settings
Note: The system will automatically configure webhooks and start tracking your Stripe payments.

Lemonsqueezy Webhook Setup

  1. Go to your Lemonsqueezy Dashboard > Settings > Webhooks
  2. Click "Add webhook"
  3. Set the webhook URL to: https://refgrow.com/api/webhook/lemonsqueezy/YOUR_PROJECT_ID
  4. Replace YOUR_PROJECT_ID with your actual project ID
  5. Select the following events:
    • order_created
    • subscription_created
    • subscription_updated
  6. Click "Create webhook" to save

Ensure you have set your Lemonsqueezy API Key in your project settings.

Cookie Lifetime Configuration

You can configure how long the referral tracking cookie lasts in your project settings:

  1. Go to your project settings
  2. Find the "Cookie Lifetime" setting
  3. Set the number of days you want the tracking cookie to last
  4. Save your settings

The default cookie lifetime is 30 days. This means that if a user clicks an affiliate link and makes a purchase within 30 days, the affiliate will receive credit for the conversion.

Setting Up Your Tracking Domain

For optimal tracking, you can configure a custom tracking domain:

  1. Go to your project settings
  2. Find the "Tracking Domain" setting
  3. Enter your domain (e.g., yourdomain.com)
  4. Save your settings

Using your own domain for tracking can improve conversion rates and build trust with your customers.

Best Practices

Security
  • Ensure your tracking script is loaded over HTTPS
  • Validate conversion data on your server
  • Review tracking logs regularly
  • Keep your API keys secure
Performance
  • Place the tracking script near the end of your HTML
  • Track the most valuable conversion points
  • Test your tracking setup thoroughly
  • Monitor tracking for any issues

Important Notes

  • The tracking.js script must be included on all pages where you want to track referral clicks and conversions.
  • For manual tracking, ensure that you call the Refgrow function after the tracking script has loaded and when you're certain the conversion has occurred.
  • Handle any errors that may occur during the tracking process to ensure a smooth user experience.
  • You can change the conversion tracking method in your project settings at any time.

Next Steps

Stripe Integration

Set up automatic commission tracking with Stripe.

View Guide
Webhooks

Learn about real-time notifications for tracking events.

View Guide
Dashboard Integration

Add the affiliate dashboard to your website.

View Guide
Widget Stripe Integration