Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


A guide to setting up Google Tag Manager to capture Data Layer Variables and Events generated by Cloudoko Forms

Step-By-Step Guide To Defining Your Data Layer Variables

You will need to have full access to the administration side of Google Tag Manager (GTM).


It's important to get these steps exactly right. Any mistakes will result in lost or incorrect data being reported to your Google Tag Manager.

  1. Log in to your GTM account and navigate to the relevant Container for your Cloudoko Forms environment.
  2. Locate the Variables option on the left hand menu of GTM and scroll down to the section named User-Defined Variables.

  3. Once we have enabled the GTM integration on your Cloudoko Forms environment, a number of Variables are populated as your users move through a Cloudoko Form.

    We need to set up these Variables as Data Layer Variables, so that you can use them in your Tag and Trigger definitions.

    For more information please see the concept article - Google Tag Manager Integration For Cloudoko Forms.
  4. We will now walk through setting up the first of these Variables. Here are the details: -

    Data Layer Variable NameDescription
    CloudokoFormKeyThe unique key that identifies your Cloudoko Form

  5. Click the New button beneath the User-Defined Variables heading.

  6. Select Data Layer Variable as your Type.

  7. Use the Data Layer Variable Name specified in the table.

  8. Leave everything else at its default setting and click Create Variable
  9. Repeat steps 5 to 8 for each of the following Data Layer Variables.

    Data Layer Variable NameDescription
    CloudokoFormNameThe name of your key that identifies your Cloudoko Form
    CloudokoFormPageThe name of the current page that the user is viewing on your form
    CloudokoFormSearchTypeThe type of search the user is executing on your form
    CloudokoFormSearchCountThe number of results returned by the search

  10. You should end up with a User-Defined Variables screen looking like this.

  11. Don't forget to publish your Container!

    See: for more information on why this is important.

titleCustom Data
If you have any customer specific data layer variables, these will also need setting up following steps 5 to 8.


Define Your Tags

We will refrain from providing specific information on this topic because all our customers will have different requirements.

Cloudoko Forms publishes as much data as it can through the above Data Layer Variables mechanism which should hopefully give you sufficient options for populating your Event Category, Action, Label and Value properties.

For our own reporting purposes, we configure the following Tags for Google Universal Analytics.

  1. Page View
  2. Event
    1. N.B Tags with a Track Type of Event introduce the {{Event}} variable which can also be used in your Category / Action / Label. 
    2. Consult the Google Tag Manager Integration For Cloudoko Forms guide for more information about the events that we publish.

For simplicity's sake we set both tags to trigger on All Pages.


Your requirements may be more complicated than ours, and you should consult the Google Tag Manager documentation for help as we unfortunately cannot recommend solutions for Google's products.



Filter by label (Content by label)
cqllabel in ("google","tag","manager","analytics") and type = "page" and space = "KB"

Page Properties
Related issues