Integration Guide: Volusion

Learn more about Listrak's Integration with Volusion and the steps to integrate.

Support avatar
Written by Support
Updated over a week ago

Installing the Listrak Analytics Click Tracking Script

  1. Log into your Volusion Store Admin Area.

  2. Navigate to the Design menu tab.

  3. Select File Editor.

  4. Select the template HTML file currently in use on your store (ex. template_90.html).

  5. Inside the editor window, navigate to the bottom.

  6. Before the end body tag, place your conversion tracking and click tracking script blocks.

  7. Save changes to the template file.

  8. Copy and paste the following code:

<!-- Listrak Analytics - Submit Tracking Click -->
<script type="text/javascript">
        (function(d) { if (document.addEventListener) document.addEventListener('ltkAsyncListener', d);
        else {e = document.documentElement; e.ltkAsyncProperty = 0; e.attachEvent('onpropertychange', function (e) {
        if (e.propertyName == 'ltkAsyncProperty'){d();}});}})(function() {
            /********** Begin Custom Code **********/
            _ltk.Click.Submit();
            /********** End Custom Code **********/
        });
</script>

<!-- Listrak Analytics - Script Source -->
<script type="text/javascript">
        var biJsHost = (("https:" == document.location.protocol) ? "https://" : "http://");
        (function (d, s, id, tid, vid) {
            var js, ljs = d.getElementsByTagName(s)[0];
            if (d.getElementById(id)) return; js = d.createElement(s); js.id = id;
            js.src = biJsHost + "cdn.listrakbi.com/scripts/script.js?m=" + tid + "&v=" + vid;
            ljs.parentNode.insertBefore(js, ljs);
        })(document, 'script', 'ltkSDK', '<<MERCHANT_ID>>', '<<VERSION>>');
</script>

The below image is an example of where to place the code:

Installing the Listrak Analytics Conversion Tracking Script

  1. Log into your Volusion Store Admin Area.

  2. Navigate to the Design menu tab.

  3. Select Site Content.

  4. Scroll down until you find the Web Page titled orderfinished.asp with a Spot Key of ROI_Javascripts

  5. Select this entry.

  6. In the Article Body section, place your conversion tracking script blocks specific to the Volusion platform.

  7. Click Update.

<!-- Listrak Conversion Tracking -->
<script type="text/javascript">
        (function(d) { if (document.addEventListener) document.addEventListener('ltkAsyncListener', d);
        else {e = document.documentElement; e.ltkAsyncProperty = 0; e.attachEvent('onpropertychange', function (e) {
        if (e.propertyName == 'ltkAsyncProperty'){d();}});}})(function() {
            /********** Begin Custom Code **********/
            var _itemTotal = 0;
            for (var i = 0; i < OrderDetails.length; i++) {
            _itemTotal += parseFloat(OrderDetails[i][6] == '' ? '0' : OrderDetails[i][6]) * parseFloat(OrderDetails[i][5] == '' ? '0' :    OrderDetails[i][5]);
            _ltk.Order.AddItem(OrderDetails[i][2], OrderDetails[i][6], OrderDetails[i][5]);}
            _ltk.Order.SetCustomer(Order[9], '', '');
            _ltk.Order.OrderNumber = Order[0];
            _ltk.Order.ItemTotal = _itemTotal;
            _ltk.Order.ShippingTotal = Order[5];
            _ltk.Order.TaxTotal = Order[4];
            _ltk.Order.HandlingTotal = 0;
            _ltk.Order.OrderTotal = parseFloat(Order[5] == '' ? '0' : Order[5]) + parseFloat(Order[4] == '' ? '0' : Order[4]) +      _itemTotal;
            _ltk.Order.Submit();
            /********** End Custom Code **********/
        });
</script>
<!-- Listrak Conversion Tracking -->

<!-- Listrak Analytics - Script Source -->
<script type="text/javascript">
        var biJsHost = (("https:" == document.location.protocol) ? "https://" : "http://");
        (function (d, s, id, tid, vid) {
            var js, ljs = d.getElementsByTagName(s)[0];
            if (d.getElementById(id)) return; js = d.createElement(s); js.id = id;
            js.src = biJsHost + "cdn.listrakbi.com/scripts/script.js?m=" + tid + "&v=" + vid;
            ljs.parentNode.insertBefore(js, ljs);
        })(document, 'script', 'ltkSDK', '<<MERCHANT_ID>>', '<<VERSION>>');
</script>

The below image is an example of where to place the code:

Granting Listrak API Access

  1. Log into your Volusion Store Admin Area.

  2. Navigate to the Customers menu tab.

  3. Select Accounts.

  4. Click Add.

  5. Within the Basic Customer Info section:

    1. Select Administrator within the Access Key drop-down list.

    2. For ease of administration, you may give the account a first name of Listrak and last name of API User.

    3. Set the email address to any email address using your store domain. This email address does not have to exist and is used solely for gaining access to the Volusion API. For ease of administration we suggest using listrakapi@yourdomain.com.

    4. Set the password. Do not share this password with anyone, not even Listrak. The password will be encrypted in the API Access URL so there is no need to reveal it to anyone.

  6. Within the Special Privileges section:

    1. Check “Is Super Admin”

    2. Save the new user.

  7. Go to: http://www.<STORE_DOMAIN>.com/net/WebForm_Import_Export_Help.aspx after replacing <STORE_DOMAIN> with your actual URL.

    💡 If you do not see the page for Volusion API – Documentation, you must manually navigate to the page by accessing Inventory > Import/Export > Volusion API, then click the Get Help link in the top right of your screen.

  8. Select the radio button Export under the instructions for heading.

    1. Select Generic Orders in the drop-down next to the Export radio option.

    2. Select the Listrak API user you created earlier.

    3. Click the URL with Query String and General Information for Importing and Exporting section heading. This section will expand, revealing the API Access URL for the selected user. (Notice that the password is encrypted in the URL.)

  9. Copy this URL.

  10. Send it to your Account/Project Manager at Listrak.

Exporting Order and Customer History

For merchants looking to gain more insight into customer buying behavior and purchase cadence optimization of products customers buy repeatedly, it is advised to export the existing customer and order history data. To accomplish this you must complete the following steps and send these data files to your Listrak Project Manager.

  1. Log into your Volusion Store Admin Area.

  2. Navigate to the inventory menu tab.

  3. Select Import/Export.

  4. Navigate to the Standard Import/Export heading.

  5. Click Data Export

Exporting Customers

  1. Select Customers in the Table drop-down list.

  2. Check off the following columns:

    1. CustomerID

    2. FirstName

    3. LastName

    4. EmailAddress

  3. Select CSV – Comma Delimited Text File in the Export To drop-down list.

  4. Click Export Now.

  5. Once the export has completed, click Click here to download your file.

  6. Save the CSV file to your local file system.

Export Products

  1. Select Products in the Table drop-down list.

  2. Check off the following columns:

    1. Product Code

    2. Product Name

    3. Product Price

    4. Product Description

    5. Product URL

    6. Photo URL

  3. Select CSV – Comma Delimited Text File in the Export To drop-down list.

  4. Click Export Now.

  5. Once the export has completed, click Click here to download your file.

  6. Save the CSV file to your local file system.

Export Orders

  1. Select Orders in the Table drop-down list.

  2. Check off the following columns:

    1. OrderID

    2. CustomerID

    3. TotalShippingCost

    4. PaymentAmount

    5. OrderDate

    6. OrderStatus

    7. SalesTax1

    8. SalesTax2

    9. SalesTax3

  3. Select CSV – Comma Delimited Text File in the Export To drop-down list.

  4. Click Export Now.

  5. Once the export has completed, click Click here to download your file.

  6. Save the CSV file to your local file system.

Export Order Details

  1. Select OrderDetails in the Table drop-down list.

  2. Check off the following columns:

    1. OrderDetailID

    2. OrderID

    3. ProductCode

    4. Quantity

    5. ProductPrice

  3. Select CSV – Comma Delimited Text File in the Export To drop-down list.

  4. Click Export Now.

  5. Once the export has completed, click Click here to download your file.

  6. Save the CSV file to your local file system.

After you have exported all data files please send them to your Listrak Project Manager.

Testing Your Installation

To ensure that all of your code is properly in place it’s a simple three step process:

  1. Open the homepage of your site and view the HTML source (right click, view source) of the page. If you see the code that you copied and pasted from the first section of this document, your site is properly configured. If you do not see the code, you may need to paste the code into a different template file. Depending on which version of Volusion you are using, your default template may change. If you are using a custom template, you will need to make sure you have the code copied to the template within the File Editor as described in the instructions.

  2. Complete a test purchase on your store, view the HTML source (right click, view source) on the order confirmation page. If you see the code that you copied and pasted from the conversion tracking section of this document, the analytics are installed properly. If you do not see this code in the HTML source, go back and verify that the code was added to the correct page template’s article body section.

  3. If you have exported your order, customer and product data files from Volusion, please make sure to check with your Listrak project manager to ensure that the data was able to be successfully imported into the Listrak database for use with email marketing campaigns.

Did this answer your question?