AI Pixel Training / Offline Conversions

WARNING : BEFORE SETTING UP OFFLINE/CONVERSION API ATTRIBUTION READ THE FOLLOWING

A) While using the HYROS conversion API for attribution is MORE accurate and USUALLY increases performance it is NOT always instant and will reset learning. SPLIT TEST and TEST performance first by only setting it as a goal or pixel for a few campaigns. AGAIN DO NOT PUSH PIXEL/TARGETING CHANGE ACCOUNT WIDE UNTIL YOU HAVE CONFIRMED BETTER RESULTS.

B) ENSURE in Google that you do not have ACCOUNT wide conversion goals on. If you do this will DOUBLE the conversions entering your account. Set your conversion goal to HYROS conversions OR specific conversion goals. IGNORING THIS CAN MESS UP AUTOMATED BIDDING RULES. DO NOT USE ACCOUNT WIDE CONVERSION GOALS IN GOOGLE AND OUR API AT THE SAME TIME.

C) We are here to help HOWEVER YOU are responsible the results of changing pixels and targeting in your account. Please make sure you know what your doing before changing your targeting and swapping pixels. Reckless changing of targeting and pixels can result in dips in performance.

D) HYROS sends in individual sales, not orders. So an order with 3 purchases will be 3 sales via our API and reflect in your Facebook/Google stats as so.

E) If you have organic sources that take attribution for the sale, they will NOT be sent to your ad manager. If you’d prefer to ignore organic sources, the best way to do this is to set them as disregard sources. You can also lengthen the disregard source timeframe if you would like to focus more on ad tracking. More information on that HERE.

F) Please ensure ads are tracking correctly before continuing. If there are errors you will be pushing back inaccurate data to the ad platform. Please wait until the onboarding team have confirmed tracking accuracy or reach out to support to ensure your ads are tracking correctly.

AI Pixel Training is one of the coolest features we offer at HYROS. It allows you to pass our conversion tracking back to your ad platforms to train them to find customers better.

What type of data do we track?

This feature does NOT allow you to send custom conversion information such as opt-ins or the number of attendees or users who reached a certain page. However, it does allow you to send sales, calls and leads to your ad managers.

The good news is we handle all the techy stuff. It is an extremely easy feature to activate. Here’s how to do it for both platforms.

Google has BY FAR much better offline conversion features that allow for much better AI training.

Video guide:

Note that the following is the suggested set up for MOST businesses of this type. However each business is different, so if you’d like more detailed information about how offline conversions work and any other options available, please see the more detailed youtube video guides HERE.

 

 

Written Guide:

To use activate Google offline conversion tracking and AI training

  1. Go to your Google ads integrations tab HERE
  2. If you are integrated with Google simply flip the offline conversion tracking toggle at the top of the page.
  3. Adjust the attribution mode depending on your business type as described in the above video. If using scientific mode, adjust the attibrution range depending on the average amount of time it takes for your customer to make a sale after clicking an ad.
  4. Click “configure” on your integrated google ad account. If you have more than one, you will need to do this for each ad account.
  5. Choose how you want to send conversions. By default, hyros sends a conversion to google depending on the product name (individual action). This can cause issues if you have a lot of different products. Toggle on “Send conversions as a general action” if you want a single general conversion to be sent into google to optimise around instead. Name it whatever you like:

THEN from within your Google ads dashboard:

  1. Wait for a sale to come into HYROS
  2. Once it has an offline conversion named after it will be created in your Google conversions area, plus the general conversion action will also be created if you have toggled this on.
  3. Go to your campaigns that sell this product and set the conversion goal to the HYROS conversion that was just added in the conversion area.
WARNING: If you choose the account level “include in conversions” settings, this may factor in extra conversions and affect campaign performance.

4. Go into your account settings and ensure that the following field is on inside the Autotagging section:

Creating Custom Rules

By default, conversions are sent into google according to their name. If you want to edit how conversions are sent into google, you can set conversion rules for each account by clicking “configure” on your google integration and going to your offline conversion settings:

By default, Hyros will send in the offline conversions according to the product name. You can use the above option to set specific rules so your conversions are named depending on predetermined criteria.

When creating rules, you have a few different conditions to choose from. These are the current conditions available:

If the lead has any of these tags – This is based on the lead and NOT the sale. So if the lead has the tag selected, anything they purchase in the future will be sent according to this rule.

For example, you can set a rule so if the lead has a “!ShopifyStore1” tag, then it is sent as X conversion event, but if the lead has a “!ShopifyStore2” tag, then it is sent to as Y conversion. In this case, you are sending the data as a different conversion event depending on which Shopify Store the user came through. If you are not aware of how our tags work in Hyros, please review the guide HERE.

If the tag for the product is any of these – This rule is based on the purchase itself, and not the lead. This allows you to choose how specific products are sent.

If the sale or call has price – This again is based on the product. Any sale made that matches the value selected will follow this rule. For example if you want to select all free trial “purchases”, you can select this condition, with a value of “0”.

You also have the option to toggle on “do not send conversion”. This will block any conversions from being sent if the selected criteria is met for that event. An example of this will be if you want to block any free trial events from being sent, you can either create a condition for the product tag itself, or for any sale with a value of 0.

Rules can be prioritized, and if no events meet the criteria of any custom rule, the event will be sent to Google using the default settings set in your google integration.

That’s it! You are now AI pixel training with Google. Your ad campaigns will now optimize according to the conversion data that HYROS sends into Google.

If you wish to view the conversions being sent into your google ads account, you can do so inside your google integration settings. Just select “configure” and then you will find you sent conversions under the offline conversions tab:

Events from Hyros are sent to Google on average within 6 hours, they are not able to be sent in real-time due to requirements set by google.

Also, please note that the conversions inside your google account will be attached to your ads, you will NOT be able to view these conversions attached to your videos for example.

Google has BY FAR much better offline conversion features that allow for much better AI training.

Video guide:

Note that the following is the suggested set up for MOST businesses of this type. However each business is different, so if you’d like more detailed information about how offline conversions work and any other options available, please see the more detailed youtube video guides HERE.

 

 

Written Guide:

To use activate Google offline conversion tracking and AI training

  1. Go to your Google ads integrations tab HERE
  2. If you are integrated with Google simply flip the offline conversion tracking toggle at the top of the page.
  3. Adjust the attribution mode to scientific mode, and adjust the attibrution range depending on the average amount of time it takes for your customer to make a sale after clicking an ad.
  4. Click “configure” on your integrated google ad account. If you have more than one, you will need to do this for each ad account.

THEN from within your Google ads dashboard:

  1. Wait for a sale to come into HYROS
  2. Once it has an offline conversion named after it will be created in your Google conversions area, plus the general conversion action will also be created if you have toggled this on.
  3. Go to your campaigns that sell this product and set the conversion goal to the HYROS conversion that was just added in the conversion area.
WARNING: If you choose the account level “include in conversions” settings, this may factor in extra conversions and affect campaign performance.

4. Go into your account settings and ensure that the following field is on inside the Autotagging section:

Creating Custom Rules

By default, conversions are sent into google according to their name. If you want to edit how conversions are sent into google, you can set conversion rules for each account by clicking “configure” on your google integration and going to your offline conversion settings:

By default, Hyros will send in the offline conversions according to the product name. You can use the above option to set specific rules so your conversions are named depending on predetermined criteria.

When creating rules, you have a few different conditions to choose from. These are the current conditions available:

If the lead has any of these tags – This is based on the lead and NOT the sale. So if the lead has the tag selected, anything they purchase in the future will be sent according to this rule.

For example, you can set a rule so if the lead has a “!ShopifyStore1” tag, then it is sent as X conversion event, but if the lead has a “!ShopifyStore2” tag, then it is sent to as Y conversion. In this case, you are sending the data as a different conversion event depending on which Shopify Store the user came through. If you are not aware of how our tags work in Hyros, please review the guide HERE.

If the tag for the product is any of these – This rule is based on the purchase itself, and not the lead. This allows you to choose how specific products are sent.

If the sale or call has price – This again is based on the product. Any sale made that matches the value selected will follow this rule. For example if you want to select all free trial “purchases”, you can select this condition, with a value of “0”.

You also have the option to toggle on “do not send conversion”. This will block any conversions from being sent if the selected criteria is met for that event. An example of this will be if you want to block any free trial events from being sent, you can either create a condition for the product tag itself, or for any sale with a value of 0.

Rules can be prioritized, and if no events meet the criteria of any custom rule, the event will be sent to Google using the default settings set in your google integration.

That’s it! You are now AI pixel training with Google. Your ad campaigns will now optimize according to the conversion data that HYROS sends into Google.

If you wish to view the conversions being sent into your google ads account, you can do so inside your google integration settings. Just select “configure” and then you will find you sent conversions under the offline conversions tab:

Events from Hyros are sent to Google on average within 6 hours, they are not able to be sent in real-time due to requirements set by google.

Also, please note that the conversions inside your google account will be attached to your ads, you will NOT be able to view these conversions attached to your videos for example.

The Amount of the Conversions Inside Google do not Match with the Sales Numbers Inside my Hyros Account.

In this case, we need to first identify that we are sending the correct data from the Hyros side.

To do this, view the sent conversions inside hyros in the “sent conversions” tab as shown at the top of this section. You should also go to the sales tab or when deep diving into specific sales inside the reports to view the “status” column for each sale as shown here:

There are five possible statuses, all of which tell you if the sale has been sent to your ads manager or not and why. They may have different explanations which you can see by hovering over the status, please note below some examples of an error report you may see if a conversion is not sent:

WBRAID_PARAM_FOUND: If there is a “WBRAID” paramater in the attributing click URL instead of “gclid” then we will not be able to send the conversion. This is a parameter on Google’s end which we do not have control over.

INVALID_CLICK: If the click does not exist in Google, then the conversion will not be sent.

UNPARSEABLE_GCLID: The “Gclid” parameter in the URL of the click is invalid, this is requirement from Google that this parameter is attached correctly. This is their parameter, so please be careful not to confuse this with “gc_id” which belongs to Hyros.

EXPIRED_CLICK: If the attributing Facebook click was more than 90 days ago, then the conversion will not be sent.

CLICK_MISSING_LABEL: The conversion wasn’t sent because clicks occurred when none of the effective conversion types in the account were enabled could be processed.

FB_OAUTH_EXCEPTION: Conversion wasn’t sent because the Facebook token has expired inside Hyros, please go back to your Facebook integration and re-integrate.

GRAPH_METHOD_ERROR: Caused by missing permissions, please ensure you have full admin access to the account, also ensure the same account has access to the pixel, and re-integrate with Facebook inside Hyros to ensure all permissions are granted

EVENT_TIME_TOO_OLD: If the event occured 7 days ago or more, the event can not be sent.

IGNORED: The event was ignored due to a conversion rule set inside your account. If you believe it should have been sent you will need to adjust the conversion rules inside your integration.

DELETED_INTEGRATION: The conversion belongs to an integration that has since been deleted in your account. Please ensure your Facebook integration is set up correctly that inlcude the correct ad account.

CONVERSION_DISABLED: Offline conversions are disabled in the account, when you are ready and ads are tracking correctly please turn this on following the guides above.

NO_FB_GOOGLE_ATTR: We will only send sales that are attributed to Facebook or Google ads. If the sale is not attributed back to a Facebook or Google ad, it will not be sent to the ad platform.

NO_ADSPEND_CLICK_ID: There is no fbclid/gclid in URL of the attributing click. If you investigate the clicks of the lead associated with the sale you should be able to see this as well. These parameters belong to Facebook/Google, and are required for the conversion to be sent. These should not be confused with our tracking parameters, “fbc_id” and “gc_id”.

NO_CLICK_ID: The click ID (associated with fbc_id) was not found inside of Facebook. Please reach out to Facebook for further assistance.

DEFAULT_ERROR: A miscellaneous error. Please retry the sending the conversion in “sent conversions” and if this does not work please reach out to support.

NO_INFO: A similar miscellaneous error. There is no information on the conversion so it can not be sent. Please retry and if this does not work then please reach out to the support team.

If we are sending events correctly from our end and you notice no issues in your Hyros account, please reach out to support and we can investigate further.

Here is how to set up offline conversion tracking and AI optimization for Facebook

WARNING : IF you have not created a Pixel inside Facebook before, please make sure you accept FB’s terms and conditions by following the guide in the “FAQ and Troubleshooting” dropdown below, otherwise AI pixel training will NOT work.

Here are the steps to activating offline conversion tracking and AI optimization:

Video guide:

Note that the following is the suggested set up for MOST businesses of this type. After reviewing this guide, if you think this doesn’t apply to your business please let us know and we can provide more advice for your specific case.

 

IF YOU ARE SENDING STANDARD PURCHASE EVENTS TO AN EXISTING PIXEL: Here is the code, please copy this and paste it exactly as instructed above: {eventID: Math.random().toString(36).substr(2, 15)}

Inside Hyros: Activating Offline Conversions

1.Ensure you have integrated HYROS with your Facebook ads. If you have not, follow this guide and return after.

2. After integrating return to your Facebook Integrations area and then select the account you would like to send conversions too under Facebook Conversions. You can only do this with a single business account. Then flip the “Enable Facebook Conversions” toggle on and select the pixel you would like to send events to.

 

Selecting Your Pixel and Attribution Mode

You can choose to create a new pixel or send the events to an existing pixel, and select the attribution mode to use when sending conversions. What you should choose will vary depending on your business type:

1) Lower ticket, short sales cycle businesses (most E-commerce stores)

  1. Select the Attribution mode “Last Click”.
  2. Send events to your exisiting pixel.
  3. Click “See Conversion Rules” and ensure the default conversion name is set to “Purchase” (with an uppercase “P”).
  4. Enable event ID collection and add a random ID to the Facebook Pixel you currently have in your site. Please follow the video guide above to complete this step.

With these settings, we will match with Facebook’s attribution mode, which is also Last Click, and simply fill in the sales that Facebook are missing inside the standard Purchase Events that you are most likely already tracking with. Facebook will also deduplicate any sales that Hyros send that were already tracked successully by them.

This also means you shouldn’t have to make any changes to your aggregated events measurement settings, which may distrupt your ads.

2) Higher ticket, longer sales cycle businesses (high ticket E-commerce, Sales Call and Webinar Funnels)

  1. Select the attribution mode “Scientific”, then select the attribution range depdning on the average length of the customer journey from first click to purchase (If this is over 30 days, select 30 days.)
  2. Create a new Hyros Pixel in the Pixel dropdown (This is just a normal Facebook Pixel with a custom name).
  3. Click “See Conversion Rules” and ensure the default conversion name is set to “Purchase” (with an uppercase “P”).

Because we are using a different attribution mode than Facebook, we need to send conversions to a brand new pixel where Facebook aren’t also tracking standard purchase events. Otherwise due to the difference in attribution they may not be able to deduplicate conversions correctly that have come in twice. However, creating a new Purchase event inside a new pixel also means you will need to add this event to your aggregated events measurement settings:

If you are sending Hyros events as a pre-exitising event that is already set up inside AEM, then please skip this step.

Please also take in mind that Facebook may pause your ads for 72 hours when changes are made to your AEM settings.

To ensure your domain is tracked and hyros events are added to AEM, follow these steps:

  1. Inside Facebook, go to Business settings ->Brand Safety -> verify domains.
  2. Assign Facebook pages to your domains.
  3. Then go to your pixel that you are sending Hyros events to in Events manager and select the aggregated event measure tab. Add the Hyros event. If you have pre-existing events you are currently using for optimization, we would suggest adding the Hyros event at the second highest priority until you have proven better results.
  4. Wait for 2 hours. Then check the ad set conversion event has no flags. Check ad tracking settings are now green for your conversion event assigned to the domain.

Also take in mind that Facebook limits 8 events per domain, NOT pixel.

Next Inside your Facebook Account: Adding Permissions to the Pixel

Go to your business settings. Find your pixels inside the “data sources” tab.

You should see the Hyros conversion pixel or the pixel you are sending hyros events to there. Click on that pixel and then add people (users in your ad account) and assets (any ad account that you are using the hyros events with).

Enabling Advanced Matching

1. Then click “open in events manager”, or go into Events Manager and then go to DATA sources.

2. If you created a new pixel, check that the “Hyros Conversions” Pixel is showing in your data sources. Ensure you have also selected your business account and not any of your ad accounts:

3. Enable “advanced matching” inside the pixel settings.

 

Optimizing Around Hyros Events

WE SUGGEST letting the conversion generate a few days to weeks of data before using it as your conversion source if it has a very limited amount of conversions. After the conversion has built up data THEN use it for conversion optimization.

Once you have enough data, to use the Hyros events to optimize go to your ad set and click “edit”, then you can select the pixel and event to optimize around here:

As a reminder, we suggest testing the Hyros event on one or two ad sets to prove better results before setting this account-wide.

Creating Custom Rules

By default, Hyros will send conversions to the pixel selected as a default event named “Hyros Conversion”. Click here to create conversion rules inside your Facebook integration:

This will allow you to send events to a specific business, pixel and as a customized conversion depending on the set criteria. This way you can send Hyros data to multiple pixels with a variety of conversions depending on your specific use case.

When creating rules, you have a few different conditions to choose from. These are the current conditions available:

If the lead has any of these tags – This is based on the lead and NOT the sale. So if the lead has the tag selected, anything they purchase in the future will be sent according to this rule.

For example, you can set a rule so if the lead has a “!ShopifyStore1” tag, then it is sent as X conversion event to X pixel, but if the lead has a “!ShopifyStore2” tag, then it is sent to as Y conversion to Y pixel. In this case, you are sending the data to different pixels/as a different event depending on which Shopify Store the user came through. If you are not aware of how our tags work in Hyros, please review the guide HERE.

If the tag for the product is any of these – This rule is based on the purchase itself, and not the lead. This allows you to choose how specific products are sent.

If the sale or call has price – This again is based on the product. Any sale made that matches the value selected will follow this rule. For example if you want to select all free trial “purchases”, you can select this condition, with a value of “0”.

You also have the option to toggle on “do not send conversion”. This will block any conversions from being sent if the selected criteria is met for that event. An example of this will be if you want to block any free trial events from being sent, you can either create a condition for the product tag itself, or for any sale with a value of 0.

Rules can be prioritized, and if no events meet the criteria of any custom rule, the event will be sent to Facebook using the default rule as shown in the above screenshot.

We advise against sending the data to an existing Pixel as a standard purchase event. This has been known to mix Hyros data with Facebook’s and causes duplication issues. Please be aware that you are responsible for the outcome of setting these rules incorrectly, and we strongly suggest waiting to gather data and testing before optimizing around Hyros conversions account-wide

Sending Lead Events to Facebook

To turn on Lead Conversions, turn on the toggle below “Enable Facebook Conversions” inside the integration.

After that is turned on, new leads who opt in through an ad with an fbclid  parameter will be sent to the default pixel and business with the “Lead” event type.

To change this, just like with conversion events above, go to the conversion rules view to create rules for lead conversions,

Rules can only match with leads by their tags. So for example any lead that came from !Shopifystore1 can be selected and sent to a specific pixel.

This guide is sufficient for setting up offline conversions. That being said, if you would like to get a deeper understanding of how offline conversions work, you can see the youtube guides HERE.

Here is how to set up offline conversion tracking and AI optimization for Facebook

WARNING : IF you have not created a Pixel inside Facebook before, please make sure you accept FB’s terms and conditions by following the guide in the next dropdown, otherwise AI pixel training will NOT work.

Here are the steps to activating offline conversion tracking and AI optimization:

Video Guide:

 

Written Guide:

Inside Hyros: Activating Offline Conversions

1.Ensure you have integrated HYROS with your Facebook ads. If you have not, follow this guide and return after.

2. After integrating return to your Facebook Integrations area and then select the account you would like to send conversions too under Facebook Conversions. You can only do this with a single business account. Then flip the “Enable Facebook Conversions” toggle on and select the pixel you would like to send events to.

 

Selecting Your Pixel and Attribution Mode

You can choose to create a new pixel or send the events to an existing pixel, and select the attribution mode to use when sending conversions. You can also choose to send the event as a custom conversion or as a standard Facebook event. This is ultimately up to you, as each specific business will be different, but this is what we advise depending on your business type:

1) Lower ticket, short sales cycle businesses (most E-commerce stores)

  1. Select the Attribution mode “Last Click”.
  2. Create a new Hyros Pixel in the Pixel dropdown (This is just a normal Facebook Pixel with a custom name).
  3. Click “See Conversion Rules” and ensure the default conversion name is set to “Purchase” (with an uppercase “P”).

With these settings, we will send Facebook a standard purchase event to a new pixel in Last click mode, which is also Facebook’s standard attribution mode. We advise sending this to a new pixel because we require an edit to the Facebook pixel in order to prevent deduplication, which unfortunately Shopify does not allow you to do at this moment in time. Sending a standard purchase event to an existing pixel with web events without following all the necessary steps may cause data to be duplicated and cause issues with your ads. Please reach out to the support team if this is not clear before moving forward.

Creating a new purchase event inside a new pixel will also mean you will need to add this event to your aggregated events measurement settings. Please move on to this step below.

2) Higher ticket, longer sales cycle businesses

  1. Select the attribution mode “Scientific”, then select the attribution range depdning on the average length of the customer journey from first click to purchase (If this is over 30 days, select 30 days.)
  2. Create a new Hyros Pixel in the Pixel dropdown (This is just a normal Facebook Pixel with a custom name).
  3. Click “See Conversion Rules” and ensure the default conversion name is set to “Purchase” (with an uppercase “P”).

Because we are using a different attribution mode than Facebook, we need to send conversions to a brand new pixel where Facebook aren’t also tracking standard purchase events. Otherwise due to the difference in attribution they may not be able to deduplicate conversions correctly that have come in twice. However, creating a new Purchase event inside a new pixel also means you will need to add this event to your aggregated events measurement settings:

If you are sending Hyros events as a pre-exitising event that is already set up inside AEM, then please skip this step.

Please also take in mind that Facebook may pause your ads for 72 hours when changes are made to your AEM settings.

To ensure your domain is tracked and hyros events are added to AEM, follow these steps:

  1. Inside Facebook, go to Business settings ->Brand Safety -> verify domains.
  2. Assign Facebook pages to your domains.
  3. Then go to your pixel that you are sending Hyros events to in Events manager and select the aggregated event measure tab. Add the Hyros event. If you have pre-existing events you are currently using for optimization, we would suggest adding the Hyros event at the second highest priority until you have proven better results.
  4. Wait for 2 hours. Then check the ad set conversion event has no flags. Check ad tracking settings are now green for your conversion event assigned to the domain.

Also take in mind that Facebook limits 8 events per domain, NOT pixel.

Next Inside your Facebook Account: Adding Permissions to the Pixel

Go to your business settings. Find your pixels inside the “data sources” tab.

You should see the Hyros conversion pixel or the pixel you are sending hyros events to there. Click on that pixel and then add people (users in your ad account) and assets (any ad account that you are using the hyros events with).

Enabling Advanced Matching

1. Then click “open in events manager”, or go into Events Manager and then go to DATA sources.

2. If you created a new pixel, check that the “Hyros Conversions” Pixel is showing in your data sources. Ensure you have also selected your business account and not any of your ad accounts:

3. Enable “advanced matching” inside the pixel settings.

 

Optimizing Around Hyros Events

WE SUGGEST letting the conversion generate a few days to weeks of data before using it as your conversion source if it has a very limited amount of conversions. After the conversion has built up data THEN use it for conversion optimization.

Once you have enough data, to use the Hyros events to optimize go to your ad set and click “edit”, then you can select the pixel and event to optimize around here:

As a reminder, we suggest testing the Hyros event on one or two ad sets to prove better results before setting this account-wide.

Creating Custom Rules

By default, Hyros will send conversions to the pixel selected as a default event named “Hyros Conversion”. Click here to create conversion rules inside your Facebook integration:

This will allow you to send events to a specific business, pixel and as a customized conversion depending on the set criteria. This way you can send Hyros data to multiple pixels with a variety of conversions depending on your specific use case.

When creating rules, you have a few different conditions to choose from. These are the current conditions available:

If the lead has any of these tags – This is based on the lead and NOT the sale. So if the lead has the tag selected, anything they purchase in the future will be sent according to this rule.

For example, you can set a rule so if the lead has a “!ShopifyStore1” tag, then it is sent as X conversion event to X pixel, but if the lead has a “!ShopifyStore2” tag, then it is sent to as Y conversion to Y pixel. In this case, you are sending the data to different pixels/as a different event depending on which Shopify Store the user came through. If you are not aware of how our tags work in Hyros, please review the guide HERE.

If the tag for the product is any of these – This rule is based on the purchase itself, and not the lead. This allows you to choose how specific products are sent.

If the sale or call has price – This again is based on the product. Any sale made that matches the value selected will follow this rule. For example if you want to select all free trial “purchases”, you can select this condition, with a value of “0”.

You also have the option to toggle on “do not send conversion”. This will block any conversions from being sent if the selected criteria is met for that event. An example of this will be if you want to block any free trial events from being sent, you can either create a condition for the product tag itself, or for any sale with a value of 0.

Rules can be prioritized, and if no events meet the criteria of any custom rule, the event will be sent to Facebook using the default rule as shown in the above screenshot.

We advise against sending the data to an existing Pixel as a standard purchase event. This has been known to mix Hyros data with Facebook’s and causes duplication issues. Please be aware that you are responsible for the outcome of setting these rules incorrectly, and we strongly suggest waiting to gather data and testing before optimizing around Hyros conversions account-wide

Sending Lead Events to Facebook

To turn on Lead Conversions, turn on the toggle below “Enable Facebook Conversions” inside the integration.

After that is turned on, new leads who opt in through an ad with an fbclid  parameter will be sent to the default pixel and business with the “Lead” event type.

To change this, just like with conversion events above, go to the conversion rules view to create rules for lead conversions,

Rules can only match with leads by their tags. So for example any lead that came from !Shopifystore1 can be selected and sent to a specific pixel.

Viewing Data sent from Hyros

If you encounter an issue with the events or notice any discrepencies, one of the first things you will need to rule out is if Hyros is sending the data to Facebook correctly.

You can do exactly that inside your Facebook integration settings. Just select “See Sent Conversions” as shown below:

You can then use this to compare with the data inside your hyros account and determine if everything is being sent correctly by diving into individual sales as shown below.

Take in mind that we only send Sales and Calls that are attributed to Facebook in the attribution mode you have set for your offline conversions.

Checking the status for each Sale/Conversion

If numbers are not matching with the events inside your pixel, we need to first identify that we are sending the correct data from the Hyros side.

To do this, view the sent conversions inside hyros in the “sent conversions” tab as shown at the top of this section. You should also go to the sales tab or when deep diving into specific sales inside the reports to view the “status” column for each sale as shown here:

There are five possible statuses, all of which tell you if the sale has been sent to your ads manager or not and why. They may have different explanations which you can see by hovering over the status, please note below some examples of an error report you may see if a conversion is not sent:

EXPIRED_CLICK: If the attributing Facebook click was more than 90 days ago, then the conversion will not be sent.

CLICK_MISSING_LABEL: The conversion wasn’t sent because clicks occurred when none of the effective conversion types in the account were enabled could be processed.

FB_OAUTH_EXCEPTION: Conversion wasn’t sent because the Facebook token has expired inside Hyros, please go back to your Facebook integration and re-integrate.

GRAPH_METHOD_ERROR: Caused by missing permissions, please ensure you have full admin access to the account, also ensure the same account has access to the pixel, and re-integrate with Facebook inside Hyros to ensure all permissions are granted

EVENT_TIME_TOO_OLD: If the event occured 7 days ago or more, the event can not be sent.

IGNORED: The event was ignored due to a conversion rule set inside your account. If you believe it should have been sent you will need to adjust the conversion rules inside your integration.

DELETED_INTEGRATION: The conversion belongs to an integration that has since been deleted in your account. Please ensure your Facebook integration is set up correctly that inlcude the correct ad account.

CONVERSION_DISABLED: Offline conversions are disabled in the account, when you are ready and ads are tracking correctly please turn this on following the guides above.

NO_FB_GOOGLE_ATTR: We will only send sales that are attributed to Facebook or Google ads. If the sale is not attributed back to a Facebook or Google ad, it will not be sent to the ad platform.

NO_ADSPEND_CLICK_ID: There is no fbclid/gclid in URL of the attributing click. If you investigate the clicks of the lead associated with the sale you should be able to see this as well. These parameters belong to Facebook/Google, and are required for the conversion to be sent. These should not be confused with our tracking parameters, “fbc_id” and “gc_id”.

NO_CLICK_ID: The click ID (associated with fbc_id) was not found inside of Facebook. Please reach out to Facebook for further assistance.

DEFAULT_ERROR: A miscellaneous error. Please retry the sending the conversion in “sent conversions” and if this does not work please reach out to support.

NO_INFO: A similar miscellaneous error. There is no information on the conversion so it can not be sent. Please retry and if this does not work then please reach out to the support team.

 

If we are sending events correctly on our end then find the event inside the pixel and compare the same data. If the conversions are significantly different then either:

  1. Facebook are deduplicating/duplicating conversions. This can happen if you send events as “Purchase”. If Facebook reads this event coming from Hyros and the same event being tracked via the pixel, then events will be deduplicated, if they do not read this correctly then they will duplicate conversions causing inflated numbers.
  2. Facebook are dropping events for other unknown reasons. Unfortunately they do drop events for reasons which aren’t made available in the account. Please reach out to Facebook support for assistance and clarification in this case.

 

The Conversions Sent From Hyros do not Match with the Sales Numbers in the Chrome Extension. I See a “[1]” or “[2]” next to the Conversion Numbers Inside the Report.

Please note that sometimes Facebook use a form of estimated attribution on occassions to attribute these conversions. You can click the numerical footnote for more information as shown in this example:

Although we do our best to send Facebook everything we need and are constantly looking to improve this, once our events arrive inside the pixel it is Facebook who then attribute them. For more information see this link.

This feature is NOT used for viewing your data in your reports to make decisions, to do this view the data inside the Hyros app or the chrome extension. This feature is specifically used to optimize your ads and only this. Viewing the sent events in your columns will not tell you if our events improve performance, the only way to do this is to test our event on an ad set.

Please note that, although we will do our best to clarify based on our experience working with clients and from our interpretation of documentation from Facebook, it is not always possible to predict their behaviour, so please take this information as a suggestion only. How you configure your Facebook account is ultimately your responsibility.

I am not able to Select a Pixel to Send my Conversions to

Depending on the exact issue, this may be for 2 reasons:

  1. You don’t see your pixel in the drop-down: Ensure you have selected the correct business when setting up your conversions.
  2. You do see it, but you are not able to select the pixel: Deactivate conversions, then select the pixel and reactivate it again.

 

Facebook says I do not Have to Add my Event to Aggregated Events Management to use for Optimization.

Please note, Facebook are beggining to allow users to optimize around events that are not prioritized in AEM. We still strongly suggest adding the hyros event to AEM at the highest priority possible in order to take advantage of the hyros data.  Otherwise ads optimizing around this event may not deliver to users who opt out of tracking.

If you have exisiting events already, then it’s normally best to place the hyros event second until you have gathered enough data and proven better results.

Does Hyros Send Data to Facebook in Real Time?

Hyros does not send conversions to Facebook in real time. On average data is sent on an hourly basis, but this can vary slightly.

 

I Can Not See the Hyros Event Inside the Aggregated Events Management Settings, or When trying to Optimize Around the Event

In summary, because Facebook does not allow you to use the Custom Event to optimize, you need to do 1 of 2 things:

  1. Create a custom conversion inside Facebook using the Hyros custom event from your pixel, then use this to optimize. This will NOT pass on the value to the custom conversion.
  2. Send the data as a standard purchase event, and then use that event in events management and to optimize. Be very careful here not to send the standard purchase event to a pixel which is already tracking purchases, this will cause duplication issues.

 

Can I Track other events, such as page views etc with the pixel?

The purpose of this guide is to show you how to send events from hyros to the Facebook pixel server-side. However the Hyros Pixel is just another Facebook pixel and behaves in exactly the same way. It can be used to track web events (add to cart/page view etc) as well by installing the pixel on your page. This is not related to Hyros tracking though.

 

I Can Not Activate Value Optimization on my Hyros Event

If you are trying to optimize around value, you may find you receive a message from FB like this:

In order to optimize around value, you will need to follow the steps outlined by Facebook. We can break the steps required down as follows:

  1. Make sure the pixel is sending purchase events: If you have completed the Facebook set up above, then you should be able to see the hyros conversion events being sent into the pixel.
  2. Make sure it has generated 30+ optimized purchases: You’ll need to add the Hyros event as an optimized event following following the set up in the above “Facebook” drop down, and then wait for 30+ purchases to come in and be used in optimization following this change.
  3. Has at least 2 distinct values in the past 7 days: There must be 30 optimized purchases in the last 7 days, and there must be 2 unique values present. For example, if 30 Hyros events have been used to optimize in the past 7 days, but all with the same value of $5, this will not meet the requirement.

Please take in mind that these requirements are set by Facebook. Although we’re happy to help with any issues you may have, ultimately in order to activate value optimization ALL of Facebook’s requirements need to be followed correctly.

 

I Receieved a Warning From Facebook about “Potentially Violating Personal Data“, and Noticed the Hyros Email Parameter.

If you receieved a warning that looked like this:

Then do not worry, our interpretation of this message (and so far from our experience), is that this is Facebook simply saying that they won’t use this data. This is not a problem because those parameter were never used by them in the first place, they were used by us.

That being said we are not Facebook and cannot predict their behaviour with certainty, this is just our interpretation from the experience we have. If you want to be careful, then the only solution would be to remove the pixel or alternatively remove the parameter causing the issue. It is your decision.

 

What information is sent to Facebook?

Amongst other things, the main parameters sent to Facebook are:

  1. Value (if you are sending a custom event, this will not be passed on to the custom conversion that you need to create to optimize).
  2. Currency.
  3. Sales group id associated with the sale. Only if the sale belongs to an integration. If it’s entered manually then this will not be available.
  4. SKU id. This will be sent only if this information is available. It can be sent either from the integration or manually.