文档AEM 6.5用户指南

为Adobe Analytics配置链接跟踪 configuring-link-tracking-for-adobe-analytics

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

当用户单击网站页面上的链接时，您可以在Adobe Analytics中捕获相关信息。 例如，使用链接跟踪功能了解用户如何与您的网站进行交互、跟踪文件下载以及跟踪退出链接。

  1. 使用​ 导航，通过​ 部署，Cloud Service ​转到​ Adobe Analytics ​部分。

  2. 使用​ 显示配置，打开所需的Adobe Analytics框架。

  3. 展开​ 链接跟踪配置 ​部分并根据需要进行配置（此页面提供了更多详细信息）：

    分析框架

跟踪文件下载 tracking-file-downloads

配置Adobe Analytics Framework，以便在Adobe Analytics中将从关联页面下载的文件自动作为下载内容进行跟踪。 启用下载跟踪后，将仅跟踪您指定的文件类型。

默认情况下，将跟踪以下文件类型的下载：

  • exe
  • zip
  • wav
  • mp3
  • mov
  • mpg
  • avi
  • wmv
  • 文档
  • pdf
  • xls

例如，为PDF文件启用下载跟踪后，每当用户单击指向PDF文件的链接时，就会跟踪PDF的下载。

框架的下载跟踪属性作为针对页面生成的analytics.sitecatalyst.js文件中的代码实施。 以下代码示例表示默认的下载跟踪配置：

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

要为Adobe Analytics框架启用下载跟踪，请执行以下操作：

  1. 打开Adobe Analytics框架并展开“链接跟踪配置”部分。
  2. 启用​ 跟踪下载。
  3. 在​ 下载文件类型 ​框中，键入要跟踪的文件类型的文件扩展名。

您可以跟踪页面上的外部链接（退出链接）点击次数。

要跟踪Adobe Analytics框架的外部链接，请执行以下操作：

  1. 打开Adobe Analytics框架并展开​ 链接跟踪配置 ​部分。
  2. 根据您的要求配置以下属性。

单击外部链接时跟踪的属性：

  • 跟踪外部
    启用外部链接跟踪。

  • 外部筛选器
    （可选）定义过滤器以匹配链接目标的外部URL。 当链接目标与过滤器匹配时，将跟踪该链接。 外部过滤器仅可用于跟踪页面上的某些外部链接。

    要指定要跟踪的外部链接，请键入链接目标的全部或部分URL。 用逗号分隔多个过滤器。 将字符串文字括在单引号中。 没有值（默认值为''，两个单引号）会导致跟踪所有外部链接。

  • 内部筛选器
    定义用于匹配内部链接URL的过滤器。 当链接定向与此过滤器匹配的URL时，不会跟踪该链接。 默认值是一个javascript命令，该命令返回当前窗口地址的URL的主机名。

    要指定未跟踪的内部链接，请键入链接目标的全部或部分内部URL。 用逗号分隔多个过滤器。 将字符串文字括在单引号中。

    默认值为'javascript:,'+window.location.hostname

  • 保留查询字符串
    在计算与内部和外部过滤器的匹配项时包含URL参数。

    如果要在根据外部和内部过滤器评估链接目标URL时包含URL参数，请启用。

外部链接跟踪属性作为为页面生成的analytics.sitecatalyst.js文件中的代码实施。 为与通过以下配置启用外部链接跟踪的框架关联的页面生成以下示例代码：

  • 外部筛选器为'google.com'
  • 内部筛选器是默认值'javascript:,'+window.location.hostname
  • 根据过滤器评估链接目标时不包括查询字符串。
s.trackExternalLinks= false;
s.linkExternalFilters= 'google.com';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.linkLeaveQueryString= false;

您可以将AEM配置为当用户单击链接时，将事件和变量数据发送到Adobe Analytics。 通过​ 链接跟踪配置 ​属性，可指定要在发生链接点击时跟踪的Adobe Analytics事件和变量。

框架映射确定事件和变量值。 您可以将Adobe Analytics变量映射到内容组件的变量，这些变量存储着您希望在单击链接时跟踪的数据。

要通过链接点击发送变量数据：

  1. 打开Adobe Analytics框架并展开“链接跟踪配置”部分。
  2. 根据您的要求配置以下属性。

通过链接点击发送变量数据的属性：

  • 链接跟踪事件
    输入要用于对链接点击次数进行计数的Adobe Analytics事件变量。

    用逗号分隔多个变量名称。

    默认值None导致无事件跟踪。

  • 链接跟踪变量
    输入您希望在单击链接时发送到Adobe Analytics的Adobe Analytics变量。 用逗号分隔多个变量名称。

    默认值None导致不发送任何变量数据。

在指定要发送的事件和变量时，该配置将作为为页面生成的analytics.sitecatalyst.js文件中的代码实施。 当框架跟踪event10事件和prop4属性时，为页面生成以下示例代码：

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

执行以下过程以探索Adobe Analytics集成的链接跟踪行为。 过程显示来自Adobe Marketing Cloud Debugger的结果。

常规配置 general-configuration

此示例说明了映射在跟踪和调试器上下文中如何工作：

  1. 打开与网页关联的框架。

  2. 将​ Page ​组件拖动到框架的映射区域。 页面 ​组件属于Sidekick中的​ 常规 ​组件组。

    note note
    NOTE
    应在现实场景中使用的组件取决于继承自的组件（如果有的话）。
    如果您不该在其中公开自己的组件（通过在其页面组件中定义Analytics子节点），

    通过从左侧面板拖动Analytics(SiteCatalyst)变量，根据下表配置映射：

CQ变量
变量浏览器
中的条目
Adobe Analytics变量
pagedata.title
自定义eVar1 (eVar1)
EVAR1
eventdata.events.pageView
自定义1(event1)
event1
  1. 将搜索组件拖动到框架的映射区域。 搜索组件属于Sidekick中的常规组件组。 通过从左侧面板拖动Analytics(SiteCatalyst)变量，根据下表配置映射：
CQ变量
变量浏览器中的条目
Adobe Analytics变量
eventdata.keyword
自定义eVar2 (eVar2)
EVAR2
eventdata.results
自定义eVar3 (eVar3)
EVAR3
eventdata.events.search
自定义2(event2)
event2

  1. 在框架中，展开​ 链接跟踪配置 ​区域。

  2. 取消选择​ 跟踪下载。

  3. 选择​ 跟踪外部。

  4. 取消选择​ 保留查询字符串。

  5. 对​ 外部筛选器 ​列表使用以下值将其标识为外部URL：

    'yahoo.com'

  6. 将以下值添加到​ 链接跟踪事件 ​字段：

    code language-none 
        event1,event2

  7. 将以下值添加到​ 链接跟踪vars ​字段：

    code language-none 
        eVar1,eVar2

  8. 在与框架关联的页面上，添加​ Text ​组件。 在​ Text ​组件内，添加指向以下地址的超链接：

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

  9. 切换到​ 预览模式 ​并单击链接。

使用Adobe Marketing Cloud Debugger查看时，发出的调用将如下所示：

Adobe Marketing Cloud Debugger

NOTE
URL不包含查询字符串： ?p=this

包含URL参数 include-the-url-parameter

  1. 在框架中，展开​ 链接跟踪配置 ​区域。
  2. 启用​ 保留查询字符串。
  3. 重新加载页面预览，然后单击链接。

Adobe Marketing Cloud Debugger中显示的调用详细信息类似于以下示例：

再次Adobe Marketing Cloud Debugger

NOTE
这次URL包含查询字符串： ?p=this

通过随机链接跟踪，内容作者可以为组件配置链接跟踪。 组件的配置将覆盖框架的​ 链接跟踪配置，因此在与框架关联的页面上，可以配置​ 文本 ​组件以进行URL的链接跟踪。

通过随机链接跟踪，您可以跟踪下载链接、外部链接以及事件和变量数据。

要启用随机链接跟踪，您需要：

配置Adobe Analytics框架以启用临时链接跟踪。

  1. 打开Adobe Analytics框架并展开​ 链接跟踪配置 ​部分。

  2. 启用​ 个人链接跟踪。

    note note
    NOTE
    并非所有用户类型都可以访问此复选框。 如果您需要访问权限，请联系您的站点管理员。
NOTE
XSS Antisamy配置现在位于路径​**/libs/sling/xss.config.xml**​下的SLING中，并且需要将以下规则添加到临时以便关联正常工作：

锚点标记规则扩展 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

在为​ Text ​组件本身配置随机链接跟踪之前，必须已经实施了以下配置：

使用以下过程配置​ Text ​组件的链接跟踪：

  1. 在编辑模式下打开页面并编辑​ 文本 ​组件。

  2. 选择要用作超文本的文本，然后单击“超链接”按钮。

    链接图标

  3. 在链接至框中添加目标URL，然后展开链接跟踪区域。

    note note
    NOTE
    自定义链接跟踪作为单独的操作显示，位于链接/取消链接操作（Analytics图标）旁边。
    仅当您在RTE中选择了有效的链接时，才会启用它。

    正在启用链接跟踪

  4. 启用​ 自定义链接跟踪 ​以覆盖Adobe Analytics Framework的链接跟踪配置，并为当前链接启用链接跟踪。

  5. （可选）要跟踪点击链接的事件，请在​ 包含Adobe Analytics变量 ​字段中添加Adobe Analytics事件名称。 用逗号分隔多个事件名称，例如

    event1, event22。

  6. （可选）要通过单击链接跟踪变量数据，请在​ 包含Adobe Analytics变量 ​字段中添加Adobe Analytics变量。 使用以下任一格式：

    • <Variable-name>：<Dynamic Value>
    • <Variable-name>：'CONSTANT'

    以下示例说明了每种格式：

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

    用逗号分隔多个值。

  7. 选择​ 确定。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2