The base library is the first magical step to begin basic CHEQ data collection. Installing it via Adobe Launch simply requires a single rule that loads our JavaScript tag at the top of every page (if possible). You may already have an existing rule you want to add our library to. For the purposes of this guide, we assume you do not.
Base Tag Installation
First, open your Adobe Launch property, navigate to Rules, and click Add Rule.
In the rule creation interface, click the + Add button below Events and add an Event to load on Library Loaded (Page Top).
| Field | Description | Example |
| Extension | Core Extension in Launch. | Core |
| Event Type (Recommended) | Tells Launch when/where the tag should be triggered. | Library Loaded (Page Top) |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. | Page Top |
Click Keep Changes in the top-right.
While we recommend loading our tag as the highest priority and Page Top (Library Loaded), we also understand that there could be reasons that this isn't possible. This recommendation mitigates certain race conditions, but is not always required.
Next, click on the + Add button below Actions and add HTML.
| Field | Description | Example |
| Extension | Core Extension in Launch. | Core |
| Event Type | Sets the type of action that will be executed. | Custom Code |
| Name (Recommended) | Some name that makes sense. This doesn't impact functionality. Use all caps if you're really excited. | CHEQ Tag |
Next, click Open Editor and copy/paste the <script> tag.
Click Save, then click Keep Changes in the top-right. Finally, Save the rule. That's it!
What about the <noscript> tag?
Adobe Launch is exclusively a JavaScript-based tag and, as such, does not support <noscript>tags (the tag that detects users with JavaScript disabled). If your business use case requires capturing these users, consider deploying the <noscript> tag immediately after the opening of the <body> tag.
Data Layer Integration
The Data Layer Connector allows CHEQ Analytics users to quickly and easily plug CHEQ data into Adobe Data Collection Tags (Launch).
Creating Data Elements
Navigate to the Adobe Data Collection Tags property and create a new Data Element to store your variable(s) from the Data Layer Push connector. In most cases, you will create a Data Element for each Key specified in the Data Layer Connector. The configuration for each Key should look something like this:
| Field | Description | Example |
| Name | User-defined name of the Data Element. | User | Threat Group |
| Extension | Recommended extension that supports Data Layer Push methodology. | Adobe Client Data Layer |
| Type | Required type of the Data Element. | Data Layer Computed State |
| Path | Represents a Key that was input from the Data Layer Connector interface. | threat_group |
| Storage Duration | Determines how long the value will be stored in the browser. For most cases, leave it as "None". | None |
From here, the Data Element can be used in any Rule in your Web 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 currently triggers once per page load. Consider adding a custom condition to load once per session.
The following example is used with the Adobe Client Data Layer Adobe Launch extension:
| Field | Description |
| Name | User-defined name of the Rule’s Event. |
| Extension | Select Adobe Client Data Layer. |
| Event Type | Select Data Pushed. |
| Listen to | Select Specific Event. |
| Time scope | Select All. |
| Event / Key to register for | Whatever the value was set for the Event in your Data Layer connector settings. |
Next Step: Send CHEQ Data to Marketing Tools
Please refer to our guide(s) on how to send data to various endpoints from Adobe Launch: