Versions Compared

Old Version 5

changes.mady.by.user Paul Berkowitz

Saved on

compared with

New Version Current

changes.mady.by.user Paul Berkowitz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

Questions or ConcernsSolutions

How do I add values to a chart report?

Once a chart has been added to a report, you can edit chart preferences by clicking the settings gear in the top right corner of the chart and selecting Edit.
In the Appearance tab, select Values to display the chart with values. For more information see Widgets.

Note - when filtering the report by a customized date range, select Show X axis margins to display chart values for both ends of the x-axis as well.

How do I share a report?

Once you have created your CardioLog Analytics dashboard, you can share it with other employees and partners in your organization.
To share a dashboard, click on the dashboards menu, and select one of the following sharing options:
You can also display CardioLog Analytics reports within your own SharePoint site using the "Site Actions" menu, and make recommendations to your users in real time based on relevant data, like the most popular pages.

How do I display targeted content on a SharePoint list using the Behavior Targeting module?

In this article, we will describe how you can automatically exclude items from a SharePoint list using the Behavioral Targeting module.

As an example, we will assume that you have a "News Items" list, and you want to display items based on the location of your visitors.

Step one: Create a new "Target Market" column

The first thing you should do is add a new column that will hold the target market the item is relevant to (in the example below we called it "Target Market" and the value is the name of the country we want this item to be targeted to)

 

Anchor
execute immediately
execute immediately
How do I execute CardioLog service components immediately?

  1. In the navigation pane, browse to CardioLog Analytics > Administration > CardioLog Schedule Services > Click on the desired service component > Select "Once" as the service schedule type > Click OK to restart the CardioLog Scheduling Service immediately. For more details see How to Edit a Service Component.
  2. In versions lower than 2.0.8.0, restart the CardioLog Scheduling Service windows service manually from Windows Services.
  3. After the service component execution is completed (For more information about following the execution process, see Troubleshooting), set the service schedule type back to the desired schedule type, and Restart the CardioLog Scheduling Service.

How can I view surveys results in a SharePoint webpart?

In order to view survey results through a web part do the following:

  1. Create a Page Viewer webpart in SharePoint. The page URL will be the survey report page. For more information, see Microsoft SharePoint support.
  2. In order to retrieve the survey report page URL, using the navigation pane, go to CardioLog Analytics > Visitor Engagement > Surveys > Click on the desired survey "Reports" button > Right Click anywhere on the report page > Select "Properties" > Copy the URL address.

How do I monitor authenticated users in an anonymous environment after they sign in?

CardioLog can identify authenticated users in an anonymous environment by retrieving the user name from a unique element value that is hidden in the client side code.

How can I view my top inactive pages?

In the Page Views report, click the settings gear in the Page Views Table to edit the table preferences, In the Advanced, set the Minimum value to 0 in order to view the top inactive pages.

To view the top inactive sites/documents/lists/list items etc. use the Page Views by Type table.

Does CardioLog track document downloads within SharePoint libraries?

CardioLog monitors browser clicks on document links, and tracks document access from non-browser clients, including Windows Explorer and Microsoft Office applications. The tracking of non-browser clients is unavailable in the Lite edition.

What is the row limit for CardioLog Lite reports?

CardioLog Lite reports are limited to 100 rows, although our complete package has no display limitations.

Can I group reporting data by SharePoint user profiles and Audiences in addition to users or Active Directory groups?

Yes, report filtering and dimensioning by SharePoint user profiles and audiences - is provided out of the box.

Why do the CardioLog Lite charts display a Flash loading image, but the data fails to load.

Please make sure that you are running the latest version of Flash, and that it is enabled in your browser.

What kind of information is transmitted from the CardioLog server to the Intlock web servers?

The CardioLog server sends outgoing requests to the Intlock website to retrieve information about product updates. No user information is included in the requests, and the requests are optional.

Why is the Active Directory Updates status "Error reading log file" in the Diagnostics Dashboard?

Confirm that theActive Directory Updates service is configured correctly:

  1. In the navigation pane, go to Administration > System Configuration > User Categories Management
  2. Click the Active Directory category.
  3. Enter the Active Directory connection string, such as - mydomain.com (without the server name), and then Save.
  4. In the navigation pane, go to Administration > CardioLog Scheduling Service.
  5. Restart the CardioLog Scheduling service from the top right corner of the main window.

Does CardioLog track outbound navigation from my portal to non-SharePoint sites?

 Yes, CardioLog tracks all internal and outbound navigation. Every click on an external link is tracked and displayed in the External Destinations report.

How do I create more efficient CardioLog reports?

To ensure optimal operation and reduce the load time for reports, here are some tips for creating efficient reports in CardioLog:
  1. Number of reports per dashboard - Limit the number of reports in a dashboard to a maximum of Remove unnecessary reports from your dashboard.
  2. Report Filters - Make sure that the reports are limited to only the pages or items you would like to monitor and not ALL subpages, when relevant.
    • To filter out AD users and groups, define a black list rule and avoid using the NOT (!) condition.
  3. Report Scheduling Type - Verify that the report scheduling type (daily/weekly/monthly) is in correspondence to the report date range, for example:
    • When a report's date range is "Last Month", schedule it to run once a month.
    • When a report's date range is "Last 30 Days", schedule it to run once a day.
  4. Report Type - "By URL" Reports - Avoid using the "By URL" reports (ie. "Page Views by URL") unless fully necessary. When creating a report for a web page or site, find the page using the Object Explorer, and use the appropriate tree item as the source of your report.
    • Use the "By URL" reports only for: Web sites which do not exist in Object Explorer; Retrieving URL Parameters in the report; Tracking banner and button clicks; Tracking custom events
    • Set the Source URL as detailed as possible (avoid using only the default "http://" prefix)
    1. Chart Reports - Avoid using unnecessary data selection (specific/aggregated)
  5. Number of Scheduled Reports - Any scheduled reports which are no longer in use should be either deleted or edited to no longer run regularly.
  6. Real Time Reporting - Use the CardioLog Analysis Center for real time queries and investigating past periods, or create an Ad-Hoc report and generate reports manually when you need them.

What are the differences between Specific and Aggregated (Home Page vs. All Pages)?

CardioLog monitors many types of portal events such as - including views, updates, and searches for any object in the organization's hierarchical tree. Object Explorer contains the hierarchical list of the your SharePoint objects which that are monitored by CardioLog. Based on this hierarchical structure, CardioLog performs the various query aggregations (for instance, eg. the number of page views for a site page and all its sub-siteschild pages).

  • Specific (Home Page) - data is displayed for a single selected item in the Object Explorer (the selected item home page).
  • Aggregated (All Pages) - data is displayed for a selected item and all its children child items in the Object Explorer (the selected item and all its sub-items).

CardioLog generates reports about portal usage and displays them as Tables, Charts or Meters:

  • Meters
 display
  •  can display data in both "Specific" and "Aggregated" modes (
for instance
  • eg, the "Page Views" Meter displays the number of page views for
a site
  • the selected page and all
its sub sites
  • child pages by default
and
  • , but can be configured to display the number of page views for a
site home
  • single page in the Meter "Advanced" settings).
  • Charts
 display
  •  can display data in both "Specific" and "Aggregated" modes (
for instance
  • eg, the "Page Views" Chart displays the number of page views for
a site home
  • the selected page in the "Specific"
series
  • setting, and the number of page views for
a site home
  • the selected page and all
its sub sites
  • child pages in the "Aggregated"
series
  • setting).
  • Tables display data in "Aggregated" mode. Each table row displays data in "Specific" mode (
for instance
  • eg, the "Page Views" Table displays a list of items
for a site
  • included on the selected page and all its
sub sites
  • child pages and items. The number of page views for each item is specific to that item URL.

Are the report links unique and static?

Report links sent via email are unique and static, but the data in the report is automatically refreshed according to the relevant date range and preference settings. Anytime the report is accessed, either by clicking a static link or using the navigation pane, the most current data will be displayed.

What actions should I take first when troubleshooting errors in CardioLog?

First, answer the following questions: 

  1. Which CardioLog edition and version are you using? (You can find this information from the navigation pane in CardioLog by clicking Administration and then selecting Product License)
  2. Are you encountering a data collection issue (tracking agent), a reporting issue (CardioLog UI and reports), or a CardioLog Windows Service issue?

Next, here are some first aid actions -

Data Collection Issues

  1. Browse within your SharePoint portal and press Ctrl+F12. Verify that you see the CardioLog tracking agent pop-up with a valid ID number.
  2. If the ID shows "None" - press Ctrl+F10 and send us the prompt content.
  3. If you cannot see the CardioLog tracking agent pop-up, verify that the CardioLog tracking code is installed correctly (See Troubleshooting the Tracking Agents for more information)
  4. A new agent console replaced the Ctrl+F12 popup from version 2.0.5.0 and up. The console will be visible only to users with a link to it. Follow the instructions in http://server:port/CardioLog/Configuration/AgentConsoleBookmarklet.aspx (edit the CardioLog server name and port) to add the agent console link to your browser.
    a) Click the "Agent Console" bookmark and wait for several seconds. Verify you see the tracking agent console.
    b) Click the "Only events" tab. The last line should say: "events: event sent. status: 0"

Reporting Issues

To troubleshoot empty usage reports, see Troubleshooting Empty Reports

CardioLog Windows Service Issue

  1. Verify that CardioLog Windows Services have been started.
  2. Send us the log files (*.log) from - [CardioLog Installation Folder]\CardioLogScheduleServices\Logs
  3. To troubleshoot service errors, see Troubleshooting the CardioLog Services

What is the difference between Page Views by URL and Page Views?

The Page Views by URL report is used for reporting data on URLs which do not exist in the portal tree. These are usually custom URLs that are defined as part of a campaign setup, or part of other extended tracking options like monitoring banners, button clicks or Flash movies.

What is the difference between client-side (JavaScript page tagging) and server-side (log file analysis) Analytics?

The two main methods used for tracking websites and monitoring site usage are JavaScript page tagging, which is client-side, or log file analysis, which is server-side.

Server-side web analytics is based on server logs. All HTTP requests and responses come into the server, and they are logged line by line into a file. Log file analysis tools parse the log files and then calculate the usage statistics of a website based on available data.

Client-side tools, however, do not use server logs for data collection. Instead, they use JavaScript page tagging and only record data when the page has successfully been loaded on a visitor's browser. JavaScript page tagging involves adding a short JavaScript code to each individual page of a website that you would like to collect data from.

CardioLog uses the JavaScript page tagging method. For SharePoint portals and websites, the CardioLog JavaScript tracking code is automatically added to all pages by activating the CardioLog Agent SharePoint Feature. This makes it simple to include or remove the CardioLog tracking agent without editing each page individually.

There are advantages and disadvantages to both types of tracking systems. Due to the two different data collection technologies, the reported data tend to vary slightly between them.

Some scenarios that are only tracked with server-side tools:

  1. Server-side tools can track information on automated search engine robot requests and other non-human visits, whereas JavaScript page tagging can't detect non-human visitors at all.
  2. Server-side tools can track information on failed page requests (Including HTTP status codes 401, 403, 404, 500, 301, and 302), whereas JavaScript page tagging only records a page if it was successfully viewed.
  3. Server-side tools can track information on any device or browser that does not support JavaScript (some mobile devices, browsers with JavaScript switched off).

Some scenarios that are only tracked with JavaScript page tagging and CardioLog:

  1. CardioLog can collect client information on browser identity, page element properties, operating systems, IP address, and even interactions with Flash movies and other plug-ins. It can also detect user interaction like mouse movement or button clicks. You can easily edit the JavaScript tag, in order to have the CardioLog server collect more information. For example, data from partial form completion, or the price of the goods that have been purchased can be recorded this way. With server-side log file analysis tools, information not normally collected by the web server can only be recorded by modifying the URL and loading a new page.
  2. CardioLog tracks every individual event that a visitor performs on a website, including file downloads, clicks, form submissions, and their navigation path through your website. This information can be used to help you to modify and improve visitor interactions based on where your visitors are engaged more with your site, or abandon their activities.
  3. CardioLog tracks all data once a page is opened, not when it is requested from the server. If a page is cached, it will not be counted by the server. Cached pages can account for up to one-third of all page views. Not counting cached pages seriously affects many metrics, which is why client-side analytics is highly preferable for tracking human activity on websites.

Log files are not 100% accurate. ISP page caching and proxies can twist data and consequently lead to inaccuracies.

JavaScript page tagging is not 100% accurate either, though it is more accurate than log files. A certain percentage of people disable JavaScript in their browsers. DNS failures and other network issues can result in data not being captured where a log file would work well.

Intlock encourages each customer to perform his/her own load tests.

Why do "401 Unauthorized" messages appear twice before the CardioLog tracking code is downloaded to the client browser?

If a client needs to authenticate itself with a proxy or server using the NTLM scheme (Used by the CardioLog Tracking Agent and SharePoint), the following 4-way handshake takes place:
1: Client   --> Server   GET...
2: Client <--  Server    401 Unauthorized
                         WWW-Authenticate: NTLM
3: Client   --> Server   GET...
                         Authorization: NTLM <base64-encoded type-1-message> 
                          (This message contains the host name and the NT domain name of the client.)
4: Client  <--  Server   401 Unauthorized
                         WWW-Authenticate: NTLM <base64-encoded type-2-message>
                         (This message contains the server's NTLM challenge.)
5: Client   --> Server   GET...
                         Authorization: NTLM <base64-encoded type-3-message>
                         (This message contains the username, host name, NT domain name, and the two 
                         "responses".)
6: Client  <--  Server   200 OK

How do I monitor anonymous users with CardioLog?

CardioLog can identify anonymous users by their workstation IP address, or by creating a unique id and storing it in a browser cookie. An anonymous user is a visitor who is not logged in using a known username from any connected accounts or the Active Directory. There are advantages and disadvantages to both methods

Using IP address

Pros - Allows for individual IPs in reports, works when browser cookies are disabled.
Cons - If a visitor is using a proxy or VPN in order to access the internal network, the CardioLog tracking agent will not be able to identify the user's workstation IP. Instead CardioLog will register the proxy IP. When this occurs, the unique users metric may be inaccurate. 
Note - CardioLog collects IP addresses for all users in order to track geographic location.

Using Unique ID

Pros - The most accurate method for identifying unique anonymous users, even if users are accessing your site using a proxy or VPN.
Cons -  Several situations will trigger the same user to receive a new unique ID. This includes deleting cookies, disabling cookies, and using multiple web browsers.
Note - By default, the user name will be a unique id in the following format - "Anonymous_XXXX" 

Why does selecting a report in the Report Center cause Internet Explorer 9 to stop responding and restart?

  1. Verify that you have the latest version of CardioLog installed (2.0.3.0 and up), which supports IE 9.
  2. Reset your IE 9 browser settings by selecting Tools > Internet Options > Advanced > Click "Reset".
  3. The latest version of CardioLog is fully supported across multiple browsers. Consider using another browser such as Google Chrome or Mozilla Firefox if problems persist in Internet Explorer.

Mezer_08-30_11-25-08.jpgImage Added

CardioLog displays cached data in reports. What time period should I expect to see when selecting each one of the date range options?

The period expected when selecting each one of the date range options is as follows:
  • This Hour - shows cached data until the last rounded minute.
  • This Day - shows cached data until the last rounded hour.
  • This Week - shows cached data until last rounded hour.
  • This Month - shows cached data until last rounded day.
  • This Quarter - shows cached data until last rounded day.
  • This Year - shows cached data until last rounded day.

You can delete the report data cache by using the navigation pane to access Administration > System Configuration > Reporting Data. Click Clear Cache and the click Save.

What is the difference between Exit Rate and Bounce Rate?

Exit Rate is the percentage of times a specific page was the last page visited by a user before closing your site.

An Exit Page is the last page on a site accessed during a visit, signifying the end of a visit. The visitor may have visited other pages on your site, but has ended their session on that specific page.

Exit Rate is important for determining when your visitors choose to stop engaging with your website. 

Note - A visit is defined as one visitor, viewing at least one page, within a single browser session

Bounce Rate is the percentage of single-page visits.

Bounce Rate is important for determining how your landing pages perform, compared to visitor expectations, which often directly affects revenue and ROI.

There are a number of reasons why you might have a high bounce rate.  For example, visitors might leave your site from the entrance page in response to site design or usability issues. Alternatively, certain pages on your site might have a high bounce rate for more concrete reasons, such as single-page sites or pages accessed through a user's bookmarks.