集成

使用Adobe Analytics跟踪已单击的组件

注意

Adobe Experience Platform Launch已更名为Adobe Experience Platform中的一套数据收集技术。因此，在整个产品文档中推出了几项术语更改。请参阅以下内容文档，以了解术语更改的综合参考。

使用事件驱动使用AEM核心组件Adobe客户端数据层跟踪Adobe Experience Manager网站上特定组件的单击次数。了解如何使用tag属性中的规则来侦听点击事件、按组件过滤并将数据发送到具有跟踪链接信标的Adobe Analytics。

您即将构建的内容

WKND营销团队有兴趣了解 Call to Action (CTA) 按钮在主页上表现最佳。在本教程中，我们将一个规则添加到用于侦听 cmp:click 事件来源 Teaser 和按钮组件。然后，将组件ID和新的事件与跟踪链接信标一起发送到Adobe Analytics。

您将生成的跟踪点击量

目标

在标记属性中创建一个事件驱动规则，以捕获 cmp:click 事件。
按组件资源类型筛选不同的事件。
设置组件ID并使用跟踪链接信标将事件发送到Adobe Analytics。

前提条件

本教程是对使用Adobe Analytics收集页面数据并假设您具有：

A 标记属性 使用 Adobe Analytics扩展已启用
Adobe Analytics 测试/开发报表包ID和跟踪服务器。请参阅以下文档，了解创建报表包.
Experience Platform调试器浏览器扩展配置了您的标记属性，该属性加载在 WKND站点或启用了Adobe数据层的AEM站点。

Inspect按钮和Teaser架构

在标记属性中创建规则之前，复查按钮和Teaser的架构并在数据层实施中检查它们。

导航到 WKND主页
打开浏览器的开发人员工具并导航到 控制台. 运行以下命令：
```
adobeDataLayer.getState();
```
上述代码返回Adobe客户端数据层的当前状态。

展开响应并查找带有前缀的条目 button- 和 teaser-xyz-cta 登入。您应会看到类似以下的数据架构：

按钮架构：

button-2e6d32893a:
    @type: "wknd/components/button"
    dc:title: "View All"
    parentId: "page-2eee4f8914"
    repo:modifyDate: "2020-07-11T22:17:55Z"
    xdm:linkURL: "/content/wknd/us/en/magazine.html"

Teaser架构：

teaser-da32481ec8-cta-adf3c09db9:
    @type: "wknd/components/teaser/cta"
    dc:title: "Surf's Up"
    parentId: "teaser-da32481ec8"
    xdm:linkURL: "/content/wknd/us/en/magazine/san-diego-surf.html"

上述数据详情是基于组件/容器项目架构. 新标记规则将使用此架构。

创建CTA点击规则

Adobe客户端数据层是事件驱动数据层。无论何时单击任何核心组件 cmp:click 事件通过data layer调度。要聆听 cmp:click 事件，让我们创建一个规则。

导航到Experience Platform并进入与AEM站点集成的tag属性。
导航到规则部分，然后单击 添加规则.
命名规则 已单击CTA.
单击事件 > 添加以打开 事件配置 向导。
对象 事件类型 字段，选择 自定义代码.

单击 打开编辑器 在主面板中，输入以下代码片段：

var componentClickedHandler = function(evt) {
   // defensive coding to avoid a null pointer exception
   if(evt.hasOwnProperty("eventInfo") && evt.eventInfo.hasOwnProperty("path")) {
      //trigger Tag Rule and pass event
      console.debug("cmp:click event: " + evt.eventInfo.path);
      var event = {
         //include the path of the component that triggered the event
         path: evt.eventInfo.path,
         //get the state of the component that triggered the event
         component: window.adobeDataLayer.getState(evt.eventInfo.path)
      };

      //Trigger the Tag Rule, passing in the new `event` object
      // the `event` obj can now be referenced by the reserved name `event` by other Tag Property data elements
      // i.e `event.component['someKey']`
      trigger(event);
   }
}

//set the namespace to avoid a potential race condition
window.adobeDataLayer = window.adobeDataLayer || [];
//push the event listener for cmp:click into the data layer
window.adobeDataLayer.push(function (dl) {
   //add event listener for `cmp:click` and callback to the `componentClickedHandler` function
   dl.addEventListener("cmp:click", componentClickedHandler);
});

上述代码片段通过以下方式添加事件侦听器推送函数到数据层中。每当 cmp:click 事件触发于 componentClickedHandler 调用函数。在此函数中，添加了一些健全性检查和一个新的 event 对象使用最新构建数据层的状态用于触发事件的组件。

最后 trigger(event) 调用函数。此 trigger() 函数是标记属性中的保留名称，它 触发器 规则。此 event 对象作为参数传递，该参数随后被标记属性中的另一个保留名称公开。标记属性中的数据元素现在可以使用代码段（如）引用各种属性 event.component['someKey'].

保存更改。
下一下操作点击添加以打开 操作配置 向导。
对象 操作类型 字段，选择 自定义代码.
单击 打开编辑器 在主面板中，输入以下代码片段：
```
console.debug("Component Clicked");
console.debug("Component Path: " + event.path);
console.debug("Component type: " + event.component['@type']);
console.debug("Component text: " + event.component['dc:title']);
```
此 event 对象传递自 trigger() 在自定义事件中调用的方法。此 component object是从数据层派生的组件的当前状态 getState() 方法，是触发点击的元素。
保存更改并运行生成标记属性中的代码，以将代码提升到环境在您的AEM网站上使用。

注意

使用 Adobe Experience Platform调试器将嵌入代码切换为开发环境。
导航到 WKND站点并打开开发人员工具以查看控制台。此外，选择 保留日志 复选框。
单击其中一项 Teaser 或按钮 CTA按钮导航到其他页面。
在开发人员控制台中观察 已单击CTA 规则已触发：

创建数据元素

接下来，创建一个数据元素以捕获已单击的组件ID和标题。调回上一个练习中的输出 event.path 类似于 component.button-b6562c963d 和的值 event.component['dc:title'] 就象是“观光旅行”。

组件Id

导航到Experience Platform并进入与AEM站点集成的tag属性。
导航到 数据元素 部分并单击 添加新数据元素.
对象名称字段，输入 组件Id.
对象 数据元素类型 字段，选择 自定义代码.

单击 打开编辑器 按钮，并在自定义代码编辑器中输入以下内容：

if(event && event.path && event.path.includes('.')) {
    // split on the `.` to return just the component ID
    return event.path.split('.')[1];
}

保存更改。

注意

请记住 event 对象将变得可用，并根据触发该对象的规则标记属性中的。直到数据元素为 已引用 在规则中。因此，在规则内使用此数据元素是安全的，例如 页面已加载 在上一步中创建的规则但是在其他环境中使用是不安全的。

组件标题

导航到 数据元素 部分并单击 添加新数据元素.
对象名称字段，输入 组件标题.
对象 数据元素类型 字段，选择 自定义代码.

单击 打开编辑器 按钮，并在自定义代码编辑器中输入以下内容：

if(event && event.component && event.component.hasOwnProperty('dc:title')) {
    return event.component['dc:title'];
}

保存更改。

向CTA点击规则添加条件

接下来，更新 已单击CTA 规则来确保规则仅在 cmp:click 事件触发于 Teaser 或按钮. 由于Teaser的CTA被视为Data Layer中的单独对象，因此检查父对象以验证它是否来自Teaser非常重要。

在标记属性UI中，导航到 已单击CTA 之前创建的规则。
下条件点击添加以打开 条件配置 向导。
对象 完成情况类型 字段，选择 自定义代码.

单击 打开编辑器 并在自定义代码编辑器中输入以下内容：

if(event && event.component && event.component.hasOwnProperty('@type')) {
    // console.log("Event Type: " + event.component['@type']);
    //Check for Button Type OR Teaser CTA type
    if(event.component['@type'] === 'wknd/components/button' ||
       event.component['@type'] === 'wknd/components/teaser/cta') {
        return true;
    }
}

// none of the conditions are met, return false
return false;

上述代码首先检查资源类型是否来自按钮或者，资源类型是否来自内的CTA Teaser.

保存更改。

设置Analytics变量并触发跟踪链接信标

目前 已单击CTA 规则仅输出控制台语句。接下来，使用数据元素和Analytics扩展将Analytics变量设置为操作. 我们还要设置一个额外操作来触发 跟踪链接 并将收集的数据发送到Adobe Analytics。

在 已单击CTA 规则，移除此 核心 — 自定义代码 操作（控制台语句）：
在“操作”下，单击添加以创建操作。
设置扩展键入到 Adobe Analytics 并设置 操作类型 到 设置变量.
设置以下值 eVar， Prop、和事件：
- evar8 - %Component ID%
- prop8 - %Component ID%
- event8
注意

此处 %Component ID% 使用，因为它确保所点击的CTA的唯一标识符。使用可能带来的负面影响 %Component ID% Analytics报表包含的值包括 button-2e6d32893a. 使用 %Component Title% 会提供一个更加人性化的名称，但值可能不是唯一的。
接下来，在右边添加一个额外的“操作” Adobe Analytics — 设置变量 点按加图标：
设置扩展键入到 Adobe Analytics 并设置 操作类型 到 发送信标.
下跟踪将单选按钮设置为 s.tl().
对象 链接类型 字段，选择 自定义链接 和 链接名称 将该值设置为： %Component Title%: CTA Clicked：

上述配置组合了数据元素中的动态变量 组件标题 和静态字符串 已单击CTA.
保存更改。此 已单击CTA 规则现在应具有以下配置：
- 1. 聆听 cmp:click 事件。
- 2. 检查事件是否由触发按钮或 Teaser.
- 3. 设置Analytics变量以跟踪 组件Id 作为 eVar， prop，和事件.
- 4. 发送Analytics跟踪链接信标(并非将其视为页面查看)。
保存所有更改并构建标记库，提升到适当的环境。

验证跟踪链接信标和Analytics调用

现在， 已单击CTA 规则将发送Analytics信标，您应该能够使用Experience Platform调试器查看Analytics跟踪变量。

打开 WKND站点在浏览器中。
单击“调试器”图标以打开Experience PlatformDebugger。
确保Debugger将标记属性映射到您的开发环境，如前面和 控制台日志记录 已选中。
打开Analytics菜单，并确认已将报表包设置为您的报表包。
在浏览器中，单击 Teaser 或按钮 CTA按钮导航到其他页面。
返回到Experience Platform调试器，然后向下滚动并展开 网络请求 > 您的报表包. 您应该能够找到 eVar， prop、和事件设置。
返回浏览器并打开开发人员控制台。导航到站点的页脚，然后单击其中一个导航链接：
在浏览器控制台中观察此消息 未满足规则“CTA已单击”的“自定义代码”.

出现上述消息是因为导航组件确实触发了 cmp:click 事件但是因为规则的条件检查资源类型，但不执行任何操作。

注意

如果您没有看到任何控制台日志，请确保 控制台日志记录 已检查 Experience Platform标记 在Experience PlatformDebugger中。