How to create a custom viewed page metric

You will learn

Learn how to create a custom Viewed Page metric and understand when your customers visit non-product pages on your site. 

Before you begin

Before continuing with this article, make sure you've integrated your ecommerce platform (such as Shopify) with Klaviyo.

It's important to add the following JavaScript code snippet to each page of your site that you want to track a Viewed Page metric for. This snippet will work for both landing pages and any other site pages.

Installing the snippet

1. Copy and paste the complete snippet below into your page files.
2. Then save and publish your website files with the updated code.

<script type="text/javascript"> 
//Script to initialize Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>
<script type="text/javascript"> 
//Script to track viewed page
klaviyo.track("Viewed Page", {           
   PageName: "About Us"   
}); 
</script>

Once the snippet has been added to your site, it will record a custom Viewed Page metric in which the property name PageName equals the value "About Us".

Changing the PageName value

You can change the default value above to represent another page name on your site.

1. Remove the default "About Us?? value.
2. Add your desired text contained within the quotation marks. For example, if you want to track visits to your brand stories page, you could instead use "Customer Stories" as the value.

Changing the Viewed Page value

You can change the Viewed Page value to represent another value (e.g., Visited Page, Tracked Page, etc.).

1. Remove the default Viewed Page value.
2. Add your desired text contained within the quotation marks.

Track Viewed Page by URL

If you would like to track Viewed Page by URL instead of by page title, you can use the alternate snippet below. Note that page you wish to track should include the quotations and be the URL of the page you want to track.

<script type="text/javascript"> 
//Script to initialize Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>
<script type="text/javascript"> 
//Script to track viewed page
klaviyo.track("Viewed Page", {           
      url: window.location.href   
}); 
</script>

Test your viewed page tracking

To test if your Viewed Page tracking is working, make sure that your page has been published and that you’ve amended "?utm_email=youremail@example.com" to your page’s URL to cookie yourself and track your activity.

1. After visiting your page, go into your Klaviyo account.
2. Navigate to Analytics > Metrics.
3. Search for Viewed Page (or, whatever alternative name you use for this metric) in the field above.

4. Click into your Viewed Page metric (or whatever metric you are using).
5. Select the Activity feed tab. You can then review that your metric is tracking, as shown in the example below.

If you can view your activity, that means the metric is tracking successfully. If you don’t see your activity, try reloading the page in Klaviyo.

Additional resources

• Understanding cookies in Klaviyo
• Getting started with Klaviyo onsite tracking
• Setting Up API-based Website Activity Events