Skip to main content

JavaScript v3 Tracking (Deprecated)

Deprecated — do not use for new integrations

JavaScript v3 tracking is fully deprecated and is no longer maintained. It is documented here for reference only, to support merchants who still have it installed.

Build every new integration on JavaScript v4 tracking (client-side) or server-side tracking. If you are still running v3, migrate to one of those.

Client-side tracking reports orders from the shopper's browser, using JavaScript on your "Thank You" page. Everything below describes the legacy v3 tracker.

Step 1 — Track visits​

Copy the following code into the <head> section of every page on your site where you expect affiliates to drive traffic. Replace YOUR-PUBLIC-KEY with the Public API key from your Refersion account.

<!-- REFERSION TRACKING: BEGIN -->
<script src="//www.refersion.com/tracker/v3/YOUR-PUBLIC-KEY.js"></script>
<script>_refersion();</script>
<!-- REFERSION TRACKING: END -->

Step 2 — Send orders from your "Thank You" page​

Add the code below to your "Thank You" or confirmation page — the page every customer reaches after completing an order. Use it as a starting template.

Within this code you must insert the customer's transaction information dynamically from the order. The sample values below are placeholders. Not all fields are required, but all are recommended; each one is described in Variable descriptions.

For best performance, place this code just before the </body> tag in your HTML, remembering to replace YOUR-PUBLIC-KEY with the Public API key from your Refersion account.

Same domain and security level

For tracking to function, the click-tracking code from Step 1 and the code below must run on the same domain and security level (http/https).

<!-- REFERSION TRACKING: BEGIN -->
<script src="//www.refersion.com/tracker/v3/YOUR-PUBLIC-KEY.js"></script>
<script>
_refersion(function(){

	_rfsn._addTrans({
		'order_id': '12345',
		'shipping': '11.90',
		'tax': '5.23',
		'discount': '2.32',
		'discount_code': 'TESTCOUPON',
		'currency_code': 'USD'
	});

	_rfsn._addCustomer({
		'first_name': 'Nancy',
		'last_name': 'Parker',
		'email': '[email protected]',
		'ip_address': '808.53.77.22'
	});

	_rfsn._addItem({
		'sku': 'DD23444',
		'quantity': '2',
		'price': '100'
	});

	_rfsn._addItem({
		'sku': 'XJ66778',
		'quantity': '3',
		'price': '50'
	});

	_rfsn._addItem({
		'sku': 'MP39592',
		'quantity': '2',
		'price': '1000'
	});

	_rfsn._sendConversion();

});
</script>
<!-- REFERSION TRACKING: END -->

Variable descriptions​

Transaction data​

A transaction represents the entire order that occurred, and contains the following values:

ValueTypeRequiredDescription
order_idStringYesUnique shopping-cart order ID or transaction number used to reference the purchase you're reporting.
shippingNumberNoTotal shipping and handling the customer was charged for the order.
taxNumberNoTotal tax the customer was charged for the order.
discountNumberNoTotal in discounts that were applied to the order.
discount_codeStringNoThe discount or coupon code that was used on the order.
currency_codeStringYesThe three-letter currency code of the order totals you are reporting. Example: USD, CAD, GBP.

Customer data​

A customer represents the individual who purchased, and contains the following values:

ValueTypeRequiredDescription
first_nameStringNoCustomer's first name.
last_nameStringNoCustomer's last name.
emailStringNoCustomer's email address.
ip_addressStringNoThe IP address of the customer.

Item data​

An item represents an individual product the customer ordered, and contains the following values:

ValueTypeRequiredDescription
skuStringYesA unique product SKU or identifier. Can be blank, but we highly recommend populating it.
quantityNumberYesTotal quantity ordered of the product.
priceNumberYesPrice of each item. For example, if the customer ordered 10 items at $5 each, report 5, not 50. Do not include currency symbols.