Setting Up and Using The HYROS Chrome Extension

Video Guide

Written Guide

Step 1: Install the Extension from the Google APP store HERE.

Step 2: Click the icon in the top right of Chrome and ad your API key which is found HERE. If you do not have an API key click “REGENERATE API KEY”.

Step 3: Go to your Facebook ad manager account. Go to the ad sets tab. Click the HYROS Chrome Extension icon and select “Last Click”, “Scientific” or “Both”.

Step 4: If you have duplicate ad set names, please tick the box inside the extension:

We normally match hyros ad sets by name, so if you do not tick that box and DO have duplicate ad set names, the optimization process can lead to wrong data inside hyros.

This will complete set up.

Video Guide:

 

 

 

Written Guide

Step 1: Install the Extension from the Google APP store HERE

Step 2: Go to Google ad manager and activate the campaign id column inside campaigns.

Step 3: Copy the API in settings > profile, then paste it into the google chrome extension which can be accessed at the top right of chrome. If you do not have an API key click “REGENERATE API KEY”.

Step 4: Follow the prompts, select your attribution mode and then click “ENABLE HYROS DATA”.

Written Guide

Step 1: Install the Extension from the Google APP store HERE.

Step 2: Then log into your Hyros account and copy the API key settings > profile. Click the HYROS Chrome Extension icon and paste the API key. Click Sync Account.

Step 3: Go to Campaign inside your Tik-Tok ad manager account and go to the ad group tab or ad tab. Activate the extension by pressing the Enable Hyros Stats button.

Note: If you don’t see the extension displayed as in the image above, make sure you extend the Name column inside your Tik-Tok account!

Written Guide

Step 1: Install the Extension from the Google APP store HERE.

Step 2: Then log into your Hyros account and copy the API key settings > profile. Click the HYROS Chrome Extension icon and paste the API key. Click Sync Account.

Step 3: Go to the Ad Sets tab inside your Snapchat account and activate the extension by pressing the Enable Hyros Stats button.

Note: If you don’t see the extension displayed as in the image above, make sure you extend the Name column inside your Snapchat account!

Using/troubleshooting the Chrome Extension

Please see the following dropdowns depending on your specific issue or question:

If you’d like to edit the hyros columns inside the extension, you can do so by clicking “configure columns” here:

You can view hyros data in different attribution modes. You’ll see the top row in this example will show data in scientific mode, and the second column shows data in last click mode:

For more information on our attribution modes, please see THIS GUIDE.

Organic/email sources will take credit for the last clicks on many sales. This will make your ads look like they are not performing since organic/email sources will take all the credit. Mixing these traffic sources together can be messy. That’s why by default organic sources are ignored in the reports, but you can toggle this off to include them. For more information on how organic sources work in Hyros see THIS GUIDE.

By default, sales are attributed to the date of sale. In other words, if a sale was made on 20th of October, you will see the sale in your reports with the date of purchase as 20th October. Toggle “Day of Attribution” on to attribute the sale to the date of the click instead.

For example, if a person clicked @facebookad1 on the 15th of October and bought on the 20th the sale would appear credited to @facebookad1 on the 15th. It would not appear on the 20th.

If you toggle this on, sources without clicks and revenue during the time range will be marked as inactive and their information will not be retrieved from Hyros.

This will only work if we receive hard costs from the integration you are using to track sales with Hyros. By default, Hyros does not take into account Hard costs in the Revenue. Turn this toggle on to take into account Hard costs.

By default, recurring payments will be taken into account when generating reports within the extension. To exclude them from reports, turn on the ignore recurring payments toggle.

Take in mind that the totals do NOT take into account filters. The totals represent the following, depending on what level you are looking at your data:

Ad level: Total equals all selected ad sets/ad groups

Ad set/group level: Total equals all selected campaigns

Campaign level: Total equals all campaigns

To be even more specific, the filters at the top of the ad manager do not have any effect on the totals column due to UI restrictions. Please ensure that you select campaigns/ad sets/ad groups this way instead:

If you have a quick reports view and would like to get a easy-to-read summary of your data from a view inside your ads manager, all you need to do is click here inside your quick reports dashboard:

This will allow you to see your most important metrics inside your ads manager without needing to enter your Hyros account. You should see these metrics displayed at the top of your screen here:

For more details on quick reports please see HERE.

Normally you would need to input the unique API key for each account, however to save any effort, you can instead connect both accounts in hyros and then use the parent API key. This will allow you to use a single API key and view the data for both accounts using the chrome extension.

Learn more about connecting 2 existing accounts HERE.

Step 1 – Initial Troubleshooting Steps

Video Guide:

 

 

Written guide: If you expand the column to its maximum width and you still see a warning to expand the column, please try removing some of the hyros columns to allow the data to fit inside the ad manager.

If that doesn’t work, or you’re not seeing data in general inside the columns, try this:

  • Clearing your cookies and checking again.
  • Check you are using the same API key as the one inside your account.
  • Ensure you have the ad/ad set/campaign ID column loaded inside the ad manager.
  • Ensure you have enabled Hyros stats in the extension.
  • Ensure that the version of the extension is up to date in chrome, try re-installing the extension if there is no option to update.
  • If you see columns but some or all of the data is missing: Check that you have set up tracking correctly for Facebook and Google ads, then compare the data from the chrome extension to what hyros is reporting inside hyros.

Step 2 – Send our Team the Required Information to Investigate

If you were not able to identify/solve the issue, please reach out to the support team. We will then be able to activate a debugging mode for your account. Once we have done so, please follow this video so we have the necessary information to find the issue:

 


Written guide: please send a screen recording / some screenshots showing us how you have set up the extension, especially showing us the following:

  • Exactly what you are seeing in your ad manager, and what data is missing inside the report. Please make sure to include the report configuration (data range + attribution modes etc).
  • The API key used in the extension.
  • The version of the hyros extension in your chrome browser.
  • A full view of the console tab when loading the extension, as per the video above.

Because the Hyros Chrome Extension is operating on Google’s and Facebook’s HTML structure, there will be times when the extension may stop working due to any updates that either ad platform makes to their interface UI. This is a normal part of the maintenance process for any extension that relies on 3rd party pages. Sending us a view of what you see in your ad manager may help us determine if this is the case.