HYROS Setup Checklist: Install HYROS Tracking Correctly

Many HYROS attribution problems don't start in HYROS itself — they start with an install that skipped a step. A script missing from the checkout page, an ad account that was never toggled on, a tracking template placed at the wrong level in Google Ads, or a booking tool that isn't passing the lead's email back. Each of these quietly removes sales or calls from your attribution, and you only notice weeks later when the numbers don't add up.

This checklist follows the order HYROS's own install guides use: tracking script first, then ad platforms, then your sales source, then calls and bookings, then testing. Work through it top to bottom and you'll have an install you can actually trust.

Quick version: copy the Universal Tracking Script from the Tracking section of HYROS and put it in the <head> of every page (once per page), including checkout and thank-you pages. Connect Meta and Google Ads under Integrations and make sure the HYROS URL parameters reach your ads. Connect one sales source (checkout platform or payment processor, not both). Set up booking/call tracking, then run a test visit, a test purchase and a test booking before you trust any report.

Why the install order matters

HYROS attributes a sale by matching a person across three things: the ad click (carried by URL parameters), their visits to your site (recorded by the Universal script), and the sale or call itself (sent by your cart, processor or booking integration). If any one of those links is missing, the sale still shows up — but without a reliable ad source. HYROS's Stripe guide says it plainly: if sales appear with no IP address, the script is missing from the checkout page. That's why the script and the sales source matter as much as the ad connections.

Step 1: Install the Universal Tracking Script on every page

The Universal script is the foundation of everything else. In HYROS, go to Tracking and copy the Universal Tracking Script (the Calendly guide describes the same thing as Tracking → Get Universal Script).

  1. Placement: HYROS recommends the <head> section, as high as possible. Just before </body> is the fallback if you can't edit the head.
  2. Once per page: the script should appear only one time on each page. Don't paste it inside another script, in a CSS file, or after the closing </html> tag.
  3. Cover every page type: landing pages, sales pages, checkout pages, booking pages and thank-you pages. Checkout and thank-you pages are the ones most often forgotten, especially when they live on a different builder than the main site.
  4. Publish and clear cache: save, publish or deploy the site, and clear any page caching so the new code is actually served.

On website builders this usually means a header custom-code setting; on WordPress the guide mentions the theme's header file or a plugin. Shopify stores are different: HYROS's Shopify guide covers the script through its 1-click integration rather than a manual paste.

Check it before moving on

Open your site, then either view the page source and search for "hyros", or open the browser console and look for HYROS messages. After a few minutes, visitor data should start appearing in your HYROS account.

Step 2: Connect Meta (Facebook) ads

In HYROS, open Integrations → Meta, click Add Account and give it a nickname. Facebook then opens a permission pop-up. HYROS's guide is firm here: choose Allow All Permissions, because skipping one leads to a "Permission Denied" error within about 24 hours. Then toggle on the ad accounts you want tracked, click Save, and confirm the integration shows as Connected.

The ad-level piece is the URL parameter string HYROS uses to tie a click to an ad set and ad:

fbc_id={{adset.id}}&h_ad_id={{ad.id}}

It goes in the URL parameters field in the Tracking section of your ads in Ads Manager. If you already have UTMs there, add & to the end and paste the HYROS string after it — a stray ? in front of existing parameters is the cause of the malformed values HYROS warns about. Two more caveats from the guide:

  • Link shorteners and redirects (bit.ly, Linktree) can strip the parameters. Use the direct landing page URL.
  • Editing live ads may reset the learning phase, so plan the change rather than doing it mid-scale.

If you run Lead Ads, there's an extra step: turn on Lead Ads for the pages that are running ads (Settings → Integrations → Facebook → Lead Ads) and make sure HYROS has Leads Access in Meta Business settings.

Step 3: Connect Google Ads and the tracking template

In HYROS's Google integration, click Add Account, sign in with Google and select the account(s). HYROS offers Automatic Setup (recommended), which applies the tracking template for you, or Manual Setup.

For a manual setup, the template goes in Google Ads under Settings → Account Settings → Tracking, in the Tracking template field:

{lpurl}&gc_id={campaignid}&h_ad_id={creative}

Click Test, then save. Shopping and Performance Max campaigns use a separate campaign-level template (under the campaign's Campaign URL options) that HYROS documents with a g_special_campaign=true flag. Two rules that cause the most trouble:

  • Level matters. Put the HYROS parameters at the same level and in the same place as your other UTMs. A campaign-level template overrides an account-level one, so a template added at the wrong level can silently be ignored.
  • Experiments aren't tracked. HYROS states it cannot track Google experimental campaigns at this time.

New campaigns can take up to 24 hours to sync into HYROS. If you'd rather have this wired up and checked for you, our HYROS setup service covers both ad platforms.

Step 4: Connect one sales source

HYROS needs to know about every sale. Pick the system that actually records the order:

Sales sourceHow HYROS connectsWatch out for
Shopify1-click integration with the Connect Shopify buttonSome apps (e.g. Recharge, PageFly, Zipify Pages) need their own add-on setup
StripeConfigure, grant Read & Write, make sure the toggle is onStripe-hosted payment pages can't hold the script, which limits accuracy
Other carts and checkoutsPlatform-specific guides in the HYROS docsScript still needs to be on the checkout page

The single biggest mistake: connecting both a checkout system and the payment processor behind it. HYROS's Stripe guide warns this duplicates sales. Choose one.

You can also import older sales (up to 365 days for Shopify and Stripe), which is useful for customer lifetime value. Those imported sales won't carry an ad source, so don't read them as attribution data. Stack-specific connections such as subscriptions, upsell funnels and CRMs are covered on our HYROS integrations page.

Step 5: Track booked calls

For high-ticket offers, the booked call is often the most important conversion. Using Calendly as the example from HYROS's guide:

  1. Install the Universal script on the booking page and on the thank-you page.
  2. In Calendly, open the event type, go to the confirmation page settings and choose Redirect to an external site, pointing to your thank-you page. Tick Pass Event Details — HYROS marks this as required. (The redirect option needs a paid Calendly plan.)
  3. In HYROS, go to Tracking → URL Rules and delete the Automatic Call Rule, so the same call isn't counted twice.
  4. Connect Calendly under Settings → Integrations → Calendly with Create New Integration.

Phone calls work differently: CallRail, for example, connects with an API key plus a webhook for incoming, outgoing and completed calls. HYROS also has guides for Acuity, OnceHub, SavvyCal and other schedulers.

Step 6: Test everything before you trust a report

Don't wait for real traffic to find a gap. Run these tests the day you finish:

  • Visit test: check the page source or console on every page type, then confirm visitor data arrives in HYROS.
  • Ad URL test: preview a Google ad and confirm the final URL contains gc_id; check that Meta ad URLs carry fbc_id and h_ad_id.
  • Purchase test: place a test order, then open that sale in HYROS. An IP address on the sale confirms the script fired on checkout.
  • Booking test: book a call with a test email, confirm the thank-you URL includes the passed details (such as ?email=), and check that a "Call" event appears in HYROS within a few minutes.

Common problems after setup

  • Sales with no ad source: usually the script is missing on checkout, or the order came through a shortener/redirect that dropped the parameters.
  • Duplicated revenue: both the checkout platform and the processor are integrated.
  • Calls counted twice: the Automatic Call Rule wasn't deleted.
  • Meta errors after a day: not every permission was allowed in the pop-up — reconnect and allow all.
  • Google campaigns missing: template at the wrong level, an experiment campaign, or the 24-hour sync window hasn't passed.

It's also normal for HYROS to report different numbers than Meta or Google Ads, since each platform counts conversions its own way. A difference isn't automatically a broken install — but the checks above are how you tell the two apart.

What this means for you

A correct HYROS install is less about one big step and more about not missing small ones across several tools. If you run multiple funnels, builders, or a phone-sales team, the number of places the script and parameters need to reach grows fast. If you'd like a second pair of eyes on it, a HYROS consultant can audit each step on this list against your actual stack and tell you which numbers you can rely on.

Frequently asked questions

Where do I get the HYROS tracking script?

In your HYROS account, go to the Tracking section and copy the Universal Tracking Script. HYROS recommends placing it in the head of every page, as high as possible, once per page.

Does the HYROS script need to be on checkout pages?

Yes. HYROS's guides say to install it on checkout and thank-you pages. If sales appear in HYROS without an IP address, the script is usually missing from the checkout page.

Should I connect both Shopify or my cart and Stripe to HYROS?

No. HYROS warns that integrating both a checkout system and the payment processor behind it duplicates sales. Connect one sales source.

What URL parameters does HYROS use for Facebook ads?

HYROS's Meta guide uses fbc_id and h_ad_id parameters (filled with the ad set ID and ad ID) in the ad's URL parameters. If UTMs already exist, append it with an ampersand rather than a question mark.

How long does HYROS take to show data after setup?

HYROS's guides say visitor data, sales and calls usually appear within a few minutes, while new Google Ads campaigns can take up to 24 hours to sync.

Want this tracked correctly in your account?

Our specialists set up, test and document GA4, GTM, HYROS and Triple Whale tracking so every conversion is counted. See our HYROS setup service.

Or hire a HYROS expert to audit your attribution.

Book a Free Audit →

Sources

More from the blog