Organic E-Commerce Initial Setup

SET UP GUIDE

This document is to provide step by step guidance on how to initially set up your HYROS account.

For the easiest setup, please follow each step in the exact order laid out:

Step 1 – Tracking to your Sources

Please select from the dropdown depending on what you would like to track and follow the guide:

This option to track using manual source parameters is very useful when we want to track specific links or pages.

To track any organic source simply add a manual source link parameter with ?el= followed by the name of the source you would like to track to the end of a URL.

HYROS will then create a source based on the name you used in that parameter and begin attributing clicks and sales to it.

Individual Source Link Tracking

To track specific traffic sources just change the text that comes after “=”

For example www.hyros.com?el=pinterestpost1. This will create a source automatically named “@pinterestpost1”.

For example, if you create 3 sources using this method such as “pinterestpost1”, “pinterestpost2” and “pinterestpost3” then when you load up a report you will be able to see how much traffic is coming in via each post. This can be useful for tracking the performance of individual links and pages.

Organizing Your Sources

We also recommend using our extra UTM parameters to automatically allow you to add these new organic sources into specific traffic sources, inside of Hyros.

Although this is an optional step, it allows you to better organize and segment your data later based on this information, without having to manually adjust any sources later.

To do this, simply add the following UTM parameter at the end of ?el=yoursource, separated by an & symbol:

htrafficsource=yourtrafficsourcename

So in an example where we are tracking three separate Pinterest links, instead of just using ?el=pinterestpost1, then ?el=pinterestpost2 etc, we would instead use the following UTM parameters for each link:

www.mysite.com?el=pinterestpost1&htrafficsource=pinterest
www.mysite.com?el=pinterestpost2&htrafficsource=pinterest
www.mysite.com?el=pinterestpost3&htrafficsource=pinterest

As you can see, although in this case we are creating 3 different sources by changing the name slightly after el=, we are including them within the same traffic source, which will allow us to group them together by traffic source in the reports later in a more automated way.

For more details on some specific setups, follow the use case examples below.

 

Use-Case Examples

Facebook Organic

Suppose we want to track URL links from organic posts on Facebook. As an example, we have this link below in the description https://www.facebook.com/community/whats-new/expanding-group-insights/.

If you want to track traffic accessing the above link, we need to append the custom parameter “el” at the end of the URL link and we can name it whatever we want, normally a unique name to be associated with that source, for example ?el=facebook-organic-post.

The final URL link will be like this:

https://www.facebook.com/community/whats-new/expanding-group-insights/?el=facebook-organic-post

If we have existing UTMs attached to the links, something like this link,

https://www.facebook.com/community/whats-new/expanding-group-insights/?utm_medium=social , we need to make sure that we add the & sign between the parameters.

The final URL link will be like this:

https://www.facebook.com/community/whats-new/expanding-group-insights/?utm_medium=social&el=facebook-organic-post 

Also, the same principle of adding the custom el parameter to URL links can be applied to URL links in comments, URL links in the Intro area or any links on your Facebook page.

Important: Please note that when we add the custom “el” parameter to any URL link we want to track the source, we need to make sure that the traffic is sent to a page where we have the Universal script, otherwise we will not be able to track the source of leads.

Youtube Organic

If you want to track the URL links in your youtube description videos, follow the procedure below. As an example, we have this link below https://docs.hyros.com/.

To track traffic accessing the above link, we need to append the custom parameter “el” at the end of the URL link and we can name it whatever we want, normally a unique name to be associated with that source, for example ?el=youtubeorganic.

The final URL link will be like this:

https://docs.hyros.com/?el=youtubeorganic

If we have existing utm’s attached to the links, something like the link below: https://docs.hyros.com/?utm_medium=social.

We need to make sure that we add the & sign between the parameters.

The final URL link will be like this:

https://docs.hyros.com/?utm_medium=social&el=youtubeorganic

Also, the same principle of adding the custom el parameter to URL links can be applied to URL links in comments, or any links.

Important: Please note that when we add the custom “el” parameter to any URL link we want to track the source, we need to make sure that the traffic is sent to a page where we have the Universal script, otherwise we will not be able to track the source of leads.

Instagram Organic

If you want to track bio links from Instagram, follow these next steps.

Let’s assume our link is www.google.com. If you want to track the traffic source using this link, you need to add the el parameter and you can name it for example instagram.

The final URL link will be www.google.com?el=instagram.

Step 3: Setting up tracking for emailing

To track leads accessing your email links, follow these guidelines.

In order to track specific links from your email campaigns, you need to add the he= and el= parameters at the end of the URL link.

Depending on your email software that you are using, you need to copy the email parameter that is associated:

  • Active Campaign: ?he=%EMAIL%&el=email
  • CleverReach: ?he={email}&el=email
  • Drip: ?he={{ subscriber.email }}&el=email
  • GetResponse: ?he=[[email]]&el=email
  • ConvertKit: ?he={{ subscriber.email_address }}&el=email
  • Mailchimp: ?he=*|EMAIL|*&el=email
  • Klaviyo: ?he={{ email }}&el=email
  • Aweber: ?he={!email}&el=email
  • Infusionsoft/Keap: ?he=~Contact.Email~&el=email
  • Clickfunnels: ?he=#EMAIL#&el=email
  • OmniSend: ?he=[[contact.email]]&el=email
  • Ontraport: ?he=[Email]&el=email
  • Everwebinar/Webinarjam: ?he={ATTENDEE_EMAIL}&el=email
  • GoHighLevel: ?he={{contact.email}}&el=email
  • HubSpot: ?he={{contact.email}}&el=email
  • Kartra: ?he={email}&el=email
  • Kajabi ?he={{email}}&el=email
  • MaroPost: ?he={{contact.email}}&el=email
  • Intercom: ?he={{email}}&el=email
  • SendGrid: ?he=[%email%]&el=email
  • SendLane: ?he=VAR_EMAIL&el=email
  • Sendy ?he=[Email]&el=email
  • Lemlist: ?he={{email}}&el=email

In the example below, we have the following link:

https://docs.hyros.com/direct-call-tracking/

When adding the parameter the final URL link with the he parameter will be like this:

https://docs.hyros.com/direct-call-tracking/?he={{ email }}&el=email

If we have existing utm’s attached to the links, something like the link below: https://docs.hyros.com/direct-call-tracking?utm_medium=social

We need to make sure that we add the & sign between the parameters.

The final URL link will be like this:

https://docs.hyros.com/direct-call-tracking/?utm_medium=social&he={{ email }}&el=email

Important: Please note that when we add the email parameter to any URL link we want to track the source, we need to make sure that the traffic is sent to a page where we have the Universal script, otherwise we will not be able to track the source of leads.

Should I Add the Above Parameters Globally or On Each Link?

Some email softwares will allow you to add parameters globally, which will be a much easier setup. However this entirely depends on the email software you are using.

One specific example where we can add the parameter el=email globally would be Klaviyo.

For more details follow the example below:

Klaviyo

In order to track email campaigns, you need to add the parameters mentioned above for Klaviyo.

Take in mind if you choose to add these parameters globally, then you can NOT add the he={{ email }}  part, because this is a dynamic parameter which Klaviyo does not allow to be added universally.

To understand the difference between the 2 email parameters we use, please see the below section. In some cases he={{ email }} may not be important, especially if you have a business with a short average customer journey, in which case this can be ignored and you can just add the el=email parameter globally:

How Does Email Tracking Work? “he=” vs “el=”

As you may have noticed, we have 2 different parameters which perform different functions that we advise adding to your email links:

For example, for Klaviyo these are: ?he={{ email }}&el=email

Which can be split up into:

“he={{ email }}” AND

“el=email”

he={{ email }}: This will generate the email of the lead and add it to the landing page URL once they click on the link inside the email. So if the lead “example@hyros.com” clicks on your email link it will generate a URL such as “www.yourlandingpage.com?he=example@hyros.com“.

We use this to ensure we track that original email on the rare occasions that the lead comes back to your funnel via an email link with totally different data points on a different device and then uses a different email.

So if they came back later in these circumstances and purchased using Hyros@Purchaseemail.com, we would be able to still track that email and therefore the purchase back to “example@hyros.com” and therefore continue their tracking profile from the original ad click.

This particular section is mostly useful for businesses with longer journeys. For e-commerce businesses or any business with a very short journey, this parameter is not necessary for accurate tracking.

el=email: This is the part of the parameter that actually creates the source. When we read the “el=email” parameter in the URL we will create an “@email” tag.

You can also change the name after “el=” to change the tag, so for example “el=emailcampaign1” will create a source named “@emailcampaign1”. This is useful if you want to track sales back to a specific email campaign.

Adding the Tracking Parameters Universally

If you want to simply add our parameter to the universal settings, please take in mind that this will track ALL emails back to the same source, such as “@email”. If you want to attribute sales and other events back to specific email campaigns, we suggest adding the recommend parameters to each specific link in your email campaigns.

However if you are happy with tracking globally, then please just copy this Tracking parameter instead: el=email

This then needs to be added in the UTM tracking section inside Klaviyo. In order to access this section, these steps needs to be followed:

  1. Click your account name in the top-right corner of your screen
  2. In the dropdown menu, select Account
  3. Click Settings, then open the UTM Tracking tab

Once inside, you need to turn it on and click on add custom UTM parameters:

A row will show up and you need to add the el parameter and on the next 2 fields we need to add email:

URL rules are an easy create way to create sources passively if the visiting URLs have distinct words or snippets in the URL.

How URL Rules Work

When URL rules are set HYROS will watch the URL that people visit from. Many times our users already have UTMs on these URL or they have distinct text in them.

An example is if you already have set up UTM parameters on your ORGANIC traffic. For example, a visit from youtube may have ?utm=youtube in the URL of the visitor.

You can create a rule that will allow HYROS to spot these unique terms and if spotted attribute a source to the visitor. This allows you to easily plug large tracking gaps from organic and easy to miss sources.

How To Create a URL Rule

Creating URL rules is easy. To do so just go TRACKING ->URL RULES. Then click “+ Add new rule”

Next, inside the tag field set the tag to something that will indicate the source, action or sale you would like to track. Make sure you use the correct tag type depending on what you would like to track, to read more about how are tags work please see the guide HERE.

After, adjust the name to whatever you like. For example, if you are using a URL rule to track youtube organic traffic, change the name to “Youtube” or “Youtube_Organic”.

Then analyze the text of visiting URLs you would like to track. For example, if you are sending traffic with a URL that looks like this “yoursite.com?utm_source=youtube” you will want to use the unique text “utm_source=youtube”.

Paste this text in the “Words to match” form. Here is an example:

Use-Case Examples

Please see the dropdown below and follow the exact steps to track some of the more commonly found external sources:

Youtube

Name = “Youtube_Organic”

Tag = “@youtube_organic”

Words to match = “youtube.”

Words to ignore = Empty

Apply rule to = “previous URL”

Advanced Settings = No changes

Google Search

Name = “google_search”

Tag = “@google_search”

Words to match = “google.”

Words to ignore = Empty

Apply rule to = “previous URL”

Advanced Settings = No changes

Google Organic Shop (for Shopify Stores)

Name = “google_shopping”

Tag = “@google_shopping”

Words to match = “utm_campaign=sag_organic”

Words to ignore = Empty

Apply rule to = “tracked URL”

Advanced Settings = No changes

Facebook Shopping

Name = “Facebook_shop”

Tag = “@Facebook_shop”

Words to match = “utm_campaign=Facebook_UA”

Words to ignore = Empty

Apply rule to = “tracked URL”

Advanced Settings = No changes

Bing Search

Name = “Bing_search”

Tag = “@bing_search”

Words to match = “bing.”

Words to ignore = Empty

Apply rule to = “previous URL”

Advanced Settings = No changes

Ecosia Search

Name = “ecosia”

Tag = “@ecosia”

Words to match = “ecosia.”

Words to ignore = Empty

Apply rule to = “previous URL”

Advanced Settings = No changes

DuckDuckGo

Name = “DuckDuckGo”

Tag = “@Duckduckgo”

Words to match = “Duckduckgo.”

Words to ignore = Empty

Apply rule to = “previous URL”

Advanced Settings = No changes

Step 2 : Connecting Your Store

WRITTEN GUIDE

Step 1 – Install the Universal Script inside Bigcommerce

1. Inside Hyros go to Tracking -> Tracking Scripts -> Get script -> Copy script. Alternatively, you can copy the script below.

2. Next go to your BigCommerce account. Select Storefront->Script Manager->Create Script. Inside Create Script section, follow these next steps:

  • Fill in “Name of the script” and “Description”;
  • Set “Location on page” to header;
  • Select All pages for “Select pages where script will be added”;
  • Script category – Targeting Advertising;
  • Script type -> Script. Paste the Universal Script.
  • Click “Save”.

Step 2 – Create the integration inside Hyros

1. Go to Settings -> Integrations -> Configure BigCommerce -> Create New Integration;

2. Fill in a name for the integration. For “Access token” and “Store hash” we need to go back to your BigCommerce account.

3. Inside your BigCommerce account go to Advanced settings -> API Accounts.

4. To setup API accounts, follow these next steps:

  • Fill in the Name field with Hyros;
  • Set the following to “Read-only”: Customers, Information & Settings, Orders, Order Transactions, and Products.
  • Click Save.
  • Once you click Save, it will automatically download a txt file containing the Access Token and the Store Hash, among other data. Also, a popup will show up with the Access token details.

5. Copy the Access token, go back to your Hyros account and paste it inside the Access token field.

6. Next go back to your BigCommerce account and copy the Store hash details. The store hash can be found in 2 places:

  • Inside your Bigcommerce account, you need to go to the URL link and copy the store hash. In this example, this is the store hash: 4pd5jpefmh
  • You can also find the store hash in the file you just downloaded after saving the API. For example, this is the store hash: 4pd5jpefmh

7. Once you copied the store hash go back to your Hyros account, paste it inside the Store hash field and click Save integration.

That concludes the Bigcommerce setup.

Please do NOT use the “Hyros” application inside the Shopify apps store to integrate Hyros, this will not work. Instead please follow the instructions below exactly as they are laid out.

 

Written Guide

1- Use our integration HERE to integrate your store.

 

 

2- Scroll down and Toggle on Add to Cart Tracking, then click “Get Configured tracking script” and copy the script.

You can also copy the same shopify script directly below:

3- Go into your shopify account and place it on your shopify pages by going to online store -> themes -> edit code -> theme.liquid and inserting the code between the “<head></head>” tags as shown in the screenshots:

 

WARNING: If your theme goes through any updates or changes please double check the universal script is still in your theme as shown above, some themes may drop the script and break your tracking following updates

4 – Go to your Shopify admin dashboard. Go to SETTINGS at the bottom of your Shopify dashboards left side bar menu

5- Once in settings click on “CHECKOUT”

 

6- Once in checkout scroll down to additional scripts

7- Paste the Shopify Universal script from HYROS into Post-purchase page and Order status page

IF THERE IS NO POST PURCHASE PAGE FIELD: then do not worry, just paste the script inside the “Order status” field and that should be sufficent. However if you do see the “Post purchase page” field because you have an app/add on that has created a post-purchase page, then adding them on both is mandatory to track.

 

8- Ensure that the email field at checkout is mandatory. If a user does not enter an email we will not be able to track the sale. You can also do this in your checkout settings here:

9- Click SAVE in the top right hand corner.

 

Optional:

Sales Mapping using Shopify

We understand every business is unique and because of that we want you to have full control regarding the particular step of the process in which we are going to count your sales, to take advantge of this feature please go to your Shopify Integration from Hyros > Settings > Integrations and click on configure below Shopify, then click on the Edit icon:

Then scroll down to the Events to be processed as Sales section and select the event status Hyros should consider a Sale from now on, (options available are Order Created, Order Paid, Order Fulfilled), after that please click on the Update State button to confirm the changes.

 

This will complete your Shopify set up. Move to the next step in this set up document!

 

Please do NOT use the “Hyros” application inside the Shopify apps store to integrate hyros, this will not work. Instead please follow the instructions below exactly as they are laid out.

 

Written Guide

1- Use our integration HERE to integrate your store.

 

2- Scroll down and Toggle on Add to Cart Tracking, then click “Get Configured tracking script” and copy the script.

You can also copy the same shopify script directly below:

3- Go into your shopify account and place it on your shopify pages by going to online store -> themes -> edit code -> theme.liquid and inserting the code between the “<head></head>” tags as shown in the screenshots:

 

WARNING: If your theme goes through any updates or changes please double check the universal script is still in your theme as shown above, some themes may drop the script and break your tracking following updates

4 – Go to your Shopify admin dashboard. Go to SETTINGS at the bottom of your Shopify dashboards left side bar menu

5- Once in settings click on “CHECKOUT”

 

6- Once in checkout scroll down to additional scripts

7- Paste the Shopify Universal script from HYROS into Post-purchase page and Order status page

IF THERE IS NO POST PURCHASE PAGE FIELD: then do not worry, just paste the script inside the “Order status” field and that should be sufficent. However if you do see the “Post purchase page” field because you have an app/add on that has created a post-purchase page, then adding them on both is mandatory to track.

 

8- Ensure that the email field at checkout is mandatory. If a user does not enter an email we will not be able to track the sale. You can also do this in your checkout settings here:

9- Click SAVE in the top right hand corner.

10 – Next, inside Shopify, go to Apps > Better Cart. Once inside, go to Settings, scroll down to Custom scripts and click the New Custom scripts button:

11 – A pop-up window will appear and you need to select All Pages, in the Name field give it a name such as Hyros, copy the normal Universal script below and paste it as explained in the image below. Once you’re done hit the Create button.

Please use this script and NOT the one from step 2 for this part:

This will complete your Shopify set up. Move to the next step in this set up document!

 

If you are using Intrecart with Shopify complete the Shopify set up in the step above and then alert your direct onboarding rep. We will complete the Intrecart set up for you.

Please do NOT use the “Hyros” application inside the Shopify apps store to integrate hyros, this will not work. Instead please follow the instructions below exactly as they are laid out.

 

Written Guide

1- Use our integration HERE to integrate your store.

 

2- Scroll down and Toggle on Add to Cart Tracking, then click “Get Configured tracking script” and copy the script.

You can also copy the same shopify script directly below:

3- Go into your shopify account and place it on your shopify pages by going to online store -> themes -> edit code -> theme.liquid and inserting the code between the “<head></head>” tags as shown in the screenshots:

 

WARNING: If your theme goes through any updates or changes please double check the universal script is still in your theme as shown above, some themes may drop the script and break your tracking following updates

4 – Go to your Shopify admin dashboard. Go to SETTINGS at the bottom of your Shopify dashboards left side bar menu

5- Once in settings click on “CHECKOUT”

 

6- Once in checkout scroll down to additional scripts

7- Paste the Shopify Universal script from HYROS into Post-purchase page and Order status page

IF THERE IS NO POST PURCHASE PAGE FIELD: then do not worry, just paste the script inside the “Order status” field and that should be sufficent. However if you do see the “Post purchase page” field because you have an app/add on that has created a post-purchase page, then adding them on both is mandatory to track.

 

8- Ensure that the email field at checkout is mandatory. If a user does not enter an email we will not be able to track the sale. You can also do this in your checkout settings here:

9- Click SAVE in the top right hand corner.

10 – Copy this universal script below (please do NOT use the one above from step 2, this is a different script):

 

 

11 – Go to your pagefly pages and select a page:

12 – Click the custom code Icon on the bottom left, then paste our universal script inside the javascript section.

Please make sure to remove the “<script> </script>” tags at the beggining and end of the universal script before saving:

13 – Once you click save, please then save and publish the whole page on the top right. The changes will not take affect until you do this:

14 – Repeat this for all pages on Pagefly.

This concludes the setup, please move on to the next steps.

Please do NOT use the “Hyros” application inside the Shopify apps store to integrate hyros, this will not work. Instead please follow the instructions below exactly as they are laid out.

 

Written Guide

1- Use our integration HERE to integrate your store.

 

 

2- Scroll down and Toggle on Add to Cart Tracking, then click “Get Configured tracking script” and copy the script.

You can also copy the same shopify script directly below:

3- Go into your shopify account and place it on your shopify pages by going to online store -> themes -> edit code -> theme.liquid and inserting the code between the “<head></head>” tags as shown in the screenshots:

 

WARNING: If your theme goes through any updates or changes please double check the universal script is still in your theme as shown above, some themes may drop the script and break your tracking following updates

4 – Go to your Shopify admin dashboard. Go to SETTINGS at the bottom of your Shopify dashboards left side bar menu

5- Once in settings click on “CHECKOUT”

 

6- Once in checkout scroll down to additional scripts

7- Paste the Shopify Universal script from HYROS into Post-purchase page and Order status page

IF THERE IS NO POST PURCHASE PAGE FIELD: then do not worry, just paste the script inside the “Order status” field and that should be sufficent. However if you do see the “Post purchase page” field because you have an app/add on that has created a post-purchase page, then adding them on both is mandatory to track.

 

8- Ensure that the email field at checkout is mandatory. If a user does not enter an email we will not be able to track the sale. You can also do this in your checkout settings here:

9- Click SAVE in the top right hand corner.

 

10 – copy this new universal script below (please do NOT use the one above from step 2):

11- Inside Shopify, go to Apps > Recurring Billing by Recharge. Once inside, go to the checkout settings here:

 

12- Scroll down and enable javascript on page 1 of the checkout, then paste the unversal script:

If you do not see the option to enable javascript above: On some versions of Recharge this option is not available. In order to complete this step you must reach out to Recharge support to request that they enable this for you manually.

 

13- Scroll down and do exactly the same for the thank you page.

Please take in mind that this does not work if you don’t have a Recharge checkout page.

By default, we will be updating the shopify order to include upsell/recurring payments via Recharge and other ad ons such as zipify, so you won’t need to do anything. If you are experiences issues with upsell payments please reach out to the support team.

This will complete your Shopify set up. Move to the next step in this set up document!

 

Please be aware that this guide specifically covers the add-on from RevenueHunt.

Other similar add-ons may be tracked differently, so please reach out to the support team if you are using any other quiz add-on.

If you are using the add-on from Revenue Hunt, first please make sure you are tracking your Shopify Store as advised the main Shopify Guide above this one.

Then copy the universal script here:

 

Last, go to the Product Recommendation Quiz add-on, select the quiz you want to track and click “edit”. In the page builder section, find the question that asks the lead to enter their email and select the edit settings Icon.

Click Add Custom Javascript and paste the script, WITHOUT the “<script></script>” tags at either end of the code, here as shown:

Then click publish.

Now Hyros should be able to track any email entered in that quiz.

You can move on to the next steps.

Please do NOT use the “Hyros” application inside the Shopify apps store to integrate Hyros, this will not work. Instead please follow the instructions below exactly as they are laid out.

 

Written Guide

1- Use our integration HERE to integrate your store.

 

 

2- Scroll down and Toggle on Add to Cart Tracking, then click “Get Configured tracking script” and copy the script.

You can also copy the same shopify script directly below:

3- Go into your shopify account and place it on your shopify pages by going to online store -> themes -> edit code -> theme.liquid and inserting the code between the “<head></head>” tags as shown in the screenshots:

 

WARNING: If your theme goes through any updates or changes please double check the universal script is still in your theme as shown above, some themes may drop the script and break your tracking following updates

4 – Go to your Shopify admin dashboard. Go to SETTINGS at the bottom of your Shopify dashboards left side bar menu

5- Once in settings click on “CHECKOUT”

 

6- Once in checkout scroll down to additional scripts

7- Paste the Shopify Universal script from HYROS into Post-purchase page and Order status page

IF THERE IS NO POST PURCHASE PAGE FIELD: then do not worry, just paste the script inside the “Order status” field and that should be sufficent. However if you do see the “Post purchase page” field because you have an app/add on that has created a post-purchase page, then adding them on both is mandatory to track.

 

8- Ensure that the email field at checkout is mandatory. If a user does not enter an email we will not be able to track the sale. You can also do this in your checkout settings here:

9- Click SAVE in the top right hand corner.

 

Steps inside of Paypal

If for some reason you can not complete any of the below steps, you will still be tracking Paypal sales by default, but please keep in mind that when a lead purchases with a unique Paypal email that has not been tracked by Hyros on a previous page, we will not be able to track the sale back to the correct ad or origin email.

This means we can not guarantee 100% tracking accuracy for Paypal sales in these cases, because we rely on the PayPal email matching exactly with a previously tracked email. The steps below are intended to resolve this issue.

1. Enable auto return 

PayPal allows configuring the URL where the user will be redirected once finished the checkout.

Account Settings >> Website payments >> Website preferences

2. Enable payment data transfer

 Enable this setting so Paypal sends the transaction data to the return URL set in the previous URL. This will include the transaction id, which we will use to track the sale back to the correct lead.

You can enable it here:

3. Use the correct payment buttons

Take in mind that this tracking method will ONLY work when you are using these buttons for Paypal payments, any other buttons will not work:

 

Once this is done, PayPal will send the transaction ID (labelled “tx” in the URL as shown in the screenshot below) to the thank you page.

Our tracking script will grab this tx and associate it with the click, so that when we receive the PayPal sale we can use this information to track the sale back to the correct lead in the case that the PayPal email is not the same as an email that we previously tracked in their journey, despite the fact we can not track the PayPal checkout page.

This concludes the setup.

 

Step 1 – Install the Universal Script

Video Guide:

 

Inside Hyros go to Tracking Scripts -> (opens in a new tab)”>Tracking -> Tracking Scripts -> Get script -> Copy script. Alternatively, you can copy the script below.

Step 2 – Add code to order confirmation page

Inside your Squarespace account you need to install the below code into the order confirmation page:

<div id=“hyros-email”> {customerEmailAddress} </div>

Inside your Squarespace dashboard got to Settings. Then you need to select Advanced:

In Advanced you must select Code Injection:

Here you need to scroll to the bottom of the page until you see the order confirmation page and paste the small snippet of code where you have place:

IF YOU WANT TO TRACK RECURRING SALES : Please be aware that WooCommerce does not currently send recurring sales into Hyros by default. We currently track recurring sales for WooCommerce users who also use the YITH Subscription plugin.

If you are using a different plugin for recurring sales, please contact support and we can try to make an update for your particular case to track recurring sales.

Video Set Up Guide

Here is a link to our WooCommerce integration

Here is the UNIVERSAL script referenced in the video

WooCommerce does not have written instructions because every WordPress site is different. When setting up your tracking in WooCommerce refer to the video above.

Sales Mapping using Woocommerce

In some cases we want to have a record of sales as early in the process as possible, for these scenarios we have updated our platform’s integration with WooCommerce so different order statuses can be counted as Sales by Hyros.

To enable this option please access your WooCommerce integration settings from Hyros > Settings > Integrations and click Configure below WooCommerce, after this please click on the Edit button:

Please type in the different order states you would like Hyros to consider as Sales, then complete the process by clicking on Change State Values:

Then make sure that

-You have installed the UNIVERSAL script (above) is pasted on EVERY page of the site including checkout pages.

-You complete the WooCommerce webhook integration (covered in the video above).

You can generate your webhook HERE.

-Then perform tracking confirmation in the next step

If some or all of your pages are on Zipify pages, follow the steps here to add the universal script to them. You will still need to follow the Shopify guide above to connect the rest of your store.

First, copy the universal tracking script below:

Then inside your Zipify Pages account go to “settings” and “global scripts”, Click “add new” and to add the script on each section you have available:

Adjust the script as shown below:

This concludes the set-up, please also ensure your Shopify store is also tracked following the guide above

Ask your onboarding rep.

Step 3 : Setting up your currency and timezone

Hyros allows you to convert the currency that we receive from your payment software and display a currency of your choice easily inside Hyros.

To configure your currency conversion settings, just go inside your true tracking settings HERE, and select the correct currency on your Inbound and Outbound Currency:

Inbound Currency – This refers to the currency that your integrations are using. For example, if sales are shown in USD inside your payment processor account, select USD.

IF you are using multiple currencies for different payment softwares that are integrated with Hyros, you can select the inbound currency for each specific integration inside the Integrations tab. Just click on the integration you wish to use to convert your currency and change the inbound currency. Inbound currencies set on a specific integration will take priority over the inbound currency set inside your true tracking settings.

Outbound Currency – This is the currency that Hyros will show inside your account, and what you will see inside your reports. This NEEDS to match with the currency shown inside your ad accounts, otherwise, the data will not make sense when comparing with Facebook or Google.

At this time we only allow a single outbound currency. Having multiple outbound currencies would cause confusion inside your reports as it would be displaying multiple currencies alongside each other.

If you already have sales inside your account, you can select the option to “Update Sales Prices” to change the currency on your previous sales as well. Please ensure that the inbound currency is correct first before doing this though.

 

Multiple Currencies from a Single Store or Integration

This is most useful when you have an e-commerce store or any funnel that accepts multiple currencies on the same site. In order to convert these values correctly, you will need to select “Grab currency from event” inside your integration as shown below:

This ensures hyros does not assume that all values are in the inbound currency only. Hyros will instead read the currency from each sale, then convert that currency to the selected Hyros currency.

This is not available for all integrations.

WARNING: Currency Conversion and Your Revenue Cap

As you know, your account is billed depending on revenue tiers. If you go above the cap for your pricing tier, you will need to upgrade your subscription in order to continue to receive data. This is why it is VERY important to configure your inbound currency correctly. For example, if you have your inbound currency set to USD (by default), but you’re actually using pesos, Hyros will assume that number is in USD and you will reach your cap much faster than you should.

For more information on how your billing plans work, please see HERE.

Make sure the timezone in your Hyros account matches the timezone in your Ad accounts. Follow the instructions below in the documentation.

 

  1. Hyros

To match the Hyros timezone with your Ad platforms, follow these steps:

  • Go to “Settings” and select Profile
  • Set up timezone from the dropdown and click Save.

 

2. Facebook 

To check the time zone of your Facebook Ad account, follow these steps:

  • Click on “Ad Account Settings
  • Select “Payment Settings
  • On the right side scroll down and click on “Edit” inside Business Info area
  • On the Pop Up Scroll at the bottom and there you will see Timezone

3. Google

To check the time zone of your Google Ad account, follow these steps:

  • Inside your Google dashboard, go to Settings and click Account Settings
  • Here you should see the Timezone section

4. Tik-Tok

To check the time zone of your Tik-Tok Ad account, follow these steps:

  • On your TikTok Ads Manager dashboard, click on your account name in the top-right corner
  • Click on the “Ad Account Settings
  • Under your Basic Information you will find your Time Zone.

 

Step 4 : Testing And Confirming Your Tracking

Part 1 – Checking the Hyros Organic Tracking Parameter 

First find the live organic link which you are trying to track.

Click on the link just like a lead would. When you are sent to the landing page, check the URL of that page. You should see the Hyros tracking parameter clearly attached in the URL like this:

Also note if you have multiple UTMs on that link and Hyros is NOT the first one, then it should begin with an “&” symbol instead of an “?”, just like this:

If the URL does not appear with our tracking parameter cleanly attached, then there could be a number of issues. Please check the following:

  • Please make sure you have added the Hyros tracking parameter on your link.
  • If added, please make sure there are no typos on the URL.
  • Please also make sure there are no redirects on that link, as these may drop any tracking parameters.

If you have followed all of these steps and you are still having issues, please let the support team know and send us the link in question so we can investigate further.

If it is working correctly, please move on to the next step.

Part 2 – Testing the Opt-in

Please note that if your funnel does not have an opt in you can go straight to the next step to test the sale.

If it does, after confirming part 1, please carry on through the funnel as if you were a lead and opt-in.

Then inside your Hyros account go to the “sales data” tab and then to “leads”, you should see the email you just used for your test opt-in here:

Then if you click on the email itself, you will open the lead profile. You should see the source labelled as a “@tag” in the journey just like the example below:

If you do not see any email inside the “sales data tab”  – then it is likely that the optin page does not have our universal script attached. Please revisit step 4 to make sure all pages, including any embedded opt-in forms, have the universal script in the header code.

If you see the email but do not see the @source tag in the journey – In this case either you have not added the Hyros tracking parameter correctly or the landing page is not being tracked by our universal script.
Please revisit the previous steps in the guide to ensure you have added the manual tracking parameter “el=” correctly, and also make sure you have added the universal script to the landing page following step 4.

If everything is working, please proceed to the final test.

Part 3 – Testing your Sales Tracking 

Staying on the same funnel, carry on like a lead would and perform a test purchase.

Allow a few moments and check the same lead journey again, you should see a new $tag, signifying a sale has been tracked and has been attributed correctly to the lead you have created.

See the below screenshot as an example:

If you do not see any sale – please go back to step 5 to confirm you have integrated with the correct checkout or payment processor software.

If you see a sale, but not attributed to the same email – If you used a brand new email for the test purchase that did not match with the previous email we tracked, then it’s possible that the checkout page is not being tracked by our universal script. Please check step 4 again to confirm all pages are being tracked by the universal script.

If the sale is correctly inside Hyros and attributed to the lead the setup is complete. Please test any other sources and funnels in the same way.

Part 1 – Checking the Hyros Email Tracking Parameter 

Send yourself a test email from your email software. Please note that this is the only way to test it properly, if you try and test the link from anyone outside of a real email, our URL parameters will not work in the same way.

Click on the link just like a lead would. When you are sent to the landing page, check the URL of that page. You should see both of Hyros tracking parameter clearly attached in the URL like this:

After “he=” you should see your test email loaded in the URL.

Also note if you have multiple UTMs on that link and Hyros is NOT the first one, then it should begin with an “&” symbol instead of an “?”, just like this:

If the URL does not appear with our tracking parameter cleanly attached, then there could be a number of issues. Please check the following:

  • Please make sure you have added the Hyros tracking parameter on your link.
  • If added, please make sure there are no typos on the URL.
  • Please also make sure there are no redirects on that link, as these may drop any tracking parameters.
  • Please check you are testing from an email in your inbox and not from anywhere else.

If you have followed all of these steps and you are still having issues, please let the support team know and send us the email in question so we can investigate further.

If it is working correctly, please move on to the next step.

Part 2 – Testing the landing page tracking

After confirming part 1, inside your Hyros account go to the “sales data” tab and then to “leads”, you should see the email that was loaded in the URL on the previous step here:

Then if you click on the email itself, you will open the lead profile. You should see the source labelled as a “@tag” in the journey just like the example below:

If you do not see any email inside the “sales data tab”  – then either the “he=” tracking parameter is not correctly in the URL, or it is possible that the landing page does not have our universal script attached.
Please revisit the email setup step to ensure the parameters are added correctly, and then step 4 to make sure all pages have the universal script in the header code.

If you see the email but do not see the @source tag in the journey – In this case either you have not added the Hyros “el=” tracking parameter correctly or the landing page is not being tracked by our universal script.
Please revisit the previous steps in the guide to ensure you have added the manual tracking parameter “el=” correctly, and also make sure you have added the universal script to the landing page following step 4.

If everything is working, please proceed to the final test.

Part 3 – Testing your final funnel pages and Sales Tracking 

Staying on the same funnel, carry on like a lead would and perform a test purchase.

Allow a few moments and check the same lead journey again, you should see a new $tag, signifying a sale has been tracked and has been attributed correctly to the lead you have created.

See the below screenshot as an example:

If you do not see any sale – please go back to step 5 to confirm you have integrated with the correct checkout or payment processor software.

If you see a sale, but not attributed to the same email – If you used a brand new email for the test purchase that did not match with the previous email we tracked, then it’s possible that the checkout page is not being tracked by our universal script. Please check step 4 again to confirm all pages are being tracked by the universal script.

If the sale is correctly inside Hyros and attributed to the lead the setup is complete. Please test any other sources and funnels in the same way.

Part 1 – Testing the funnel and URL rule tracking

Please carry on through the funnel as if you were a lead and opt-in (or go straight to purchase if there is no opt-in), making sure to go through the same URL that you have used in your URL rule in the “words to match”.

If you have set this as a “previous URL” such as for Google organic search tracking, then simply find your site via Google search and click on your link as if you were a lead.

Then inside your Hyros account go to the “sales data” tab and then to “leads”, you should see the email you just used for your test opt-in/purchase here:

Then if you click on the email itself, you will open the lead profile. You should see the source labelled as a “@tag” in the journey just like the example below:

If you do not see any email inside the “sales data tab”  – then it is likely that the optin/checkout page does not have our universal script attached. Please revisit step 4 to make sure all pages, including any embedded opt-in forms, have the universal script in the header code.

If you see the email but do not see the @source tag in the journey – In this case there may be an error in the URL rule set. Perhaps there is a typo in the “words to match” used, or during your test you did not click on the same URL.
It could also be possible that the universal script is not added to the URL that you are using to fire your URL rule.
Please revisit the previous steps in the guide to ensure you have added the URL rule correctly, and also make sure you have added the universal script to the page following step 4.

If everything is working, please proceed to the final test.

Part 3 – Testing your Sales Tracking 

Staying on the same funnel, carry on like a lead would and perform a test purchase.

Allow a few moments and check the same lead journey again, you should see a new $tag, signifying a sale has been tracked and has been attributed correctly to the lead you have created.

See the below screenshot as an example:

If you do not see any sale – please go back to step 5 to confirm you have integrated with the correct checkout or payment processor software.

If you see a sale, but not attributed to the same email – If you used a brand new email for the test purchase that did not match with the previous email we tracked, then it’s possible that the checkout page is not being tracked by our universal script. Please check step 4 again to confirm all pages are being tracked by the universal script.

If the sale is correctly inside Hyros and attributed to the lead the setup is complete. Please test any other sources and funnels in the same way.

Once you’re done with the setup process, you can Learn how to use HYROS by taking this PRODUCT TOUR, and by seeing our HOW TO USE guides