社区功能的分析配置

概述

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

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

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

此外,对于以下情况,必须进行分析:

支持的社区功能包括:

本文档的本节介绍如何将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 Experience 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的变量的任何疑虑,请与您的客户代表联系。

注意

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

  • evar1evar11

  • event1event7

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

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

否则可能导致无法恢复的数据丢失。

视频心率分析

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

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

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

marketing-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

云 — 配置

创建配置对话框

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

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

create-cloud-config

  • 标题

    (必需)配置的显示标题。
    例如,输入Enablement Community Analytics

  • 名称

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

  • 模板

    选择 Adobe Analytics Configuration

  • 选择​创建

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

分析设置对话框

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

analytics-settings

  • 公司

    与Adobe Analytics帐户关联的公司。

  • 用户名

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

  • 密码

    授权用户的登录密码。

  • 数据中心

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

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

    保留为默认值(取消选择)。

  • 使用 AppMeasurement

    保留为默认值(取消选择)。

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

    保留为默认值(取消选择)。

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

    保留为默认值(取消选择)。

要保存设置:

  • 选择​连接到Analytics

    • 如果不成功,

      • 验证条目中不包含前导空格。
      • 尝试使用其他数据中心。
  • 选择​确定

    analytics-enablement-settings

创建框架

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

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

    analytics-framework

  • 标题

    (必需)框架的显示标题
    例如,输入Enablement Community Framework

  • 名称

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

  • 模板

    选择 Adobe Analytics Framework.

  • 选择​创建

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

AEM Analytics Framework配置

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

analytics-enablement-framework

选择报表包

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

如果尚未创建或未正确设置报表包,请参阅上一节:
Adobe Analytics视频报表包

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

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

report-suite

  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. 选择“发布”。

analytics-framework2

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

为社区站点启用分析

为新社区站点启用

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

  • 在步骤3中,在ANALYTICS选项卡下:

    • 选中​启用分析​复选框。
    • 从下拉框中选择框架。
  • (可选)返回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?lang=zh-Hans"
    style="visibility: hidden;"
>
</div>

社区分析功能

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

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

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

组件配置

component-configuration1

注意

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

将分析映射到AEM变量

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

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

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

map-analytics

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

Enablement
资源
类型
站点
标题
函数
类型

标题

路径
UGC
类型
UGC
标题
用户
(成员)
UGC
路径
站点
路径
eVar1 eVar2 eVar3 eVar4 eVar5 eVar6 eVar7 eVar8 eVar9 eVar10
事件1
资源播放
(某个) - - - - - - - (i) -
事件2
SCFView
(某个) (b) (c) (d) (e) (f) (g) (h) (i) (j)
事件3
SCFCreate(Post)
- (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值示例:

  • MIME类型:video/mp4

  • 社区站点标题:Geometrixx社区

  • 社区函数名称:论坛

  • 社区组名称:远足

  • 社区组内容的路径: /content/sites/<site name>/en/groups/hiking

  • UGC组件resourceType: social/forum/components/hbs/topic

  • UGC组件标题:远足主题

  • login(authorizableId): aaron.mcdonald@mailinator.com

  • UGC的SRP路径: /content/usergenerated/asi/.../forum/jmtz-topic3

    要遵循的组件路径: /content/sites/<site name>/en/jcr:content/content/primary/forum

  • 社区站点内容的路径: /content/sites/<site name>/en

修改分析变量映射

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

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

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

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

注意

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

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

analytics-mapping-evar

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

analytics-mapping-evar1

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

analytics-mapping-evar2

发布社区站点

验证Analytics到AEM变量映射

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

请参阅以下部分:

注意

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

  • evar1evar11

  • event1event7

然后,在发布社区站点之 前,请务必恢复先前存在的映射,并将自动映射的社区AEM变量(在为社区站点启用Analytics时)移动到其他Analytics变量。此重新映射应在所有社区组件中保持一致。

否则可能导致无法恢复的数据丢失。

主发布者

如果选择的部署是发布场,则必须将一个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小时。

report-importer

组件报表自定义

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

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

  • 在主发行商上,使用管理权限登录。

  • 导航到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​属性将覆盖Report Importer时间间隔。
    • 该值以秒为单位,设置为4小时(14400秒)。

component-report

在Analytics中管理用户数据

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

资源

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now