Last modified on December 4, 2017
Note: To use this guide, you need to know how to use AlertSite DéjàClick transaction recording tool. If you do not have the DéjàClick toolbar in your Firefox browser, go to the DéjàClick Downloads page to download the DéjàClick add-on and additional modules (TrueScreen and ImageMagick). If you have never used DéjàClick before, please go to the DéjàClick Quick Start Guide. After you have become comfortable with recording DéjàClick transactions, you will be able to move on to this more advanced feature.

Overview

Today's websites have content from a variety of sources, not only from your own company, but 3rd party content as well. DéjàClick™ ContentViews categorizes this content, providing segregated reporting capabilities and the ability to intelligently notify the responsible owner of the content when it is down or in error. This enhances your ability to troubleshoot performance issues within your site without having to deal with poorly performing components from external sources.

ContentViews automatically captures all site content found in your transactions, allowing you to:

  • Easily monitor the components independent of each other.

  • Select and prioritize whether or not to receive notifications based on ContentView errors.

  • Produce ContentViews-specific reports with graphs and charts.

Features

  • Easy set-up through the DéjàClick Properties Sidebar or the Validation selector on the DéjàClick toolbar.

  • Visibility in the AlertSite console.

  • Alert notification control.

  • Configurable ad-hoc (one-time) reports.

Each feature and procedure is explained in detail below.

Configuration

Before you get started, you must first decide how you want to partition the content contained in your transaction. For example, you may want to have only URLs with your web site's domain in one ContentView. In another, you might want certain Content Delivery Network (CDN) URLs. The third might contain other 3rd party URLs. It is completely up to you to determine how you want to categorize the content within your transaction.

Once you have decided how to classify your content, you are ready to add and configure different ContentViews.

There are two ways to configure ContentViews:

  1. From the Properties sidebar.

  2. By using the Validation menu.

In Plan-Based accounts, ContentViews can be included as an additional feature for most DéjàClick plans. Once added to an existing plan, ContentViews can be configured as described in this guide. In Usage-Based accounts, ContentViews consume measurement credits at a rate of 1/4 usage credit per action in your AlertSite account. However, if no matching content is reported by the ContentView, no usage credits are charged to your account.

Let's take an example in which we partition one domain into one ContentView, another domain into another ContentView, and create the third ContentView for all pages not contained in either of the other two ContentViews.

AlertSite Dashboard

If a transaction has ContentViews, the AlertSite Dashboard will display the icon next to the monitor name.

CV icon on the Dashboard
Note: If you have configured everything correctly and do not see the icon, make sure the Show ContentViews in device grid: is set to Yes in the monitor Tab Preferences settings.

The icon is displayed even if ContentViews is disabled on the Manage Transaction screen.

Add ContentViews from the Properties Sidebar

For this example, we recorded 3 actions on amazon.com using DéjàClick and played it back on the desktop. After replay, we are ready to add ContentViews.

Click the Properties tab in the DéjàClick sidebar. Locate ContentViews in the list and expand it.

Content_Views_PP.png

In our example, we will set up 3 ContentViews, one for the amazon.com domain, one for the ad.doubleclick.net domain, and one for all other pages that do not contain amazon.com or ad.doubleclick.net. To accomplish this, we will:

  1. Create a ContentView with the URL amazon.com, which we will call Amazon Only.

  2. Create a ContentView with the URL ad.doubleclick.net, which we will call Doubleclick Only.

  3. Create another ContentView that excludes any members of the other two ContentViews, that is, containing neither amazon.com nor ad.doubleclick.net, but some other 3rd party content; we will call it Neither Amazon nor Doubleclick.

Amazon Only

Here is how to create the first ContentView, Amazon Only:

  • Click the Add button in the ContentViews properties panel to display the Add ContentView dialog.

    Add Content View dialog
  • Enter Amazon Only in the Name field.

  • Click green plus sign. This displays the Add ContentView Component dialog; the left side window defaults to an expanded Domains list:

    Add ContentView Component
  • Expand the URLs list.

    URLs list
  • Select one or more Domains, one or more URLs, or one or more ContentViews from the Available list on the left, then click on the arrow button to move your selection to the Included list on the right. There are no minimums or maximums to the number of selections you can add to your ContentView.

    You can also click the New button to display the Add Component dialog and enter a specific URL:

    Add Component

    For this example, move amazon.com from the Domains list to the Included list by clicking the arrow button.

  • Click OK. The Add ContentView Component dialog now displays amazon.com.

  • Click OK in the Add ContentView Component dialog.

    The Amazon Only ContentView name is now in the ContentViews section of the Properties sidebar.

    Amazon Only

Doubleclick Only

To create the second ContentView, Doubleclick Only, repeat the above steps, enter Doubleclick Only in the Name field, and select ad.doubleclick.net from the Domains list in the Add ContentView Component dialog.

Note: Pay attention to the Match Type options in the Add Component dialog. If you select Plain Text, the filter will find a match anywhere within the domain portion of the URL. If you select Regular Expression, the filter will find a match anywhere in the whole UR, including any field pairs in the query string.

Neither Amazon nor Doubleclick

Next, create the ContentView Neither Amazon nor Doubleclick that contains all Domains in the transaction other than amazon.com and ad.doubleclick.net:

  • Similarly to the first and second ContentViews, add the third one and enter Neither Amazon nor Doubleclickin the Name field.

  • Click .

  • In the Add ContentView Component dialog, click New.

  • In the Add Component dialog, set the following options:

    • Select ContentView from the Type drop-down list.

    • Select Amazon Only from the Parameters drop-down list.

    • Select the Exclude from ContentView.

    • Click OK.

      Add Component dialog
  • Repeat the above steps to add Doubleclick Only to Neither Amazon nor Doubleclick. Here what the Add ContentView Component dialog looks like:

    Adding ContentView members

    Click the image to enlarge it.

  • Click OK in the Add ContentView Component dialog.

  • Click OK in the Add ContentView dialog.

Now the ContentViews property sidebar shows the three ContentViews:

Populated ContentViews

Exclusionary ContentView

If you need a ContentView for specific third-party objects, you can create a regular expression to exclude any objects whose URLs contains a specific string. For a set of strings, you can create a regular expression by using logical notation.

For example, you want a ContentView for objects that do not contain the string amazon anywhere in the URL. In the Add Component dialog:

  • Enter amazon in the URL field.

  • Select the Regular Expression match type.

  • Select the Exclude from ContentView check box.

  • Click OK.

In case you need a ContentView for objects without amazon, doubleclick, or mdn in their URLs, in the Add Component dialog:

  • Enter amazon|doubleclick|mdn in the URL field (where | is the logical or or a vertical bar).

  • Select the Regular Expression match type.

  • Select the Exclude from ContentView check box.

  • Click OK.

Add Component: regular expression
Exclude 3rd party objects
ContentViews: 3rd Party Only
To assure exclusion of all objects with any of the strings in a ContentView, the strings must be separated by |, but not just listed or excluded separately.

Add ContentViews by Using the Validation Selector

You can add ContentViews while recording or while replaying the recorded script at the Action or Event levels.

Note: If you want to have your ContentViews for the entire transaction, create them by using the Properties sidebar. See the steps in the section.

While recording a new transaction:

  • Click Record and navigate to your starting page.

  • At any time during a recording, when DéjàClick pauses for the next step, appears on the toolbar. Click the drop-down arrow next to the icon and select Add ContentViews.

  • Follow the steps to add your ContentView as described above.

While replaying a recorded transaction:

  • Click the drop-down arrow next to Replay and select Replay Next Action or Replay Next Event.

  • Click Replay to step through the transaction.

  • When the replay pauses, appears on the toolbar. Click the drop-down arrow next to the icon and select Add ContentViews.

  • Follow the steps to add your ContentView as described above.

Advanced ContentView Configuration

Along with partitioning on URLs, ContentViews, and predefined lists, the Add ContentView dialog has 3 optional attributes you can use in addition to the URLs or Domains to separate URLs by:

Advanced ContentView options

Content Types

Content Length

Scope

You can also configure the ContentView to continue to the next action or event in case of an error. To do this, select the check box under Replay Options. Enable this option, if the ContentView does not contain the critical path of the transaction.

Replay Options

After you have recorded and verified a transaction and configured ContentViews, upload the script to AlertSite. You will be redirected to the Manage Transaction screen, where you can make more configuration changes, such as monitoring type, timeouts, locations, and so on. You can also configure there Fullpage Options, Capture Options, ContentViews, and Transaction Description.

Notification Control

You can configure ContentViews notifications in the ContentView Settings section of the Manage Transaction screen:

ContentView Settings

Click the image to enlarge it.

Note: The ContentView Settings section will not be displayed if the transaction does not have any ContentViews.

There are two settings:

  • Notify – If selected, sends alert notifications in case of an error in the listed ContentViews. Clear the check box if you do not want alerts to be sent on error in ContentViews.
  • Inherit Global Errors – If selected, report global errors not associated with a ContentView URL. Clear the check box if you do not want global errors in the main transaction to be reported in the ContentView.

By default, some global errors that occur in the transaction may affect individual ContentViews, but they are not passed through to the ContentView, so notifications will be issued for the error in the main transaction but not in the ContentView.

If you want ContentViews to inherit these errors from the main transaction, for example, if a fullpage timeout occurred on one step, you may want pass that error through to the ContentView set up for your domain. In that instance, select the Inherit Global Errors check box for that ContentView.

The following AlertSite Status Codes apply to Inherit Global Errors:

Code Description
80 Browser event timeout encountered.
81 Maximum transaction time was exceeded.
90 Unexpected processing exception occurred.
92 Maximum number of skipped events exceeded.
93 Missing instruction for dialog prompt.
96 Unable to parse transaction XML.
97 Target page element was not found.
7202 Fullpage Timeout.

To receive notifications for the base transaction, make sure the Notify on Error option of the Device Settings section is set to Yes, because the script may fail while the ContentViews may still be successful.

Set Up Recipients

You can configure recipients for ContentViews. For the most control over notifications, we recommend that you create a recipient group for all ContentViews otherwise all recipients in AlertSite will be alerted on ContentView errors. This takes advantage of the main reasons for utilizing ContentViews. By using Notifier Groups, you select who is to be notified based on content of interest.

To create a recipient group:

  • From the top menu, select Notifiers > Notifier Groups.

  • Click Add a New Group at the upper right.

  • In the Notifier Group Name field, enter a group name. For example, Amazon Only CV Group.

  • Locate the transaction in the Available Sites list, find the Amazon Only ContentView and click to move it to Included Sites.

  • Select recipients from the Available Notifiers list and click to move them to Included Notifiers. In our example, we selected Administrator, Operations, and Management.

    Amazon Only CV Group

    Click the image to enlarge it.

  • Click Submit at the upper right to save the changes.

  • Similarly, add Two more groups:

    • The Doubleclick Ads Only CV Group group for the Doubleclick Only ContentView. In our example, we assigned Marketing to this recipient group.

    • The Neither Amazon nor Doubleclick Content Group group for the Neither Amazon nor Doubleclick ContentView. In our example, we assigned Management and Operations to this recipient group.

Now, when the pages with the amazon.com domain produce errors, only the Administrator, Operations, and Management recipients will be notified. If pages with ad.doubleclick.net in the domain name are in error, only the Marketing recipient will be alerted. And when pages with any domains other than amazon.com or ad.doubleclick.net are in error, only Administrator and Operations will receive alerts.

Reporting

After uploading the transaction to your account, it will take some time for the transaction to propagate out to your selected monitoring locations and begin gathering performance measurements. Allow 10-15 minutes past your monitoring interval before attempting to run a report.

You can produce graphs and charts based on the selected ContentViews.

  • Performance Graphs (Availability, Response Time, etc.)

  • Scatter Plots

  • Report API for data extraction

When a transaction has been configured with ContentViews, the AlertSitePerformance Reports screen will display the ContentViews below the main transaction in the Site/Device list:

Performance Report: ContentViews

To illustrate the properties of ContentViews-partitioned reports, we have created a couple of reports for the Amazon Only and Doubleclick Only ContentViews.

A line of measurements has been expanded in each one. By expanding the sections and drilling down to the object level, you can see that the list of objects in Amazon Only contains only objects with amazon.com in the URL:

Amazon Only report

Click the image to enlarge it.

The objects in Doubleclick Only contain only objects with the domain ad.doubleclick.net:

Doubleclick Only report

Click the image to enlarge it.

The objects in Neither Amazon nor Doubleclick contain only objects that do not include the domains amazon.com or ad.doubleclick.net:

Neither Amazon nor Doubleclick report

Click the image to enlarge it.

In this way, reports with relevance for particular groups or individuals can be created and scheduled, then distributed as needed.