Integrating Refersion with your Uscreen account is a quick way to set up affiliates and referral programs. Refersion is compatible with Stripe and PayPal transactions. Using the link above you can get an extended free trial for 30 days to try out Refersion.
First, we'll want to grab the keys we need from Refersion.
In Refersion, navigate to Account > Settings. Under Tracking, click Add Tracking and then select Refersion API Tracking.
Keep this tab open while we add them into Uscreen.
Navigate to Settings > Integrations and click Connect under Refersion. Paste the keys and subdomain in from your Refersion account and click Connect.
Make sure you've set up your affiliate tracking in order to properly track data sent by Uscreen. You will likely want to set up SKUs. Here's Refersion's documentation on SKUs.
Technical specs of the payload that is sent to Refersion
The information that gets sent to Refersion on the payload is detailed below
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
}
]
}
Commonly Asked Questions
1. How can I obtain SKUs for products for affiliate tracking?
The SKU is constructed of the following two parts: {content_id OR offer_id}-{product type}, with content_id or offer_id being an integer and product type being a string.
The {content_id} can be obtained from the checkout process. Proceed to checkout the content as a non-signed-in user. From there, look in the URL bar for something like this ".../orders/checkout?c=343365" as that would be the numbers you want to use for your {content_id}.
If you are tracking a video, live event, or collection, the product type will be Content. If you are tracking a subscription or bundle, the product type will be Offer.
For a subscription, you can get the {offer_id} from the checkout process. Proceed to checkout the content as a non-signed-in user. From there, look in the URL bar for something like this ".../orders/customer_info?o=24229" as that would be the numbers you want to use for your {offer_id}.
It's possible that if you have content assigned to be either a one-time purchase or part of a subscription, that you need to click on the respective subscription, then click on Continue, to see the subscription's offer id in the url. This might look something like this ".../orders/customer_info?o=24229&c=343365", in which case, you still want the number behind the "o=..." for the {offer_id}.
Taking an example {content_id} from one of the above examples for a video, the SKU would look like this:
343365-Content
For a subscription or bundle, the SKU will look similar to this:
24229-Offer
2. When is conversion data sent to Refersion?
Data is sent to Refersion upon a successful transaction. This includes a trial with a $0.00 price associated with the transaction, transactions with a price greater than $0.00, and transactions where a coupon code has been applied - whether the total after discount is $0.00 or greater. If you have a subscription, and you are crediting the affiliate for the recurring orders, recurring orders will also be sent to Refersion for affiliate crediting.