WooCommerce Integration | Hyros Documentation

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.

Optional steps:

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

Tracking Cash On Delivery Events as Sales

By default, Hyros will ignore "Cash on Delivery" events because money is not actually received.

However if you would prefer to track this as a sale even if it is not paid, then just turn this toggle on inside your Woocommerce integration and we'll process these events as sales once the order has the "PROCESSING" status:

WooCommerce Subscription plugin rebill

By default, "Subscription plugin rebilling" must be enabled. However, if your business has subscription plans with trial periods, then we will want to disable it.

An example of when this function should be disabled is if we have the following situation:

Step 1: Customer starts subscription for X trial days;

Step 2: The customer pays after x days their first payment.

Step 3: The customer pays subscriptions.

With the journey above, having the default configuration, step 2 will be marked as recurring sales, which is not correct in this case. Turning off "Subscription plugin rebilling" the clients will be tracked correctly.

Tracking Checkouts using Plugin and Play

If you are using plug in and play, you will need to add an extra universal script to track any pages hosted on this plugin.

In order to do this though, plugin and play requires it's users to setup a custom domain for the checkout page. Otherwise it is impossible to add our third party tracking script on the page to track it correctly.

To do this, just go to settings and then domains:

Then create your domain and validate it inside plug in and play.

Once you have validated the custom domain and are using it for your checkout page, please copy our universal script below:

Once copied, you can paste the universal script under the "widgets" settings. It needs to be in the javascript widgets under all pages that you are using with plug in and play. This includes any checkout, thank you and upsell pages you may be using:

Discard IP from events

If you enable this property, Hyros will then discard the IP address from your sales. This is most useful when it is found that the integration is sending incorrect IP data which can cause misattribution.