Skip to main content
You have permission to edit this article.
Edit

BLOX CMS Data Layer Elements for Google Tag Manager (Flex only)

  • Updated

Table of Contents

Page Variables

GTM Data Layer & Elements | Page Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Page Variables tncms.page.style This variable will contain the "Site style" of the page, as set in the General design section of the URL page customizations. N/A
Page Variables tncms.page.grid This variable will contain the "Wireframe grid" setting of the page, as set in the Layout section of the URL page customizations. N/A
Page Variables tncms.page.http_status This will return the page's current HTTP status (200, 400, etc.). This allows you to create a report in Google Analytics and mark pages with status of greater than or equal to 400 as exceptions (and not count them as page views). N/A
Page Variables tncms.page.app The controller, or app, which drives the current request (i.e. Editorial, Classifieds). blox_application
Page Variables tncms.page.skin The base (directory) name of the skin used for the current request blox_skin
Page Variables tncms.page.theme The template “theme” for this page, either Site (local copied templates), Flex (System Templates). N/A
Page Variables tncms.page.reaction This is a boolean value indicating whether the User Reactions is active on the page N/A
Page Variables tncms.page.platform This property will be set when a page is served from an external platform, such as AMP or Facebook Instant Articles. N/A
Page Variables tncms.page.syndicated This is a boolean value indicating whether the content is syndicated from another source. N/A
Page Variables tncms.page.outbrain This is a boolean value indicating whether the Outbrain feature is active on the page. N/A
Page Variables tncms.page.taboola This is a boolean value indicating whether the Taboola feature is active on the page. N/A

GTM Data Layer & Elements | Page Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.page.style Yes Yes Yes No Yes Yes No Yes No
tncms.page.grid Yes Yes Yes Yes Yes Yes No Yes No
tncms.page.http_status Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.page.app Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.page.skin Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.page.theme Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.page.reaction Yes No No No No No No No No
tncms.page.platform No No No No No No Yes No No
tncms.page.syndicated Yes No No No No No No No No
tncms.page.outbrain Yes No Yes No No No No No No
tncms.page.taboola Yes No Yes No No No No No No

Template Info Variables

GTM Data Layer & Elements | Template Info Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Template Info Variable tncms.template.version Template release version running on the site N/A

GTM Data Layer & Elements | Template Info Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.template.version Yes Yes Yes Yes Yes Yes No Yes No

Syndication Variables

GTM Data Layer & Elements | Syndicated Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Syndication Variables tncms.syndication.channel Returns 'cen' if article originated from the TownNews.com Content exchange. (This is currently the only value available.) N/A
Syndication Varables tncms.syndication.source This is the information from the asset's "source" field. asset_source
Syndication Variables tncms.syndication.origin This will show the canonical url for the article unless that is not available, then the original host of the article. N/A
Syndication Variables tncms.syndication.category This is a value used by the TownNews.com Content Exchange to track the various content channels available from the Content Exchange (such as health, politics, entertainment, etc.). It is derived from a #cen_CATEGORY keyword. N/A

GTM Data Layer & Elements | Syndicated Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.syndication.channel Yes No Yes No No No No No No
tncms.syndication.source Yes No Yes No No No No No No
tncms.syndication.origin Yes No Yes No No No No No No
tncms.syndication.category Yes No Yes No No No No No No

Asset Variables

GTM Data Layer & Elements | Asset Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Asset Variables tncms.asset.author "Will use the author user account with first and last name if available. If not, in editorial, will use the byline and attempt to remove the ""by"" or ""from"". Assets that do not have asset authors will not support this variable." asset_byline, but formatted differently

GTM Data Layer & Elements | Asset Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.asset.author Yes Yes Yes No No No No No No

e-Edition Variables

GTM Data Layer & Elements | e-Edition Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
e-Edition Variables tncms.eedition.is_segmented True or false, depending if the page is segmented. N/A
e-Edition Variables tncms.eedition.publication Name of the e-Edition publication. N/A
e-Edition Variables tncms.eedition.view Used to see which view the customer is looking at the e-Edition in, "Page" or "Text" N/A

GTM Data Layer & Elements | e-Edition Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.eedition.is_segmented No No No Yes No No No No No
tncms.eedition.publication No No No Yes No No No No No
tncms.eedition.view No No No No No No No No No

Infinity Scroll Variables

GTM Data Layer & Elements | Infinity Scroll Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Infinity Scroll Variables tncms.infinity_scroll.display Name of the infinity scroll setup running on the page. N/A
Infinity Scroll Variable tncms.infinity_scroll.order Name of the infinity scroll order running on the page. N/A

GTM Data Layer & Elements | Infinity Scroll Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.infinity_scroll.display Yes Yes Yes No No No No Yes Yes
tncms.infinity_scroll.order Yes Yes Yes No No No No Yes Yes

Client Variables

GTM Data Layer & Elements | Client Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Client Variables tncms.client.noscript true/false | This property indicates that the client has javascript disabled. N/A
Client Variables tncms.client.breakpoint Reports the breakpoint for the given page. Breakpoints are determined by looking at the current page viewport size and comparing it to the breakpoint values defined in the template skin breakpoint settings. Flex, for example, tracks: large devices (desktops, = 1200 px), medium devices (desktops, = 992 px), small devices (tablets, = 768px) and extra small devices (phones, < 768 px) N/A
Client Variables tncms.client.is_bot A “yes” or “no” declaring whether the current user-agent which rendered the page is judged to be a bot by our servers. This is probably not particularly useful for customers because it only includes rendered pages, not cached pages. It is a measure of how much pressure bots are putting on our servers. N/A

GTM Data Layer & Elements | Client Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.client.noscript Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.client.breakpoint Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.client.is_bot Yes Yes Yes Yes Yes Yes Yes Yes No

Subscription Variables

GTM Data Layer & Elements | Subscription Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Enhanced Ecommerce Event tncms.event.trigger Trigger to be used to pass enhanced ecommerce events through to Google Analytics. N/A
Enhanced Ecommerce Event tncms.event.trigger.category This will always be the text : subscription N/A
Enhanced Ecommerce Event tncms.event.trigger.avtion This wil contain text summarizing the action taken in the purchase workflow N/A
Enhanced Ecommerce Event tncms.event.trigger.label This will contain a description of the action taken in the purchase workflow. N/A
Enhanced Ecommerce Event tncms.event.trigger.value Not applicable N/A
Subscription Variables tncms.subscription.required True or false, depending on whether subscription is required on this page. N/A
Subscription Variables tncms.subscription.access_service_ids This is a comma separated list of the service ids restricting access to this page. N/A
Subscription Variables tncms.subscription.user_service_ids This cannot function currently as this is something that caches in the system and is not accurately reporting the service ids of each user. N/A

GTM Data Layer & Elements | Subscription Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event.trigger Yes No No Yes No No No No Yes
tncms.event.trigger.category Yes No No Yes No No No No Yes
tncms.event.trigger.avtion Yes No No Yes No No No No Yes
tncms.event.trigger.label Yes No No Yes No No No No Yes
tncms.event.trigger.value Yes No No Yes No No No No Yes
tncms.subscription.required Yes No No Yes No No Under Review No No
tncms.subscription.access_service_ids Yes No No Yes No No Under Review No No
tncms.subscription.user_service_ids No No No No No No No No No
tncms.subscription.paid_access_service_ids Yes No No No No No No No
tncms.subscrption.user_service_ids Yes No No No No No No No

Subscription Events

If UA Mode is enabled on your Google Settings (on the dropdown menu, go to Settings / Google), these events will automatically be pushed to your Google Analytic account for the UA ID is listed.  The Enhanced Ecommerce setting will need to be turned on.  For those that use GTM in the Google Settings, a GTM Container will need to be set up in order for these events to be automatically pushed to Google AnalyticsGTM uses this Data Layer to trigger the events.  

CategoryActionLabelValue
SubscriptionFree ViewPreviously ReadMeter Count
SubscriptionFree ViewFree ClickMeter Count
SubscriptionFree ViewUnder Registration LimitMeter Count
SubscriptionFree ViewUnder Subscription LimitMeter Count
SubscriptionRegistration WallHit Registration LimitMeter Count
SubscriptionSubscription WallHit Subscription LimitMeter Count
SubscriptionGoalLogged in after encountering wallMeter Count
SubscriptionGoalPurchased SubscriptionMeter Count
SubscriptionGoalPurchased subscription after encountering wallMeter Count

Enhanced Ecommerce Service Data Layers Additions and Impressions

If UA Mode is enabled on your Google Settings (on the dropdown menu, go to Settings / Google), these events will automatically be pushed to your Google Analytic account for the UA ID is listed.  The Enhanced Ecommerce setting will need to be turned on.  For those that use GTM in the Google Settings, a GTM Container will need to be set up in order for these events to be automatically pushed to Google AnalyticsGTM uses this Data Layer to trigger the events.  

  • tncms.event.ecommerce - This will be used to trigger all events.

Ecommerce Events

CategoryActionLabel
Subscription (1)Product Impression EventThis is fired any time a list of services is displayed. These are available on the paywall modal (when show service on paywall is enabled) as well as in the user dashboard. There is also a services list block that will fire the product impression event.
Subscription (2)Product Click EventThis is fired when a user clicks on the "get started" button which displays in the service lists.
Subscription (3)Product Detail ViewThis is fired when the service purchase form is loaded.
Subscription (4)Add To CartThis is fired when the user selects a rate from the service purchase page and an additional add to cart are fired when you change the rate.
Subscription (5)Remove From CartThis is fired when the user selects to remove from cart and an additional add to cart are fired when you change the rate.
Subscription (6)CheckoutThis event is fired as the use continues to fill out the information in the service purchase form.
Subscription (7)PurchaseThis event is fired when the purchase is complete.

Events Triggerd by Subscription Service

  • Subscription Service Type - Uses all seven listed in the Event List table.
  • CSV Service Type -
    • CSV With Rates - will use all seven listed in the Event List table.
    • CSV Without Rates - will use 1, 2, 3, and 7 only based on the Event List table.
  • Free Service Type - will use 1, 2, 3, and 7 only based on the Event List table.
  • Domain Service Type - will use 1, 2, 3, and 7 only based on the Event List table.
  • Falcon Service Type - Uses all 7 steps as outlined. Impressions will however not be fired on articles, rather they will be fired on /service/purchase as they are not shown until they click on the paywall options.

Enhanced Ecommerce Resources

Social Events

Social events are triggered when a user performs a function related to sharing, following or commenting on an asset. Each social event has three parts, the action (which is the thing that the user did - follow, share, tweet, etc.), the network (which is the site receiving their action - the current BLOX site, Facebook, Twitter, etc.) and the target (which is the URL being tracked).

GTM Data Layer & Elements | Social Event Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Action tncms.event.social.action Possible Values: socialEvent.action
Follow - A user follows the profile of the article author.
Post - A use shares a story to a network.
Tweet - A user tweets an asset.
Comment - A user posts a comment.
Reaction - The reaction the user clicks on.
Network tncms.event.social.network Possible Values: socialEvent.network
Site - The media's organization hosted site.
Twitter - The Twitter Platform.
Facebook - The Facebook Platform.
Disqus - The Disqus Commenting Platform.
Target tncms.event.social.target The URL of the item being tracked (i.e. the user being followed, the story being shared, etc.). socialEvent.target

GTM Data Layer & Elements | Social Event Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event.social.action Yes Yes Yes No No No No No Yes
tncms.event.social.network Yes Yes Yes No No No No No Yes
tncms.event.social.target Yes Yes Yes No No No No No Yes

Vendor Variables

GTM Data Layer & Elements | Vendor Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Vendor Variables tncms.vendor.chartbeat This variable holds the chartbeat UID setting from the third party integrations section of the page customizations. chartbeat
Vendor Variables tncms.vendor.comscore This variable holds the Comscore Client ID from the third party integrations section of the page customizations. comscore
Vendor Variables tncms.vendor.quantcast This variable holds the Quantcse ID from the third party integrations section of the page customizations. quantcast

GTM Data Layer & Elements | Vendor Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.vendor.chartbeat Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.vendor.comscore Yes Yes Yes Yes Yes Yes Yes Yes No
tncms.vendor.quantcast Yes Yes Yes Yes Yes Yes Yes Yes No

Ads Elements

GTM Data Layer & Elements | Ad Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Ad Blocking Event tncms.event.trigger This is the name of the event to trigger off of in GTM. tncms.event.trigger
Ad Blocking Event tncms.event.trigger.category Contains the text : tnt-adblock tnt-adblock
Ad Blocking Event tncms.event.trigger.action Contains the text : adblock adblock
Ad Blocking Event tncms.event.trigger.label Contains the text : adblock detected adblock detected
Ad Blocking Event tncms.event.trigger.value Contains the number : 1 1
Ad Vendor Variable tncms.ad.vendor "Contains the fixed ad provider for the current page. Note - additional ads servied via block placement my possibly be different." N/A

GTM Data Layer & Elements | Ad Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event.trigger Yes Yes Yes Yes Yes Yes No Yes No
tncms.event.trigger.category Yes Yes Yes Yes Yes Yes No Yes No
tncms.event.trigger.action Yes Yes Yes Yes Yes Yes No Yes No
tncms.event.trigger.label Yes Yes Yes Yes Yes Yes No Yes No
tncms.event.trigger.value Yes Yes Yes Yes Yes Yes No Yes No
tncms.ad.vendor Yes Yes Yes Yes Yes Yes No Yes No

Gallery Virtual Page View Events

Use the following elements to pass along the gallery virtual events through GTM to Google Analytics.

GTM Data Layer & Elements | Gallery Virtual Page View Event Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Trigger tncms.event_virtual_pageview This is the name of the event to trigger off of in GTM. VirtualPageview
Title tncms.event_virtual_pageview.title This is the title to be used for the virtual page view. VirtualPageview.title
URL tncms.event_virtual_pageview.url This is the URL to be used for the virtual page view VirtualPageview.url

GTM Data Layer & Elements | Gallery Virtual Page View Event Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event_virtual_pageview Yes Yes Yes Yes Yes Yes No Yes Yes
tncms.event_virtual_pageview.title Yes Yes Yes Yes Yes Yes No Yes Yes
tncms.event_virtual_pageview.url Yes Yes Yes Yes Yes Yes No Yes Yes

Metering Events

GTM Data Layer & Elements | Metering Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Metering Event tncms.event.trigger Trigger to be used to pass enhanced ecommerce events through to Google Analytics. For tncms.event.trigger details - Reference Event Triggering Chart Below. gaTriggerEvent
Metering Event tncms.event.trigger.category This will always be the text : subscription gaEventCategory
Metering Event tncms.event.trigger.action This describes the action of the event. for example free view, wall, or goal gaEventAction
Metering Event tncms.event.trigger.label This will provide a descriptoin of where this event falls in the metering workflow. gaEventLabel
Metering Event tncms.event.trigger.value This will always contain the value of the meter count gaEventValue
Metering Variables tncms.subscription.meter.thresholds.registration The value of this element comes from the “Require registration after”setting in BLOXCMS/Design/Blocks/Page Customizations/Paywall settings. N/A
Metering Variables tncms.subscription.meter.thresholds.subscription The value of this element comes from the “total free vews”setting in BLOXCMS/Design/Blocks/Page Customizations/Paywall settings. N/A
Metering Variables tncms.subscription.meter.views.count This element contains the current meter count of the reader for the current month(or specified period of time). N/A
Metering Variables tncms.subscription.meter.views.rem_count This element contains the number of remaining free views before the next wall is encountered. N/A

GTM Data Layer & Elements | Metering Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event.trigger Yes No No No No No No No No
tncms.event.trigger.category Yes No No No No No No No No
tncms.event.trigger.action Yes No No No No No No No No
tncms.event.trigger.label Yes No No No No No No No No
tncms.event.trigger.value Yes No No No No No No No No
tncms.subscription.meter.thresholds.registration Yes No No No No No No No No
tncms.subscription.meter.thresholds.subscription Yea No No No No No No No No
tncms.subscription.meter.views.count Yes No No No No No No No No
tncms.subscription.meter.views.rem_count Yes No No No No No No No No

Metering Event Trigger Chart

CategoryActionLabelValue
tnt-meteringfree viewpreviously readmeter count
tnt-meteringfree viewfrom social mediameter count
tnt-meteringfree viewunder registration limitmeter count
tnt-meteringfree viewunder subscription limitmeter count
tnt-meteringwallhit registration limitmeter count
tnt-meteringwallhit subscription limitmeter count
tnt-meteringwall actionlogged in after encountering wallmeter count
tnt-meteringwall actionpurchased subscriptionmeter count
tnt-meteringwall actionpurchased subscription after encountering wallmeter count

Video Events

GTM Data Layer & Elements | Video Variables

Datalayer Category Datalayer Element Description Legacy Element Being Replaced
Video Event tncms.event.trigger Trigger to be used to pass Video events through to Google Analytics. gaTriggerEvent
Video Event tncms.event.trigger.category This will always be the text : tnt-video gaEventCategory
Video Event tncms.event.trigger.action This contains the video action occuring gaEventAction
Video Event tncms.event.trigger.label This contains the video action and the Player ID gaEventLabel
Video Event tncms.event.trigger.value N/A gaEventValue
Video Ad Event Variable tncms.event.trigger The value of this element comes from the “Require registration after”setting in BLOXCMS/Design/Blocks/Page Customizations/Paywall settings. gaTriggerEvent
Video Ad Event Variable tncms.event.trigger.category The value of this element comes from the “total free vews”setting in BLOXCMS/Design/Blocks/Page Customizations/Paywall settings. gaEventCategory
Video Ad Event Variable tncms.event.trigger.action This element contains the current meter count of the reader for the current month(or specified period of time). gaEventAction
Video Ad Event Variable tncms.event.trigger.label This element contains the number of remaining free views before the next wall is encountered. gaEventLabel
Video Ad Event Variable tncms.event.trigger.value N/A gaEventValue

GTM Data Layer & Elements | Video Variables Supported Pages

Variable Editorial Asset Pages Businesses Asset Pages Calendar Asset Pages e-Edition Asset Pages Static Asset Pages Forms Asset Pages AMP Index Pages Available w/o GTM
tncms.event.trigger Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.category Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.action Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.label Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.value Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.category Yea Yes Yes Yes No No No Yes Yes
tncms.event.trigger.action Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.label Yes Yes Yes Yes No No No Yes Yes
tncms.event.trigger.value Yes Yes Yes Yes No No No Yes Yes

Video Event Trigger Chart

CategoryActionLabel
tnt-videovideo pausedUser paused
tnt-videovideo playinguser watching: [PLAYER ID]
tnt-videovideo resumeduser resumed: [PLAYER ID]
tnt-videovideo endeduser watched: [PLAYER ID]
tnt-video-adpreroll playinguser watching: [ASSET URL]
tnt-video-adpreroll clickeduser clicked: [ASSET URL]
tnt-video-adpreroll linkopening: [ASSET URL]
tnt-video-adpreroll endeduser watched: [ASSET URL]
tnt-video-adpostroll playinguser watching: [ASSET URL]
tnt-video-adpostroll clickeduser clicked: [ASSET URL]
tnt-video-adpostroll linkopening: [ASSET URL]
tnt-video-adpostroll endeduser watched: [ASSET URL]

We want your feedback!

See something that needs updating or additional clarification? Want assistance with a topic that isn’t listed here? Please let us know!

At BLOX Digital we are dedicated to providing you the information you need to be successful when you need it.

Visit our feedback page to log in, submit a support ticket, and track the progress of your open requests.