Page View tag

A Page View tag tells Digital Analytics that someone has viewed a page uniquely identified by the Digital Analytics "Page ID" collected as parameter 1. The Page View tag also captures data related to on-site keyword searches.

On search results pages, the Search Term parameter of the Page View tag should be set to the value of the term on which that search was performed. The Search Results parameter should be set to the number of results returned by the search.

Key Reports Populated: Dashboards; Site Metrics; Marketing; Content (Page Categories, * Pages, On-Site Search); Paths; Demographics (Geography, Languages, Profile Segments); Report Segments
Digital Data Exchange Object Example: digitalData = { page:{pageInfo:{pageID:'',onsiteSearchTerm:'', onsiteSearchResults:''},category:{primaryCategory:''},attributes: {exploreAttributes:'',extraFields:''}}};

Tagging function

To use the Page View tag, a call is made to the cmCreatePageviewTag(…) 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.

Page ID (Required): Uniquely identifies the given 'page' in Digital Analytics. This can be any alphanumeric string and should be set according to the agreed-upon page naming conventions. Length: 256.
Category ID (Optional): Category ID for the leaf node to which this page belongs. This should match with a category ID sent in the CDF file. Length: 256.
Search Term (Optional): On-site search term used to generate the search results page. Length: 256.
Search Results (Optional): Number of results returned by the keyword search. This value should equal the total results for this search across all results pages. If the search returned no results, this value should be "0". Length: 10.
Attribute String (Optional): Up to 50 "-_-" delimited 'attribute' values accessible in Explore reporting. Length: 256 per value.
Extra Fields (Optional): Up to 15 "-_-" delimited 'extrafield' values accessible through optional Standard Data Export. It is possible to automatically copy the first 15 values from the first 15 Attribute String values by calling cmSetupOther ({"cmAutoCopy AttributesToExtra Fields":true}); on the page prior to tag function calls. Length: 100 per value.

Examples

Example - Retail and Content

Here is an example of creating a Page View tag with a Page ID of "FAQ Page 1", no on-site search term or results, and a Category ID of "FAQ".

<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">
	cmCreatePageviewTag("FAQ Page 1", "FAQ");
</script>
</body>

The next example creates a Page View tag for a search results page where the search term "jeans" was used and 100 results were returned, where <N> is the specific results page browsed in a multi-page results set. The search results value should include total results across all pages.

<script type="text/javascript">
	cmCreatePageviewTag("Search Successful: Page <N>", "SEARCH", "jeans", "100");
</script>
</body>

The next example creates a Page View tag for a search results page where the search term "xyz" was used and "0" results were returned: the search term returned no results.

<script type="text/javascript">
	cmCreatePageviewTag("Search Unsuccessful", "SEARCH", "xyz", "0");
</script>
</body>

Example - Travel

cmCreatePageviewTag("Hotels", "US:TX:Austin");

Example - Travel Search Results

cmCreatePageviewTag("Search Successful>Hotels: Page 1", "HOTEL-SEARCH", 
"location:austin", "14");

Example - Financial Services

cmCreatePageviewTag("APPLICATION STEP 1(START):Home Equity Loan", "Consumer 
Loan");

Example - Financial Services Search Results

cmCreatePageviewTag("Search Successful: Page 1", "SEARCH", "home equity", "100");

Data tag reference

Tagging function

Examples

Comments

Data tag reference

Tagging function

Examples

Related articles