About The Tracker JavaScript Code

Marin's Asynchronous JavaScript click and conversion capture code snippets record incoming traffic and conversions from paid search. This code can also be used to show conversion relationships (called "paths") between paid search and other media channels such as affiliate marketing, online display campaigns and natural search. The asynchronous nature of the code means the pixel is built in the background, and will not affect page load speed.

• JavaScript will be placed on the customer's website(s).
• Confirmation pages will require a change to the server-side page generation code in order to include details about the transaction.
• URLs must be tagged at the keyword or creative level with Marin's tracking parameters.
• Marin Tracking numbers will be validated by Customer and Marin Professional Services to ensure accuracy. Despite this, there may be differences between different tracking methodologies based on attribution rules, page placement, etc. 90% accuracy is typically considered a good match but the number could be lower for valid reasons.

Click Capture Code

What does this code do: The javascript will log the keyword and creative that brought the visitor to your site, based on, but not limited to, the keyword ID and creative ID which are embedded in the paid click destination URL. The Javascript will capture the referring URL, Destination URL, and set a Cookie ID (UUID) in the user’s browser then send all three values to Marin. This Click data will be joined with Conversion data in order to attribute conversions to a keyword or creative. In the unlikely event that JavaScript is disabled in the browser the <noscript> image pixel will fire, but will not contain any tracking data, it is used for auditing purposes only.

Where to place the code: The following javascript code snippet is to be exposed on all landing pages of the website, ideally by being placed in a global template such as a footer template.

Field Values: (provided by your onboarding team)

• [CLIENT-TRACKING-ID] = (required) Static Alphanumeric String, unique to each Marin client account.

Please note the code in this section is only an example and should not be placed on the customer's landing pages.

<!-- BEGIN: Marin Software Tracking Script -→
   
     <script type="text/javascript">
    var _mTrack = _mTrack || [];
    _mTrack.push(['trackPage']);
    
    (function() {
    var mClientId = '[CLIENT-TRACKING-ID]';
    var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');
    var mHost = 'tracker.marinsm.com';
    var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';
    var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);
    })();
    </script>
    <noscript>
    <img src="https://tracker.marinsm.com/tp?act=1&cid=[CLIENT-TRACKING-ID]&script=no" >
    </noscript>
   
<!-- END: Copyright Marin Software -→

Conversion Type Settings

Marin will work with the customer during scoping and Integration Plan development to define their conversion types in the following table:

Where:

• Conversion Type: The conversion type name as it should appear in the Marin interface.
• Conversion Type ID: The conversion type id as it should be passed in the Marin conversion code.
• Conversion Source: Marin Tracker JavaScript.
• Use for Bidding: Yes or No to indicate if the conversion type should be used for bidding.
• Revenue: Yes or No to indicate if the conversion type passes revenue.
• Many or 1 Per Click: Indicates how Marin should attribute conversions.
• Attribution: Date of Click and Date of Conversion.

Marin Software cannot effectively bid against user engagement metrics like pageviews, bounces, time on site, and other non-transactional conversion information. During the Integration Plan review call customer will to confirm conversion types, # Conversions per Click, and Method of Attribution (Date of Click versus Date of Conversion or both.

Conversion Capture Code

What does this code do: The Javascript will take the values specified below in the array of conversion metrics and send them to Marin along with the Cookie ID (UUID) created by the Click JavaScript; this allows Marin to join Clicks and Conversion data together. The client’s development team is responsible for inserting the appropriate conversion data into the fields specified below, using server-side logic. The fields below are defined in a JSON Array as a name-value pair; field values are defined below the code snippet. In the unlikely event that JavaScript is disabled in the browser the <noscript> image pixel will fire, but will not contain any tracking data, it is used for auditing purposes only. 
Where to place the code: The following javascript code snippet should be placed on the Conversion Success Page (thank you page). If using an On-Click Event to track Conversion events please consult with your Marin onboarding team first.

Please note the code in this section is only an example and should not be placed on the customer's conversion pages.

<!-- BEGIN: Marin Software Tracking Script -→
    <script type="text/javascript">
     var _mTrack = _mTrack || [];
     
     _mTrack.push(['addTrans', {
     currency :'<ISO-CURRENCY-CODE>',
    items : [
     {
     orderId : '<ORDER-ID>',
    convType : '<CONV-TYPE-ID>',
     product : '<PRODUCT-SKU/NAME>',
     price : '<PRICE>',
    category : '<CATEGORY>',
    quantity : ‘<QUANTITY>’
    }
    ]
     }]);
     
    _mTrack.push(['processOrders']);
    (function() {
     var mClientId = '[CLIENT-TRACKING-ID]';
    var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');
     var mHost = 'tracker.marinsm.com';
     var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';
    var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);
     })();
     
    </script>
    <noscript>
    <img src="https://tracker.marinsm.com/tp?act=2&cid=[CLIENT-TRACKING-ID]&script=no" >
    </noscript>
   
<!-- END: Copyright Marin Software -→

URL Structure

In order for Marin to track using Tracker to attribute conversions/revenue, each keyword, creative, and placement URL must be tagged with a unique identifier (ID). We are recommending the following URL structure where the highlights represent the required Marin variables:

 (Google Keyword Example) 
http://www.domain.com/path/landingPage.html?mkwid=[distribution][uniq_id]&pcrid=[creative_id]&pkw=[keyword_text]&pmt=[matchtype]&pdv=[device]

The following table illustrates the values which will be substituted using when using Marin variable insertion.

The following lead parameters should be included for the given publisher where an “X” is present. The {device} value will either be placed within the MKWID parameter or in the PDV parameter, not both. 

URL Builder And ID Parser Settings

The following settings under keyword ID parsing will need to be configured in the Marin application:

The following settings will be enabled for the client in the Marin URL Builder:

Google Sitelink Settings

Marin supports two methods for tracking Google sitelink performance. Please note that only one option may be selected.

&{copy:mkwid}&pcrid={creative}&pkw={keyword}&pmt={matchtype}&pdv={device} 

Implementation Check List

Use Cases

<!-- BEGIN: Marin Software Tracking Script -->

<script type="text/javascript">
 var _mTrack = _mTrack || [];
 
 _mTrack.push(['addTrans', {
 currency : 'USD',
 items : [

User signs up for a membership, valued at $20.00

{
orderId : '123456-subscription',
convType : 'subscription',
product : 'membership signup',
price : '20.00',
quantity : ‘1’
 },
 {

User also upgrades membership to gold level, valued at $10.00

orderId : '123456-upgrade_gold',
convType : 'upgrade_gold',
product : 'membership upgrade (gold)',
price : '10.00',
quantity : ‘1’
 }
 ]
 }]);

_mTrack.push(['processOrders']);
 (function() {
 var mClientId = '1a2b3c4d';
 var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');
 var mHost = 'tracker.marinsm.com';
 var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';
 var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);
 })();
</script>
<noscript>
<img src="https://tracker.marinsm.com/tp?act=2...3c4d&script=no" >
</noscript>
<!-- END: Copyright Marin Software -->

<!-- BEGIN: Marin Software Tracking Script -→

<script type="text/javascript">
 var _mTrack = _mTrack || [];

_mTrack.push(['addTrans', {
 items : [{
 orderId : '300188403',
 convType : ‘store_locator’
 }]
}]);

 _mTrack.push(['processOrders']);
 (function() {
 var mClientId = '1a2b3c4d';
 var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');
 var mHost = 'tracker.marinsm.com';
 var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';
 var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);
 })();
</script>
<noscript>
<img src="https://tracker.marinsm.com/tp?act=2...3c4d&script=no" >
</noscript>

<!-- END: Copyright Marin Software -->

<!-- BEGIN: Marin Software Tracking Script -→

<script type="text/javascript">
 var _mTrack = _mTrack || [];

 _mTrack.push(['addTrans', {
 currency : 'USD',
 items : [
 {

Item 1: Running Shoes Valued at $120.00 X 1 (quantity) = $120.00 in Marin

orderId : '123456',
 convType : 'sale',
 product : 'mens running shoes', 
 price : '120.00',
 quantity : ‘1’
 },
 {

Item 2: Running Socks Valued at $10.00 X 5 (quantity) = $50.00 in Marin

orderId : '123456',
 convType : 'sale',
 product : 'mens running socks',
 price : '10.00',
 quantity : ‘5’
 }
 ]
 }]);

 _mTrack.push(['processOrders']);
 (function() {
 var mClientId = '1a2b3c4d';
 var mProto = ('https:' == document.location.protocol ? 'https://' : 'http://');
 var mHost = 'tracker.marinsm.com';
 var mt = document.createElement('script'); mt.type = 'text/javascript'; mt.async = true; mt.src = mProto + mHost + '/tracker/async/' + mClientId + '.js';
 var fscr = document.getElementsByTagName('script')[0]; fscr.parentNode.insertBefore(mt, fscr);
 })();
</script>
<noscript>
<img src="https://tracker.marinsm.com/tp?act=2...3c4d&script=no" >
</noscript>