Open topic with navigation

Ektron 8.6.1

Analyzing Content

Ektron has 2 types of analytics.

ClosedBusiness analytics

Business Analytics

The Business Analytics feature lets you track statistics about visits to your website. You can use it to determine the following kinds of information:

  • how often your content was viewed
  • how many site visitors viewed for first time, and how many returned
  • the most popular referral pages (that is, the Web page from which visitors clicked to arrive on your site)

Several options for selecting a date range let you compare activity across different weeks, months, and years.

By default, the Business Analytics feature is disabled in the web.config file. To enable it, set the value of the ek_enableClassicAnalytics property to true. If you set this property to true and later change it to false, statistical data remains within Ektron, but no additional data is collected.

<add key="ek_enableClassicAnalytics" value="true" />
Closed Specifying the frequency of writing to the database

Specifying the Frequency of Writing to the Database

After you set up the Business Analytics feature, your database is subject to a continuous barrage of write activity, generated by visits to your site. To optimize your database’s performance, you can hold visit activity in application server memory until a predetermined amount of data is collected. When collected, it is moved in one packet to the database. So, the database is “hit” much less frequently.

Specify the amount of data saved in memory prior to being written to the database using these web.config file elements.

  • recordsBeforeWrite—the number of unique template visits
  • timeBeforeWrite—the number of seconds since the last time a database write occurred

When either element reaches the value set in web.config, all records stored in memory are written to the database. That event resets both elements to zero (0).

Closed Captured statistics

Captured Statistics

For every template view, the following statistical information is captured.

  • url—the visited page
  • content_id—the ID of the visited content. Captured by the Analytics server control. Tracking Clicks by File Type
  • visitor_id—a unique GUID that identifies a visitor
  • hit_date—date and time when a page view occurred
  • referring_url—the URL a user was viewing before jumping to the visited page
  • visit_type—zero (0) indicates new visitor, 1 indicates returning visitor, 2 indicates all other views. After a user logs on, the first page hit tracks the visit as zero (0) (if the user is new) or 1 (if the user previously visited the page). From then on, 2 is logged for that user.

In addition to writing Business Analytics data to the database, you can write it to the IIS log. To do this, enable the appendToIISLog element in the web.config file. Note that if you set appendToIISLog to true, some Business Analytics data is only written to the IIS log and does not appear in the Workarea.

Closed Tracking new and returning site visitors

Tracking New and Returning Site Visitors

The Business Analytics feature provides information about visits made by new versus returning visitors. To capture this data, the feature asks this question whenever a page is visited: is the user logged in as either a membership or regular user?

  • If yes, capture the user ID with the statistical data
  • If no, place a cookie on the visitor’s computer

The next time the user visits that page, the feature checks the visit history for the user ID, or for a cookie. If either is found, the visit is considered a return.

The same user visit may be considered new on one view but not on another. For example, someone visits on January 30 (Monday) then again February 2 (Thursday). On the monthly statistics, that visitor is new, but on the weekly statistics, the February 2 hit would be a return visit (his second this week).

Now consider a second visitor, who browses to your site on the first and 20th of the month. These visits appear on weekly statistics as 2 new visits, but on the monthly statistics, only the first visit would show up on that month's tally of new visitors. The second visit would add to the return visitor statistics.

Closed Reporting business analytics

Reporting Business Analytics

The Business Analytics feature's reports let you drill down from the entire site to individual templates to individual content items.

Prerequisite

In your site's web.config file, the ek_enableClassicAnalytics setting is set to true.

NOTE: The Most Popular and Trends widgets also report on Business Analytics data. See Most Popular Widget and Trends Widget.

To access Business Analytics Reports:

Either

  1. Browse to a content item for which Business Analytics data is being captured.
  2. Right click the mouse.
  3. Choose View Template Activity to see Business Analytics data for the current content item (to learn more about data captured for one content item, see Content View).
  4. ChooseView Site Analytics to view Business Analytics data for the entire site.

or

Closed Analyzing site statistics

Analyzing Site Statistics

The following table shows analytic statistics available for each level of the site.

Closed

Type of Statistical Information

Site-wide

Template-
Level

Content-
Level

Views of Any Template

Visitors: New and Return

Pie Chart of New vs. Return Visitor

Pie Chart of Views/Visitors Ratio

Bar Graph of Views/Visitors Ratio

Visited Pages

 

 

Visited Content Blocks

 

URLs from which Site Visitors Accessed Ektron

 

 
Closed Site statistics view

Site Statistics View

The Site Statistics view offers an overview of tracked activity within the selected date range. You see actual data for the

Below this are pie charts of the ratio of views to visitors and new vs. return visitors.

Closed Content view

Content View

The Content View shows the most frequently-accessed content on your website.

Click any content item to view:

  • Content Statistics—statistics for that content item only (See Also: Analyzing Site Statistics)
  • Content Activity—relative activity for that content item only (See Also: Content View)
  • Audit Content—all users who viewed the selected content; to the right of each user are the date and time when content was viewed

NOTE: Only users who viewed content after logging in appear on the list. Site visitors who do not log in affect statistics but are not tracked on this report.

Closed Templates view

Templates

The Templates View shows all viewed templates on your website, with the most frequently-accessed ones on top.

By default, the templates at the top have the highest number of unique visitors. You can change the sort by clicking any column header. For example, to sort templates by the number of views, click Views.

You can click any template to view

  • Template Statistics—statistics for that template only
  • Template Activity—relative activity for that template only
  • Content in Template—if a content item was specified for the template in the Content Analytic server control, this view show statistics for the template. You can click the template to view Template Level activity.
Closed Referrers view

Referrers View

The Referrers View shows domains from which your site was most frequently accessed.

Closed Changing the date range of the statistical data

Changing the Date Range of the Statistical Data

When you first view statistical data, the default date range is today (one day).

If you view statistics for different date ranges, when you return to the screen, the last selected date range is the default selection. You can change it if needed.

Using Quick View Options

Use Quick View options to view analytics for any of these time periods.

  • one day
  • one week
  • one month
  • one year

When you click Quick View [week], [month] or [year], the current end date is used as the last day of the range. Here are some examples.

  • Week—If end date is today, begin date is one week earlier than today
  • Month—If end date is today, begin date is one month earlier than today
  • Year—If end date is today, begin date is one year earlier than today

Using Jump To Options

Use Jump To options to view statistics for a time period before and after the current date range. The time period is determined by the Quick View increment. For example, if the Quick View option is Day, you can jump to the previous day, the following day, or today.

Regardless of the Quick View increment, you can always view statistics for today.

Closed Most Popular widget

Most Popular Widget

The Most Popular widget reports on these categories of content on your website. By default, every Most Popular widget tab shows up to 5 results.

  • Most Viewed
  • Most Emailed
  • Most Commented
  • Highest Rated

You can place the Most Popular widget onto any PageBuilder page. See Also: Creating Web Pages with PageBuilder

NOTE: You cannot place more than one Most Popular widget on a PageBuilder page. Also, you can hide up to 3 tabs if you do not want all of them seen.

The Most Popular widget references content events, which are Ektron events that are tracked when used with various server controls. Here are 2 examples of a content event:

  • for the Most Viewed tab, the content was viewed and tracked by the Analytics Tracker server control. See Also: Analytics Tracker
  • for the Most Emailed tab, the content was emailed from the Social Bar server control

The Most Popular widget displays content items that meet these criteria.

Each time a content item is used with one of the following server controls, its count for that day is incremented by 1.

  • Analytics Tracker—Most Viewed tab—A site visitor browses to a page that is tracked by the Analytics Tracker server control. The control lets you determine which content is counted when the page is viewed.
  • SocialBar—Most Emailed tab—A community group member browses to a page that hosts the Social Bar server control, and emails a content item to a friend. (The SocialBar server control must be associated with content.)
  • MessageBoard—Most Commented tab—A Community Group member browses a page that hosts the Message Board server control and comments on a content item on that board. (The MessageBoard server control must be associated with content.)
  • ContentReview—Highest Rated tab—A site visitor browses to page that hosts the Content Review server control, and uses the control to rate a content item.

Next to each content item is a count. The count indicates the number of times a content event occurred for that content item within the specified time frame. See Also: Reporting Business Analytics

Note that the date range may affect the count. For example, if a content item was viewed once a day for the past 10 days but the date range is set to 7 days, the count is 7. To change this maximum:

  1. Open siteroot/widgets/mostpopular.ascx.cs.
  2. Find the following line private int _PageSize = 5;.
  3. Change the number at the end of the line to the maximum number of results to display.

    NOTE: This setting affects all tabs and instances of the Most Popular widget.

A logged in user can change the properties that determine what appears on the Most Viewed tab. To do so, click Edit ().

Closed Most Popular widget properties.
  • Tab text—The text that appears on this tab. In the above example, the left tab's text is the default Most Viewed.
  • Visible—Determines if the tab you are editing appears on the widget. At least one tab must appear. Checked is the default.
  • Number of days to report—The number of days for which to display the data. The default is 7.
    • The current day is not counted, since it is incomplete. So if you enter 1, you see information for all of yesterday and today.
    • The date calculation is based on the clock on the website's server.

      NOTE: You can change this to any number you wish. However, the widget can only show data for days for which data is stored in your database.

  • Report—Determines the information appears when a tab is clicked.
    • Tab 1—Most Viewed
    • Tab 2—Most Emailed
    • Tab 3—Most Commented
    • Tab 4—Highest Rated
  • Filter By—You can restrict the content appears on this widget by selecting a folder (default) or a taxonomya content-level categorization system that uses one-to-many relationships to create a scalable organization of content. A taxonomy lets you create a navigation system that is independent of the folder structure..

    While selecting a folder/taxonomy category, you have the option to include all folders/categories under the selected one. If you later want to remove this restriction, click Delete ().

Closed Trends widget

Trends Widget

By default, the Trends widget shows the Most Viewed content on your website. You can edit the widget's properties so that it displays any of the following categories of content instead.

  • Most Emailed
  • Most Commented
  • Highest Rated

The Trends widget is a subset of the Templates, so you should be familiar with that section before reading this. It explains topics such as how Ektron determines which content appears for each category. You can place the Trends widget onto any PageBuilder page. See Also: Developing Wireframe Templates

A logged in user can change properties that determine the appearance of the Trends widget. To do so, click Edit (). The Trends widget screen appears.

Closed

  • Report Type—Report types are:
    • Most Viewed (default)
    • Most Emailed
    • Most Commented
    • Highest Rated
  • Number of days to report—The number of days for which to display the data. The default is 7.
    • The current day is not counted, since it is incomplete. So if you enter 1, you see information for all of yesterday and today.
    • The date calculation is based on the clock on the website's server.

    NOTE: You can change to any number you wish. However, the widget only shows data for days for which data is stored in your database.

  • Order Direction—The direction in which search results are sorted. The default is Descending.
    • Ascending—Alphabetical results from A to Z; numeric values low to high; dates from oldest to most recent
    • Descending—Alphabetical results from Z to A; numeric values high to low; dates from most recent to oldest
  • Maximum Number of Items—Enter the maximum number of content items that may appear on the Trends widget. The default is 5. The Ektron database maintains a count (number of hits) for each content item, for each date. When you select a number of days, the Trends widget displays the content with the most hits during that date range, up to the number you set in this field.
  • Filter By—You can filter which content appears on this widget by selecting a folder or a taxonomya content-level categorization system that uses one-to-many relationships to create a scalable organization of content. A taxonomy lets you create a navigation system that is independent of the folder structure..

    While selecting a folder/taxonomy category, you have the option to include all folders/categories under the selected one. If you later want to remove this restriction, click Delete ()

Closed Business analytics API

Business Analytics API

The Business Analytics API's namespace is Ektron.Cms.Framework.Analytics.BusinessAnalytics and consists of several static methods arranged into 2 groups:

  • those that save events to the database
  • those that retrieve the event data from the database for use in reports

NOTE: The demonstration code in this section uses C# syntax.

Closed Saving event data

Saving Event Data

ClosedShow how event data is saved to the database

To save events, use the static class EventLogger, which exposes the following methods.

  • IAnalyticsEventData CreateAnalyticsEventData()
  • void Log(IAnalyticsEventData eventObject)
  • void Log(string eventName)
  • void Log(string eventName, string xml)
  • void Log(string eventName, string xml, int count)
Closed Show the illustrated EventLogger classes

As long as an event (myEvent) has been registered in the system, you can store an event like this:

using Ektron.Cms.Framework.Analytics.BusinessAnalytics;
…
EventLogger.Log(“myEvent”);

This code saves the event data with default values. As shown, the Log method has several overloaded versions. Each provides a different amount of control over the information saved to the database. The following list shows the Log method's parameters.

  • eventName (String)—A name that uniquely identifies the event. This name must be registered and enabled in the database for it to be recorded.
  • XML (String)—This parameter is purely for customization. By default, its value is null. The API stack passes the string to the database, where the appropriate stored procedure can use it. For example, it can store additional values that are not part of the current event-object
  • count (Integer)—Allows increments other than the default value of one. For example, you may want a specific event to increment the event counter by 5.

In addition to the parameters listed above, you can set other values by referencing the event object that carries the information to the database. A call to CreateAnalyticsEventData returns this object, and can be used as follows: 

IAnalyticsEventData eventObject = CreateAnalyticsEventData();

Through the interface IAnalyticsEventData, the object provides the following additional parameters, which allow more control over what information is saved with the event.

  • ObjectId (Long)—For a content related event, ObjectId should be set to a Content ID.
  • LanguageId (Integer)—The content object's Language ID. If that is not available, the current request's Language ID.
  • SiteId (Long)—The current request's Site ID

    NOTE: A value of -1 means this value has not been set, and will be updated appropriately at a lower level.

  • UserId (Long)—The current request's User ID (if logged in)
  • VisitorId (String)—The current request's Visitor ID (if not logged in)
  • EventDate (DateTime)—Defaults to current date and time
Closed Retrieving Event Data

Retrieving Event Data

Closed Show how data is retrieved into reports

Use the static class EventReporter to retrieve events stored in the database. This class exposes the following methods.

  • IList<string> GetReportNameList()
  • IAnalyticsQueryRequest CreateQueryRequest()
  • IContentQueryRequest CreateContentQueryRequest()
  • IList<IAnalyticsEventItem> GetList(IAnalyticsQueryRequest queryRequest)
  • IList<IContentEventItem> GetList(IContentQueryRequest queryRequest)
  • void UpdateReportData(String eventName, DateTime eventDate)
Closed Show the illustrated EventReporter classes

Closed GetReportNameList method

GetReportNameList Method

Use the GetReportNameList method to obtain a list of recognized (e.g., registered) report names. You can extend this list by adding custom event types and their corresponding stored procedure handlers.

For example, to obtain a list of the allowed report names, use the following code.

using Ektron.Cms.Framework.Analytics.BusinessAnalytics;
...
IList<String> names = EventReporter.GetReportNameList();
Closed CreateQueryRequest method

CreateQueryRequest Method

Use the CreateQueryRequest method to specify an event data report of the base-level type. The method returns an object that implements the interface IAnalyticsQueryRequest, which has the following parameters.

  • ReportName (String)—Uniquely specifies the report, which is registered and corresponds to one or more stored procedures which, when run, generate the requested data.
  • SiteId (Long)—The Site ID of the data being returned.
  • UserId (Long)—The User ID of the data being returned.
  • EventStartDate (DateTime)—If desired, use to determine the earliest date for which report data is returned. By default, data from the earliest date is returned.
  • EventEndDate (DateTime)—If desired, use to determine the latest date for which report data is returned. By default, data through the most recent date is returned.
  • PagingInfo (Ektron.Cms.PageingInfo)—Page size and number let you display a small portion of the report at a time. By setting page size and number, the report data is reduced, and performance will improve. Conversely, performance degrades as page size (RecordsPerPage) increases, especially if the amount of stored data is large. This type has the following fields:
    • CurrentPage
    • EndRow
    • RecordsPerPage
    • StartRow
    • TotalPages
    • TotalRecords
  • OrderByDirection (EkEnumeration.OrderByDirection)—Descending or Ascending
  • XML (String)—This parameter is purely for customization. By default, its value is null. While saving event data, the API stack passes the string to the database, where the appropriate stored procedure can use it. For example, it can store additional values that are not part of the current event-object. Within the CreateQueryRequest method, this parameter can returns that string.
Closed CreateContentQueryRequest method

CreateContentQueryRequest Method

Use the CreateContentQueryRequest method to specify a report of event data that is related to content. It returns an object that implements the interface IContentQueryRequest which, in addition to those provided by interface IAnalyticsQueryRequest (see CreateQueryRequest Method) has the following parameters.

NOTE: You can use either the FolderID or the TaxonomyID parameter but not both. Also, you can only use the IncludeChild parameter related to the selected parent parameter.

Closed GetList method

GetList Method

There are 2 versions of the GetList method.

One version takes an IAnalyticsQueryRequest object, and returns a list of objects that implement IAnalyticsEventItem. That version has the following parameters.

  • ID (Long)—The object Id s supplied when the related events were saved.
  • XML (String)—This parameter is purely for customization. By default, its value is null.

    While saving event data, the API stack passes the string to the database, where the appropriate stored procedure can use it. It can store additional values that are not part of the current event-object.

The other version of the GetList method takes an IContentQueryRequest object and returns a list of objects that implement the interface IContentEventItem. That provides the following parameters in addition to those of IAnalyticsEventItem (shown above).

  • LanguageId (Integer)—The Language ID of the content that the report returns.
  • Quicklink (String)—The object's URL.
  • Title (String)—Determines whether the report includes children of the folder specified in the FolderID parameter.
  • Teaser (String)—The content summary. See Also: Writing a Summary for Content
  • Status (String)—The content's status. See Also: Content Statuses
  • FolderID (Long)—The FolderID of the content being reported.
  • Count (Integer)—The count of the object being reported. For example, if you are retrieving the most frequently emailed content item, the count is the number of times it was emailed. The count and average values may be used individually or together, depending on the report. For example, the rating report returns both the average (rating) and the count (the number of ratings), while the commented report uses only the count.
  • Average (Decimal)—The a numerical value divided by the count. For example, when Ektron calculates average content rating, it divides the total number of rating points (on a scale of 1 thru 10) by the number of votes.
Closed UpdateReportData method

UpdateReportData Method

This method tells the database that an event's details should update that event's aggregated data. This method is only required if the database does not automatically do this, such as when the corresponding bit is disabled for that an type in the database. Disabling the corresponding bit generally improves performance, especially if the event logging rate is high. But, if you disable the corresponding bit, you must call this update method if you want the report to show current data.

The UpdateReportData method takes the following parameters.

  • eventName (String)—The event whose data will be updated.
  • eventDate (DateTime)—The date of the event's occurrence. For example, if you pass 1/1/2009, one row in the aggregate table is updated. If the row does not exist, it gets created. If you do not pass an event date, this method updates the aggregate table with summary info for that event for all dates. For example, if today is February 1, the system has been in use since the beginning of the year, and you pass NULL for the date, 32 table rows are updated (31 days in January plus 2/1).
Closed Disabling the saving or reading of events

Disabling the Saving or Reading of Events

You can disable the saving or reading of all events or of individual events.

It is useful to disable events when you want to minimize database traffic. To disable all events:

  1. Open siteroot/web.config.
  2. Set the following parameters to false.
    <!-- Enable saving business-analytics events to the database
  (at API level) -->
      <add key="ek_enableBusinessAnalyticsEventStorage" value="false"/>
    <!-- Enable querying the database for business-analytics events
  (at API level) -->
      <add key="ek_enableBusinessAnalyticsEventReports" value="false"/>

    NOTE: These settings are set to enabled (true) by default.

You can also enable or disable individual events in the database itself, but this does require a call to travel through the full stack.

Closed Using a custom provider

Using a Custom Provider

Below the service level are providers that read and write event data. The default providers simply pass calls through to the standard Ektron database-access-level code, which reads and writes from the database. But you can modify this behavior to almost any conceivable alternative. For example, you can

  • save the data to an alternate database on an alternate machine
  • call a Web service to handle the reads and writes
  • filter the data and/or requests
  • process information on its way to or from the database

The SDK contains sample providers, as well as full source code for the Ektron-supplied providers. You can use this material as a basis for writing custom providers, which is the preferred technique for customizing the behavior of the Business Analytics API stack and subsystem.

Closed The default providers

The default providers for saving and reading event data (respectively) are EktronEventProvider.cs and EktronQueryProvider.cs. Example custom-provider source code has the following names for saving and reading event data (respectively): DemoEventProvider.cs and DemoQueryProvider.cs. For the default providers, the siteroot/web.config file must contain the following, inside <configuration><configSections>.

<section name="businessAnalyticsQueryProvider"
  type="Ektron.Cms.Analytics.Providers
    .BusinessAnalyticsQueryProviderConfiguration,
  Ektron.Cms.BusinessObjects"
  allowDefinition="MachineToApplication"
  restartOnExternalChanges="true"/>
<section name="businessAnalyticsEventProvider"
  type="Ektron.Cms.Analytics.Providers
    .BusinessAnalyticsEventProviderConfiguration,
  Ektron.Cms.BusinessObjects"
  allowDefinition="MachineToApplication"
  restartOnExternalChanges="true"/>

Additionally, the following must exist inside the <configuration> tags.

<businessAnalyticsQueryProvider
  defaultProvider="EktronBusinessAnalyticsQueryProvider">
  <providers>
    <add name="EktronBusinessAnalyticsQueryProvider"
      type="Ektron.Cms.Analytics.Providers.EktronQueryProvider,
      Ektron.Cms.BusinessObjects"/>
  </providers>
</businessAnalyticsQueryProvider>
<businessAnalyticsEventProvider
  defaultProvider="EktronBusinessAnalyticsEventProvider">
  <providers>
    <add name="EktronBusinessAnalyticsEventProvider"
      type="Ektron.Cms.Analytics.Providers.EktronEventProvider,
      Ektron.Cms.BusinessObjects"/>
  </providers>
</businessAnalyticsEventProvider
Closed Creating custom providers

To override the default Ektron provider with the a custom provider:

  1. Create a new solution with a project named CustomProviders.
  2. Add the following references to your project.
    • Ektron.Cms.BusinessObjects.dll
    • Ektron.Cms.Common.dll
    • Ektron.Cms.ObjectFactory.dll
  3. Add files DemoEventProvider.cs and DemoQueryProvider.cs (from the Ektron SDK).
  4. Build.
  5. Copy the CustomProviders.dll file to your Ektron site's bin file.
  6. Update web.config by modifying the <configuration> section. Specifically, add demo providers to the Business Analytics providers as shown below.
<businessAnalyticsQueryProvider
  defaultProvider="DemoQueryProvider">
  <providers>
    <add name="EktronBusinessAnalyticsQueryProvider"
      type="Ektron.Cms.Analytics.Providers.EktronQueryProvider,
      Ektron.Cms.BusinessObjects"/>
    <add name="DemoQueryProvider"
      type="Ektron.Cms.Analytics.Providers.DemoQueryProvider,
      CustomProviders"/>
   </providers>
</businessAnalyticsQueryProvider>
<businessAnalyticsEventProvider
  defaultProvider="DemoEventProvider">
  <providers>
    <add name="EktronBusinessAnalyticsEventProvider"
      type="Ektron.Cms.Analytics.Providers.EktronEventProvider,
      Ektron.Cms.BusinessObjects"/>
    <add name="DemoEventProvider"
      type="Ektron.Cms.Analytics.Providers.DemoEventProvider,
      CustomProviders"/>
  </providers>
</businessAnalyticsEventProvider>
ClosedWeb traffic analytics

Web Traffic Analytics

By analyzing the user traffic coming to and interacting with your site, you can better understand key elements of your Web presence. Traditional Web analytics packages help you understand where your traffic is coming from, when the traffic is occurring (including high and low points) and what pages users are interacting with. But this information is often isolated from the Web content and is, therefore, lacking the context needed to take advantage of it.

    To view Web traffic analytics, you must have an Ektron Professional or Enterprise License, and only the following users can view the Web Analytics data.
  • Members of the Administrators Group
  • Users assigned to the Analytics Viewer role. See Also: Defining Roles

Ektron has a fully-developed, Web traffic analytics provider model. By hooking into best-of-breed analytics software, like Google Analytics, your website’s information is integrated into Ektron's Workarea and so is at your fingertips as you use it to optimize the site experience.

ClosedUsing Web traffic analytics data within Ektron

Using Web Traffic Analytics Data with Ektron

Ektron’s Workarea provides customized reporting, reflecting exactly the information you care about. The data can analyzed in many ways, such as:

  • number of visits per day
  • browser usage
  • visitor location
  • visitor language
  • top content
  • referring sites

Web Traffic Analytics data is available for your entire site and individual pages. A sample Web Analytics display is below.

Closed

The Web Analytics widget can be placed on your dashboard, so that you have instant access. Also, the software is integrated into the content history. This makes your traffic analytics more relevant: you can see what modifications were made, when, and how they impacted traffic to that page. You can react immediately, restoring content that performed better or changing the current content to better reflect your goals.

This full integration makes your analysis more efficient; there is no reconfiguration of the analytics tool and no learning curve. Customer reporting, segmentation, and legacy data are easier to access, and Ektron becomes the central hub for all of your website’s information, bringing it together so that it is no longer siloed. Having all information in one place puts it in context, making it easier to draw the conclusions you need to optimize your Web presence.

When you set up Web Traffic Analytics, the Analytics Provider monitors every site visit. In the Workarea, you can view this data from many perspectives.

Closed

WARNING! No data is stored in Ektron -- Ektron retrieves it upon demand from your Web Analytics provider.

ClosedViewing analytics data

Viewing Analytics Data

The analytics feature provides 3 basic types of data:

Closed Page-level analytics data

Page-Level Analytics Data

After you enable analytics tracking, your provider retains data on every visited page (that is, a unique URL) such as http://developer.ektron.com/articles.aspx or http://developer.ektron.com/template.aspx?id=6572. Data is tracked when the quicklink is used, as well as any alias assigned to the content. See Also: Creating User-Friendly URLs with Aliasing

Closed Viewing page-level analytics from the site

Viewing Page-Level Analytics from the Site

Any authorized user can view analytics for a page on your website by following these steps.

  1. Log in to the website.
  2. Navigate to the page whose analytics data you wish to view.
  3. Hover the cursor over the Website Content menu.
  4. Choose View Page Activity. The SEO page’s Traffic tab appears.
    Closed

The Traffic tab of the SEO control graphs the analytics data of any 2 search criteria. Below the graph is data for the 5 visit criteria tracked by the analytics provider.

  • Pageviews—number of pageviews for this page over the selected date range
  • Unique pageviews—number of unique visitors to this page over the selected date range
  • Average time on page—how long a visitor spent on the page. It is calculated by subtracting the initial view time for this page from the initial view time of the subsequent page. So, this metric does not apply to exit pages.
  • Bounce rate—the percentage of single-page visits (that is, visits in which the visitor exited your site from the entrance page)
  • % Exit—the percentage of site exits that occurred from this page

Note that you can change the date range, analytics provider, and either search criterion (Pageviews and Time on Page in the example above). To learn about using the Segments button (), see .

You can also replace the URL with a different one, and view the page being analyzed (by clicking Visit this page in the green bar).

Closed Viewing page-level analytics from a PageBuilder page

Viewing Page-Level Analytics from a PageBuilder Page

Any authorized user can view analytics for a PageBuilder page by following these steps.

NOTE: You cannot drag and drop the Analytics widget onto a PageBuilder page.

  1. Open the PageBuilder menu. See Also: Creating Web Pages with PageBuilder
  2. From the menu, choose View > Analytics. The SEO page’s Traffic tab appears.
Closed Viewing page-level analytics from the Workarea

Viewing Page-Level Analytics from the Workarea

The Workarea provides 2 page-level views of analytics data.

  • The View Content History screen—compares analytics data for any 2 published versions
  • The Analytics toolbar button—displays the SEO page’s Traffic tab.

To view a content item’s analytics data from the Workarea:

  1. Navigate to the folder containing the content whose analytics data you want to view.
  2. Click the content item.
  3. To compare analytics data between any 2 published versions, click History().
    See Also: Comparing Versions of Content

    To view analytics for the currently published version, click Analytics (). When you do, you see the Traffic tab of the SEO page.

On the View Content History screen, blue and orange radio buttons appear next to each published version of content, as shown below.

Closed 

To compare analytics data, click the appropriately-colored radio button next to each version, then click Compare (). The Compare screen for the 2 versions appears.

Closed 

You can change the date range for each content version. You can also:

  • Use the Display pull-down to graph any visit data.
  • Click the URL Filtering tab to select the URLs being displayed. See Also: URL Filtering
  • Select a different site
  • Select a different analytics provider
  • Use the Segments button ().
Closed URL filtering

URL Filtering

Any content item can be viewed via several URLs, such as

NOTE: While Regex-based aliases affect Analytics data, they do not appear on the URL Filtering tab.

The URL Filtering tab of the Compare Analytics screen lets you analyze the data by each of these identifiers. So, for example, you can drill down to view only the data collected when site visitors accessed a page by typing its manual alias into the browser.

Closed Site-level analytics data

Site-Level Analytics Data

You can view analytical data for any site via the Analytics Report widget and several reports. See Also: Widget Reference

You can drag and drop the Analytics Report widget onto the Smart Desktop. When you do, you initially see the Direct Traffic report for the past 7 days.

You can click Edit () to change the display using any of the options shown below.

Closed 

There are 3 time interval choices:

  • last 7 days (the default)
  • last 30 days
  • last 90 days
Closed Site report descriptions

Site Report Descriptions

You can customize the Analytics reports in the Workarea in the following ways.

  • Change the text that describes a report or folder
  • Remove reports or entire folders

To complete either task:

Prerequisite

Permission to edit files on your Ektron Web server

  1. Open the following file: C:\inetpub\wwwroot\CMS400Developer\Workarea\controls\NavigationTrees
    \WebtrendsReportSubtree.ascx
  2. To change a report's or folder's text, find the text and replace it.

    To delete a report or an entire folder, find it and comment it out.

ClosedGoogle Web analytics

Google Web Analytics

Google Web Traffic Analytics is an enterprise-class solution that gives you rich insights into your website traffic and marketing effectiveness. Powerful, flexible and easy-to-use features let you see and analyze your traffic data in an entirely new way. Google Web Analytics prepare you to write better-targeted ads, strengthen your marketing initiatives, and create higher converting websites. Its main features are:

  • Advertising ROI—Measure the success of your display, search, new media, and offline advertising efforts.
  • Cross Channel and Multimedia Tracking—Compare your site usage metrics with industry averages and track Flash, video, and social networking sites and applications.
  • Visualizing Data—Uncover trends, patterns, and key comparisons with funnel visualization, motion charts, mapping, and more.
  • Customized Reporting—Create reports, dashboards, and segments that make the most sense for your business.
  • Sharing and Communicating—Administration controls and email reports let you share data across your organization.
  • Google Integration and Reliability—Google Web Analytics complements a suite of related products, all running on the same world-renowned infrastructure that powers Google.

For more information, see the Google Analytics home page.

Closed Deciding which Google analytics version to use

Deciding Which Google Analytics Version to Use

Ektron supports Google Analytics versions 2.4 and 3.0. To compare versions, see Migration Guide: Moving from v2.3 APIs to v2.4 & v3.0 > Differences between v2.4 and v3.0.

You may use both versions. If you enable both, the Ektron Workarea displays a drop-down for choosing a provider. Data is the same for both providers if you use the same Google analytics profiles.

IMPORTANT: If you will use Google’s Core Reporting API v3.0, Ektron supports the ClientLogin authentication method. OAUTH 2.0 is not supported at this time.

Closed Setting up Google analytics

Setting up Google Analytics

This section explains how to set up Google analytics. After you complete these steps, Google begins tracking your entire website. Alternatively, you can track individual site pages (see Tracking a Single Page), or clicks by file type (see Tracking Clicks by File Type).

WARNING! Enabling the tracking code may cause a significant increase in CPU usage.

  1. Create a Gmail account (http://mail.google.com).
  2. Sign up for Google Web Analytics (www.google.com/analytics/). When you set up a Google Web Analytics profile for your site, you are assigned a profile ID and a User Account. You need those to complete Step 8.

  3. Open this Google Analytics help page: Migration Guide: Moving from v2.3 APIs to v2.4 & v3.0.

  4. Under "Create a Project in the Google APIs Console," follow steps 1 through 4. On the API Access screen, under Simple API Access, click the Create new Browser key button. Copy the new browser key. You will use this for your API key in Step 8.

  5. On the server that hosts Ektron, go to C:\Program Files\Ektron\CMS400vxx\Utilities\EncryptEmailPassword.exe.
  6. Use that utility to encrypt the Gmail username and password that you obtained in Step 1. Enter your full user name, including @gmail.com.
  7. Open your site’s siteroot/web.config file and find the AnalyticsDataProvider tag. If you enable versions 2.4 and 3.0, edit the GoogleV3.0 and GoogleV2.4 tags.
    <AnalyticsDataProvider defaultProvider="Google"> 
  <providers>
    <add name="GoogleV3.0" 
      type="Ektron.Cms.Analytics.Providers.GoogleAnalyticsProviderv3,
      Ektron.Cms.BusinessObjects"
   EmailAddress="" 
   KeyFilePassword="" 
   KeyFilePath="/Key/privateKey/xxxxxxxxx.p12" 
   Username="" Password="" ProfileId="" 
      SiteURL="" UserAccount="" 
      Endpoint="https://www.googleapis.com/analytics/v3/data/" 
      ApiKey="" CacheInterval="0" 
GoogleAnalyticsTrackingCodePath="Analytics\template\googletrackingcode.ascx" 
      Version="3.0" />
    <add name="GoogleV2.4" 
      type="Ektron.Cms.Analytics.Providers.GoogleAnalyticsProvider, 
      Ektron.Cms.BusinessObjects" Username="" Password="" ProfileId="" 
      SiteURL="" UserAccount="" 
      Endpoint="https://www.googleapis.com/analytics/v2.4/" 
      ApiKey="" CacheInterval="0" 
GoogleAnalyticsTrackingCodePath="Analytics\template\googletrackingcode.ascx"
      Version="2.4" />
     
  </providers>
</AnalyticsDataProvider>

    NOTE: If your web.config has several analytics providers and you want to turn off analytic tracking for one of them, delete the value of the GoogleAnalyticsTrackingCodePath property.

  8. Complete each tag’s properties.
    • name—The free text name of the site being tracked and the Google version. You should use the site name followed by the provider name and version. For example, www.ektron.com-GoogleV3.0. When users view site-level displays of Web Analytics data within the Workarea, you choose the site from a drop-down. If you change the name, you must also change the value of the <AnalyticsDataProvider defaultProvider element to match the name.

    • Username—The Gmail username you encrypted.
    • Password—The Gmail password you encrypted.
    • ProfileID—The Google Analytics Profile ID you obtained in Step 2. Another way to find your Profile ID is to go to Google Analytics and click Analytics Settings. Next Edit a website profile. The Profile ID shows under the Profile Settings Title.

      NOTE: Tip! On the Google Analytics settings page, in the address bar, the &id= value is your ProfileId.

    • SiteURL—Your site root name. For example, you could set up one <providers> tag for the developer.ektron.com site, and another for the synergy.ektron.com site. The SiteURL needs to match the development site URL when you test in your development environment. For example, if the site path is http://MyDevMachine/default.aspx, the SiteURL is MyDevMachine. If there is no match, the Google beacon is not inserted onto your page.
    • UserAccount—The Google Analytics SiteURL you obtained.

      NOTE: Tip! When you visit your Google Analytics Settings page at google.com, the UA-xxxxxx-x string next to your site domain is the UserAccount assigned by Google.

      NOTE: To track multiple providers or sites, copy the contents of the <providers> tag, paste it below the existing tag and above </AnalyticsDataProvider>, and modify the elements listed.

    • API key—Insert the API key that you created in Step 4.
  9. Within the web.config's <analyticsSettings> tags is a suppressBeacon element that lets you track or suppress the tracking of users on your website. Many site administrators do not want to track user behavior in Traffic Analytics reports, as it corrupts the data. (This setting does not apply to Business Analytics.) See Also: Analyzing Content. The following are the settings for this element.
    • None—Track all users, including authenticated membership and Ektron users.
    • Members—Track unauthenticated and logged-in Ektron users only. Do not track membership users.
    • Authors—Track unauthenticated and logged-in membership users only. Do not track Ektron users.
    • All—Track unauthenticated users only. Do not track membership and Ektron users.
  10. Within the web.config's <appSettings> tags is an ek_AutoInsertBeaconScript element that either tracks or suppresses tracking activity on your website. Change its value to true.
  11. Save web.config.

    IMPORTANT: No special server control is needed to track Web Analytics. After you enable Web Analytics in the web.config file, the following JavaScript is automatically added to each PageBuilder page and any site page that contains an Ektron server control.

    <%@ Control Language="C#" 
  AutoEventWireup="true" 
  CodeFile="googletrackingcode.ascx.cs" 
  Inherits="Analytics_Template_GoogleTrackingCode" 
  EnableTheming="false" EnableViewState="false" %> 
<!-- Start Google Code --> 
<script type="text/javascript"> 
  var _gaq = _gaq || []; 
  _gaq.push(['_setAccount','<asp:literal id="GoogleUserAccount" runat="server"/>']); 
  _gaq.push(['_trackPageview']); 
  <asp:literal runat="server" id="variables"/> 
    (function() 
      { var ga = document.createElement('script'); 
      ga.type = 'text/javascript'; 
      ga.async = true; 
      ga.src = ('https:' == document.location.protocol ? 'https://ssl' :
         'http://www') + '.google-analytics.com/ga.js';
      s.parentNode.insertBefore(ga, s);
        var s = document.getElementsByTagName('script')[0]; 
      }
    )(); 
/* Start Track Event binding Code */ 
//
// extracted from 
// http://runtingsproper.blogspot.com/
//   2009/12/how-to-automatically-track-events-with.html 
//
// un-comment the below if you would like google analytics to track your pdf   
  // download links on the website. 
//$(document).ready(function () { 
// TrackEventsForClicks(); 
//}); 
// 
//function TrackEventsForClicks() 
//{ 
// TrackEventByFileExtension(".pdf");
// 
// add your file extension here 
//} 
// 
//function TrackEventByFileExtension(FileExtension) 
// {
// $("a[href$='" + FileExtension + "']").click(function() 
//{
// var fileURL = $(this).attr("href"); 
// _gaq.push(['_trackPageview', fileURL]); 
// }); 
//} 
/* End Track Event Binding Code */ 
</script> <!-- End Google Code -->
Closed Tracking a single page

Tracking a Single Page

As an alternative to tracking your entire site, you can track individual .aspx pages. To do that, follow these steps on every page you wish to track.

Prerequisite

You completed all steps in Setting up Google Analytics

  1. Open the siteroot/web.config file.
  2. Find the ek_AutoInsertBeaconScript tag.
  3. Set its value to false.
  4. Save web.config.

    NOTE: The previous steps disable the tracking code on your website.

  5. Open Visual Studio.
  6. Open the .aspx page to which you want to apply the tracking code.
  7. In the Solution Explorer tree, navigate to Workarea/Analytics/template/googletrackingcode.ascx.
  8. Drag and drop that user control onto the page.
  9. Assign EktronAnalyticsTrackingCode as the ID of the control.
Closed Tracking clicks by file type

Tracking Clicks by File Type

To track the number of times that files on your site (for example, PDFs) are accessed, follow these steps.

Prerequisite

You completed all steps in Setting up Google Analytics

  1. Open the siteroot/web.config file.
  2. Find the ek_AutoInsertBeaconScript tag.
  3. Set its value to true.
  4. Save web.config.
  5. Open Visual Studio.
  6. Open the .aspx page to which you want to apply the tracking code.
  7. In the Solution Explorer tree, navigate to Workarea/Analytics/template/googletrackingcode.ascx.
  8. Uncomment the code shown below.
    Closed
    /* Start Track Event binding Code */
//
// extracted from 
// http://runtingsproper.blogspot.com
//   /2009/12/how-to-automatically-track-events-with.html
//
// un-comment the below if you would like google analytics to track your pdf 
//   download links on the website.
//$(document).ready(function () { 
// TrackEventsForClicks();
//});
//
//function TrackEventsForClicks()
//{	
// add your file extension here
// TrackEventByFileExtension(".pdf");
//
//}
//
//function TrackEventByFileExtension(FileExtension)
//{
// $("a[href$='" + FileExtension + "']").click(function() {
// var fileURL = $(this).attr("href");
// _gaq.push(['_trackPageview', fileURL]);
// });
//}
/* End Track Event Binding Code */

The JavaScript tracks the opening of PDF files on your website. To add file types, copy TrackEventByFileExtension(".pdf");, paste it below, and update the file type. See example below.

xfunction TrackEventsForClicks()
  {
    TrackEventByFileExtension(".pdf");
    TrackEventByFileExtension(".png");
Closed Google site reports

Google Site Reports

You can access site-level Google Analytics reports from within the Workarea by selecting Reports > Traffic Analytics > Google.

NOTE: The following text was adapted from Google Analytics Help Center. Check that site for additional details on the reports.

Google sites reports show direct traffic on left side, top content on the right.

Search reports show terms used by site visitors to find content on your site. Note that this data is not retrieved from Google Analytics. Instead, it is retrieved from Ektron’s site search.

The following sections describe Google’s site-level reports.

Closed Visitors

Visitors

This report shows the number of new and returning visitors who came to your site and how extensively they interacted with your content. This traffic overview lets you view aspects of visit quality (i.e. average pageviews, time on site, bounce rate) and visit characteristics (i.e. first time visitors, returning visits).

  • Locations—Countries of your site visitors.
  • New vs. Returning—The number of visitors to your site who are new or returning.

    A high number of new visitors suggests that you are successful at driving traffic to your site, while a high number of return visitors suggests that the site content is engaging enough to keep visitors coming back. You can see how frequently visitors return and how many times they return in ‘Recency’ report and the ‘Loyalty report’, both under ‘New vs. Returning’ in the Visitors section.

  • Languages—Uses the language provided by the HTTP Request for the browser to determine site visitors’ language. Values are given in 2- or 4-character language code (for example, en-br for British English).

    This report captures the preferred language that visitors have configured on their computers. Understanding who your visitors are is crucial to developing the right content and optimizing your marketing spend. Many times, geo-location is not enough. Many countries have diverse populations speaking different languages which present important market targeting opportunities.

  • User defined—If you modified the tracking code to provide a user-defined segment, this field identifies that segment by the string you provide when setting up a user-defined segment.
Closed Visitor trending

Visitor Trending

  • Visits—The number of visits your site receives is the most basic measure of how effectively you promote your site. Starting and stopping ads, changing your keyword buys, viral marketing events, and search rank influence the number of visits your site receives.
  • Absolute Unique Visitors—The number of unduplicated (counted only once) visitors to your website over the specified time period. A Unique Visitor is determined using cookies.
  • Pageviews—The total number of pages viewed on your site. It is a general measure of how much your site is used. It is more useful as a basic indicator of the traffic load on your site and server than as a marketing measure.
  • Average Pageviews—Average pageviews is one way of measuring visit quality. A high Average Pageviews number suggests that visitors interact extensively with your site. A high Average Pageviews results from:
    • Appropriately targeted traffic (that is, visitors who are interested in what your site offers)
    • High quality content presented effectively

    Conversely, a low average pageviews indicates that traffic coming to the site has not been appropriately targeted to what the site offers or that the site does not deliver what the visitor expected.

  • Time on Site—One way of measuring visit quality. If visitors spend a long time visiting your site, they may be interacting with it extensively. However, Time on site can be misleading because visitors often leave browser windows open when they are not actually viewing or using your site.
  • Bounce Rate—The percentage of single-page visits (that is, visits in which the person left your site from the entrance page).

    Bounce rate is a measure of visit quality, and a high bounce rate generally indicates that site entrance (landing) pages are not relevant to your visitors. You can minimize Bounce Rates by tailoring landing pages to each keyword and ad that you run. Landing pages should provide the information and services that were promised in the ad copy.

Closed Browser capabilities

Browser Capabilities

Optimizing your site for the appropriate technical capabilities helps make your site more engaging and usable and can result in higher conversion rates and more sales.

  • Browsers—The browsers that your visitors use.
  • Operating Systems—The operating systems that your visitors use.
  • Browsers and OS—The browser/operating system combinations that your visitors use.
  • Screen Colors—The number of screen colors your visitors use.
  • Screen Resolutions—The screen resolutions that your visitors use.
  • Flash Versions—The versions of Flash that your visitors have installed.
  • JavaSupport—Whether Java is supported on your visitors' platforms.
Closed Network properties

Network Properties

  • Network Location—The internet service providers that your visitors use. This report lets you track the internet service provider (ISP) domains to which the user resolves.

    The domain is determined by the internet service that owns the user's internet protocol (IP) identifier.

  • Hostnames—Hosts from which people are visiting your site. Hostnames sometimes provide insight into organizations that are interested in what you offer.
  • Connection Speeds—Connection speeds that your visitors are using. Optimizing your site so that it loads quickly for most visitors can result in higher conversion rates and more sales.
Closed Traffic sources

Traffic Sources

This section provides an overview of the different kinds of sources that send traffic to your site. The graph shows traffic trends; the pie-chart and tables show what is driving the trends.

  • Direct Traffic—Visits from people who clicked a bookmark to come to your site or who typed your site URL directly into their browser. Direct traffic can include visitors recruited via offline (i.e. print, television) campaigns.
  • Referring Sites—Externals sites from which visitors linked to your site.
  • SearchEngines—Visitors who clicked to your site from a search engine result page.
  • All TrafficSources—Visitors referred from search engines, sites, and tagged links. The graph shows the overall trends while the table shows the specific sources (i.e. search engines, sites, and tagged links) driving the trends.
  • Keywords—Compares traffic from search keywords to overall traffic to your site.
  • Campaigns—How people referred from your configured campaigns compare to the “average” visitor to your site.

    The graph shows overall trends, while the table lists each configured campaign. Because all traffic in this report results from campaigns that you explicitly control, you can use this information to add or delete campaigns, or to determine the effectiveness of tests that you have set up using custom tags.

  • Ad Versions—Compares your AdWords ads (and configured campaigns in which you use the “content” tag) against each other.

    This report shows you which ad copy (in AdWords ads or in configured campaigns) is most effective. Ads with high clickthrough rates show that the copy is effective at getting the user to click, while high bounce rates, for example, indicate a need for landing pages that are consistent with what the ad promises.

Closed Content

Content

This report provides an overview of pageview volume and lists the pages (Top Content) that were most responsible for driving pageviews. You can also reach some useful reports that reveal how users interact with your site and statistics related to how they found your site in the first place.

NOTE: Content reports include a link icon () and a hyperlink. If you click the link icon, you go to the page. If you click the hyperlink, you see a more detailed Analytics report about that page.

  • Top Content—The most commonly viewed pages on your site, and how they are used.

    The table lists all pages which were viewed on your site. A high bounce rate indicates a landing page that should be redesigned or tailored to the specific ad which links to it. A high 'Time on Page' may indicate content that is particularly interesting to visitors. The significance of exits varies according to each page. For example, it may be common for visitors to exit your site from a receipt or “thank you” page because they have completed a conversion activity. In contrast, a high number of exits from a non-goal page (from a funnel page, for example) may indicate that the page is confusing or that it generates user errors.

  • Content by Title—The most commonly viewed groups of pages on your site (grouped by title), and how they are used. This report provides the same information in the “Top Content” report, but aggregated by title tag value.
  • Top Landing Pages—Data on how effectively your landing pages entice visitors to click further into your site. You can lower bounce rates by tailoring landing pages to their associated ads and referral links and placing a clear call-to-action on each landing page.
  • Top Exit Pages—Pages from which people exit your site.

    The significance of an exit rate varies according to each page. For example, it may be common for visitors to exit your site from a receipt or “thank you” page because they have completed a conversion activity. In contrast, a large number of exits from a non-goal page (from a funnel page, for example) may indicate that the page is confusing or that it generates user errors

Closed Viewing Google segments

Viewing Google Segments

Google Analytics has an Advance Segments tool that lets you "slice and dice" your Analytics data with great precision. Advanced segments let you choose what types of visits you want to be considered when generating the data for a report." (source: About Advanced Segments)

Google segments allow marketers using analytics reports to drill down to specific classes, or segments, of site visitors, such as

  • Users
  • Sessions and visitors
  • Members and authors

This section explains how to select and view segments within Ektron.

NOTE: While you can view custom segments within Ektron, you must create them within Google Analytics.

  1. Browse to a view of Analytics data. See Also:
  2. Click Segment ().
    Closed

  3. The Segments screen appears. Select up to 4 segments to display.
  4. The screen refreshes and graphs each segment in a different color. In the following example, new visitors are graphed in blue and returning visitors are orange. Also, the screen breaks down data by each segment.
    Closed

ClosedWebtrends analytics

Webtrends Analytics

Marketers today face a new set of challenges. With the explosion of new digital channels such as social and mobile, it is even harder to understand customer behaviors and optimize how to communicate with them. Both Webtrends Analytics On Demand and On Premises deliver the industry’s most accurate picture of how customers interact with your brand in the digital space.

Real-time data, intelligent alerts, and the ability to easily share information within your organization means you empower your team to make smart and timely decisions based on solid data. You'll find new opportunities, ensure conversions are on track and respond to needs faster than ever before.

Prerequisite

Webtrends On Demand

Closed Setting up Webtrends analytics
  1. Create a Webtrends Account and create a tracking script.
    1. Set up a Webtrends account: Webtrends Developer Network.
    2. Webtrends sends you an account name, username, and password.
    3. Log into Webtrends using this URL: Webtrends Developer Network Login.
    4. Use your Webtrends account name, username, and password.
    5. From that page, follow this menu path: Administration> Application Settings > Data Sources.
    6. Click New. A Data Source Wizard screen appears.
      • Enter a name for the data you will retrieve.
      • Select your server's time zone.
      • Click Next.
      • A summary of the information you entered appears along with a Webtrends data collection server ID (DCSID) value.
      • Click Save. The Data Sources screen reappears with your new data source.
    7. Copy your Data Source ID number (DCSID), indicated in the following figure. You will use this number in the next step.
      Closed

  2. Build the Tracking Files. In this step, you tell Webtrends the type of data you want to track. Webtrends then generates files that track that data.
    1. Open Webtrends' Tag Builder page: Webtrends Tag Builder
    2. From the Data Sources screen, you can click Build Tag (Tracking Code).
    3. Complete this page, which prompts you to identify which data Webtrends should track.
    4. Into the page's Webtrends data collection server ID (DCSID)field, paste the number you copied in Step 1g above. For help completing the Tag Builder page, click the information button in the top right corner.
      Closed

    5. Click the Build Tag button. Webtrends generates files you will use to track usage statistics. The Summary and Confirmation screen appears.
    6. Click the Download tag button.
      Closed

    7. Save the .zip file to your computer.
  3. Copy Webtrends Tracking Files to Ektron. You must have permission to edit files on theEktron Web server. In this step, you
    • replace the Webtrends.html file in your Workarea folder with the one you downloaded.
    • replace the <div> tag in your Workarea's Webtrends.ascx file with the one in the downloaded file of the same name
    1. Extract the .zip file you downloaded.
    2. Open the folder that contains the extracted files.
    3. Copy Webtrends.js.
    4. Paste it into the site root\Workarea\Analytics\template folder. This action replaces a file of the same name.
    5. In the folder that contains the extracted files, open Webtrends.html.
    6. Copy the <div> tag highlighted below.
      Closed

    7. In the site root\Workarea\Analytics\template folder, open Webtrends.ascx.
    8. Replace the <div> tag with the one you copied.
  4. Update Ektron's web.config file. You must have permission to edit files on your Ektron Web server.
    1. Obtain a value for your web.config file's ProfileFileName property by going to https://ws.Webtrends.com/v2/ReportService/profiles/?format=xml. (Authentication required.)
      • In the User name field, enter your account name\username that you obtained.
      • In the Password field, enter your password. A screen displays your Webtrends profile as follows.
        <?xml version="1.0" encoding="utf-8" ?> —
<list> —
  <ProfileDefinition> 
    <string name="ID">ABCD1234</string> 
    <string name="name">MyAnalyticsAccountName</string> 
    <decimal name="AccountID">234567</decimal> 
    <decimal name="TimeZoneID">-500</decimal> 
  </ProfileDefinition> 
</list>

        You will use the string name value (highlighted in red), ProfileFileName property.

    2. Open your siteroot/web.config file
    3. Find the tag beginning with <add name="Webtrends".
    4. Replace the Webtrends tag's properties.
      • Name—The name displayed on the report. If you have several accounts, you can use names like these.
        • Webtrends—developer.ektron.com
        • Webtrends—document.ektron.com

        However, the value of this field for one analytics provider must match the value of the <AnalyticsDataProvider defaultProvider> tag.

      • Type—Do not change.
      • Username, Password—
        1. Go to C:\Program Files\Ektron\CMS400vxx\
          Utilities\EncryptEmailPassword.exe          .
        2. Encrypt the Webtrends username and password you obtained.
        3. Enter the encrypted values into these properties.
      • ProfileFileName—Enter the string name value you obtained.
      • SiteURL—Enter the URL visitors use to access your site. For example, www.example.com.
      • UserAccount—Enter the account name you obtained.
      • Endpoint—The default value is https://ws.Webtrends.com/v2/ReportService/. You only need to update this value if you are not using the default Data Collection Server on the Tag Builder page.
      • Cache Interval—Use to cache the Analytics provider's data. Enter a number in seconds. The maximum 86400. Caching improves the performance of the traffic report page.
      • AnalyticsTrackingCodePath—Do not change.
Closed Displaying Webtrends site reports

Displaying Webtrends Site Reports

You can access Webtrends analytics reports within the Workarea by selecting Reports > Traffic Analytics > Webtrends.

Refer to the following WebTrends manual for information about specific reports: Webtrends Administration User Guide > Chapter 32 : Webtrends Analytics Report Library

Display Options

Webtrends reports provide the following display options.

Closed Data table (default)

Closed Bar chart

Closed Heat map

Closed Pie chart

From the pie chart, you can change the display to see percentages of the following factors.

  • Visits
  • Page views
  • Average visit duration (minutes)
  • Single page view visits
  • Entry page visits
ClosedSiteCatalyst analytics

SiteCatalyst Analytics

Adobe's SiteCatalyst® (formerly known as Omniture) provides marketers with actionable, real-time intelligence about online strategies and marketing initiatives. SiteCatalysthelps marketers quickly identify the most profitable paths through their website, determine where visitors are navigating away from their site, and identify critical success metrics for online marketing campaigns. (source: Adobe SiteCatalyst)

Closed Setting up SiteCatalyst analytics
  1. Log onto site and generate tracking code.
    1. Contact Adobe and set up an account to use SiteCatalyst.
    2. Use the information Adobe provides (URL, username, password, and so on) to log in to Adobe Online Marketing Suite.
      Closed

    3. Click Admin > Admin Console > Code Manager.
      Closed

    4. In the Select the type of code to generate drop-down, choose Javascript.
    5. In the Select a Report Suite that collects data for your website drop-down, choose a report suite you selected when setting up your SiteCatalyst account.
    6. In the Match the Character-Encoding of your website drop-down, choose UTF-8.
    7. In the Choose your Currency for Tracking Conversion drop-down, choose your currency.
    8. In the How many periods are in your domain name? drop-down, enter the appropriate number. The screen shows an example.
    9. If your site uses SSL, check the box next to Use https:// instead of http://?. See Also: Installing Ektron
    10. Click Generate Code.
  2. Copy the tracking code to sitecatalyst.ascx.
    1. The Code Manager screen displays code to track analytics on your Ektron site. Copy the code under the Page Code tab.
      Closed

    2. Open the following file:site root\Workarea\Analytics\template\sitecatalyst.ascx.
    3. Delete all text below the following line.
      <%@ Control Language="C#" 
  AutoEventWireup="true" 
  CodeFile="sitecatalyst.ascx.cs" 
  Inherits="Analytics_Template_SiteCatalyst" 
  EnableTheming="false" EnableViewState="false" %>
    4. Paste the code you copied in Step 1 into sitecatalyst.ascx, below the line shown above.
    5. Save sitecatalyst.ascx.
  3. Copy the s_code.js file to Workarea folder.
    1. Use the Code Manager screen's Code Archive Name field to assign a name to the files you created in the previous step.
      Closed

    2. Use the Code Archive Description field to assign a more detailed description to the files you created in Analyzing Content.
    3. Click Save. Code Manager compresses the Page Code and Core Javsascript files into a .zip file, and displays them under Saved Code.
    4. Click Download next to the saved .zip file. You are prompted to download the .zip file to your computer.
    5. Click OK.
    6. Open the downloaded .zip file.
    7. Extract the s_code.js file to site root\workarea\analytics\template. You may be prompted to confirm that you are overwriting a file of that name already in the folder.
  4. Update Ektron's web.config file.

    NOTE: Your SiteCatalystWeb Services Username and Shared Secret. To obtain, log in to Adobe Online Marketing Suite and click Admin > Admin Console > Company > Company Home > Web Services.

    Closed

    1. Open your siteroot/web.config file.
    2. Find the tag beginning with <add name="SiteCatalyst".
    3. Replace the SiteCatalyst tag's properties.
      • Name—Do not change.
      • Type—Do not change.
      • Username, Secret—
        1. Go to C:\Program Files\Ektron\CMS400vxx\Utilities
          \EncryptEmailPassword.exe          .
        2. Encrypt the SiteCatalyst Web Services Username and Shared Secret you obtained.
        3. Enter the encrypted values into these properties.
      • CompanyName—Enter the company name obtained from Adobe when your account was created.
      • ReportSuiteID—Enter the ReportSuiteID obtained from Adobe when your account was created.
      • SiteURL—Enter the site URL. For example, www.example.com.
      • Endpoint—Enter your account's endpoint. You obtain one when you set up your SiteCatalyst account. An endpoint looks like this: https://api-sbx1.omniture.com/admin/1.2/rest/.
      • CacheInterval—You can use this field to cache the Analytics provider's data. Enter a number in seconds. The maximum 86400 (24 hours). Caching improves the performance of the traffic report page.
      • AnalyticsTrackingCodePath—Do not change.
ClosedSiteCatalyst reports

SiteCatalyst Reports

You can access site-level SiteCatalyst reports from within the Workarea by selecting Reports > Traffic Analytics > SiteCatalyst.

NOTE: The descriptions were adapted from SiteCatalyst Analytics Help Center (Adobe Marketing Cloud Sandbox Sign In). Check that site for additional details on the reports.

Closed Site metrics

Site Metrics

Page views

Displays the number of times your website pages were viewed for the selected time period (hour, day, week, month, quarter or year). This report lets you track page views for each individual page on your site, as well as an aggregate of page views for your website as a whole.

Visits

Displays the number of visits made to your website during the selected time period.

Daily unique visitors

Shows the number of unique visitors to your site for a selected daily time frame. A unique visitor is counted the first time he/she visits your site within the selected time frame. If a visitor returns again to your site, they are not counted as a unique user again until the selected time frame has passed.

Time spent per visit

Reveals the length of time visitors spend viewing your site as a whole during each visit. It also has an Average Time Spent on Site statistic that shows the average time that was spent viewing your site, taken across all visitors.

Closed Site content

Site Content

Pages

Ranks pages on your site based on those that receive the most traffic.

Site Sections

Shows the areas of your site that were visited most by your site customers. Site Sections could include (but are not limited to) groups of products, similar to Categories. Data for the Conversion Site Sections report is imported from the Site Section report in the Traffic group, which receives its information from the channel variable in the SiteCatalyst tracking code. You can use this report to identify the greatest impact on site statistics from items in varying site sections.

Servers

SiteCatalyst lets you group pages together that are being hosted by a particular server. For example, if you have a website that is hosted on two different servers, you may want to see if one server is serving more impressions than the other server. This report lists all of the servers of your website that are being tracked by SiteCatalyst and tells you which servers are being accessed the most.

Exit links

Shows links that your visitors click to leave your site and go to another site. Exit links are those links that take your visitor to another site. Most common examples of exit links are links to partners, affiliates, and so on.

Custom links

Shows links your site visitors prefer, helping you better understand the navigation patterns within your site.

File downloads

Displays files that have been downloaded from your website. These files can be any type of document you wish to track, including user manuals, presentations, audio, or video files. This report requires that link tracking code to be installed on the site you are tracking.

Pages not found

Lists the number of times a Page Not Found (404- error) page appears to your site visitors and lists the URLs of the pages that were not found.

Closed Mobile

Mobile

Mobile

Several criteria about mobile devices visitors use to access your site, such as device type, screen size, audio support, and so on.

Closed Paths

Paths

Reloads

Shows the number of times individual pages were reloaded by page visitors.

Page depth

Identifies the depth at which each page within your site is visited. Depth for a page is measured by counting the number of pages viewed before that page. So, if your "About Us" page is the third page visited by a given visitor, its depth for that visit is 3. You can use this report to identify which pages compel your visitors to travel the deepest into your site and to optimize content and navigation to make key content more accessible.

Time spent on page

Displays the length of time that visitors browse individual pages in your site. The time spent is divided into 10 categories: less than 15 seconds, 15-30 seconds, 30-60 seconds, 1-3 minutes, 3-5 minutes, 5-10 minutes, 10-15 minutes, 15-20 minutes, 20-30 minutes and greater than 30 minutes.

Entry pages

Shows, by percentage and total visits, which pages on your site are the first ones seen by new visitors.

Original entry pages

Shows the first page viewed of the first-ever visit to your site. Each user is counted only once unless they delete their cookies or are not being tracked with cookie

Closed Traffic sources

Traffic Sources

Search keywords—All, Paid

Displays a breakdown of each search keyword that has been used to find your site. You can sort this list by page views or search keywords by clicking the column title above the listing. Click on the blue magnifying glass next to each search keyword to see the actual search results screens where your site was listed.

Search engines—All, Paid, Natural

Helps you learn which search engines people are using to find your Web page. The graph shows you the percentage breakdown of the search engines that have been used to find your site.

All Search Page Ranking

Shows the results pages on which your site links were located in the user's searches that were performed. For example, a user who came to your site from a search engine may have seen you on the third of one hundred pages of results. This can help you quickly see and optimize search engine efforts. Data for this report may be viewed for all but the 'Hourly' time period.

Referring domains

Shows the domains that referred the customers that most impacted your site's Success Metrics. Referrers fall into 2 main categories: Domains and URLs. Domains refer to the domain name, and appear as the base domain without the query string or subdirectories attached. URLs include the base domain name, as well as any query strings or subdirectories.

Original Referring Domain

Shows the original referrers that produced the customers on your site. Customers can visit your site multiple times, and have a different referrer for each visit. This report shows how they were referred the first time they arrived at your site. This can help you see if they continued to use the same referrer and view patterns in how customers are referred to your site. You can view the number of visitors generated by an original referrer or discover how much revenue each original referrer was responsible for producing.

Closed Products

Products

Helps you identify how individual products and groups of products (categories) contribute to your various conversion metrics, such as revenue or checkouts.

Closed Visitor retention

Visitor Retention

Return frequency

Shows the number of visitors who returned to your site within one of the following categories (representing the time lapse between visits): less than 1 day, 1-3 days, 3-7 days, 8-14 days, 14 days to 1 month and longer than 1 month.

Visit number

Provides another method for gauging visitor loyalty by displaying the visit number for each visitor that comes to your site.

Closed Visitor profile

Visitor Profile

Geosegmentation

  • Countries—Shows countries from which visitors access your site. In addition to the standard "Ranked" and "Trended" views available on most reports, there is also a "Map" view that color-codes the countries according to their relative contribution to your total traffic-the more intense the color the greater the number of daily unique visitors from that country that are visiting your site
  • Regions—Shows regions from which visitors access your site. To the right of each region shown, the country of the region is also shown in parentheses. Clicking the magnifying glass icon to the left of the region will open the line item in the SiteCatalyst Cities Report. With this report, you can see how a selected region performed compared to another on your web site.
  • State—The U.S. states from which visitors access your site.
  • Zip/postal code—Shows the zip and postal codes that produced the customers that had the greatest effect on purchase success metrics.
  • Cities—Shows U.S. cities from which visitors access your site.
  • U.S. DMA (Designated Market Area)—Shows the marketing areas within the United States from which visitors access your site. By clicking the link next to State in the Report Status header, you may restrict the report to marketing areas within a particular state. This data is provided via a partnership between Omniture and Nielsen Media Research, Inc. By clicking the Visitors Per Capita link next to Display in the Report Status header, you can adjust the data by the relative population of each marketing area. Enabling this option shows both the number of daily unique site visitors per 10,000 people living in the market area as well as the percent above or below the national average value. You can also generate a Correlation report by clicking the Correlation icon next to one of the market areas and selecting the item with which you want to correlate the data.
  • Visitor Home Page—Another method of gauging visitor loyalty and assessing the perceived value your visitors place on your website's content. The report shows how often your visitors mark a page on your website as their 'Home Page' in their browser.
  • Language—Displays your visitors' preferred languages. The Languages Report captures the default browser language and displays those most used by visitors to your site.
  • Time zone—Displays the time zones your visitors are located in when they view your site. This report superimposes a bar graph (indicating the number of visitors) on a map of the world so you can quickly see what part of the world your visitors are from.
  • Domains—Lists the organizations and ISPs your visitors use to browse your site. This report differs from the Full Domains report in that the Full Domains report registers the full ISP domain, whereas this report lists the secondary domain.
  • Top Level Domains—Identifies world regions that visitors come from, based on their originating domain extension, and shows how many visitors come from these countries. Domains ending in Commercial (.com), Network (.net), Education (.edu), Government (.gov) and Organization (.org) are usually based in the United States, and are listed separately from the rest of the domains.

Technology

  • Browsers—Identifies the types and versions of browsers that are used by your visitors.
  • Browser Type—Classifies the browsers visiting your site into their major families
  • Browser Width, Browser Height—Shows the most common widths or heights of the browsers (in pixels) your visitors use to view your site.
  • Operating Systems—Shows which operating systems are being used by your site visitors
  • Monitor Color Depth—Shows your visitors' most popular color-depth settings as configured on their computer. Color-depth refers to the number of colors that can be displayed on the screen.
  • Monitor Resolutions—Shows screen resolutions that visitors to your website most commonly use, as configured on their computers.
  • Java, JavaScript —The JavaScript Version report displays the versions of JavaScript your visitors' browsers use while viewing your site.
  • Cookies—Shows the percentage of visitors that prefer to use cookies while browsing.
  • Connection Type—Displays the percentage of your site's visitors that utilize high-speed Internet connections versus slower dial-up connections.
ClosedSetting up site overlay

Setting Up Site Overlay

Site Overlay provides an easy-to-use visual map of popular links on a Web page, based on the frequency of clicks. When Site Overlay is enabled, each link on a page is represented by a horizontal bar graph. When you hover over the graph, you see its statistics. The following image shows menu links and the overlay bar graphs.

Closed 

Prerequisites

  • Site Overlay requires Google Analytics as your Web Traffic provider.
  • Set the web.config key ek_AutoInsertBeaconScript to true.

    <add key="ek_AutoInsertBeaconScript" value="true" />

To enable Site Overlay, access the Content Menu by hovering over the access point () and selecting Site Overlay.

NOTE: You must be assigned the Analytics Viewer role or a member of the Administrators group.

Closed 

  • When Site Overlay is enabled, a toolbar appears at the top of the page and lets you change the date range of the Site Overlay data.

  • Change the date range to view statistics for a different period. Default is one month before today. To refresh the page, click Refresh ().
  • Click Remove Overlay to disable Site Overlay.

On every place that a visitor can click on your Web page, a bar graph indicates the percentage of clicks on this element. When you hover over a bar graph, you see a click count and a percentage comparing these clicks to all clicks on the page.

Closed Troubleshooting Site Overlay

Troubleshooting Site Overlay

You may encounter these issues.

  • Error message—"Username and/or password not set. Please update the AnalyticsDataProvider section on your web.config. Parameter name: Username, Password."
  • The Google Analytics provider must be configured in web.config. See
  • Clicks are not showing on the Overlay.
    • Be sure enough time has elapsed since the clicks occurred and the Google Analytics provider has recognized them. (24 hours)
    • Check that the key for ek_AutoInsertBeaconScript is true.
Closed Remarks about the data

Remarks about the data

  • Data providers typically record clicks based on the link href parameter. If a link with identical hrefs exists in more than one location on a page, the data provider reports each one clicked the same, equal to the total of all clicks for that href on that page. This means that if link A is clicked 10 times and link B is never clicked, but they have the same href parameters, both show 10 clicks.
  • Some providers are case-sensitive in certain cases; Google data has been shown to report data separately when a letter-case of the page's URL changes. Therefore, clicks for “Test.aspx” might not show up for “test.aspx”.

Open topic with navigation