Hyros

info

This is a pro feature. Get the pro version here

Hyros is an ad attribution and tracking platform. Its Universal Script follows visitors across your funnel and ties every step back to the ad, email, or organic source that brought them in. The Pixel Manager loads the Universal Script for you, consent-aware and on every page, and tags the shopping funnel milestones on the visitor journey.

note

The Hyros integration is currently in beta.

Available from version 1.63.1 of the Pixel Manager.

Setup

Product hash

Hyros identifies your account through the product hash, the ph value of your Universal Script.

1. Log in to Hyros and open Tracking → Universal Script.

2. Copy the Universal Script.

3. In the Pixel Manager, open Tracking Pixels → Hyros and paste it into the Product Hash field, then save.

   You do not have to hunt for the hash inside the snippet. Paste the whole script tag, or just the script URL, and the Pixel Manager extracts the ph value for you. If you already know the bare hash, you can enter that instead.

That is the whole setup for the tracking script. Do not also paste the Universal Script into your theme header or a header-scripts plugin: the Pixel Manager already loads it, and a second copy would make Hyros count every visit twice.

Connect WooCommerce to Hyros for sales data

The Universal Script tracks the visitor journey. It does not report your revenue. Hyros reads your orders directly from WooCommerce, so you also need its native WooCommerce connection:

1. In WordPress, go to WooCommerce → Settings → Advanced → REST API and create a key with read permission.

2. In Hyros, open Settings → Integrations, find WooCommerce, click Configure, and enter the consumer key, consumer secret, store name, and domain.

Without this step Hyros sees the traffic but no sales, and the attribution reports stay empty. See the Hyros WooCommerce guide for the details, including sales mapping and cash on delivery.

Application tag

Hyros attributes a tag to every visitor the moment they land on a tracked page. By default that tag is !clicked, and it is configured in Hyros under Tracking → Universal Script in the Application Tag field.

If you changed it there, mirror the same value in the Pixel Manager under Tracking Pixels → Hyros → Advanced → Application Tag. Leave the field empty to use the Hyros default.

This is worth changing when the same Hyros account tracks several funnels and you want the shop traffic separated from the rest. Only letters, digits, underscores, dashes, and the leading exclamation mark are allowed.

Supported Events

The Universal Script records page visits and the landing tag on its own. On top of that, the Pixel Manager adds these action tags to the visitor journey, so you can see the shopping funnel as a chain of checkpoints in the Hyros journey view:

Milestone	Hyros action tag
Product added to cart	!add_to_cart
Checkout started	!begin_checkout
Purchase completed	!purchase

These tags mark journey milestones. They carry no order values and no line items, and they do not create the sale in Hyros. The sale itself comes from the WooCommerce connection described above.

Here's a list of supported events.

Consent Management

Hyros belongs to the Pixel Manager's Attribution category. Attribution pixels follow the statistics consent category: with Explicit Consent Mode enabled, the Universal Script only loads, and the funnel tags are only sent, after the visitor grants statistics consent.

Testing

1. Open your shop with the browser console on and the Pixel Manager logger enabled (append ?pmwloggeron to the URL). You should see Hyros: pixel loaded.

2. In the network tab, look for a request to t.hyros.com/v1/lst/universal-script. It carries your product hash as ph, your application tag as tag, and the current page URL as ref_url.

3. Add a product to the cart and complete a test order. The console logs Hyros: !add_to_cart tag sent and Hyros: !purchase tag sent.

4. In Hyros, open the journey of that visitor. The action tags appear ordered by attribution time, with the most recent event on top.

If the script does not load, check that Hyros is enabled in the Pixel Manager, that the product hash is correct, and that your consent banner grants statistics consent.