Help: Usage Report

The Usage Report shows how votes were received over time. Each time a vote is submitted, your database is updated to reflect that vote along with its date and the associated poll. Use the Usage Report to determine usage patterns. Some examples include:
  1. Times of the day and week which get responses
  2. See how individual polls perform
  3. See how categories perform
With this knowledge, you can fine tune the polls you offer to entice response and returns to your site.

The Usage Report is available for individual polls from the Poll Results page and for groups of polls from the Poll Administration page. It generates a bar graph showing the total votes submitted for each period of time. You select the period size, which can be from every half hour to one week. You also can limit the records into a particular date range. The resulting graph shows a bar for each period which has data. If a period had no data, it will be omitted and the next bar will show its label in a special color to highlight the gap.

Setting Up The Report

Use the fields at the top of the page to establish any selection criteria, such as categories and dates, and formatting such as bar colors and period size. Then click Draw The Graph.

Select By Categories

The Categories fields are not offered when you run a Usage Report from the Poll Results page.

Initially, the Usage Report will include all polls. Use the Categories fields to narrow the data to polls associated with one or more categories. You can enter up to four categories and select whether each poll must match any or all with the radio buttons to the left.

Since you can define complex categories like "Entertainment\Music\RollingStones", the drop down lists next to each text box let you determine where your text is found in those categories.
  1. Exact - the text must match the full category.
  2. Contains - the text can be any part of the category.
  3. Starts with - the text must begin a category.
  4. Ends with - the text must be at the end of the category.
Matching is always case insensitive.
Category Commands
The fields of this row make it easier to work with categories. After all, who wants to set up the category fields each time?

This system retains your category fields using cookies in your browser. So if you have disabled cookies, these commands will not work. There are 10 slots which can retain your settings. They are named "Categories 1" through "Categories 10" and shown in the Quick Lookup drop down list. You may want to associate them with individual Poll controls so you can report on how each Poll control did. Here's how to save and retrieve category settings:

To save, choose the slot where you want to save from the drop down list then click Save.
To retrieve, choose the slot containing the saved settings from the drop down list and click Get.

Use the Clear Categories button to set the category fields to their defaults.

While this page doesn't let you change the names of the slots, here is a trick to do so. Edit the file Poll_WebAdmin\CategoryQuickLookup.xml. It houses the names of the slots and is designed so you can edit it, so long as you maintain the XML structure it uses.
NOTE: The Quick Lookup's data is shared with other features in this program.

Date Range

Limit the report to votes within this date range. If the start date text box is blank, all records from the beginning are retrieved. If the end date text box is blank, all records through the current date are retrieved.

Period Size

Use the Period Size drop down list to determine the size of a period represented by each bar. Choose from sizes of half hour to one week.

Odd Bar Color and Even Bar Color

Use these drop down lists to choose the colors of bars. The Odd Bar Color is applied to the first, third, fifth, and so on bars while the Even Bar Color is applied to the rest.

Bar Height

Use the Bar Height drop down list to reduce or enlargen the bar height and associated font size.

Color following a gap in the data

When a period has no data, the next bar shown will show its label in this color to point out the gap.