Debug Google Tag Manager Configuration | Zoho Forms

Steps to debug your Google Tag Manager Configuration

Before you debug

  1. If you have embedded your form on a website, make sure that the form is embedded as an iframe and not using the downloaded HTML/CSS of the form.
  2. Make sure that you have configured Google Tag Manager only with a Google Analytics 4 property.
  3. Make sure that you have already configured Tag, Trigger and the required Data Layer Variables.
If you have done the above, make sure that you publish Google Tag Manager only after checking out the steps below.
The steps to debug below are structured this way:
  1. The headers are the debug steps to follow 
  2. The content beneath each header refers to the steps to follow if the debug steps don't work

  1. If the event is not getting fired, check if you have enabled the event on Zoho Forms end.

    Event Configuration

  2. Check if the domain is enabled for debugging in GTM Preview window.


Once the event is visible, click the event to see if the Tag configured is fired

  1. While configuring the custom event trigger, check if you have set the Event Name as given in Zoho Forms. For example: zf_submitform, or set a custom event name as zf_* and select Use regex matching.

    Event
    		Event Name
    Form View
    		zf_formview
    Page View
    		zf_pageview
    Onclick Fields
    		zf_onclickfield
    Review Form
    		zf_reviewform
    Save Form
    		zf_saveform
    Submit Form
    		zf_submitform

  2. In the Preview  mode, click the required event and click the Tag that is not getting fired to view the Tag Details.

    Tag that is not fired

    Tag Details

    Here, we can check the trigger that is not getting executed.

  3. Navigate to the Data Layer part of the event to see the data received from Zoho Forms.

    Data Layer

Verify the variables received with the variables shown under Firing Triggers  in step 2 to find where the discrepancy lies.

After the event has fired, check in Google Analytics realtime if the event is visible

Publish the changes in Google Tag Manager once more.

The event has fired, but the data shown in Google Analytics realtime is different from expected.


Wherever data layer variables are expected while configuring the Tag, make sure it has been set properly by clicking the    icon next to the input box and selecting the pre-configured data layer variables.

Continue with the below steps if you have your form embedded in a website, but only after you have verified the above steps.  

 

Preview the website with the form embedded in it now and see if event is getting fired while performing the action

Make sure that you have followed the steps here for Google Analytics 4 property. If you are unable to view your form in preview mode, it is likely that you have not installed the Tag Assistant Companion browser extension, which is required for your form embedded within an iframe to work reliably in preview mode.
Install extension