Configuring Link Tracking for Adobe Analytics

חפש
Experience Manager 6.4 Sites מדריך למשתמש בנושא אדמיניסטרציה

בדף זה

חל על: Experience Manager 6.4 Sites

在中国购买的 Creative Cloud 产品不含 CC 桌面应用程序中的 Creative Cloud 移动应用程序和在线服务及相关功能。

אתה מציג תוכן עזרה עבור גרסה:

Capture information in Adobe Analytics 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.

Configuring Link Tracking for an Adobe Analytics Framework

  1. Using Navigation, go via Deployment, Cloud Services to the Adobe Analytics section.

  2. Using Show Configurations, open the required Adobe Analytics framework.

  3. Expand the Link Tracking Configuration section:

    AA-08

Tracking File Downloads

Configure the Adobe Analytics framework so that files downloaded from associated pages are automatically tracked as downloads in Adobe Analytics. 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

So for example, with download trackng enabled for PDF files, whenever 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 code sample represents the default download tracking configuration:

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

To enable download tracking for your Adobe Analytics framework:

  1. Open the Adobe Analytics framework and expand the Link Tracking Configuration section.
  2. Enable Track Downloads.
  3. In the Download File Types box, type the filename extensions for the types of files that you want tracked.

You can track the clicking of external links (exit links) on your pages.

To track external links for your Adobe Analytics framework:

  1. Open the Adobe Analytics framework and expand the Link Tracking Configuration section.
  2. Configure the following properties according to your requirements.

Properties for tracking when external links are clicked:

  • Track External
    Enables external link tracking.
  • External Filters
    (Optional) 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.
    To specify the external links to track, 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 (the default value of '', two single quotes) causes all external links to be tracked.
  • 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.
    To specify the internal links that are not tracked, 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.
    The default value is 'javascript:,'+window.location.hostname
  • Leave Query String
    Includes URL parameters when evaluating matches with internal and external filters.
    Enable to include URL parameters when evaluating link target URLs against external and internal 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;

Sending Variable Data with Link Clicks

You can configure AEM to send event and variable data to Adobe Analytics when a user clicks a link. The Link Tracking Configuration properties enable you to specify the Adobe Analytics events and variables to track when link clicks occur.

The framework mappings determine the event and variable values. You can map Adobe Analytics variables to the variables of your content components that store the data you want tracked when links are clicked.  

To send variable data with link clicks:

  1. Open the Adobe Analytics framework and expand the Link Tracking Configuration section.
  2. Configure the following properties according to your requirements.

Properties for sending variable data with link clicks:

  • Link Track Events
    Enter the Adobe Analytics 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.
  • Link Track Vars
    Enter the Adobe Analytics variables that you want to send to Adobe Analytics when links are clicked. Separate multiple variable names with a comma.
    The default value of None causes no variable data to be sent.

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';

Example Link Tracking Configuration

Perform the following procedures to explore the link tracking behavior of the Adobe Analytics 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-adobe-analytics-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
    		 Adobe Analytics 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
    		 Adobe Analytics 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:

linkexternal1

הערה:

The URL does not contain the Query string: ?p=this

Include the URL parameter

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

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

linkexternal2

הערה:

This time the URL does contain the Query string: ?p=this

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:

linkexternal3

Ad-Hoc Link Tracking

Ad-hoc link tracking allows content authors to configure link tracking for a component. The configuration of the component overrides the Link Tracking Configuration of the framework, so on pages that are associated with the framework, Text components can be configured for link tracking of URLs.

Ad-hoc link tracking enables you to track download links, external links, together with event and variables data.  

To enable ad-hoc link tracking you need to:

Enabling Ad-hoc Link Tracking

Configure your Adobe Analytics framework to enable ad-hoc link tracking.

  1. Open the Adobe Analytics framework and expand the Link Tracking Configuration section.

  2. Enable 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 for a Text Component

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

Use the following procedure to configure 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. Enable Custom Link Tracking to override the link tracking configuration of the Adobe Analytics framework and to enable link tracking for the current link.

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

  6. (Optional) To track variable data with the link click, add Adobe Analytics variables in the Include Adobe Analytics 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. Select OK.

עבודה זו בוצעה ברישיון של Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  הודעות המתפרסמות ב- Twitter™‎ ו- Facebook אינן מכוסות בתנאי Creative Commons.

הצהרות משפטיות   |   מדיניות פרטיות מקוונת