Integrating the CHEQ response with Amplitude attaches CHEQ's traffic classification to your Amplitude users as user properties. Once the data is flowing, you can segment any chart or funnel by Threat Group to separate genuine users from bots and malicious traffic, break down acquisition and conversion reporting by Threat Type to see which channels are delivering invalid traffic, isolate AI Traffic Type to understand how much of your engagement comes from agents and crawlers rather than people, and build cohorts that exclude non-human traffic entirely so your retention, engagement, and conversion metrics reflect real user behavior.
Prerequisites
Complete both of the following before configuring Amplitude:
- Install the CHEQ library tag on your website.
- Configure the Data Layer Connector to expose the CHEQ fields you want to report on and choose how the response is delivered — data layer push, JavaScript variable, cookie, or local storage.
Send CHEQ Data to Amplitude
Set the CHEQ values as Amplitude user properties using the set operator.
Use either approach below.
Option A — via your tag management system
- Install your tag manager's Amplitude integration (for example, the Amplitude Analytics Browser SDK template in CHEQ Manage or Google Tag Manager, or the Amplitude v2 extension in Adobe Launch).
- Create a variable or equivalent for each CHEQ key you configured, reading from the delivery method you selected.
- Create a trigger that listens for the CHEQ event name set in the Data Layer Connector.
- Create an Amplitude tag or action using Identify / Set User Properties with the
setoperator, mapping each user property to its corresponding CHEQ variable. - Test, then publish.
| Setting | Value |
|---|---|
| Trigger / Event | Custom event matching your CHEQ Event Name |
| Action | Identify (Set User Properties) |
| Operator | set |
| User Property |
threat_type, threat_group, etc. |
| Value | The variable holding the CHEQ value |
Option B — via the Amplitude JavaScript SDK
Read the values from wherever you configured CHEQ to write them and pass them to Amplitude directly:
document.addEventListener("cheq_response", function(e) {
const identify = new amplitude.Identify();
identify.set("threat_type", window.localStorage.getItem("cq_threat_type"));
identify.set("threat_group", window.localStorage.getItem("cq_threat_group"));
identify.set("ai_traffic_type", window.localStorage.getItem("cq_ai_traffic_type"));
amplitude.identify(identify);
});Adjust the read method to match your chosen delivery option — for example window.dataLayer for Data Layer Push, or a cookie read for Cookie. Repeat for each key you configured.