Refersion is a powerful affiliate marketing platform that integrates with Uscreen to help you manage your affiliate network and track referrals.

This integration works with both Stripe and PayPal transactions, giving you flexibility in how you process payments from referred customers.

Set Up Refersion with Uscreen

Step 1: Obtain Your Refersion API Keys

In Refersion

Navigate to Account > Settings
Go to the Tracking section
Click Add Tracking
Select Refersion API Tracking from the options
Copy the generated details and keep this browser tab open, as you'll need this in the following steps

Step 2: Connect Refersion to Uscreen

In Uscreen

Navigate to Settings > Integrations
Find Refersion and click Connect
Enter the API keys and subdomain from your Refersion account
Click Connect to finalize the integration

Step 3: Enable v4 Tracking in Refersion

To use Refersion's v4 JavaScript tracking with your Uscreen site:

Go back to the Refersion browser tab you've kept open
Click Continue with the Refersion API
Click the toggle option to enable V4 Tracking
Click Save Changes

📝 NOTE: Refersion V4 Tracking is required for the integration to work properly with Uscreen. If URL-based conversions aren't firing, ensure that V4 tracking is enabled in your Refersion account.

Refersion V4 Tracking

Refersion's V4 tracking is their latest client-side tracking system that offers improved performance and reliability over previous versions.

Key differences include:

Enhanced tracking capabilities across different browsers and devices
Improved handling of ad blockers and privacy settings
Better support for modern web technologies and frameworks
More reliable conversion tracking for affiliate referrals

ℹ️ INFO: The V4 tracking script is automatically added to all pages of your Uscreen site when the integration is enabled, ensuring comprehensive tracking of user interactions and conversions.

Set Up SKUs for Tracking

For proper tracking, it's recommended to set up SKUs (Stock Keeping Units) in Refersion. SKUs are constructed using the format:

{content_id OR offer_id}-{product type}

Getting the Content and Offer IDs

For instructions on how to obtain these IDs of your content and offers, please refer to our documentation.

Unique IDs in Uscreen

Product Type Formats

Video: -video
Live Event: -live_event
Collection: -collection
Subscription/Bundle: -offer

Your final SKU might look like 12345-offer or 12345-video.

💡 TIP: For more detailed guidance on setting up SKUs, please also have a look at Refersion's official documentation.

Refersion: SKU Conversion Triggers

Technical Details: Data Sent to Refersion

When a transaction occurs, Uscreen sends the following information to Refersion:

params = {
  cart_id: invoice.user.uid,
  order_id: invoice.id,
  currency_code: invoice.currency,
  customer: { email: invoice.user.email },
  items: [
    {
      name: invoice.product&.title,
      price: Money.new(invoice.original_price).to_f,
      sku: "#{invoice.product&.id}-#{invoice.product.class}",
      quantity: 1
    }
  ]
}

ℹ️ INFO: This payload ensures that Refersion can properly track and attribute sales to your affiliates.

Conversion Data Tracked in Refersion

The conversion data is sent to Refersion after successful transactions, including:

Transactions with any positive amount (including those with applied discounts)
Trials, even if the transaction amount is $0.00
Recurring orders for subscriptions (if you're crediting affiliates for these)

FAQs

How does Refersion compare to Rewardful?

Both Refersion and Rewardful allow you to manage your affiliate network and track referrals. The primary difference is that Rewardful works exclusively with Stripe, while Refersion works with both Stripe and PayPal.

Does Refersion support coupon codes?

While Refersion offers various tracking options, you'll need to create the coupons in Uscreen and find a method for these Uscreen coupons to be readable within Refersion. You can create the coupons directly in Uscreen and then have affiliates share those along with their affiliate links. 🔗 Learn more about Automatically Applying Coupon Codes via URL

Can I use Refersion with mobile app purchases?

The Refersion integration primarily tracks web-based purchases. Mobile app purchases through app stores may not be properly tracked through the standard Refersion integration.

What happens if a user has an ad blocker?

External plugins like ad blockers can interfere with the proper functioning of Refersion scripts. If users are experiencing difficulties with tracking, recommend that they temporarily disable their ad blocker. Refersion's V4 tracking is built to be more resilient and efficient, unlike its predecessors, which are more susceptible to issues with ad-blockers that disrupt traditional third-party tracking.

Does Refersion track gross or net price?

Refersion calculates referral commissions based on the net price. If a coupon is used during checkout, Refersion will calculate the commission using the discounted price.

Integrations Overview

Google Tag Manager Integration

Zapier Integration

Rewardful Integration

Marketing Overview

Refersion Integration