MineWhat Help

Technical help, integration steps and api documentation

[minewhathelp]

Installing MineWhat on an Americommerce store

To start getting insights right away, you can install MineWhat directly onto your Americommerce store. To complete the installation, you will need access to your store’s admin panel and a MineWhat account.

Login to your MineWhat account and navigate to the installation page. Choose the americommercce option and then copy the script in the next section. 

Login to your store admin panel, click on setting on the left sidebar and choose marketing. Paste the MineWhat script into the Analytics script box and click save.

Go back to your admin panel and click on tools in the left sidebar, select apps & addons and navigate to API apps and integrations.

Click on New, fill in the information a required , click next and select the single token flow.

Choose view level permission on People, orders and catalog and save your changes

Copy the access token. click on create.  Go back to the installation page on minewhat and paste it into the appropriate box there.

Navigate to Setting > Store Info > Advanced. Copy the domain  name and paste into the appropriate box on the MineWhat installation page.

Connecting your Google Analytics account

Once you’ve integrating MineWhat into your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Adding a product feed.

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete.

If you need some more help or info write to us at [email protected]

[minewhathelp]

Installing MineWhat on a BigCommerce store

You can add MineWhat directly onto your Bigcommerce store. To complete the installation, you will need access to your store’s admin panel and a MineWhat account.

Step 1: Setting up your MineWhat account

On the signup screen, you will see a list of platform options listed, choose the “Bigcommerce” option.

Once you do so the app will attempt to connect to your bigcommerce account, authorize the connection.

You will then have to set a password for your account.

Alternatively you can also install the MineWhat plugin from your bigcommerce admin screen as well. If you do so, you will be redirected to the password screen at the end of that.

Login to your store admin panel, click on apps here and search for MineWhat. Once you find the plugin, click on it and then click on install. Confirm the installation. Step 2: Adding the MineWhat script tag to your site.

Once you have logged in, you will be redirected to the integration wizard. Navigate to the “Install Script” section.

Verify the details listed on the page and then copy the script you see in the next section.

Go back to your Bigcommerce admin panel and navigate to the code editor section of your store. Click on design on the top right and then click on edit HTMl/CSS.

Look for the footer.html and paste the minewhat script at the bottom of the file hit save and you are done.

Step 3: Connecting your Google Analytics account

After setting up your  the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done. You can also choose to do this step later.

Step 4: Importing the product feed

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

For customers on Bigcommerce, MineWhat can automatically import a product feed. You will see something like the image below on the screen.

Once you have verified the different fields available in the feed, you can click on the next button to review and complete the installation.

If you need some more help or info write to us at [email protected]

[minewhathelp]

Installing MineWhat on your Highwire store

To complete the installation, you will need access to your store admin panel and a MineWhat account. If you don't have an account you can sign up here.

Login to your store admin panel and navigate to Appearance>Template Editor and launch the Code Editor

Click on Snippets in the left sidebar and then choose “styles-scripts.html”

Navigate to the install section on your MineWhat account, choose Highwire from the list of platforms available and fill in the rest of the information as required.

Copy the script in the next section of the page.

Paste the script after the {{ #end }} section on the “styles-scripts.html” box and click save.

Go back to the MineWhat installation page and copy the checkout script.

Navigate to settings>payment settings on your admin panel and paste the script into the checkout scripts section and save your changes.

Connecting your Google Analytics account

Once you’ve integrating MineWhat into your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Adding a product feed.

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete.

If there’s something you need help with, do write to us at [email protected]

[minewhathelp]

Installing MineWhat on your Prestashop store

You can add MineWhat directly to your Prestashop store. To complete the installation, you will need access to your store admin panel and a MineWhat account. If you haven’t got a MineWhat account yet you can sign up here.

Navigate to the installation section on your MineWhat account.

Choose the Prestashop option and download the installation file.

Log in to your admin panel and click on “Module” in the left sidebar and then choose “Modules”.

Click on “Add a new module” on the top right side of the page and upload the MineWhat file.

You will be taken back to the Modules page, you should  now see the MineWhat plugin on the page.

Click on install, you might see a warning like the one below. This usually happens when you install third party modules. Click on the proceed with the installation button.

Go back to the MineWhat installation page, copy the domain id and paste it into this box here.

Choose enable and click on Save.

Connecting your Google Analytics account

Once you’ve integrating MineWhat into your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Adding a product feed.

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete.

[minewhathelp]

Installing MineWhat on your OpenCart store

You can install MineWhat directly on to your OpenCart store. To complete the installation, you will need access to your store’s admin panel* and a MineWhat account. If you haven't got a MineWhat account you can sign up here.

Login into your MineWhat account, navigate to the installation page.

Choose the OpenCart plugin option and download the installation file.

Login into your store admin panel and upload the MineWhat plugin into your store. You’ll find more information on uploading 3rd party modules here.

Go back to your admin panel and navigate to extension>modules.

Locate the MineWhat eCommerce analytics plugin and click on install.

Click on the edit link on the MineWhat plugin.

Go back to your MineWhat account settings page, copy the domain id and paste into the appropriate box on your admin panel.

Choose enable and click on “Save”. Once you’ve done this we will begin receiving events from your store.

Connecting your Google Analytics account

Once you’ve integrating MineWhat into your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Adding a product feed.

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete.

If there's something you need help with, do write to us at [email protected]

[minewhathelp]

Installing MineWhat on a Shopify store

You can add MineWhat directly to your shopify store from the app store. Navigate over to the the app store search for “MineWhat”. Simply click on the green “Get App” button on the right hand side of the page. Once that is done, you can continue on with the rest of the steps.

Step 1: Creating a MineWhat account

On the signup screen, you will see a list of platform options listed, choose the “Shopify” option.

Once you do so the app will attempt to connect to your shopify account, authorize the connection.

You will then have to set a password for your account.

Step 2: Installing the user tracking and conversion script

step 2a)

If you would like to track individual shoppers you will have to also install the user tracking script.

Copy the “Theme liquid” script on the page and navigate to the “Themes” page on your shopify admin panel.

Click on the Template Editor for a published theme. You’ll notice a list of files on the left hand side, click on “theme.liquid”. Once you do so you should be able to see some html code.

Scroll through the page to find the tag. You can use the CTRL + F combination and search for it as well.

Paste the code you copied from your MineWhat account just before the tag like this. Once you are done, just click on save.

step 2b)

Although we get some transaction data like “add-to-cart” events directly from your store, you will need to add one additional script so we can track purchases and order data as well. You can add this script to your Shopify conversion page AKA the Thank You page.

On the “Install Script”page, verify the details there, enter your store URL and copy the conversion script. .

Navigate to  Settings > Checkout in your shop admin and paste the code in the “Additional Content & Scripts'” text box. 

Step 3: Connecting your Google Analytics account

After setting up your  the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done. You can also choose to do this step later. 

Step 4: Importing the product feed

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

For customers on Shopify, MineWhat can automatically import a product feed. You will see something like the image below on the screen.

Once you have verified the different fields available in the feed, you can click on the next button to review and complete the installation.

[minewhathelp]

Improving data accuracy on MineWhat

The preferred installation method for customers on platforms like Magento, Shopify and WooCommerce should be via the MineWhat plugin. The data collection accuracy on this method is consistently around 95%.  Here are some tips to increase data accuracy for those who aren’t on these platforms and have used a custom script installation process to install MineWhat.

Improve campaign detection efficiency:

We automatically detect UTM campaigns on your store. If you are using some other marker on your campaigns, you can define a simple rule to enable us to track it.

Navigate to the Settings tab, it is listed under the drop-down menu on the top of the page.

Click on “Domain Settings” on the left hand side of the page and then click on “Campaigns”

Click on “Add campaign detection rule”, fill in the form as required and hit save.

There are two kinds of rules you can create. One is a pattern match rule. Here’s an example, if your url is “http://www.yourstore.com/promotions/Campaign_UgadiPromotion” then the pattern would be “promotions”. The other is a URL parameter rule. Here’s an example, if your url is “http://yourstore.com/?hpbnr=hm-flash-sale-09apr” then the parameter would be “hpbnr”.

Improve add to cart detection accuracy:

There are two ways you can improve the accuracy of the “add to cart” metric.

Navigate to the settings page and click on the “Cart” tab.

Just  create an “Add-to-cart detection rule” and click save.

The other method involves calling the MineWhat API. You can define an “add to cart” event according to your store’s parameters and push it to our servers through the API. Please read this for detailed instructions.

Improve purchase detection accuracy:

Follow these steps to improve the accuracy of the “purchase” metric.

Navigate to the settings page and click on the “Buy” tab.

Create an “Add buy detection rule” and click save.

You can also call the MineWhat API in the similar manner as stated earlier. By this method you can define what is a purchase event according to your store’s parameters. You’ll find detailed instructions here.

Adding a product feed In addition to traffic and transaction data MineWhat also collects some product information like tags, brand, category, product images and so on to show insights. To do this we typically crawl the website at fixed intervals. You can control this process and also increase the accuracy of data collection by adding a product feed. If you run a flash sales store this becomes all the more important, as you can keep the data on MineWhat updated as you change the product assortment on your store.

To add a product feed to your MineWhat account,

Navigate to the settings page on your MineWhat account.

Click on the "Product Feeds" tab on the left sidebar.

The feed can be either an url or a csv with the product information. Choose the appropriate option and upload the data and you are done.

[minewhathelp]

Installing MineWhat on a Magento Store

You can add MineWhat to your Magento Store directly from your Magento Admin Panel.

Step 1: Creating a MineWhat account

On the signup screen, you will see a list of platform options listed, choose the “magento” option.

You will then have to verify your account and set a password for your account.

You can also install the plugin first and create your MineWhat account later.

Step 2: Installing the MineWhat data collection plugin

After you’ve logged into your Magento Admin Panel, click on the System Tab and choose Magento Connect Manager from the drop down list*.

You will now have to search for and install the MineWhat Magento plugin, click on the Magento Connect link under the Install New Extensions section.

Once you’ve found the MineWhat Plugin, click on “Install Now” and then click on the “Get Extension Key” button and copy the key.

Go back to the the Magento Connect Manager and paste the extension key into the text box as required and then click on “Install”.

You can also choose to do the installation manually by downloading the file.

Step 3: Configuring the MineWhat plugin

Once you have logged in, you will be redirected to the integration wizard. Navigate to the “Install Script” section

Ensure the right domain key is pasted in the box

From your Magento Admin Panel, select the configuration option from the drop down list under the Systems tab.

On the Configuration page you will find MineWhat listed under the services section on the left sidebar menu, click on it to access the settings for the plugin.

Enable the plugin and then paste the Domain Key from the install page in MineWhat and save the configuration once you are done.

Step 3: Connecting your Google Analytics account

After setting up your  the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Step 4: Importing the product feed

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

For customers on Magento, MineWhat can automatically import a product feed. You will see something like the image below on the screen.

Once you have verified the different fields available in the feed, you can click on the next button to review and complete the installation.

 * Magento Connect manager is listed under Magento Connect on the drop down list.

** You can also choose to install MineWhat Script on your Magento Store either  manually or by using Google Tag Manager. We would recommend a plugin install.

[minewhathelp]

Adding MineWhat to Your WooCommerce Store

You can add MineWhat to your WooCommerce store directly from your wordpress dashboard. To do this you have to follow a two step process:

Installing the MineWhat data collection plugin on your store

Adding a MineWhat script tag to send the data to our servers

  Step 1:-

After you’ve logged on to your wordpress store. Click on “Plugins” in the sidebar and then choose “Add New” from the drop down list.

Run a search for "minewhat". You will then find a "WooCommerce MineWhat" plugin.

Click on "Install Now".

Click on “Activate Plugin” after the installation.  Once the activation is  complete you will be taken to the settings page.

  Step 2:-

Copy paste the MineWhat custom script into the script box. To learn how to generate a custom script your store click here.

Enable the script and then save the changes.

Connecting your Google Analytics account

Once you’ve integrating MineWhat into your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so….

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done.

You can also choose to do this step later.

Adding a product feed.

In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete.

Note: If you choose to  integrate manually or to use Google Tag Manager instead to add MineWhat to your online store you can skip Step 2

[minewhathelp]

How to install MineWhat onto your custom built eCommerce store

Just follow these simple steps to add MineWhat to your eCommerce store. Marketeers and non-tech users can also do this with ease The pre-requisites a) You should be an administrator of an eCommerce website or should have access to the tag manager account of your store. 

Step 1: Creating a MineWhat account

On the signup screen, you will see a list of platform options listed, choose the “Custom” option.

Fill in the options available, verify your account and set a secure password. You will now have a MineWhat account.

Alternatively if you already have created a MineWhat account, simply start from step 2

Step 2: Generating the MineWhat script tag

Once you have set your password and logged into your account, you will see a screen like the one below. Click on the “Install Script” box.

Verify the details given there and then copy the script you see in the next section.

Step 3: Placing the code snippet into your site The code snippet can be integrated in two ways into your site. You need to follow only one of the methods

Method 1: The code snippet should be placed as high up in the code of your web page as possible, preferably in the <head> section. If that is not possible you can paste the code snippet into the <body> section of the web page. The code snippet should be kept on every page of the website unless you are using a common header or footer template across the website.

Method 2: This method is easier for marketers and non-technical users with Google tag manager access. You can read how to place the code snippet using Google Tag Manager in this post

Step 4: Verify the code snippet integration

Once you have integrated the code snippet into your site, we will start getting your site activities. You’ll notice a notification bar on the bottom of the page which will tell you if we have received any events from your store. Please note that it can take up to a minute after installation for us to receive the first event.

You can also click on the “check now” button to verify the installation immediately.

Step 5: Connecting your Google Analytics account Once you’ve integrating the script onto your store, the major steps of the installation are complete. In addition to these there are a couple of optional steps, which will enable us to add extra value to your account. The first one of these is to connect your GA account to MineWhat. To do so…

Simply click on the the “Connect GA” button, allow access, choose the right profile and you are done. You can also choose to do this step later.

Step 6: Adding a product feed. In addition to clickstream and transactional data from your website, MineWhat also collects product related information like name, brands, tags etc...and connect the two. To ensure this goes on seamlessly we recommend clients to upload a product feed.

The feed can be uploaded in many formats including CSV, TXT, XLS, Json, XML and more.

Once you are on the “Import Feed” tab, you’ll see a screen like the one below.

Choose the appropriate option and import your feed.

Once you’ve done so, the system will go through your file and see if it has all the mandatory fields included.

You will also have to verify the system’s mapping of the fields.

Once that is complete, MineWhat will begin to process the feed you’ve imported. Depending on the volume of data contained in the field, this could take anywhere from a few minutes to an hour.

If you don’t have a feed in place you can also choose to let MineWhat crawl your website for product information.

After the feed is successfully set up the integration process is complete. 

[minewhathelp]

How to integrate MineWhat to your eCommerce store using Google Tag Manager

Marketeers and non-tech users can easily add MineWhat to their eCommerce stores using Google tag manager. Code snippet can be interchangeably used as script or page tag.

Google Tag Manager is a free tag management system. Instead of editing the site code every time to add code snippets, you can install the Tag Manager once and make updates from within Google tag manager. It is a placeholder for all the other page tags. 

The Pre-requisites: 

a) You need to have access to Google tag manager account of the desired eCommerce store.

b) You should have generated the code snippet for your eCommerce site in MineWhat , follow this post to do it.

  Integrating Minewhat code snippet in Google Tag Manager

Set up your account at the Google Tag Manager website. You’ll be asked to create a “container”, which is a collection of tags for a website. After completing the basic steps, you can add the MineWhat page tag in step 4. You need to click on "Custom HTML tag". 

Add new "Custom HTML Tag" screen opens up.

While generating the MineWhat code snippet, you'll have to click on the Google tag manager option.

Name the tag as ‘MineWhat’, and Paste the code snippet copied from the MineWhat app in the "HTML" area.

      Click the button "+ Add Rule to Fire Tag" , so that you can tell Google to load our snippet on "All pages" . Save it.

      Now you can place your tag by clicking “Create Version” in the top right corner.

      You can preview your changes here, so when ready, click "Save and Publish" 

      You have integrated the MineWhat code snippet in your store.

Verify the code snippet integration. 

Once you have integrated the code snippet into your site, we will start getting your site activities. You can quickly verify the integration, please read this post for more details.