Tracking Custom Parameters

Typically Hyros has it’s own set of parameters for each ad platform and for organic and miscellaneous ad sources to track correctly. However if you have pre-existing UTM parameters you would like to use without making any edits to your existing ads or links, then you can add additional custom parameters for Hyros to read and use for tracking purposes.

This is especially useful with ad traffic, however please take in mind you will need to include the IDs as the value of these custom UTM parameters, not the names.

In this guide we will use the example of tracking Facebook ads using your existing parameters, but this feature is available for all ad platforms. Just follow the same steps but adapt them to the ad platform you are trying to track, and ensure you are including all the relevant IDs required in Hyros for each ad platform:

  • Ad set ID
  • Ad ID

If you’re not sure what version of Google ads you are using, you can confirm here in your Google integration:

If it says V2, please include the IDs specified in the V2 dropdown below.

Otherwise we need the following IDs:

  • Campaign ID
  • Ad ID

Please do not use custom parameters to track the ad group ID in Hyros, this will break your tracking. 

If you’re not sure what version of Google ads you are using, you can confirm here in your Google integration:

If it says V1, please include the IDs specified in the V1 dropdown above this one.

 

If it says V2 then we need the following IDs, depending on if they exist in the campaign type:

  • Campaign ID
  • Ad group ID
  • Ad ID
  • Keyword ID
  • Keyword
  • Placement

  • Ad group ID
  • Ad ID

  • Ad set ID
  • Ad ID

  • Campaign ID
  • Ad group ID
  • Ad ID

  • Campaign ID

Using Custom Parameters to Track Facebook ads

For Facebook, the standard ad tracking parameters that you need to add to your ads are fbc_id={{adset.id}}&h_ad_id={{ad.id}}

However, imagine you already have the following UTMs on your ads: fb_adset={{adset.id}}&fb_ad={{ad.id}}

These are different UTM parameters than the standard Hyros parameters, but they still contain the same IDs, specifically we just need the following information to be in the URL:

  • Ad set ID
  • Ad ID

If you already have this information added, then there is no need to add the Hyros UTM parameters and risk resetting learning/engagement etc. Instead just follow the steps below to use the existing UTM parameters already added:

First, navigate to the universal script inside your Hyros account.

Then select “Custom Parameters” here:

Now scroll down until you get to “adset ID” and find the Facebook field. Edit the field name so it matches exactly with the UTM parameter name you are using to capture the ad set ID.

In the example above we are using fb_adset, so we will change it as shown here:

We will still continue to use the standard UTM tracking parameters for Hyros in addition to the ones added here.

Now we need to do the exact same thing for the ad ID, this will be located under “other”. In the example above the parameter containing the ad ID is fb_ad so we would add that to this field, so Hyros knows to pick up the ad ID when we see this UTM parameter in the URL:

The standard Hyros tracking parameters for ad level will still work in addition to the one entered here

This concludes the setup, if you have any questions please reach out to your onboarding team.