A headless Shopify store is one that has a custom built front end website that still uses the Shopify checkout system to handle payments and back end management. If you are running a regular Shopify store, see our installation guide for regular stores here: http://help.thoughtmetric.io/en/articles/5982672-shopify-installation-guide

The first part of the installation is to install the ThoughtMetric app on your store.

a.) Make a ThoughtMetric account

The first step is to make a ThoughtMetric account by going to https://thoughtmetric.io/users/sign_up and signing up.

b.) Select the Shopify platform

Once you make an account you will be directed to an onboarding guide. Click on the Shopify button to view the installation instructions for that platform.

c.) Install ThoughtMetric App

Install the ThoughtMetric app on your Shopify store by entering your Shopify store URL and clicking "Install App". If you need help finding your store URL refer to the documentation here.

d.) Enable Tracking Pixel

Click the "Enable Tracking Pixel" button to enable the ThoughtMetric tracking pixel on your theme. You will be redirected to your Shopify theme editor where you should see the ThoughtMetric Pixel app block toggled on. Click "Save" in your theme editor to enable the pixel.

a.) Navigate to Settings -> Customer Events then click Add Custom Pixel and enter "ThoughtMetric" as the name.

b.) Configure the Customer Privacy Settings. Set Permission to Not Required and Data Sale to Data collected does not qualify as data sale. ThoughtMetric doesn't sell customer data and all collected data can be fully anonymized.

c.) Paste the revenue tracking code from your ThoughtMetric onboarding guide into the code text box and click Save then click Connect.

d.) Install checkout extension

Navigate to Settings -> Checkout then click Customize.

Select the Thank You Page from the page dropdown then click Add App Block.

Select the ThoughtMetric App Block then click Save.

e.) Click Save

f.) Wait for ThoughtMetric to verify the installation

Go back to the ThoughtMetric onboarding step that you were on and scroll to the bottom of the page and click “Done”. This will bring you to the final step where ThoughtMetric will check the installation of the tracking code to make sure it has been installed correctly. Once ThoughtMetric detects that the tracking code is correctly installed you have finished the setup and can proceed to the ThoughtMetric dashboard. Note: for ThoughtMetric to detect that the system is working it listens for data coming for your website. So to speed up detection you can go to your website and refresh the page a few times to send data our way.

a.) Switch E-Comm platform setting to 'Custom'

Head to the Configure -> Store settings page in ThoughtMetric and change your e-commerce platform to "Custom"

b.) Install tracking pixel code into your front end
Head to the Configure -> Tracking Code page. Here you will find the tracking pixel code that needs to be installed into the header of your custom front end.