Implementation with Google Tag Manager

As CHEQ Manage's Server-Side Tagging is a completely beacon (or pixel) based solution, the beacons can be deployed through any means including Google Tag Manager. If Google Tag Manager is your primary client-side tag management solution, you can follow the below instructions to deploy the Server-Side Tagging Web SDK and events.

Before starting to use Server-Side Tagging with Google Tag Manager, ensure that you have a Manage account with Server-Side Tagging enabled.

If your website uses a Content Security Policy (CSP), ensure to allow script requests to nexus.ensighten.com.

Import the tag templates

1. Download the SDK and Event templates.
2. Login to Google Tag Manager and select your container.
3. Click on "Templates" from the left navigation menu.
4. Click "New".
5. In the top-right corner, click the 3 vertical dots and then select "Import".
   
6. Select the SDK template downloaded in step 1 and click "Save".
7. Repeat the steps 2-6 for the Event template.

Add tag

1. Click "Add a new tag" within the Overview section.
2. Click "Choose a tag type to begin set-up...".
3. Click "Discover more tag types in the Community Template Gallery".
4. In the search box at the top, enter "CHEQ Manage".
5. Click the "CHEQ Manage - Server-Side Tagging - Web SDK" entry, click "Add to workspace", then "Add".
6. Repeat the above steps to also import the "CHEQ Manage - Server-Side Tagging - Event" template.
   

Tag configuration and triggering

Server-Side Tagging - Web SDK

The Server-Side Tagging - Web SDK makes the SST library available on the page and helps build the SST beacon and it's payload. 

The Web SDK does not execute any SST events by default such as page_view.

1. Within the "Tags" section of your Google Tag Manager account, click "New".
2. Enter a tag name (e.g., "CHEQ SST - Web SDK") at the top of the screen.
3. In the Tag Configuration section, select the "CHEQ Manage - Server-Side Tagging - Web SDK" template that was added to your workspace in the previous step.
   
4. Tag Configure the inputs:
   • Account
     Your Manage account name that is provided to you by your account manager.

   • SST Domain
     Your first-party domain or use the default third-party domain t.nc0.co. Using a first-party domain is highly recommended and you can find steps on how to create it here.

     If your website uses a Content Security Policy (CSP) and you are using the third-party SST domain t.nc0.co, ensure allow t.nc0.co in your Content Security Policy.

   • Custom Data
     Custom Data can be used to add dynamic data to all SST events. Once added here, each SST event will include this data in the request so that it can be used in Server-Side Tagging.
   • Storage
     The storage section allows you to proactively set cookies, localStorage, and/or sessionStorage within the SST instance.
   • Integrations
     Enable the pre-built integrations if using these vendors for Server-Side Tagging.
   • Options
     Advanced options that can allow you to disabling batching, specify a batch timeout, specify a different Server-Side Tagging publish path, and change your data layer's name (if something other than "dataLayer").
5. Under Triggering, click "Choose a trigger to make this tag fire..."
6. Select "All Pages".
7. Click "Save".
8. Click "Submit" and publish your changes.

Server-Side Tagging - Event

Once your Web SDK tag is deployed on all pages, you can start to configure your Server-Side Tagging Events. Events consist of a name and a payload that is specific to the event. It is typical to configure a "page_view" event that executes on each page and any other key events such as "add_to_cart" that occur between page loads.

The SST Web SDK automatically handles timing of SST events so that tag firing priority, sequencing, or other options are not needed.

1. Within the "Tags" section of your Google Tag Manager account, click "New".
2. Enter a tag name (e.g., "CHEQ SST - Event - Page View") at the top of the screen.
3. In the Tag Configuration section, select the "CHEQ Manage - Server-Side Tagging - Event" template that was added to your workspace in the previous step.
4. Tag Configure the inputs:
   • Event Name
     The name of the event you want to track (e.g., "page_view").
   • Event Data
     Event specific to this event to track. For example, if sending an "add_to_cart" event, pass the details of the item that was added to the cart. These values can be referenced within tags in SST by using the JavaScript variable this.
   • Options
     Advanced options that can allow you to disabling batching for this event (send immediately) or specify custom or parameters to send.
     
5. Under Triggering, click "Choose a trigger to make this tag fire..."
6. Select your trigger of when to execute this SST event. For example, if sending a "page_view" event, select "All Pages". If sending an "add_to_cart" event, select your existing Add to Cart event or create a new one.
7. Click "Save".
8. Click "Submit" and publish your changes.

Next Steps

Once the tags are configured in Google Tag Manager, follow the steps to configure an SST Environment and setup tags in SST.