Orders

Order tracking enables the client to evaluate media spending and creative designs on the basis of generated orders or even ROI.

Additionally when the order tracking is in place clients are able to target customers with specific advertising.

Order variables

The following tables contain implementation details about variables supported when using the Delta Projects tracker scripts.

All variable names and values are case sensitive.

Order items object variables

Definition for the objects in the items array of the order action.

Tracker implementation guidelines

General conventions

String encoding

All strings going in or out of Delta Projects must be in UTF-8.

Secure pages

The Delta Projects javascript tracker automatically adjusts for secure pages. You can use it on either protocol.

Tracker placement

There are no restrictions on where to put the javascript tracker, our recommendation is to put the script at the end of body as per yahoos best practices for speeding up your web site. But since the script is asynchronous and every measure has been taken not to block your page from loading the choice of placement is in your hands.

Placeholders

The tracker script added to pages should never contain the placeholder values, please remove the variable entirely if not used/needed. See examples below. Note that YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID will be replaced by Delta Projects.

YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID

In the examples in this document YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID is a placeholder string. In the trackers shipped from Delta Projects this placeholder is replaced with the id of your account in Delta Projects systems.

YOUR_PAGE_ID

The pageId variable is used to track specific pages. If the tracker script is wrapped in an iframe the pageId is mandatory for tracking that specific page. Tracking of pages can also be accomplished without the pageId by using either the title, the referrer or the URL of the page.

YOUR_ORDER_ID

The orderId variable is specific to the order action, in the shipped scripts from Delta Projects it is recommended that you replace this placeholder with your internal orderId. If you do not replace the placeholder then the script will generate a random orderId for each registered order.

YOUR_TOTAL_PRICE

The totalPrice variable is specific to the order action, in the shipped scripts from Delta Projects it is recommended that you replace this placeholder with the actual totalPrice for each registered order. If it is omitted then both totalPrice and currency will be ignored.

YOUR_CURRENCY

The currency variable is specific to the order action, in the shipped scripts from Delta Projects it is recommended that you replace this placeholder with the currency (ISO 4217, 3 letter code) of totalPrice. If it is omitted then both totalPrice and currency will be ignored. Allowed values are SEK, NOK, DKK, EUR, USD, GBP.

Format Options

Our tracker may be implemented in a number of ways. The most common implementation is a small javascript placed on the client web page where one or more actions should be tracked.

The tracker scripts used for the implementation may be downloaded from the Delta Projects UI or sent to you by email from Delta Projects staff.

Sample implementations of our different tracker formats.

Order tracker example

A sample order registration with all recommended variables, excluding optional variables:

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

  _d7.push({
    action:"order",
    orderId:"o23452431",
    totalPrice:"299",
    currency:"USD"
  });

  (function(){
    var d=document.createElement("script"),s=document.getElementsByTagName("script")[0];
    _d7.id="YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID";_d7.p=("https:" == document.location.protocol ? "https://" : "http://");
    d.src=_d7.p+"tb.de17a.com/d7.js";d.type="text/javascript";d.async=1;s.parentNode.insertBefore(d,s);
  })();
</script>

A sample order registration with all recommended variables and pageId definition, excluding optional variables:

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

  _d7.push({
    action:"order",
    orderId:"o23452431",
    totalPrice:"299",
    currency:"USD",
    pageId:"YOUR_PAGE_ID"
  });

  (function(){
    var d=document.createElement("script"),s=document.getElementsByTagName("script")[0];
    _d7.id="YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID";_d7.p=("https:" == document.location.protocol ? "https://" : "http://");
    d.src=_d7.p+"tb.de17a.com/d7.js";d.type="text/javascript";d.async=1;s.parentNode.insertBefore(d,s);
  })();
</script>

A sample order registration with all recommended and optional variables

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

  _d7.push({
    action:"order",
    orderId:"o29235382",
    totalPrice:"818.9",
    currency:"USD",
    items: [
      { sku:"B00CMQTVQO",
        productName:"PlayStation 4: Standard Edition",
        productCategory:"Video Games",
        unitPrice:"699",
        currency:"USD",
        quantity:"1"
      },
      { sku:"B00BGA9X9W",
        productName:"PlayStation 4 Dualshock 4 Wireless Controller",
        productCategory:"Video Games",
        unitPrice:"59.95",
        currency:"USD",
        quantity:"2"
      }
    ]
  });

  (function(){
    var d=document.createElement("script"),s=document.getElementsByTagName("script")[0];
    _d7.id="YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID";_d7.p=("https:" == document.location.protocol ? "https://" : "http://");
    d.src=_d7.p+"tb.de17a.com/d7.js";d.type="text/javascript";d.async=1;s.parentNode.insertBefore(d,s);
  })();
</script>

A sample order that is triggered on a click event

<a id="clickevent" onclick="pushOnClick()" href="#">Click event</a>

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

  (function(){
    var d=document.createElement("script"),s=document.getElementsByTagName("script")[0];
    _d7.id="YOUR_UNIQUE_DELTA_TRACKING_ACCOUNT_ID";_d7.p=("https:" == document.location.protocol ? "https://" : "http://");
    d.src=_d7.p+"tb.de17a.com/d7.js";d.type="text/javascript";d.async=1;s.parentNode.insertBefore(d,s);
  })();
</script>

<script type="text/javascript">
  function pushOnClick() { _d7.push({action:"order", pageId:"ClickEvent",orderId:""})
  }
</script>

Last modified: Mon Sep 23 2024 11:48:54 GMT+0200 (Central European Summer Time)