The Data Layer Connector allows users to quickly and easily plug Cheq data into Google Tag Manager.
Creating Variables
Navigate to the Google Tag Manager property and create a new Variable to store your value(s) from the Data Layer Push connector. In most cases, you will create a Variable for each Key specified in the Data Layer Connector. The configuration for each Key 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. |
| Data Layer Version | Select Version 2. |
| Default Value | Optional. If there’s no value, fall back to some other value. |
From here, the Variable can be used in any Tag in your Property.
Detecting Data Layer Updates
An event is assigned in every payload, which will proactively signal that the user’s status has changed (for instance, from Valid to Malicious). This event will trigger every time the status is changed, including the first time it is set. This is especially useful to eliminate race conditions because users can trigger a server call when the status is set instead of relying on the data to be sent with the pageview payload.
Note: Please ensure you have considered implications on hit volume in your analytics tool, as the event will typically trigger once per user.
The following example is used to build a Trigger in Google Tag Manager:
| Field | Description |
| Name | User-defined name of the Trigger. |
| Trigger Type | Select Custom Event. |
| Event Name | Whatever the value was set for the Event in your Data Layer connector settings. |
| This trigger fires on | Select All Custom Events. |