社区功能的Analytics配置

概述

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

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

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

此外,对于以下情况,需要进行分析:

支持的社区功能包括:

文档的此部分介绍如何将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框架之前,可能需要修改变量映射。 有关专用于社区的变量的任何问题,请联系您的客户代表。

注意

如果使用的现有报表包已在

  • evar1evar11
  • event1event7

然后,在社区网站发布之前, 务必要通过移动在为社区网站启用AEM时自动映射到Analytics变量的Analytics变量,来恢复之前存在的映射。

要恢复预先存在的映射并将AEM变量移动到其他Analytics变量,请参阅修改Analytics变量映射中的部分。

如果不这样做,则可能会导致无法恢复的数据丢失。

视频心率分析

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

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

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

chlimage_1-264

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

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

AEM Analytics Cloud服务配置

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

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

chlimage_1-265

创建配置对话框

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

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

chlimage_1-266

  • 标题

    (必需)配置的显示标题。

    例如,输入​Enablement Community Analytics

  • 名称

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

    例如,输入​communities

  • 模板

    选择 Adobe Analytics Configuration

  • 选择​创建

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

Analytics设置对话框

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

chlimage_1-267

  • 公司

    与Adobe Analytics帐户关联的公司

  • 用户名

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

  • 密码

    授权用户的登录密码

  • 数据中心

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

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

    保留为默认值(未选中)

  • 使用 AppMeasurement

    保留为默认值(未选中)

  • 夜间不导入页面展示(创作)

    保留为默认值(未选中)

  • 夜间不导入页面展示(发布)

    保留为默认值(选中)

要保存设置,请执行以下操作:

  • 选择​连接到Analytics

    • 如果不成功,

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

chlimage_1-268

创建框架

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

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

chlimage_1-269

  • 标题

    (必需)框架的显示标题

    例如,输入​Enablement Community Framework

  • 名称

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

    例如,输入​communities

  • 模板

    选择 Adobe Analytics Framework

  • 选择​创建

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

AEM Analytics框架配置

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

chlimage_1-270

选择报表包

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

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

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

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

chlimage_1-271

  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

chlimage_1-272

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的新自定义组件,则应将这些组件添加到此已配置组件列表。

组件配置

chlimage_1-273

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

将Analytics映射到AEM变量

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

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

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

chlimage_1-274

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

启用资源类型 网站标题 函数类型 组标题 组路径 UGC类型 UGC标题 用户(会员) UGC路径 网站路径
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
event1资源播放 (某个) - - - - - - - (i) -
event2SCFView (某个) (b) © (d) (e) (f) (g) (h) (i) (j)
event3SCFCreate(Post) - (b) © (d) (e) (f) (g) (h) (i) (j)
event4SCFFollow - (b) © (d) (e) (f) (g) (h) (i) (j)
event5SCFVoteUp - (b) © (d) (e) (f) (g) (h) (i) (j)
event6SCFVoteDown - (b) © (d) (e) (f) (g) (h) (i) (j)
event7SCFRate - (b) © (d) (e) (f) (g) (h) (i) (j)

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和/或事件,并恢复原始映射。

注意

在社区网站已发布且启用了Analytics之前重新映射很重要,否则可能会丢失数据。

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

chlimage_1-275

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

chlimage_1-276

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

chlimage_1-277

发布社区网站

验证Analytics到AEM变量的映射

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

请参阅以下章节:

注意

如果使用的现有报表包已在

  • evar1evar11
  • event1event7

然后,在社区网站发布之前, 务必要恢复预先存在的映射,并将自动映射的社区AEM变量(在为社区网站启用Analytics时)移动到其他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小时。

chlimage_1-278

组件报表自定义

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

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

  • 在主发布者上

  • 使用管理权限登录

  • 导航到CRXDE Lite

  • 语言根的jcr:content节点下

    • 例如,/content/sites/engage/en/jcr:content
  • 导航到为Analytics报表配置的组件

    • 例如,analytics/reportConfigs/social_forum_components_hbs_topic
  • 请注意创建的时间段

    • last30Days
    • last90Days
    • thisYear
  • 请注意total节点

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

chlimage_1-279

在Analytics中管理用户数据

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

资源

在此页面上