How to install the Pixel?
Read the introduction to the Billy Pixel article to learn more about the Billy Pixel.
In this guide, different ways of installing the Pixel are described. The installation for Shopify stores is different from e-commerce, B2B and B2C. In these cases, the installation is done via Google Tag Manager.
Headless stands for a Shopify store that has a different front-end or different backend than a default Shopify store. If you have a headless Checkout, please use the Google Tag Manager guide. If you have a headless front-end but native Shopify checkout, follow the Shopify installation guide.
The pixel is unique for every client. The pixel per client can be copy and pasted from Settings -> Billy Pixel in your Billy Grace account.
Table of contents
Installation via Google Tag Manager
Follow the step-by-step explanation or watch the instruction video.
First navigate to Google Tag Manager to import the Billy Grace configuration templates. In GTM navigate to Templates -> Search Gallery
In the Gallery, search for 'billy grace' and add both templates to your workspace.
Click on one of the templates and click on "Add to workspace", on the next step click on "Add"
The Configuration Web Pixel templates must be added to the header of your website. This can be done by creating a new tag in Google Tag Manager. First, you need to create a trigger for a Pageview on All pages level. (it could be that you already have this in your Google Tag Manager, in that case you don't have to follow the first step).
Trigger
Add a new Trigger in Tag Manager by navigating to Triggers and clicking on New.
Give the trigger a name, for example: All Pages - Pageview and click on Trigger Configuration
Select Page view and then click on Save.
We will add a new tag for the Pixel to load on every page of the website. Go to Tags and click on New.
Give the Tag a name, for example Billy Pixel | Snippet and click on Tag configuration
Select the Billy Grace - Configuration Web Pixel template and paste the Pixel Snippet from the Billy Grace Pixel page:
Next step is to add the tracking ID from Billy Grace into the tag:
You can find the ID on the Pixel Snippet page.
Now add the Pageview - all pages trigger to the tag. The Tag will look like this:
Next, click on Save. To finish the installation, you have to publish the changes to the live website.
The Pixel is now installed and will start to receive the first data soon. If you have installed the Pixel via Google Tag Manager, you will need to configure Custom Events. Read more about Custom Events here.
Installation for Shopify stores
The pixel needs to be placed as a Custom Event in Shopify settings. Follow the steps or watch the how-to video.
1. Create a Customer Event.
Copy the pixel snippet (The snippet can be copied inside the app - Settings - Pixel) and log into your Shopify account.
Go to: /Admin and navigate to Settings - Customer Events
Click on add Custom Pixel
As name fill in Billy Grace Pixel and click on add pixel
Paste the Pixel inside the code block
First click on Save in the top right corner of the screen and then click on Connect
After saving, make sure to set the right Customer Privacy options, the same as in the screenshot below:
Permission to Analytics
Data sale to Data collected does not qualify as data sale
Frequently asked questions (FAQ)
I have a content policy on my website, which domains should I set on the allowance list?
Read this article to learn more about which Billy Grace domains to add to the allowance list.