文档Experience Platform标记

AEM资产分析扩展概述

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员

这项扩展旨在与 AEM 资产洞察结合使用。更具体地说，它可以替换“pageTracker”进程和嵌入代码。当完成配置后，这项扩展会向 Adobe Analytics 发送资产“展示次数”和“单击次数”量度，随后，这些量度将导入 AEM 资产洞察报告中。​​接下来，可使用 AEM 资产洞察或 Adobe Analytics 项目工作区来报告资产量度。

扩展的先决条件

Analytics

Analytics 中的 AEM 资产报表包含三个 AEM 维度：

  • 资产 ID
  • 资源Source
  • 已单击资产

另外，还包括两个量度：

  • 资产展示次数
  • 资产单击次数。

必须以 Analytics 管理员的身份启用这些报表（依次选择 Analytics> Admin > Report Suites > <report suite> > Edit Settings > AEM >AEM Assets Reporting ），只有这样才能使用此扩展来填充这些报表。

Adobe Experience Platform的“Adobe Analytics”标记扩展必须安装到同一Web属性中。

Adobe Experience Manager (AEM)

  1. 启用 AEM 资产洞察。在 AEM 中，选择 Tools > Assets，然后打开 Insights Configuration 面板。

  2. 禁用 UUID 跟踪。

    note important
    IMPORTANT
    如果选中 AEM 资产配置设置 Disable UUID Tracking，这项扩展则​**“无法”正常运行。默认情况下，该复选框处于未选中状态。

    禁用 UUID 跟踪

配置 Adobe Experience Manager (AEM)

本部分将介绍如何使用Adobe Experience Platform中的标记配置AEM，如何在AEM中启用资产Insight，以及如何为Assets启用UUID跟踪。

将AEM与标记集成

通过Adobe I/O，完成了建议的Experience Platform与Adobe Experience Manager的集成。

  1. 使用Adobe I/O连接AEM和标记。

  2. 创建Adobe Experience Platform Cloud Service配置。

在 AEM 中启用资产洞察

有关启用资产洞察的操作说明，请参阅 Experience Manager 6.5 Assets 用户指南。

启用资产的 UUID 跟踪

通过 AEM 中资产的 UUID 来跟踪 Analytics 中的资产。

要启用资产的 UUID 跟踪功能，请打开可编辑模板的组件策略控制台，并取消选中“禁用 UUID 跟踪”属性。（默认情况下，将为 OOTB 图像组件选中此属性。）

启用 UUID 后，您应该会看到“data-asset-id”数据元素已采用资产的 UUID 进行填充。Analytics 使用 UUID 来跟踪资产的单击次数和展示次数。

扩展的用途

这项扩展包含两个事件和一项操作。

  • 已单击资产：​作为一个​事件，它的触发条件是：访客已选择某个为了跟踪而启用的 AEM 资产，且具有目标（href 属性）。

  • 已单击资产（无目标）：​作为一个​事件，它的触发条件是：访客已选择某个为了跟踪而启用的 AEM 资产，但是没有目标（无 href 属性）。

  • 设置 AA 变量：​作为一项​__​操作，它将根据使用的事件以及该事件和操作的配置方式，设置那些为 AEM Assets 保留的 Analytics 变量（上下文数据变量 a.assets.source、a.assets.idlist 和 a.asset.clickedid）。这项扩展不使用任何 Analytics 事件、prop 或 eVar。

资产展示次数

将“设置AA变量”操作添加到新的或现有的标记规则中，以便在每个页面上触发并发送Analytics图像请求。 “设置 AA 变量”操作必须显示在“Adobe Analytics - 发送信标”操作​之前。至于其他操作，可根据需要进行添加。

在 [设置 AA 变量] 配置页面中，选中 [已查看的资产]（默认）选项。该操作将会专门针对访客实际看到的资产，设置“展示次数”事件。

NOTE
尽管没有推荐，但是“设置 AA 变量”操作也支持“已加载”选项，无论访客是否看到资产，该选项都会发送页面上每个资产的资产展示次数。

展示次数

资产单击次数

通过“已单击资产”事件和“设置 AA 变量”操作，可配置第二个规则。应该配置“已单击资产”事件，以便将“已单击资产的图像请求”设置为“按页面加载”（默认）。这个规则不要求 Adobe Analytics 执行任何操作（如发送信标），因为资产 ID 将保存在 sessionStorage 中，并且由后续的展示次数规则发送。

另外，“已单击资产”事件还支持“单击时”的“已单击资产的图像请求”设置。这会将相关的单击量度立即发送至 Analytics，同时还要求执行 Analytics“发送信标”操作。

页面加载时的资产单击次数

配置第三个规则，当页面上的资产没有目标（无 href 属性）时，将触发该规则。新规则至少需要使用“已单击资产（无目标）”事件，以及“设置 AA 变量”操作和“Adobe Analytics - 发送信标”操作。至于其他条件和操作，可以根据需要进行添加。

无目标的资产单击次数

扩展测试提示

请根据上述说明，配置三项规则：

  • 资产展示次数
  • 资产单击次数
  • 无目标的资产单击次数

展示次数

  1. 导航到包含 AEM 资产的页面。

  2. 如果浏览器中没有可见的资产，请您滚动浏览，直到您至少能够看见一个资产，然后选择该资产，或者只是导航到其他页面。

  3. 查看 Analytics 图像请求。

    如果 a.assets.idlist 包含上一页可见的资产 ID，则该规则正确运行。

    如果图像请求中没有出现 a.assets.idlist，则很可能是由于以下两个原因之一：

    • 浏览器的查看区域从未出现任何资产

    • 页面上的资产均未使用 AEM 中启用的资产洞察进行配置。

单击次数

  1. 导航到包含 AEM 资产的页面。

  2. 选择其中一个资产。

在生成的 Analytics 图像请求（从下一页开始）中，如果 a.assets.idlist 在目标页面上具有资产 ID，并且 a.assets.clickedid 具有在原始页面上选择的资产的资产 ID，那么该规则可以正确运行。

如果图像请求中没有出现 a.assets.clickedid，则很可能是因为已选择资产未在 AEM 中启用资产洞察。

无目标单击次数

  1. 导航到一个页面，该页面至少包含一个没有目标（无 href 属性）的 AEM 资产。

  2. 选择该资产。

在生成的 Analytics 图像请求中，如果 a.assets.clickedid 具有资产 ID，则该规则可以正确运行。

如果图像请求中没有出现 a.assets.clickedid，则很可能是因为已选择资产未在 AEM 中启用资产洞察。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743