Collecting CHEQ Data

Amplitude Analytics doesn't have its own native Tag Management System, so often users will leverage one from other vendors. Please use whichever methodology is compatible with your unique tech stack. Each methodology uses the Amplitude Identify API. So if you hard-coded your implementation, please leverage those methods.

CHEQ Manage

Prerequisites

To send data to Amplitude from CHEQ Manage, use the Amplitude Browser SDK App, which provides a friendly UI to implement Amplitude tags. If the Amplitude Browser SDK (core library) isn't already loaded on your pages, first deploy the core library on your pages as outlined in the documentation here.

Installation

Configure Data Layer Connector

Once the Browser SDK is installed, configure the Data Layer connector if not already done so ensuring that an "Event Name" is set (e.g., cq_response).

Create CHEQ Response Event

Create a Custom JavaScript tag with the below code to add a JavaScript event listener. Ensure the tag is set to use the "All Pages - Non-blocking (Asynchronous)" Condition, then save & commit, and publish the tag. Replace cq_response with the name of the event in Data Layer connector if different.

Bootstrapper.bindDOMParsed(() => {
  document.body.addEventListener("cq_response", (e) => {
    Bootstrapper.ensEvent.trigger("cq_response", e.detail);
  });
});

Next, go to Events > Add New, input the below values, and click Save.

• Name: "cq_response"

• Condition: All Pages - Non-blocking (Asynchronous)

• Event Type: Named Event

Add Amplitude Event

1. Create a new Amplitude Event by going to: Apps > Amplitude Browser SDK > Configure > Events.

2. Click "Add Event"

3. In the "Event" dropdown, select "cq_response".

4. Change "Action" to "Set User Properties (identify)"

5. Ensure "Identify Event Action" is set to "Set".

6. Click "Add Row" to add key/value pairs for each piece of information you want to track to the user.

   Key	Value	Value Type
   threat_group	this.cq_threat_group	JavaScript Variable
   threat_type	this.cq_threat_type	JavaScript Variable

7. Click Save
8. Click Continue and select the "All Pages - Non-blocking (Asynchronous)" Condition.
9. Save & Commit, then publish the Space.
   
   

Adobe Tags (Launch)

To send data to Amplitude from Adobe Tags (Launch), we recommend using the Amplitude v2 Extension (seen below), which provides a friendly UI to implement Amplitude tags.

To track CHEQ properties via Amplitude, first create a new Rule by going to Rules and clicking Add Rule.

Under Events, click + Add. If you're using Local Storage and triggering an Event, you'll fill out the Event interface similar to what's below (replace cheq_response with whatever name you put into the Event Name box). 

If you're using the Data Layer Push connector, please trigger the rule via your data layer extension and the Event Name you specified in the CHEQ interface.

Under Actions, click + Add and add an Action to set the user's properties to CHEQ data attributes. Use the set operator to set the parameter only once during the session. 

Click Keep Changes. The resultant Rule should look something like this:

Save the Rule to your working library.

Google Tag Manager

To send data to Amplitude from Google Tag Manager, we will assume you are using the Amplitude Analytics Browser SDK Template found in the Template Gallery. This provides a friendly UI to use when sending tag data to Amplitude.

With this Template installed, proceed to adding a new Tag by clicking New, Create a Tag with the following properties:

Click Save. Test the tag and deploy when ready.