Set up Qubit on Magento

In this article...

We'll cover the steps involved in implementing the Qubit Tracking extension in your Magento store.

Compatibility

This extension is compatible with Community and Enterprise versions 1.8, 1.8.1, 1.9, 1.9.1, 1.9.2, 1.9.3.

Installation

Before getting started, we recommend making a full backup of your Magento website. This is a good practice that should be followed before installation of any Magento modules. See Creating a Backup for more information.

Step 1

▸ Navigate to the Magento Marketplace and enter Qubit in the search field provided. Then select Qubit Integration from the search results. Alternatively, navigate to Qubit Integration

Step 2

▸ Add the extension to your cart and complete the checkout process. Once you have completed the order, select Install and copy the installation key. In our example, this is:

https://connect20.magentocommerce.com/6126cf80c523c2e0cfd4bf12d375e446/qubit+Qubit_Tracking-0.1.2

Step 3

▸ Login to your Magento Administration Panel, then navigate to System > Magento Connect > Magento Connect Manager. Select the Extensions tab and paste the key you copied into the field provided

Select Install to complete the installation process

Step 4

▸ Clear your cache, log out of the Administration Panel and log in again

Configuration

Step 1

▸ Login to the admin area for your Magento store. Typically, this is the URL specified during the installation of Magento, with the addition of /admin. Enter your admin username and password:

admin login

Step 2

▸ Select System from the toolbar:

system

Then select Qubit > Qubit Tracking from the side menu:

tracking

Step 3

▸ Configure the extension as required, referring to the following table as a guide:

Value

Expected Value

Description

Qubit Enabled

Yes/No

Whether to enable the Qubit Tracking extension for your Magento store

Emit Events

Yes/No

Whether to enable the emission of Qubit events for your Magento store

Tracking Id

String

The tracking Id for your property. This is provided by Qubit during onboarding.

If your property is hosted on multiple domains, typical for multi-language sites, then a tracking Id will be provided for each site. You will need to set up and configure the Qubit Tracking extension for each site

Package

Pro/Aura

Which Qubit package you have purchased

There are differences between the events emitted by Qubit Aura and Qubit Pro

Smartserve URL

String

The URL of smartserve.js

This will be provided to you by Qubit

Smartserve Location

End of HEAD/End of BODY

The page location to inject smartserve.js

Smartserve Asynchronous

Yes/No

Whether to load smartserve asynchronously or not

Namespace

String

The custom namespace, required to send custom events to Qubit

This will be provided to you by Qubit

Send Product Listing Events

Yes/No

Whether to emit events on product listing pages

Product Listing Event Limit

Integer

The maximum number of events that will be sent on product listing pages

Product Stock Data

Yes/No

Whether to include the product stock level in product events

Always Send Basket Events

Yes/No

Whether to send basket events on every page or just the checkout funnel

In the following example, we can see some of the configuration settings:

config settings

Known issues

For assistance in resolving these issues, please reach out to Customer Support at Qubit.

Checkout

If your Magento store has a custom checkout functionality or plugin, the following events might be prevented from triggering:

  • ecBasketItem
  • ecBasketSummary
  • ecBasketItemTransaction
  • ecBasketTransactionSummary

minicart.js

When using the default minicart component minicart.js, it is possible that basket item events will not be sent, including:

  • ecBasketItem
  • ecBasketSummary

The Qubit Tracking extension rectifies this issue by extending the JavaScript object updateItem method.

If you are using a custom minicart implementation rather than the default minicart.js, you will need to replicate the logic to ensure basket item events are sent.

Configurable product

If your Magento store has a different configurable product implementation, with modifications in the default configurable.js file, and specifically the Product.Config.prototype.configureElement method, it is possible that the ecProduct event will not be sent when a visitor makes a product option selection.

Themes

If your Magento store has a different theme that is not using minicart.js and/or configurable.js files, it is likely that the issues reported above will be reproducible. For more information, reach out to your CSM at Qubit.

Last updated: February 2021
Did you find this article useful?