HYROS Docs Uncategorized Braze

Braze

 Step 1 – Setup UTM Tracking in Drip

Following Braze’s documentation, setup your default campaign parameters in the UTM tracking settings.

Specifically for the purposes of Hyros tracking, it’s recommended to do the following.

Make sure you have utm_source and utm_campaign rows displayed as below.

  • for utm_source type in braze
  • for utm_campaign introduce {{campaign.${name}}}

This will add these UTMs to all of your campaigns and flows by default.

Step 2 – Add a URL rule inside Hyros

Follow the steps here to setup a dynamic URL rule to track whatever comes after utm_campaign as a source in Hyros, which means we’ll be tracking events back to the specific campaign they came from.

This will not effect other tracking such as ad tracking as long as you have already setup tracking correctly. For ad sources and other specific sources, we highly advise tracking them following their specific guides before proceeding with these steps.

You can also get there by clicking “Tracking” and then “URL Rules” in your Hyros account.

Click “Dynamic Rule”

Click “Add new rule”.

Click the “URL Rule Name” field.Name it whatever makes sense to you, for example “Email” if you are trying to track email traffic.

Using the standards UTM’s you have already setup, you can add the parameter you want to use to track a source. For example, the most common case for email’s would be to type “utm_campaign” and click enter. This will create a source based on whatever comes after utm_campaign= in the URL, which in the case of email will allow you to track back to specific email campaigns. So for example if a lead clicks on an email campaign labelled “campaign1” then the URL they land on will be www.hyros.com?utm_campaign=campaign1 In this case Hyros will generate a source labelled @campaign1

Select the Tag type you want to generate. In the example of emails we want to generate a source. If you are unsure what each tag does please consult the following guide https://docs.hyros.com/using-tags-to-track-customers.

OPTIONAL STEP – Click “Advanced Settings”.

You will see by default under the “Dynamic Source Traffic Parameter” we are using utm_source. This means when we first create a brand new source using this rule, if the utm_source exists in the same click we will use this to organize this source into a traffic source automatically. Please change this as necessary depending on your unique UTM setup.

You can do exactly the same in the “Dynamic Source Category Parameter” to automatically configure the category of any newly created sources using this rule, although this is not necessary. For more information on how traffic sources and source categories work in Hyros to organize your data, please see https://docs.hyros.com/organizing-mass-data/

Click “Create rule”.

This will conclude the setup, however please proceed to the next step if you want to optimize tracking by passing on the lead email.

Step 3 – Add the lead email to the URL (Optional step)

This step is optional as tracking the source click is already done by the URL rule you setup in the previous step.

If you decide you don’t need to do this, please move to step 4 to test your email tracking.

What does this do?

This step is used to optimize tracking by passing on the lead email when they click on a call to action link in one of your emails.

The reason this might be needed, is although Hyros is very effective at tracking leads across multiple devices over a long time period, there may be some rare cases as described here that cause attribution to fail:

If you’d like to set this up for optimized tracking please see the below:

Adding the parameter: he={{ email }}

Click the Add query parameter button below. The first field on the left should type in he, and the second field {{ email }}.

Step 4 – Test your Campaign or Flow

Following Klaviyo’s guides beflow send yourself a test email campaign or SMS.

Test your email campaigns here.

Test your flows/SMS here.

Click on the call to action link and find the URL. You should see the standard UTMs attached cleanly in the URL like this:

www.yourlandingpage.com?utm_source=email&utm_campaign=emailcampaignname

If you have added the “he” UTM parameter following step 3, you should also see that included in the URL with the email clearly attached like this:

www.yourlandingpage.com?he=johndoe@hyros.com&utm_source=email&utm_campaign=emailcampaignname

Please take in mind some email softwares won’t display the dynamic data as expected in test emails, so you may see slightly different information than you were expecting. The important thing is that the UTMs are present and cleanly attached to the end of the URL.

Go through the funnel and opt in, book a call or checkout as if you were a lead.

After waiting a few minutes you should be able to find your tracked email under sales data -> leads. Click on the email and you should see the email source attached:

If you see this tracking has been successful!

If you do not see this , please follow the troubleshooting steps below:

If you don’t see your email

  • If you haven’t done so yet, make sure you follow the funnel steps and submit and email.
  • Make sure the universal script is added to all your pages, including on the page where you entered your email (such as the opt in or checkout page).

If you see the email but no @source tag in the journey

  • Check the UTMs are being passed on correctly to the URL after clicking on an email link.
  • Ensure the URL rule you setup in step 2 is added correctly. Check for typos in the “URL parameter” field, it must match exactly with the UTM in the URL.
  • Ensure the landing page has the Hyros Universal script attached
FAQ

Filtering Email and Organic Sources In Reports

Pixel Warning: Potentially Violating Personal Data Sent To Facebook