How to setup: Carma Conversion tracker

Introduction

To read more about Carma Conversion Tracker, click here.

 

Carma Conversion Tracking

The Carma Conversion Tracking feature is a specially built feature for Carma users. With this feature you are able to track conversions without using any third party systems.
Please contact support@compost.se to activate the feature.

How to activate the “Carma Conversion Tracking” feature

When you have done the required adjustments on your site (please read “Setup” below) you will get the statistics for your conversions in Carma after you have done the following steps

Manually adding conversion tracking to links

If you are coding your own HTML emails, or for any reason do not wish to add the tracking parameter to all links, you can specify the required parameter by addingc_rid=!!roiid!! to your link URL.

<a href=”http://www.example.com/page.html?c_rid=!!roiid!!”>Go to landing page</a>

<a href=”http://www.example.com/page.php?p1=something&c_rid=!!roiid!!”&g… to landing page</a>

Testing

Before setting up everything on your website you can use the following test example to see how this works.

  • Activate the feature in your account (see above)
  • Link to one of the following pages from your email

http://[your carma server]/conversion/

http://[your carma server]/conversion/shop.htm

Explanation on [your carma server] is found in the “Setup” section below.

  • Send an email to yourselves but remember to use a normal list and not a test list since you don’t get statistics on test emails
  • Click the link in the email
  • “Buy” something in the test shop
  • Look in the statistics of your email and view the conversions you made in your test email

Setup

Explanation of [your carma server]: This is the domain you use when you are logging in to Carma.

1. Copy and paste this snippet into the <head> tag on all pages that will be used as landing pages or conversion pages from your emails:

You should use following login URL: https://www2.carmamail.com/carma then replace [your carma server] with www2.carmamail.com/

<script type=”text/javascript”>

function initCarmaRoi(){

carma.roi.init(“https://[your carma server]/mail”, true);

}

</script>

<script type=”text/javascript” src=”https://www.carmamail.com/scripts/carma.roi.js”></script>

2. Call the function that initializes the conversion functionality when your page has loaded. This can be done by adding the following snippet to your page’s <body> tag:

 

onload="initCarmaRoi()"

The result should look similar to

<body onload="initCarmaRoi()">

 

3. When a conversion is made, call carma.roi.register(amount).

  • Make sure you have called carma.roi.init before calling carma.roi.register
  • The “amount” parameter is optional
  • If you do not specify an “amount” parameter, you will not see the total order value and value per conversions on emails in your Carma report.
  • If you are using multiple currencies on your website, make sure that the correct currency is sent to Carma. Carma is not currency specific, Carma will only show the number you send in “amount”.
<script type="text/javascript"> function onCheckout(amount){ 	carma.roi.register(amount); } </script>

 

Advanced setup

By default, the tracking cookie will be removed when the recipient close their browser. If you want to specify how long you consider a purchase to be a conversion from the link in your email, pass a third parameter to carma.roi.init.

Valid formats:

An absolute date

carma.roi.init("https://[your carma server]/mail", true, new Date(2012, 0, 1));

 

A UTC formatted date string

carma.roi.init("https://[your carma server]/mail", true, "Sun, 1 Jan 2012 12:00:00 GMT");

 

A time frame, in minutes

carma.roi.init("https://[your carma server]/mail", true, 120);