社区功能的分析配置

概述

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

Adobe Analytics可以为AEM Communities配置，这样，当成员与支持的Communities功能交互时，事件会发送到生成报告的Adobe Analytics。

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

此外，对于以下情况，必须进行分析：

• 在发布环境中：

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

• 在作者环境中：

  • 在成员管理控制台(视图、帖子、关注、点赞)中显示参与数据
  • 支持资源的趋势摘要、视频心率和视频设备报告

支持的社区功能包括：

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

本文档的本节介绍如何将Analytics报表包与社区功能相连。 基本步骤是：

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

前提条件

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

• 公司名称

  与Adobe Analytics帐户关联的公司

• 用户名

  已授权管理Analytics帐户的用户的登录用户名

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

• 密码

  授权用户的登录密码

• Analytics数据中心

  帐户的Analytics数据中心URL

• 报表包

  要使用的Analytics报表包的名称

Adobe Analytics Report Suite for Video报告

使用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框架之前，修改变量映射。 有关专用于Communities的变量的任何疑虑，请与您的客户代表联系。

视频心率分析

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

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

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

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

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

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

AEM Analytics Cloud服务配置

要使用创作实例上的标准UI创建将Adobe Analytics与AEM社区站点集成的新Analytics集成，请执行以下操作：

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

创建配置对话框

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

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

• 标题

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

  例如，输入​Enablement Community Analytics

• 名称

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

  例如，输入​communities

• 模板

  选择 Adobe Analytics Configuration

• 选择​创建

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

分析设置对话框

初始创建新的Analytics配置会显示配置，并显示一个新对话框以输入Analytics设置。 此对话框要求从帐户代表处获得必备帐户信息。

• 公司

  与Adobe Analytics帐户关联的公司

• 用户名

  已授权管理Analytics帐户的用户的登录用户名

• 密码

  授权用户的登录密码

• 数据中心

  选择承载报表包的Analytics数据中心

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

  保留为默认值（未选中）

• 使用 AppMeasurement

  保留为默认值（未选中）

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

  保留为默认值（未选中）

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

  保留为默认值（选中）

要保存设置：

• 选择​连接到Analytics

  • 如果不成功，

    • 验证条目中不包含前导空格
    • 尝试其他数据中心
    • 联系您的客户代表

• 选择​确定

创建框架

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

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

• 标题

  （必需）框架的显示标题

  例如，输入​Enablement Community Framework

• 名称

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

  例如，输入​communities

• 模板

  选择 Adobe Analytics Framework

• 选择​创建

创建Analytics Framework会打开要配置的框架。

AEM Analytics Framework配置

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

选择报表包

选择已设置用于视频报告的报表包。

如果尚未创建或未正确设置报表包，请参阅上一节：
Adobe Analytics Report Suite for Video报告

Sidekick不需要并且可以最小化，以便它不会妨碍访问报表包设置。

选择“添加项目”前后的“报表包”对话框

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

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

为社区站点启用分析

为新社区站点启用

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

• 步骤3

• 在ANALYTICS选项卡下：

  • 选中​[!UICONTROL 启用Analytics]​复选框
  • 从下拉框中选择框架

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

为现有社区站点启用

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

• 导航到​[!UICONTROL 社区>站点]​控制台

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

• 选择设置

• 在“分析”部分：

  • 选中​[!UICONTROL 启用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?lang=zh-Hans"
    style="visibility: hidden;"
>
</div>

社区分析功能

Analytics可自动用于多个Communities功能。

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

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

组件配置

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

将分析映射到AEM变量

在启用Analytics并选择云配置框架的情况下保存社区站点后，AEM变量将自动映射到分别从evar1和事件1开始的Analytics evar和事件，并递增1。

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

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

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

eVar值示例：

• MIME类型:video/mp4
• 社区站点标题:Geometrixx社区
• 社区函数名称:论坛
• 社区组名称:远足
• 社区组内容的路径：/content/sites/communities/cn/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/cn/jcr:content/content/primary/forum
• 社区站点内容的路径：/content/sites/community/cn

修改分析变量映射

在为社区站点启用Analytics后，可以从框架配置中看到Analytics evar和事件到AEM变量的映射。

启用Analytics后，在社区站点发布之前，可通过将所需的Analyticsevar或事件从左边栏拖放到映射表中的相关行，在框架中更改映射。

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

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

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

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

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

发布社区站点

验证Analytics到AEM变量映射

最好在发布社区网站之前验证变量映射，该网站也会发布Analytics云服务和框架。

请参阅以下部分：

• 将分析映射到AEM变量
• 修改分析变量映射

主发布者

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

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

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

有关具体说明，请参阅部署社区的主发布者部分。

复制加密密钥

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

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

发布社区站点和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中的数据的频率。

当数据可能被归类为“大数据”时，更频繁的民意测验可能会给社区站点带来很大负担。

默认轮询​导入间隔​设置为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属性将覆盖Report Importer时间间隔
  • 该值以秒为单位，设置为4小时(14400秒)

在Analytics中管理用户数据

Adobe Analytics提供了允许您访问、导出和删除用户数据的API。 有关详细信息，请参阅提交访问和删除请求。

资源

• Adobe Marketing Cloud:分析帮助和参考
• AEM:集成Adobe Analytics
• AEM:具有外部提供者的分析