Element tag
The Element tag is used to track intra-page content in Digital Analytics. Data collected by the Element tag is used to populate values in the Element Categories and Top Viewed Elements reports.
The Element tag and its associated reports provide organizations with the flexibility to track interaction with various intra-page elements and how these elements drive objective attainment. Below are some examples of elements that could be tracked using the Element tag:
- Portlets
- Search portlets
- News portlets
- AJAX Detail Hovers
- Product detail hover-overs
- Customer review hover-overs
- Video Plays
- Play
- Stop
- Rewind
- Explore Video Reporting
- Dynamic Page Content
- Price slider bars
- Brand filter checkboxes
- Feature selectors
- Page or Form Error messages
- Clicks on File Downloads or 3rd Party Content or Banners
- PDF downloads
- 3rd Party Banners or Content
- Key Report Populated:
- Content (Elements); Report Segments
- Digital Data Exchange Object Example:
-
digitalData = {component:[{componentInfo:{componentID:'ELEMENT-ID'}, category:{primaryCategory:'ELEMENT-CATEGORYID'}, attributes:{exploreAttributes:''}}]};
Tagging function
In order to use the Element tag, a call is made to cmCreateElementTag(…) function with the
appropriate parameters.
Note: The following values are automatically removed from Acoustic Digital Analytics tag parameter data and cannot be collected or reported:
- single quote (')
- double quote (")
- carriage return (hex 0D; regular expression \r)
- line feed (hex 0A; regular expression \n)
- comma (,): replaced with a space character prior to data loading and reporting
- backslash (\): this is a standard JavaScript escape character. In order to collect and report a "\" character, two "\" must be specified in sequence ("\\"). The 2nd "\"is reported.
- Element ID (Required): The unique identifier or name for the Element and the value that is displayed in the Elements report. Length limit is in 'characters,' which vary in byte length depending on encoding. Length: 50.
- Element Category (Optional): The category passed in the Element tag is used to populate the Element Categories report. Only one hierarchical level of categorization is currently supported and not related in any way to the client's Category Definition File (CDF) specification. Length: 50.
- Attribute String (Optional): Up to 50 "-_-" delimited 'attribute' values representing demographic group information in Analytics and Explore Reporting. Length: 256 per value.
Examples
Here is an example of an Element tag with an Element ID of "Vacation Planner" and with an Element
Category ID of "Vacation
Tools".
<head>
<script type="text/javascript" src="//libs.coremetrics.com/eluminate.js"></script>
<script type="text/javascript">
cmSetClientID("99999999",true,"data.coremetrics.com","thesite.com");
</script>
</head>
<body>
...
<script type="text/javascript">
cmCreateElementTag("Vacation Planner", "Vacation Tools");
</script>
</body>