Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This tutorial will help you to make the most out of the UltraCart Analytics platform. 

Info
titleAnalytics Engine started collecting data in 2018

PLEASE NOTE: The analytics engine that drives the 'Statistics' dashboard, started collecting data in 2018. 
(Because it's an event based system, it can't go further back in time.)


Background

The UltraCart Analytics platform strives to provide near real-time insight into the performance of your business with a level of insight that most reporting platforms do not achieve.  We've helped merchants with the struggle of gaining insight into their business from end-to-end for a long time.  In the end we've always come down to three problems with external reporting tools:

...

  • Quickly see key performance indicators and compare them over time.
  • Quickly setup required data flows that need to be captured

Beta Notice

...

Metrics

The UltraCart Analytics system provides reporting on the following metrics across three categories (basic, RTGs, and affiliates)

...

First make sure that you have linked your Google Adwords account to your Google Analytics account (this is recommended by Google).  Next click on StoreFronts → Conversion and Tracking → Google.  Scroll down to the Google Analytics Experiments section and populate the Account Id, Property Id and Profile ID then click Connect.  More detail on finding these values and connecting the API is found under the Performing an Experiment.  In the future this section will be renamed "Google Analytics API" as the connection does more than use the Google Analytics experiment engine.

...

UltraCart automatically knows the fee structure associated with PayPal and Amazon payments.  By default UltraCart will assume that your credit card processing rate is 2.9% and $0.30/transaction.  If you're paying more than that considered checking out UltraCart Payments!  If you need to configure different rates than the default, configure a merchant account profile and specify the rates. After configuring the merchant account profile, navigate to the payments configuration and then into the transaction gateways configuration page, then scroll down to the configured gateway and to the right of the card types checkbox fields, select the configure merchant account profile form the drop-down list, then click the save button to save the changes.

Some high risk merchant accounts also place a reserve on the funds processed.  You can also configure that under the merchant acocunt profile.

...

Code Block
languagexml
themeDJango
titleExternal Tracking Script Example
<script async defer src="https://d9i5ve8f04qxt.cloudfront.net/UC/62/uca/0.1.0/js/collect-g.js" data-mid="SAMPL" data-channel="sampl.ultracartstore.com"></script>

...

This script will set a tracking cookie in order to keep track of the customer through multiple engagements with your website.

Tracking on External Websites (with Google Tag Manager)

The way Google Analytics loads scripts, it will not replicate the data tags.  To solve this problem we'll use a URL syntax instead of data attributes.  For example if our merchant id is SAMPL, our StoreFront is sampl.ultracartstore.com and our website is www.mysamplesite.com, then we connect the two by placing the following tracking script into the Google Tag Manager container for the www.mysamplesite.com website:

No Format
<script async defer src="https://d9i5ve8f04qxt.cloudfront.net/UC/62/uca/0.1.0/js/collect-g.js?mid=SAMPL&channel=sampl.ultracartstore.com"></script>

Just change the mid and channel to match your UltraCart account.

Tracking on External Websites with Different Domains

The UltraCart Analytics engine will make a best effort to track users between the landing page domain and the checkout domain when they are different.  There are no additional changes that are required when deploying the tracking script to your external site other than properly configuring the mid and channel parameters.

Firing Events on External Websites

If you have implemented a custom checkout using our REST APIs you may want to fire events when the customer adds items to their cart and initiates the checkout process to help drive the funnel information on the analytics dashboard.  Below are example of firing events when UC Analytics is loaded on the page.

Add Items

Code Block
languagejs
titleAdd Items Event
window.ucaEvent(
  {
    "event": "add items",
    "items": [
      {
        "itemId": "SKU_1",
        "quantity": 1
      },
      {
        "itemId": "SKU_2",
        "quantity": 1
      }
    ]
  }
);


Initiate Checkout

Code Block
languagejs
titleInitiate Checkout
window.ucaEvent(
  {
    "event": "initiate checkout",
    "items": [
      {
        "itemId": "SKU_1",
        "quantity": 1
      },
      {
        "itemId": "SKU_2",
        "quantity": 1
      }
    ]
  }
);



Dashboard Widgets


There are currently three different types of widgets related to UltraCart Analytics that you can place on your dashboard. 

...

You may need to edit your Adwords campaigns or FaceBook campaigns to add these values.  You can also track more than Adwords and FaceBook campaigns though.  Any type of traffic tagged with these parameters will be tracked.

Tracking Facebook


FAQ

This new system works by gathering events as they occur and then reducing the information down into meaningful statistics.  Unfortunately that means that it has no look back capabilities beyond when the system began gathering data
Expand
title I've had my UltraCart account for a long time but statistics data only goes back a month or so?
to 2018?

The analytics engine that drivers that dashboard started collecting data in 2018.  Because it's an event based system, it can't go further back in time before that.


Expand
titleMy profit is much higher than in reality.  What should I change?

Make sure that you configure all of your expenses as shown in the document above.  Once you configure an expense it will effect go forward data collection, but nothing historical that has already been collected.


Expand
titleI am seeing auto order rebills that contain UTM parameters, why is that?

UTM campaign hits across all sessions since customer first visited or their last order.


Expand
titleWhy do orders show UTM parameters appearing after the order placed date?

Analytics sessions process asynchronously several minutes after the order is placed.


Expand
titleMy marketing campaigns are not tracking profit.  What is wrong?

Make sure that you instrument your marketing campaigns with UTM parameters so that the source and campaign name can properly match up.  If the campaigns are targeted at an external website, please see the section above about tracking on an external website for the proper script to deploy.

...

Expand
titleCan you add XYZ statistic to the system?

Maybe.  There are a million things that can be reported on, but we are trying to keep the system very usable with minimal one time configuration requirements and produce statistics that all users can understand.


Expand
titleWhy is there a difference between the legacy sales graph and the dashboard for today?

The newer dashboard system works off an event processing system which process approximately 45 minutes behind real-time.  The data will eventually be consistant with the legacy sales graph.


Expand
titleI'm trying to build some deeper reporting for our orders coming through ultracart. I've exported the orders using all columns into a CSV format and the numbers I see from those orders don't match the "Total Sales" number in the Statistics (Basic) section. I was wondering if you could enlighten me as to how that number and the "Total orders" is calculated. I have all the orders in one table with line items in the order broken out into another table and I can't seem to match the numbers up.

The analytics engine that drives that dashboard widgets uses a delayed event stream (see previous Q/A above), therefore it may differ slightly from the official order database. 
If you're doing accounting type reporting and reconciliation, it's recommended that you use either the
Reports menu or order exports for conducting a deeper analysis of your sales activity.


Expand
titleWhat is the definition of a 'Repeat customer?

A repeat customer is a customer that has two or more orders in the order history.

Please note that the order retention settings can affect this metric. So, if you have your Order Retention configuration set less than "Infinite", then repeat customers may no longer be reflected as such, due to their previous order(s) being purged from the order database.


Expand
titleWhat does "Referrals" refer to in the "Online visits by traffic source" section of the Statistics widget?

A "Referral" references traffic coming from a domain other than a search engine or social network or your own storefront.

For Example: If I had a site named: mywebsite.com and I linked to your website, then all the traffic from my site to yours would be considered referral traffic.