Tracking Order Amounts: Advanced - Revision history

Admin at 15:22, 26 February 2016

2016-02-26T15:22:54Z

Admin at 22:32, 25 January 2011

2011-01-25T22:32:22Z

Admin: Created page with 'How to set up ConversionRuler commerce tracking snippets. To pass financial information to our servers you will need to modify the “order snippet”. This will generally r…'

2009-09-17T16:12:10Z

Created page with 'How to set up ConversionRuler commerce tracking snippets. To pass financial information to our servers you will need to modify the “order snippet”. This will generally r…'

New page

How to set up ConversionRuler [[commerce tracking]] snippets.

To pass financial information to our servers you will need to modify the “order snippet”. This will generally require some coding in the technology that your shopping cart uses.

The [[Tracking Snippet]] page allows you edit your snippet to add values you have configured.
==Technical Documentation==

The tracking snippet needs to be modified with the values for the orders that you might track. Two [[JavaScript]] variables are recognized by ConversionRuler.

The basic change you need to make is filling in the '''ORDER_AMOUNT''' and '''ORDER_NUMBER''' values:

<code>
var cramount = ''''ORDER_AMOUNT''''; 
var crtext = ''''ORDER_NUMBER''''; 
cr_track('3'); 
</code>

Because "'''cramount'''" and "'''crtext'''" are Javascript values, they can be defined anywhere on the page prior to invoking our snippet.

It is best to quote them with single quotes to avoid JavaScript errors.

== Microsoft Active Server Pages Example ==
For example, if you are using Microsoft Active Server Pages, your snippet may look like this:

<code>
var cramount = ''''<%= oRS("subtotal") %>''''; 
var crtext = ''''<%= oRS("order_id") %>''''; 
cr_track('3'); 
</code>

== PHP Example ==
If you are using PHP in your server, you snippet may appear like this:

<code>
var cramount = ''''<?= $order['subtotal'] ?>''''; 
var crtext = ''''<?= $order['id'] ?>''''; 
cr_track('3'); 
</code>

When your pages generate, the final page should look like this for an order of $199.99 with order number 2369:

<code>
var cramount = '199.99'; 
var crtext = '2369'; 
cr_track('3'); 
</code>

== JavaScript-only Example ==

Some shopping carts actually generate JavaScript variables with the order amount and order number in them already on the page, in which case no quoting is required:

<code>
var cramount = CAOrderSubTotal; 
var crtext = CAOrderID; 
cr_track('3'); 
</code>

All variables are optional, so to just include the order amount:

<code>
var cramount = '199.99'; 
cr_track('3'); 
</code>

== Comprehensive Example ==
And, as a final example, you can pass up to four different amounts and strings with each action:

<code>
var cramount0 = "USD $33.55"; 
var cramount1 = "$5.34"; 
var cramount2 = "$2.33"; 
var cramount3 = "$512.23"; 
var crtext0 = "ORD1850-6923942639234"; 
var crtext1 = "john-doe@example.com"; 
var crtext2 = "2009-05-30 44:33:22"; 
var crtext3 = "affiliate5434"; 
cr_track('3'); 
</code>

== Special characters ==
Order amounts '''may include special characters such as $ or €''' - our servers will strip away all of the non-numerical information.

== Using different variables which mean the same thing ==
Note that the [[JavaScript]] variables "'''cramount'''" and "'''cramount0'''" are analogous, as are "'''crtext'''" and "'''crtext0'''".

If, for some reason, you define '''cramount''' and '''cramount0''' on your page, then '''cramount''' will be recorded, and '''cramount0''' ''is not recorded''.

<code>
var cramount = "USD $33.55"; 
var cramount0 = "USD $330000324.55"; 
cr_track('3'); // Records $33.55 only 
</code>

== For more help ==
We have installed order tracking in hundreds of shopping carts so if you are stuck, [[ConversionRuler Support|feel free to contact us!]]

== Related ==
* [[Tracking Order Amounts]]
* [[Commerce Tracking]]
* [[JavaScript]]

[[Category:ConversionRuler]]
[[Category:ConversionRuler Installation]]
[[Category:Technical]]

@@ Line 11: / Line 11: @@
 <code>
-var cramount = ''''ORDER_AMOUNT'''';<br />
+var
-var crtext = ''''ORDER_NUMBER'''';<br />
+cramount = ''''ORDER_AMOUNT'''',<br />
-cr_track('3');<br />
+crtext = ''''ORDER_NUMBER'''';<br />
 </code>
@@ Line 24: / Line 25: @@
 <code>
-var cramount = ''''<%= oRS("subtotal") %>'''';<br />
+var
-var crtext = ''''<%= oRS("order_id") %>'''';<br />
+cramount = ''''<%= oRS("subtotal") %>'''',<br />
-cr_track('3');<br />
+crtext = ''''<%= oRS("order_id") %>'''';<br />
 </code>
@@ Line 33: / Line 35: @@
 <code>
-var cramount = ''''<?= $order['subtotal'] ?>'''';<br />
+var
-var crtext = ''''<?= $order['id'] ?>'''';<br />
+cramount = ''''<?= $order['subtotal'] ?>'''',<br />
-cr_track('3');<br />
+crtext = ''''<?= $order['id'] ?>'''';<br />
 </code>
@@ Line 41: / Line 44: @@
 <code>
-var cramount = '199.99';<br />
+var
-var crtext = '2369';<br />
+cramount = '199.99',<br />
-cr_track('3');<br />
+crtext = '2369';<br />
 </code>
@@ Line 51: / Line 55: @@
 <code>
-var cramount = CAOrderSubTotal;<br />
+var
-var crtext = CAOrderID;<br />
+cramount = CAOrderSubTotal,<br />
-cr_track('3');<br />
+crtext = CAOrderID;<br />
 </code>
@@ Line 60: / Line 65: @@
 <code>
 var cramount = '199.99';<br />
-cr_track('3');<br />
+__CR.track('3');<br />
 </code>
@@ Line 75: / Line 80: @@
 var crtext2 = "2009-05-30 44:33:22";<br />
 var crtext3 = "affiliate5434";<br />
-cr_track('3');<br />
+__CR.track('3');<br />
 </code>
@@ Line 89: / Line 94: @@
 var cramount = "USD $33.55";<br />
 var cramount0 = "USD $330000324.55";<br />
-cr_track('3'); // Records $33.55 only<br />
+__CR.track('3'); // Records $33.55 only<br />
 </code>
@@ Line 99: / Line 104: @@
 * [[Commerce Tracking]]
 * [[JavaScript]]
 [[Category:ConversionRuler]]
 [[Category:ConversionRuler Installation]]
 [[Category:Technical]]

← Older revision		Revision as of 22:32, 25 January 2011
Line 1:		Line 1:
−	How to set up ConversionRuler [[~~commerce tracking~~]] snippets.	+	How to set up ConversionRuler [[Commerce Tracking]] snippets.

	To pass financial information to our servers you will need to modify the “order snippet”. This will generally require some coding in the technology that your shopping cart uses.		To pass financial information to our servers you will need to modify the “order snippet”. This will generally require some coding in the technology that your shopping cart uses.