CHEQ’s enriches your data by introducing new fields for Threat Type (an indicator for the reason of how CHEQ classified the request – automation tools, VPN, click hijacking, etc.), Threat Group (malicious, bot, suspicious, valid, good bots, etc.), AI Traffic Type (agent, crawler, or none), and other dimensions.
Install the CHEQ Library Tag
Implement the JavaScript Tag
To find your tag, log into your account to access your Dashboard. In the bottom-left of your user interface, click on your [Account Name] > Account Settings:
Copy the Invocation tag to your clipboard.
Now go to Google Tag Manager and create a Tag. It should look something like this:
| Field | Description | Example |
| Tag Type | Select Custom HTML. | Custom HTML |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. | CHEQ Tag |
| Support document.write | Ensures the script that's posted is secure and triggers the right way. | Checked |
| Tag firing priority | Something over 9,000 just to ensure it triggers first. | 9999 |
Click Save in the top-right. Validate the tag by Previewing the Workspace and then Publish!
Implement the <noscript> Tag
Before starting, Find your CHEQ <noscript> tag and go ahead and click that Copy icon for the <noscript> tag. To implement this, we will need 3 elements: a Variable, Trigger, and a Tag.
In Google Tag Manager, create a Custom JavaScript Variable by going to the Variables section and clicking New.
| Field | Description | Example |
| Variable Type | Select Custom JavaScript. | Custom JavaScript |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. | JS Enabled |
| Custom JavaScript | The custom JavaScript that is pasted into the code editor. | function() { return true; } |
Click Save.
Next, navigate to the Triggers section and click New to create a Trigger to fire the tag for when users' JavaScript is disabled.
| Field | Description | Example |
| Trigger Type | Select Page View. | Page View |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. | JS is Disabled |
| Trigger fires on | If users have JavaScript, it will return true - and we want the opposite of that. | JS Enabled does not contain true |
Click Save.
Finally, head to the Tags section and click New to create the image Tag that will load for users without JavaScript enabled.
| Field | Description | Example |
| Tag Type | Select Custom Image. | Custom Image |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. | CHEQ No-Script |
| Image URL |
The URL that comes after the iframe source parameter: |
https://its.1wittydomain.com/ns/XXXX.html?ch=cheq |
| Tag firing priority | Something over 9,000 just to ensure it triggers first. | 9999 |
Click Save.
Make sure you validate the tag (it shouldn't fire unless you have JavaScript disabled) and then Publish the Workspace.
Send CHEQ Data to Analytics
Configure the Data Layer
In the CHEQ platform, navigate to Analytics > Settings > Data Layer. Configure the Data Layer Connector to use Google Tag Manager's standard data layer object name named dataLayer, as shown below:
Create a Trigger
In Google Tag Manager, navigate to the Triggers section and input the following:
| Field | Description |
| Name | User-defined name of the Trigger. |
| Trigger Type | Select Custom Event. |
| Event Name | The Event Name value in your Data Layer connector settings (see section above). |
| This trigger fires on | Select All Custom Events. |
Create Variables
Create a new Variable to store your value(s) from the Data Layer Push connector. Create a Variable for each Key specified in the Data Layer Connector (see below):
The configuration for each Variable should look something like this:
| Field | Description |
| Name | User-defined name of the variable. |
| Variable Type | Select Data Layer Variable. |
| Data Layer Variable Name | Represents a Key that was input from the Data Layer Connector interface (see Data Layer section above). |
| Data Layer Version | Select Version 2. |
From here, the Variable can be used in any Tag in your Property.
Create the Google Analytics Tag
Once you've created your Variables and Trigger, you're able to create Tags and input the variable(s) in the Event Parameters and/or User Properties:
Create a new Tag and apply the Trigger created above.
Add Dimensions in Google Analytics
For this example, one would create Dimensions in Google Analytics for each of the Properties and/or Parameters sent in the response tag.