用于社区功能的Analytics配置 analytics-configuration-for-communities-features

概述 overview

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

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

例如,在社区站点中,管理员能够查看有关视频播放的各种报告。

此外,分析对于以下各项是必要的:

  • 在Publish环境中:

    • 社区趋势的报告
    • 允许网站访客按“查看次数最多”、“最活跃”、“最喜欢”进行排序
    • 查看UGC(用户生成的内容)列表计数
  • 在创作环境中:

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

支持的社区功能包括:

此文档的此部分介绍如何将Analytics报表包与Communities功能相关联。 基本步骤为:

  1. 复制加密密钥,以确保所有AEM实例上正确进行加密/解密

  2. 准备Adobe Analytics 报告包

  3. 创建AEM Analytics 云服务框架

  4. 为社区站点启用Analytics

  5. 验证 Analytics到AEM的变量映射

  6. 识别主发布者

  7. Publish社区站点

  8. 配置将报表数据从Adobe Analytics导入到社区站点

先决条件 prerequisites

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

  • 公司名称

    与Adobe Analytics帐户关联的公司。

  • 用户名

    有权管理Analytics帐户的用户登录用户名
    (应包括Web服务访问权限)。

  • 密码

    授权用户的登录密码。

  • Analytics数据中心

    帐户的Analytics数据中心的URL。

  • 报告包

    要使用的Analytics报表包的名称。

用于视频报表的Adobe Analytics报表包 adobe-analytics-report-suite-for-video-reporting

使用Adobe Experience Cloud的报表包管理器,可以配置Analytics报表包,以便启用社区站点来提供社区功能报表。

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

  • 11转化变量 (eVar)

    • evar1 ​到​ evar11 ​已启用

    • 可以重新利用(重命名)现有eVar或创建用于Communities功能的项目

  • 7个成功事件 (个事件)

    • event1 ​到​ event7 ​已启用

    • 类型​ Counter

      • 不是​ Counter (no subrelations)
    • 可以重新利用(重命名)现有事件或创建要用于Communities功能的事件

  • 视频管理

    • 视频报表控制台

      • 启用Video Core
      • 选择保存
    • 视频核心测量控制台

      • 选择Use Solution Variables
      • 选择保存

如果使用​ 新报表包,则新报表包可能仅包含4个evar和6个事件变量,而社区需要11个evar和7个事件变量。

如果使用​ 现有报表包,则在激活社区站点的Analytics框架之前,可能需要修改变量映射

有关专用于社区的变量的任何问题,请联系您的客户代表。

CAUTION
如果使用的现有报表包已在 ​内使用变量
  • evar1evar11

  • event1event7

在发布社区站点之前, ​请务必通过移动在为社区站点启用Analytics时自动映射到Analytics变量的AEM变量来恢复预先存在的映射。
要恢复预先存在的映射并将AEM变量移动到其他Analytics变量,请参阅修改Analytics变量映射一节。
否则,可能会导致无法恢复的数据丢失。

视频心率分析 video-heartbeat-analytics

在许可视频心率分析时,将分配Marketing Cloud Org Id

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

Marketing Cloud Org Id可以在社区站点创建时输入,也可以通过修改社区站点属性来输入。

marketing-org-id

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

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

AEM Analytics Cloud服务配置 aem-analytics-cloud-service-configuration

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

  • 从全局导航: 工具 > 部署 > Cloud Service
  • 向下滚动至​ Adobe Analytics
  • 选择​ 立即配置 ​或​ 显示配置

云配置

“创建配置”对话框 create-configuration-dialog

  • 选择​ 可用配置 ​旁边的[+]图标,以便您可以创建配置。

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

create-cloud-config

  • 标题

    (必需)配置的显示标题。
    例如,输入 社区分析

  • 名称

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

  • 模板

    选择Adobe Analytics Configuration

  • 选择​ 创建

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

Analytics设置对话框 analytics-settings-dialog

首次创建新的Analytics配置后,将显示该配置,并新增一个用于输入Analytics设置的对话框。 此对话框需要从帐户代表获得的必备帐户信息

分析设置

  • 公司

    与Adobe Analytics帐户关联的公司。

  • 用户名

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

  • 密码

    授权用户的登录密码。

  • 数据中心

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

  • 不向页面添加跟踪标记

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

  • 使用AppMeasurement

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

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

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

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

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

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

  • 选择​ 连接到Analytics

    • 如果不成功,

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

    分析设置

创建框架 create-framework

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

  • 选择​ 可用框架 ​旁边的[+]图标,以便您可以创建框架。

    分析框架

  • 标题

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

  • 名称

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

  • 模板

    选择Adobe Analytics Framework

  • 选择​ 创建

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

AEM Analytics框架配置 aem-analytics-framework-configuration

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

分析框架

选择报表包 select-report-suite

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

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

Sidekick不是必需的变量,可以将其最小化,这样它就不会妨碍对报表包设置的访问。

选择“添加项目”之前和之后的“报表包”对话框 report-suites-dialog-before-and-after-selecting-add-item

报告包

  1. 选择​ 添加项+

    出现两个下拉框。

  2. 选择Report suite.

    与公司帐户关联的报表包可供选择。

  3. 在打开的对话框中选择​

    code language-none
    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

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

为社区站点启用Analytics enable-analytics-for-a-community-site

为新社区站点启用 enable-for-new-community-site

要在创建社区站点时添加Analytics Cloud服务,请执行以下操作:

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

    • 选中​ 启用Analytics ​复选框。
    • 从下拉框中选择框架。
  • 或者,返回到Analytics框架配置以调整变量映射。

为现有社区站点启用 enable-for-existing-community-site

要将Analytics Cloud服务添加到现有社区站点,请执行以下操作:

  • 导航到​ 社区>站点 ​控制台。

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

  • 选择设置。

  • 在Analytics部分中:

    • 选中​ 启用Analytics ​复选框。
    • 从下拉框中选择框架。
  • 或者,返回到Analytics框架配置以调整变量映射。

为自定义站点启用 enable-for-customized-sites

为了使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-for-communities-features

Analytics自动用于多个Communities功能。

创作环境的OSGi配置 AEM Communities Analytics Component Configuration提供了已针对Analytics进行检测的组件的列表。 变量的自动映射由列出的组件决定。

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

组件配置 component-configuration

组件配置1

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

将Analytics映射到AEM变量 mapped-analytics-to-aem-variables

保存社区站点后,启用Analytics并选择云配置框架后,AEM变量会自动映射到Analytics eVar和事件。 它分别从evar1和event1开始,并递增1。

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

以下是默认映射的示例:

map-analytics

随每个事件发送的eVar映射 map-of-evars-sent-with-each-event

启用
资源
类型
站点
标题
函数
类型

标题

路径
UGC
类型
UGC
标题
用户
(成员)
UGC
路径
站点
路径
EVAR1
EVAR2
EVAR3
EVAR4
EVAR5
EVAR6
EVAR7
EVAR8
EVAR9
eVar10
event1
资源播放
(a)
-
-
-
-
-
-
-
(i)
-
事件2
SCFView
(a)
(b)
(c)
(d)
(e)
(f)
(g)
(h)
(i)
(j)
event3
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)
event6
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组件resourceTypesocial/forum/components/hbs/topic

  • UGC组件标题:登入主题

  • 登录(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变量映射 modifying-analytics-variable-mapping

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

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

要避免出现重复的映射,请确保将鼠标悬停在替换的Analytics evar或事件上并选择Analytics变量元素右侧显示的“X”来从行中删除该变量或事件。

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

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

示例步骤1:将Analytics evar14拖到映射表中 example-step-dragging-analytics-evar-into-mapping-table

analytics-mapping-evar

示例步骤2:选择“x”以移除替换的evar11 example-step-selecting-x-to-remove-replaced-evar

analytics-mapping-evar1

示例步骤3:AEM var eventdata.siteId重新映射到Analytics evar14 example-step-aem-var-eventdata-siteid-remapped-to-analytics-evar

analytics-mapping-evar2

发布社区站点 publishing-the-community-site

验证Analytics到AEM的变量映射 verify-analytics-to-aem-variable-mapping

明智的做法是在发布社区站点(该站点还发布了Analytics Cloud服务和框架)之前验证变量映射。

请参阅以下部分:

CAUTION
如果使用的现有报表包已在 ​内使用变量
  • evar1evar11

  • event1event7

则在发布社区站点之前, ​恢复预先存在的映射。 将自动映射的Communities AEM变量(为社区站点启用Analytics时)移动到其他Analytics变量。 所有Communities组件中的此重新映射都应保持一致。
否则,可能会导致无法恢复的数据丢失。

主要发布者 primary-publisher

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

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

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

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

CAUTION
请务必配置主发布器,以防止从多个发布实例进行轮询。

复制加密密钥 replicate-the-crypto-key

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

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

Publish社区站点和Analytics Cloud服务 publish-community-site-and-analytics-cloud-service

为社区站点启用Analytics Cloud服务并在必要时调整Analytics到AEM变量的映射后,通过(重新发布社区站点)将配置复制到发布环境。

从Analytics获取报表 obtaining-reports-from-analytics

报告管理 report-management

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

对于作者,查询用于实时报告。

在主要发布服务器上,使用查询来提供信息,为报表导入程序的分析数据导入做准备。

查询间隔默认为10秒。

报告导入程序 report-importer

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

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

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

默认轮询​ 导入间隔 ​设置为12小时。

报告导入程序

组件报表自定义 component-report-customization

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

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

  • 在主发布服务器上,使用管理权限登录。

  • 导航到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 ​属性会覆盖报表导入程序时间间隔。
    • 该值以秒为单位,设置为四小时(14400秒)。

组件报告

在Analytics中管理用户数据 manage-user-data-in-analytics

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

资源 resources

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791