Account & Setup
      Back to home
      1. Hyly AI Help Center
      2. Account & Setup

      How to install and troubleshoot GTM (Google Tag Manager)?

      1. Introduction

      In the previous version of Hyly Source Attribution, marketing managers needed to ask the web developer to insert the beacon Master Script on the property website; this process was time-consuming and error-prone.

      With our newly released Attribution Manager template, the marketing manager will be able to install it without changing a single line of code on the property website. This is a simple guide for marketing managers to install the GTM tags from Hyly and troubleshoot potential issues with the installation.


      1.1 Source Attribution

      Lead source attribution is the process of giving credit to different marketing campaigns that contributed to the accomplishment of a specific goal (such as a prospect scheduling a tour, submitting the contact form, etc.)

      A lead source is some additional metadata that attaches to the prospect’s record and contains attributes from both Google Analytics and affiliate tracking applications. These attributes are:

      1. Source (a UTM parameter)
      2. Medium (a UTM parameter)
      3. Campaign (a UTM parameter)
      4. Content (a UTM parameter)
      5. Term (a UTM parameter)
      6. Page URL
      7. Referrer
      8. Channel
      The aforementioned lead source will be tracked automatically when you install the Hyly Attribution Manager tag to your GTM container.

      1.2 Event Tracking

      Event tracking is an advanced Google Analytics feature that allows you to track a specific prospect’s interaction/activity with a web page element. For example:
      1. Downloading a file
      2. Submitting a form
      3. Viewing a video
      4. Clicking on a link
      With the new simplified event tracking installation for hyForms, Journey AI Tours, and Tour Site, you won't have to worry about the technical knowledge needed to set up tags, triggers, and variables. Just install the Hyly Attribution Manager Tag to your GTM container, and you're good to go!

      1.3 Prerequisites 

      Please ensure GTM is installed on your website and it can pass the events to GA.

      2. Source Attribution Installation

      2.1 Template

      GTM makes it easy to deploy and share a tag. Hy.ly has created the template below to simplify the tag installation process. Please click here to download the template.

      2.2 Install Hyly Attribution Manager Tag from Template

      Step 1 -  Navigate to the Admin page of GTM

      Go to  http://tagmanager.google.com/,  click on Admin, then click Import Container

       

       

      Step 2 - Upload Attribution Manager template

      1. Upload the Hyly Attribution Manager template from '2.1. Template'
      2. Choose the Default Workspace
      3. Click the options from the screenshot
      4. Click 'Confirm'
       
       

      Step 3 - Submit and Publish

      • Click 'Submit' and then 'Publish' to publish the new Hy.ly Attribution Manager tag:.

       
      Congratulations! You have successfully installed the Hy.ly Attribution Manager tag to your GTM container; the tag will immediately take effect on your property website.

      3. Event Tracking Installation

      3.1. Activation

      Please contact support@hy.ly to activate the GA4 Event Taxonomy and GA4 DataStream API Key.

      3.2. Create Custom Dimensions (GA4) on Google Analytics

      To see event parameters and user properties that were tracked in your reports, you will need to register them as custom dimensions.

       

      Step 1 - Navigate to the Custom Definitions in GA

      Go to https://analytics.google.com/ > Select GA4 property > click on Admin > Custom definitions.
       
       

      Step 2 - Fill in the Custom Dimensions

      1. Click on 'Create Dimensions'
      2. Fill in the form with values from the table below.

        Dimension Name

        Scope

        Event Parameter

        Event Name

        Page Type 

        Event

        h_page_type

        h_click, h_fill_forms

        Clicked Location

        Event

        h_clicked_location

        h_click,h_watch

        Click Value

        Event

        h_click_value

        h_click

        Display Method

        Event

        h_display_method

        h_click

        Stream

        Event

        h_stream

        h_click, h_fill_forms

        Tour Type

        Event

        h_tour_type

        h_click

        Tour Date

        Event

        h_start_date

        h_click

        Tour Time

        Event

        h_start_time

        h_click

        Availability Date

        Event

        h_availability_date

        h_click, h_watch

        Video Title

        Event

        h_video_title

        h_watch

        Watch Duration

        Event

        h_watch_duration

        h_watch

        Watch Percentage

        Event

        h_watch_percentage

        h_watch

        Video Type

        Event

        h_video_type

        h_watch

        Bedroom Type

        User

        h_bedrooms

        h_watch, h_click

        Floor Plan Type

        User

        h_floor_plan_type

        h_watch, h_click

        Floor Plan

        User

        h_floor_plan

        h_watch, h_click

        Bath

        User

        h_bath

        h_watch, h_click

        Area

        User

        h_area

        h_watch, h_click

        Price Range

        User

        h_price_range

        h_watch, h_click

        Unit

        User

        h_unit

        h_watch, h_click
       

      In the above table, we can see the same parameter belonging to multiple event_types.

      For example, a user can start filling out the form and, in the process, click the buttons but then may not submit the form.

      In case the user submits the form, both the click event and submit form events will have those fields as it was available at both places.

       

      4. Troubleshooting Source Attribution with Hyly Assistant

      Source attribution is a common source of pain for many business owners. And multifamily properties, unfortunately, are not immune to this troubling trend.Many multifamily properties are unable to identify the source of a majority of their leads, and in some cases, a property feels that their digital marketing isn’t really a driver of many of these engagements.


      With the help of the Hyly Assistant extension, marketing managers can easily check if the source attribution is working properly or not when the prospect comes from a Search Engine, Internet Listing Service, Paid Ads, or Social Networks ...

      4.1. Source Code

      Please click here to download the extension source code.

      4.2.  Install Hyly Assistant from Source

       

      Step 1 - Navigate to Chrome Settings

      • In your Chrome browser, click 'Settings.'
       
       
      • Next, click 'Extensions'
       
       
       

      Step 2 - Enable Developer Mode

      1. Enable Developer mode
      2. Click 'Load unpacked' and load the extension source code that you downloaded from '4.1. Source Code.'
       
       
       

      Step 3 - Pin the Hyly Tags Assistant 2

      • Click 'Extensions'
      1. Pin the extension 'Hyly Tags Assistant 2' so you can quickly open the extension to troubleshoot the issue.
      2. Click on Clear Cookies.
       
       
       
      Congratulations! You have successfully installed the Hyly Assistant extension.

      5. Troubleshooting Event Tracking

      If you don’t see any Hyly events on the Google Analytics report, please send an email to support@hy.ly, and we will assist you in troubleshooting the event tracking.