Show Menu
主题×

社区分析配置功能

概述

Adobe Analytics和Adobe Experience Manager(AEM)都是Adobe Marketing Cloud的解决方案。
可以为AEM Communities配置Adobe Analytics,这样,当成员与支持的Communities功能交互时,事件会发送到生成报告的Adobe Analytics。
例如,当启用社区站点的成员视图分配给他们的视频资源时,资源播放器会将事件发送到Analytics,包括视频心跳数据。 从社区站点中,管理员可以查看有关视频播放的各种报告。
此外,对于以下情况,分析是必要的:
  • 在发布环境中:
    • 报告社区趋
    • 允许网站访客按“查看次数最多”、“最活跃”、“最喜欢”排序
    • 视图计入UGC列表
  • 在作者环境中:
    • 在成员管理控制台中显 示参与数据 (视图、帖子、关注、赞)
    • 用于启用资源报告的趋势摘要、视频心跳和视频设
支持的社区功能包括:
本文档的此部分介绍如何将Analytics报告套件与Communities功能相连。 基本步骤是:
  1. 复制加密密钥 ,以确保在所有AEM实例上正确进行加密/解密
  2. 准备Adobe Analytics报 告套件
  3. 创建AEM Analytics云服 务和框
  4. 验证​ Analytics到AEM变量映射
  5. 识别主 要发布者
  6. 发布社区站点 (Publish the community site)
  7. 配置 将报告数据从Adobe Analytics导入社区站点

前提条件

要配置Analytics for Communities功能,必须与您的帐户代表一起设置Adobe Analytics帐户和报 告包 。 建立后,应提供以下信息:
  • 公司名称
    与Adobe Analytics帐户关联的公司。
  • 用户名
    已授权管理Analytics帐户的用户的登录用户名(应包括Web服务访问权限)。
  • 密码
    授权用户的登录密码。
  • Analytics数据中心
    帐户的Analytics数据中心URL。
  • 报表包
    要使用的Analytics报表包的名称。

Adobe Analytics Report Suite for Video报告

使用Adobe Marketing Cloud的 Report Suite Manager ,可以配置Analytics报表包,以便允许社区站点提供社区功能的报表。
通过使用 公司名和用户名登录 Adobe Marketing Cloud ,可以将新的或现有的报表包配置为:
    • evar1 通过启用 evar11
    • 可以重用(重命名)现有eVar或创建新eVar以用于Communities功能
    • event1 通过启用 event7
    • 类型 Counter
      • Counter (no subrelations)
    • 可以重用(重命名)现有事件,或创建新的社区功能
    • 视频报告控制台
      • 启用 Video Core
      • 选择保存
    • 视频核心测量控制台
      • 选择 Use Solution Variables
      • 选择保存
如果使用新 的报表包 ,请注意,新的报表包可能只有4个evar和6个事件变量,而社区需要11个evar和7个事件变量。
如果使用 现有报表包 ,则可能需要修改变 修改分析变量映射 量映射,然后才能激活社区站点的Analytics框架。 有关专用于社区的变量的任何疑虑,请与您的客户代表联系。
如果使用的现有报表包已经在
  • evar1 evar11
  • event1 event7
然后,在发布社区站点之前, 请务必通过移动在为社区站点启用Analytics时自动映射到Analytics变量的AEM变量来恢复预先存在的映射。
要恢复先前存在的映射并将AEM变量移至其他Analytics变量,请参阅修改分析变 量映射一节
否则可能导致无法恢复的数据丢失。

视频心率分析

当视频心率分析获得许可时,将 Marketing Cloud Org Id 分配一个。
要在配置Analytics报表包以进行视 频报告后启用视频心率报告,请执行以下操作 :
Marketing Cloud Org Id 以在创建社区站点时或更 高版本时 ,通过修 改社区站点属性 来输入。 AEM Analytics云服务配置
启用视频心率分析后,视频播放器的JavaScript(JS)代码将实例化视频心率库代码(也包含在JS中),该代码每10秒(不可配置)处理向Analytics视频跟踪服务器发送视频状态更新的所有逻辑,并最终将视频会话的累积报告发送到主Analytics服务器。
如果未启用,则视频心跳代码永远不会被实例化,只有视频进度和恢复位置跟踪会保留到SRP以进行报告。

AEM Analytics云服务配置

要创建新的Analytics集成,它使用创作实例上的标准UI将Adobe Analytics与AEM社区站点集成:
  • 从全局导航:“工 具”>“部署”>“云服务”
  • 向下滚动到 Adobe Analytics
  • 选择“ 立即配置 ”或“显 示配置”

创建配置对话框

  • 选择 [+] 可用配置旁 边的图标 ,以创建新配置
在“创建配置”对话框中,要输入的值标识配置。
  • 标题
    (必需)配置的显示标题。 例如,输入 Enablement Community Analytics
  • 名称
    (可选)如果未指定,则名称将默认为从标题派生的有效节点名称。 For example, enter communities
  • 模板
    选择 Adobe Analytics Configuration
  • Select Create
    • 启动配置页面并打开对 Analytics Settings 话框

分析设置对话框

初始创建新的Analytics配置时,将显示配置,并显示一个新对话框以输入“Analytics设置”。 此对话框要求从 帐户代表处获得 入门项目帐户信息。
  • 公司
    与Adobe Analytics帐户关联的公司
  • 用户名
    已授权管理Analytics帐户的用户的登录用户名
  • 密码
    授权用户的登录密码
  • 数据中心
    选择承载报告包的Analytics数据中心
  • 不将跟踪标记添加到页面
    保留为默认值(取消选择)
  • 使用 AppMeasurement
    保留为默认值(取消选择)
  • 夜间不导入页面展示(创作)
    保留为默认值(取消选择)
  • 不要在夜间导入页面展示次数(发布),请 ​将其保留为默认值(取消选择)
保存设置:
  • 选择 连接到分析
    • 如果失败,
      • 验证条目中不包含前导空格
      • 尝试使用其他数据中心
      • 联系您的客户代表
  • 选择确

创建框架

成功配置与Adobe Analytics的基本连接后,必须为社区站点创建或编辑框架。 该框架的用途是将社区功能(AEM)变量映射到分析(报表包)变量。
  • 选择 [+] 可用框架旁 的图标 ,以创建新框架
  • 标题
    (必需)框架的显示标题例如,输入 Enablement Community Framework
  • 名称
    (可选)如果未指定,则名称将默认为从标题派生的有效节点名称。 For example, enter communities
  • 模板
    选择 Adobe Analytics Framework
  • Select Create
创建Analytics Framework可打开配置框架。

AEM Analytics Framework配置

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

选择报表包

选择已设置用于视频报告的报表包。
如果尚未创建或未正确设置报表包,请参阅上一节: Adobe Analytics Report Suite for Video报告
Sidekick不需要并且可以最小化,以便它不会妨碍对“报告包”设置的访问。

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

  1. 选择 添加项目+
    出现两个下拉框。
  2. 选择 Report suite.
    可以选择与公司帐户关联的报表包。
  3. 在打 开的对话框 中选择“是”:
    Load default server settings?
     Do you want to load the default server settings and overwrite current values in the Server section?
    
    
  4. 选择 Run Mode
  5. Select Publish
Analytics云服务和框架现已完成。 在启用此Analytics服务的情况下创建社区站点后,将定义映射。

为社区站点启用分析

为新社区站点启用

在创建新社区站点时添 加Analytics云服务 :
  • 在步骤3中,在“ ANALYTICS”(分析)选项卡下 :
    • 选中“ 启用分析 ”复选框。
    • 从下拉框中选择框架。
  • (可选)返回Analytics框架配置以调整变量映射。

为现有社区站点启用

要将Analytics云服务添加到现有社区站 点,请执行以下操作 :
  • 导航到“社 区”>“站点 ”控制台。
  • 选择社区站点的“编辑站点”图标。
  • 选择设置。
  • 在“分析”部分中:
    • 选中“ 启用分析 ”复选框。
    • 从下拉框中选择框架。
  • (可选)返回Analytics框架配置以调整变量映射。

为自定义站点启用

为了使Analytics跟踪和导入能够正常地用于社区站点,必须存在具有类和href属 scf-js-site-title 性的页面元素。 页面上只应存在一个此类元素,如社区站点的未修改脚 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可自动用于多个Communities功能。
作者环境 的OSGi配置 , AEM Communities Analytics Component Configuration 提供了已为Analytics分析所处理的组件的列表。 变量的自动映射由列出的组件决定。
如果创建了用于Analytics的新自定义组件,则应将这些组件添加到此列表的已配置组件。

组件配置

日志组件用于实现博客功能。

将分析映射到AEM变量

在启用Analytics并选择云配置框架的情况下保存社区站点后,AEM变量将自动映射到分别从evar1和事件1开始的Analytics eVar和事件,并增加1。
如果使用现有的报表包将evar1至evar11中的任何变量以及事件1至事件7中的任何变量进行映射,则需要重新映射 AEM变量 ,并恢复原始映射。
下面是继入门教程之后默认映 射的示例 :

随每个事件发送的eVar映射

Enablement Resource Type 站点 Title 函数类型 组标题 Group Path UGC Type UGC Title 用户 (会员) UGC Path 站点路径 (Site Path)
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
事件 1资源播放 (a) - - - - - - - (i) -
事件2 SCFView (a) (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件3 SCFCreate(发布) - (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件4 SCFFollow - (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件5 SCFVoteUp - (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件6 SCFVoteDown - (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件7 SCFRate - (b) (c) (d) (e) (f) (g) (h) (i) (j)
eVar值示例:

修改分析变量映射

在为社区站点启用Analytics后,Analytics eVar和事件到AEM变量的映射可从框架配置中看到。
启用Analytics后,在社区站点发布之前,可通过将所需的Analytics evar或事件从左边栏拖放到映射表中的相关行,在框架中更改映射。
要避免重复映射,请务必将替换的Analytics evar或事件从行中删除,方法是将鼠标悬停在该行上,然后选择Analytics变量元素右侧显示的“X”。
如果Communities eVar和事件覆盖了报表包中预先存在的映射,则为避免数据丢失,请将Communities功能的AEM变量分配给其他Analytics eVar或事件,并恢复原始映射。
在启用Analytics的情况下发布社区站点之前重新映射 很重要 ,否则会有数据丢失的风险。

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

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

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

发布社区站点

验证分析到AEM变量映射

最好在发布社区站点之前验证变量映射,该站点也会发布Analytics云服务和框架。
请参阅以下部分:
如果使用的现有报表包已经在
  • evar1 evar11
  • event1 event7
然后,在发布社区站点之前,请务必恢复 “预先存在”的映射,并将自动映射的Communities AEM变量(在为社区站点启用Analytics时)移至其他Analytics变量。 此重新映射应在所有社区组件之间保持一致。
否则可能导致无法恢复的数据丢失。

主发布者

当选择的部署是发 布场 ,则必须将一个AEM发布实例标识为主发布者,以便轮询Adobe Analytics以向 SRP写入报告数据
默认情况下, AEM Communities Publisher Configuration OSGi配置将其发布实例标识为主发布者,这样发布农场中的所有发布实例都将自标识为主发布者。
因此,必须编辑所有辅助发布实例上的配置以取消选中“主发 布者 ”复选框。
有关具体说明,请参阅部署社区的主要发布 者部分
配置主发布者以阻止从多个发布实例进行轮询很重要。

复制加密密钥

Adobe Analytics凭据已加密。 为了便于作者和发布者之间复制或传输加密分析凭据,所有AEM实例必须共享相同的主加密密钥。
为此,请按照复制加密密钥 中的说明操作

发布社区站点和Analytics云服务

为社区站点启用Analytics云服务后,如果需要, Analytics到AEM变量的映射也已调整 ,则必须通过(重新)发布社区站点来将配置复制到发布环境 发布站点

从Analytics获取报告

报告管理

作者和主出版商的 OSGi配置 , AEM Communities Analytics Report Management 用于查询Analytics。
作者可查询实时报告。
在主发布者上,查询用于提供准备报告导入程序的分析数据导入的信息。
查询间隔默认为10秒。

报告导入程序

在发布启用了Analytics的社区站点后,可以将主发行商的 配置OSGi AEM Communities Analytics Report Importer OSGi配置配置为为那些未在CRXDE中单独配置的配置设置默认轮询间隔。
轮询间隔控制向Adobe Analytics请求要提取并保存到 SRP中的数据的频率
当数据可能被分类为“大数据”时,更频繁的民意测验可能会给社区站点带来很大的负担。
默认的轮询 导入间隔 ,设置为12小时。

组件报告自定义

目前,为了自定义要跟踪的度量,在存储库中创建节点,该节点定义了要为其生成该度量报告的时间段。
论坛主题目前是此自定义的唯一示例:
  • 在主发行商上,使用管理权限登录。
  • 导航到 CRXDE Lite 。 例如, https://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允许您访问、导出和删除用户数据。 有关详细信息,请参 阅提交访问和删除请求

资源