社区功能的Analytics配置

概述

Adobe Analytics和Adobe Experience Manager(AEM)都是Adobe Marketing Cloud的解决方案。

可以为AEM Communities配置Adobe Analytics，以便成员与支持的社区功能交互时，事件会从中发送到生成报表的Adobe Analytics。

例如，当启用社区网站的成员查看分配给他们的视频资源时，资源播放器会将事件（包括视频心率数据）发送到Analytics。 从社区站点，管理员可以查看有关视频播放的各种报表。

此外，对于以下情况，需要进行分析：

• 在发布环境中：

  • 报告社区趋势
  • 允许网站访客按“查看次数最多”、“最活跃”、“最喜欢”进行排序
  • 查看UGC列表中的计数

• 在创作环境中：

  • 在成员管理控制台中显示参与数据（视图、帖子、关注、称赞）
  • 用于启用资源报表的趋势摘要、视频心率和视频设备

支持的社区功能包括：

• 支持资源
• 论坛
• 问题与解答
• 博客
• 文件库
• 日历

文档的此部分介绍如何将Analytics报表包与社区功能连接起来。 基本步骤包括：

1. 复制加密密 钥以确保在所有AEM实例上正确进行加密/解密
2. 准备Adobe Analytics 报表包
3. 创建AEM Analytics 云服务和框架
4. 为社 区站点启用Analytics
5. 🔗 验证Analytics到AEM变量的映射
6. 识别主发布者
7. 🔗 发布社区网站
8. 配置将报表数据从Adobe Analytics导入社区站点

前提条件

要配置Analytics for Communities功能，需要与您的客户代表合作来设置Adobe Analytics帐户和报表包。 建立后，应提供以下信息：

• 公司名称

  与Adobe Analytics帐户关联的公司

• 用户名

  有权管理Analytics帐户的用户的登录用户名

  （应包括Web服务访问权限）

• 密码

  授权用户的登录密码

• Analytics数据中心

  帐户的Analytics数据中心URL

• 报表包

  要使用的Analytics报表包的名称

Adobe Analytics用于视频报告的报表包

使用Adobe Marketing Cloud的报表包管理器，可以配置Analytics报表包，以便社区站点能够提供社区功能的报表。

通过使用公司名称和用户名登录到Adobe Marketing Cloud，可以将新的或现有的报表包配置为：

• 11转化变量 (evar)

  • evar1 通过启 evar11 用
  • 可以重新调整（重命名）现有evar的用途或创建新evar以用于“社区”功能

• 7个成功事件 （事件）

  • event1 通过启 event7 用

  • 类型 Counter

    • 否 Counter (no subrelations)

  • 可以重新调整（重命名）现有事件的用途或创建新事件以用于“社区”功能

• 视频管理

  • 视频报告控制台

    • 启用 Video Core
    • 选择保存

  • 视频核心测量控制台

    • 选择 Use Solution Variables
    • 选择保存

如果使用​新报表包，请注意，新报表包可能只有4个evar和6个事件变量，而社区则需要11个evar和7个事件变量。

如果使用​现有报表包，则在为社区站点激活Analytics框架之前，可能需要修改变量映射。 有关专用于社区的变量的任何问题，请联系您的客户代表。

视频心率分析

在获得视频心率分析的许可后，将分配一个Marketing Cloud Org Id。

要在配置Analytics报表包以进行视频报告后启用视频心率报告，请执行以下操作：

• 创建Analytics云服务
• 为社区站点启用Analytics
• 将Marketing Cloud Org Id与社区站点关联

Marketing Cloud Org Id可在社区站点创建或更高版本时通过修改社区站点属性输入。🔗

启用视频心率分析后，视频播放器的Javascript(JS)代码会实例化视频心率库代码（同样位于JS中），该代码会处理每10秒向Analytics视频跟踪服务器发送视频状态更新的所有逻辑（不可配置），并最终将视频会话的累积报表发送到主Analytics服务器。

如果未启用，则从不实例化视频心率代码，并且只会将视频进度和恢复位置跟踪保留到SRP以进行报告。

AEM Analytics Cloud服务配置

要使用创作实例上的标准UI创建新的Analytics集成，该集成将Adobe Analytics与AEM社区站点集成：

• 从全局导航：工具>部署>Cloud Services
• 向下滚动到​Adobe Analytics
• 选择​Configure Now​或​Show Configurations

创建配置对话框

• 选择​可用配置​旁边的[+]图标以创建新配置

在创建配置对话框中，要输入的值标识配置。

• 标题

  （必需）配置的显示标题。

  例如，输入​Enablement Community Analytics

• 名称

  （可选）如果未指定，则名称将默认为从标题派生的有效节点名称。

  例如，输入​communities

• 模板

  选择 Adobe Analytics Configuration

• 选择​创建

  • 启动配置页面并打开Analytics Settings对话框

Analytics设置对话框

初始创建新Analytics配置时，会显示配置并显示一个用于输入Analytics设置的新对话框。 此对话框要求从客户代表处获得先决条件帐户信息。

• 公司

  与Adobe Analytics帐户关联的公司

• 用户名

  有权管理Analytics帐户的用户的登录用户名

• 密码

  授权用户的登录密码

• 数据中心

  选择托管报表包的Analytics数据中心

• 不将跟踪标记添加到页面

  保留为默认值（未选中）

• 使用 AppMeasurement

  保留为默认值（未选中）

• 夜间不导入页面展示（创作）

  保留为默认值（未选中）

• 夜间不导入页面展示（发布）

  保留为默认值（选中）

要保存设置，请执行以下操作：

• 选择​连接到Analytics

  • 如果不成功，

    • 验证条目不包含前导空格
    • 尝试使用其他数据中心
    • 请联系您的客服专员

• 选择​OK

创建框架

成功配置与Adobe Analytics的基本连接后，需要为社区站点创建或编辑框架。 该框架的用途是将社区功能(AEM)变量映射到Analytics（报表包）变量。

• 选择​可用框架​旁边的[+]图标以创建新框架

• 标题

  （必需）框架的显示标题

  例如，输入​Enablement Community Framework

• 名称

  （可选）如果未指定，则名称将默认为从标题派生的有效节点名称。

  例如，输入​communities

• 模板

  选择 Adobe Analytics Framework

• 选择​创建

创建Analytics框架会打开配置框架。

AEM Analytics框架配置

该框架的用途是将AEM变量映射到Analytics变量（evar和事件）。 可用于映射的Analytics变量在报表包🔗中定义。

选择报表包

选择为视频报告设置的报表包。

如果尚未创建或未正确设置报表包，请参阅上一部分：
Adobe Analytics用于视频报告的报表包

无需使用Sidekick，并且可以将其最小化，以便它不会妨碍对报表包设置的访问。

“报表包”对话框中的“添加项目”

1. 选择​添加项目+​将显示两个下拉框
2. 选择Report suite与公司帐户关联的报表包应可供选择
3. 在打开的对话框中选择​Yes:Load default server settings? Do you want to load the default server settings and overwrite current values in the Server section?
4. 选择Run Mode
   选择​publish

Analytics云服务和框架现已完成。 在启用此Analytics服务的情况下创建社区站点后，将定义映射。

为社区站点启用Analytics

为新社区站点启用

在创建新社区站点时添加Analytics云服务：

• 在步骤3中

• 在ANALYTICS选项卡下：

  • 选中​启用Analytics​复选框
  • 从下拉框中选择框架

• （可选）返回到Analytics框架配置以调整变量映射。

为现有社区站点启用

要将Analytics云服务添加到现有社区站点，请执行以下操作：

• 导航到​Communities > Sites​控制台

• 选择社区站点的编辑站点图标

• 选择设置

• 在Analytics部分中：

  • 选中​启用Analytics​复选框
  • 从下拉框中选择框架

• （可选）返回到Analytics框架配置以调整变量映射。

为自定义网站启用

为了使Analytics跟踪和导入对社区站点正常工作，必须存在具有scf-js-site-title类和href属性的页面元素。 页面上只应存在一个此类元素，例如，在未修改的sitepage.hbs社区站点脚本中，应仅存在此类元素。 将提取siteUrl的值，并将其作为​站点路径​发送到Adobe Analytics。

# present in default sitepage.hbs
# only one scf-js-site-title class should be included
# this example sets it to be hidden as it serves no visual purpose
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

对于覆盖sitepage.hbs脚本的​自定义社区站点，请确保元素存在。 siteUrl变量在提供给客户端之前在服务器上呈现时进行设置。

对于包含Communities组件的​通用AEM站点，但未使用站点创建向导创建，则需要添加该元素。 href的值应该是网站的路径。 例如，如果站点路径为/content/my/company/en，则使用：

<div
    class="navbar-brand scf-js-site-title"
    href="/content/my/company/en.html"
    style="visibility: hidden;"
>
</div>

Analytics for Communities功能

Analytics会自动用于多个社区功能。

创作环境的OSGi配置、AEM Communities Analytics Component Configuration提供了已用于Analytics的组件列表。 变量的自动映射由列出的组件决定。

如果创建了用于Analytics的新自定义组件，则应将这些组件添加到此已配置组件列表。

组件配置

注意：journal组件用于实施博客功能。

将Analytics映射到AEM变量

在启用Analytics并选择云配置框架后保存社区网站，AEM变量将自动映射到以evar1和event1开始的Analytics evar和事件，并增加1。

如果使用现有的报表包来映射evar1到evar11以及event1到event7中的任何变量，则需要重新映射AEM变量并恢复原始映射。

以下是入门教程之后的默认映射示例：

随每个事件一起发送的eVar映射

eVar值示例：

• MIME类型:video/mp4
• 社区站点标题:Geometrixx社区
• 社区函数名称:论坛
• 社区组名称:远足
• 社区组内容的路径：/content/sites/communities/en/groups/hiking
• UGC组件resourceType:social/forum/components/hbs/topic
• UGC组件标题：徒步主题
• 登录（可授权Id）：aaron.mcdonald@mailinator.com
• UGC的SRP路径：/content/usergenerated/asi/…/forum/jmtz-topic3或​组件路径的后续路径:/content/sites/communities/en/jcr:content/content/primary/forum
• 社区站点内容的路径：/content/sites/community/en

修改Analytics变量映射

为社区站点启用Analytics后，框架配置中会显示Analytics evar和事件到AEM变量的映射。

启用Analytics后且发布社区网站之前，可以在框架中更改映射，方法是从左边栏中拖动所需的Analytics evar或事件，并将其拖放到映射表的相关行中。

要避免出现重复映射，请务必从行中删除替换的Analytics evar或事件，方法是将鼠标悬停在该evar上，然后选择Analytics变量元素右侧显示的“X”。

如果社区eVar和事件覆盖报表包中预先存在的映射，则为避免数据丢失，请将社区功能的AEM变量分配给其他Analytics evar和/或事件，并恢复原始映射。

示例步骤1:将Analytics evar14拖入映射表

示例步骤2:选择“x”以删除替换的evar11

示例步骤3:AEM var eventdata.siteId已重新映射到Analytics evar14

发布社区网站

验证Analytics到AEM变量的映射

明智的做法是，在发布社区网站（该网站也发布Analytics云服务和框架）之前验证变量映射。

请参阅以下章节：

• 将Analytics映射到AEM变量
• 修改Analytics变量映射

主发布者

如果选择的部署是publish farm，则必须将一个AEM发布实例标识为轮询Adobe Analytics以将报表数据写入SRP的主发布者。

默认情况下，AEM Communities Publisher Configuration OSGi配置将其发布实例标识为主发布者，这样发布场中的所有发布实例都将自标识为主发布者。

因此，必须编辑所有辅助发布实例上的配置以取消选中​主发布者​复选框。

有关具体说明，请参阅Deploying Communities中的主发布者部分。

复制加密密钥

Adobe Analytics凭据已加密。 为便于作者和发布者之间复制或传输加密的AEM凭据，所有Analytics实例必须共享相同的主加密密钥。

为此，请按照复制加密密钥中的说明操作。

发布社区站点和Analytics Cloud服务

为社区站点启用Analytics云服务后，并且（如有必要）调整了将Analytics映射到AEM变量的操作，接下来需要通过(re)发布社区站点将配置复制到发布环境。

从Analytics获取报表

报表管理

作者和主发布者的OSGi配置 AEM Communities Analytics Report Management用于查询Analytics。

作者可查询实时报表。

在主发布者上，查询用于提供信息以准备报表导入器的分析数据导入。

查询间隔默认为10秒。

报表导入器

在发布启用了Analytics的社区站点后，可以将主发布者的OSGi配置(AEM Communities Analytics Report Importer)配置为为那些未在CRXDE中单独配置的配置设置默认轮询间隔。

轮询间隔控制向Adobe Analytics请求数据提取并保存到SRP的频率。

当数据可能被分类为“大数据”时，更频繁的轮询可能会给社区站点带来很大负载。

默认轮询​Import interval​设置为12小时。

组件报表自定义

目前，为了自定义要跟踪的量度，在存储库中创建节点，定义要为其生成该量度报表的时间段。

论坛主题目前是此自定义的唯一示例：

• 在主发布者上

• 使用管理权限登录

• 导航到CRXDE Lite

  • 例如， http://localhost:4503/crx/de

• 语言根的jcr:content节点下

  • 例如，/content/sites/engage/en/jcr:content

• 导航到为Analytics报表配置的组件

  • 例如，analytics/reportConfigs/social_forum_components_hbs_topic

• 请注意创建的时间段

  • last30Days
  • last90Days
  • thisYear

• 请注意total节点

  • 修改interval属性将覆盖报表导入器的间隔
  • 该值以秒为单位，设置为4小时(14400秒)

在Analytics中管理用户数据

Adobe Analytics提供了用于访问、导出和删除用户数据的API。 有关更多信息，请参阅提交访问和删除请求。

资源

• Adobe Marketing Cloud:Analytics帮助和引用
• AEM:与Adobe Analytics集成
• AEM:具有外部提供程序的Analytics