Вы находитесь на странице справочной информации о версии:

Capture information in SiteCatalyst when users click links on the page. For example, use link tracking to learn how users interact with your site, track file downloads, and track exit links.

linktracking_001

Tracking File Downloads

Configure the SiteCatalyst framework so that files that are downloaded from associated pages are automatically tracked as downloads in SiteCatalyst. When you enable the tracking of downloads, only the file types that you specify are tracked.

Downloads of the following file types are tracked by default:

  • exe
  • zip
  • wav
  • mp3
  • mov
  • mpg
  • avi
  • wmv
  • doc
  • pdf
  • xls

For example, with download trackng enabled for PDF files, when users click links to PDF files, the download of the PDF is tracked.

The download tracking properties of the framework are implemented as  code in the analytics.sitecatalyst.js file that is generated for a page. The following example code represents the default download tracking configuration:

s.trackDownloadLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';

Use the following procedure to enable download tracking for your SiteCatalyst framework:

  1. Open the SiteCatalyst framework and expand the Link Tracking Configuration section.

  2. To enable download tracking, select Track Downloads.

  3. In the Download File Types box, type the file name extensions of the typs of files that you want to be tracked.

Track the clicking of external links (exit links) on your pages. Configure the following framework properties to track external links:

  • Track External: Enables external link tracking.
  • External Filters: Defines filters for matching the external URLs of the link targets. When the link targets match the filter, the link is tracked. External filters are useful for tracking only some of the external links on your pages.
  • Internal Filters: Defines filters for matching the URLs of internal links. When the link targets URLs that match this filter, the link is not tracked. The default value is a javascript command that returns the hostname of the URL for the current window address.
  • Leave Query String: Includes URL parameters when evaluating matches with internal and external filters.

The external link tracking properties are implemented as  code in the analytics.sitecatalyst.js file that is generated for a page. The following example code is generated for a page that is associated with a framework that has enabled external link tracking with the following configuration:

  • External filter is 'google.com'
  • Internal filter is the default value of 'javascript:,'+window.location.hostname
  • Query strings are not included when evaluating the link target against filters.
s.trackExternalLinks= false;
s.linkExternalFilters= 'google.com';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.linkLeaveQueryString= false;

Use the following procedure to configure external link tracking for a SiteCatalyst framework:

  1. Open the SiteCatalyst framework and expand the Link Tracking Configuration section.

  2. To enable external link tracking, select Track External.

  3. (Optional) To specify the external links to track, in the External Filters box type all or part of the URL of the link target. Separate multiple filters with a comma. Enclose string literals within single quotation marks.

    No value causes all external links to be tracked.

  4. To specify the internal links that are not tracked, in the Internal Filters box type all or part of the internal URL of the link target. Separate multiple filters with a comma. Enclose string literals within single quotation marks.

  5. To include URL parameters when evaluating link target URLs against external and internal filters, select Leave Query String.

Sending Variable Data with Link Clicks

Send event and variable data to SiteCatalyst when a user clicks a link. The Link Tracking Configuration properties enable you to specify SiteCatalyst events and variables to track when link clicks occur. The framework mappings determin the event and variable values.

When you specify the events and variables to send, the configuration is implemented as code in the analytics.sitecatalyst.js file that is generated for a page. The following example code is generated for a page when the framework tracks the event10 event and the prop4 property:

s.linkTrackEvents= 'event10';
s.linkTrackVars= 'prop4';

Perform the following procedure to capture the data:

  1. Map SiteCatalyst variables to the variables of your content components that store the data that you want to track when links are clicked. (See Setting Up A Framework For Basic Tracking.)

  2. Expand the Link Tracking Configuration area.

  3. In the Link Track Events box, type the SiteCatalyst event variables that you want to use for counting link clicks. Separate multiple variable names with a comma. The default value of None causes no event tracking.

  4. In the Link Track Vars box, type the SiteCatalyst variables that you want to send to SiteCatalyst when links are clicked. Separate multiple variable names with a comma. The default value of None causes no variable data to be sent.

Example Link Tracking Configuration

Perform the following procedures to explore the link tracking behavior of the SiteCatalyst integration. The procedures show results from Adobe DigitalPulse Debugger.

General configuration

  1. Open the framework that has been associated with a web page, such as my-sitecatalyst-framework and http://localhost:4502/content/geometrixx-outdoors/en.html.

  2. Drag the Page component to the mappings area of the framework. The Page component belongs to the General component group in Sidekick. Configure the mapping according to the following table:

    CQ Variable
    SiteCatalyst Variable
    pagedata.title eVar1
    eventdata.events.pageView event1
  3. Drag the Search component to the mappings area of the framework. The Search component belongs to the General component group in Sidekick. Configure the mapping according to the following table:

    CQ Variable
    SiteCatalyst Variable
    eventdata.keyword eVar2
    eventdata.results eVar3
    eventdata.events.search event2

Configure external link tracking

  1. In your framework, expand the Link tracking Configuration area.
  2. Deselect Track Downloads.
  3. Select Track External.
  4. Deselect Leave Query String.
  5. Use the following value for the External Filters list to identify it as an external URL:

    ‘yahoo.com’

  6. Add the following value to the Link Track Events field:

    event1,event2

  7. Add the following value to the Link track vars field:

    eVar1,eVar2


  8. On the page that is associated with the framework, add a Text component. Inside the Text component, add a hyperlink pointing to the following address:

    http://search.yahoo.com/?p=this

  9. Switch to Preview mode and click the link. 

The call made will look like this when viewed with DigitalPulse Debugger:

Notice the URL does not contain the Query string (?p=this)

Include the URL parameter

  1. In the framework, expand the Link Tracking Configuration area and select Leave Query String.
  2. Reload the page preview, and click the link.

The call details that appear in DigitalPulse Debugger are similar to the following example:

 

Notice the URL contains the Query string this time around.

Perform a search

  1. On the page that is associated with the framework, add the search component.
  2. Preview the page and perform a search using the aaaaaaaaaaa keyword, which returns no results.

The call details that appear in DigitalPulse Debugger are similar to the following example:

Ad-Hoc Link Tracking

Ad-hoc link tracking enables content authors to configure link tracking for a component. The configuration of the component overrides the link tracking configuration of the framework.

When a page is associated with a framework that enables ad-hoc link tracking, the Text component includes properties for configuring link tracking.

Enabling Ad-hoc link tracking

Configure your SiteCatalyst framework to enable ad-hoc link tracking. On pages that are associated with the framework, Text components enable you to configure link tracking for URLs.

  1. Open the SiteCatalyst framework and expand the Link Tracking Configuration section.

  2. Select Ad-hoc Link Tracking.

    Примечание.

    Not all user types have access to this checkbox. Contact your site administrator if you need access.

Примечание.

The XSS Antisamy configuration is now in SLING under path /libs/sling/xss.config.xml and the following rules need to be added to for ad-hoc linking to work:

Anchor tag rule extension

<attribute name="onclick">
    <literal-list>
        <literal value="CQ_Analytics.Sitecatalyst.customTrack(this)"/>
    </literal-list>
</attribute>
<attribute name="adhocenable">
    <literal-list>
        <literal value="true"/>
        <literal value="false"/>
    </literal-list>
</attribute>
<attribute name="adhocevents">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>
<attribute name="adhocevars">
    <regexp-list>
        <regexp name="anything"/>
    </regexp-list>
</attribute>

Configuring Link Tracking Using the Text Component

Configure link tracking for the links in Text components. Ad-hoc link tracking enables you to track download links, external links, and event and variables data. Ad-hoc link tracking overrides the link-tracking configuration of the framework that is associated with the page to which you add the Text component.

Before you can configure ad-hoc link tracking, the following configurations must have already been implemented:

  • The SiteCatalyst framework is configured to enable ad-hoc link tracking.
  • The page that contains the Text component is associated with the framework.

Use the following procedure to confiure link tracking for a Text component:

  1. Open the page in edit mode and edit the Text component.

  2. Select the text that you want to use as hypertext and click the Hyperlink button.

    chlImage_1
  3. Add the target URL in the Link To box, then expand the Link Tracking area.

    chlImage_1
  4. To override the link tracking configuration of the SiteCatalyst framework and to enable link tracking for the current link, select Custom Link Tracking.

  5. (Optional) To track events with the link click, add SiteCatalyst event names in the Include SiteCatalyst Variables field. Separate multiple event name with commas, for example
    event1, event22.

  6. (Optional) To track variable data with the link click, add SiteCatalyst variables in the Include SiteCatalyst Variables field. Use either of the following formats: 

    • <Variable-name>: <Dynamic Value>
    • <Variable-name>: ‘CONSTANT’

    The following examples illustrate each format:

    • eVar10:pagedata.title
    • prop1: ‘Aubergine'

    Separate multiple values with a comma.

  7. Click OK.

Эта работа лицензируется в соответствии с лицензией Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported  На посты, размещаемые в Twitter™ и Facebook, условия Creative Commons не распространяются.

Правовые уведомления   |   Политика конфиденциальности в сети Интернет