社区分析配置功能

概述

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

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

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

此外,对于以下情况,分析是必需的:

  • 在发布环境中:

    • 社区趋势报告
    • 允许网站访客按“查看次数最多”、“最活跃”、“最喜欢”进行排序
    • 视图计入UGC列表
  • 在作者环境中:

    • 成员管理控制台中显示参与数据(视图、帖子、关注、喜欢)
    • 启用资源报告的趋势摘要、视频心跳和视频设备

支持的社区功能包括:

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

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

  2. 准备Adobe Analytics报告套件

  3. 创建AEM Analytics 云服务框架

  4. 为社 区站点启用分析

  5. 验证 分析到AEM变量映射

  6. 识别主发布者

  7. 布社区站点

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

前提条件

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

  • 公司名称

    与Adobe Analytics帐户关联的公司。

  • 用户名

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

  • 密码

    授权用户的登录密码。

  • Analytics数据中心

    帐户的Analytics数据中心的URL。

  • 报表包

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

Adobe Analytics视频报告报告套件

使用Adobe Marketing Cloud的报表包管理器,可以配置分析报表包,以便允许社区站点提供社区功能的报表。

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

  • 11转换变量 (eVar)

    • evar1 通过启 evar11

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

  • 7成功事件 (事件)

    • event1 通过启 event7

    • 类型 Counter

      • Counter (no subrelations)
    • 可以重用(重命名)现有事件或创建新的社区功能

  • 视频管理

    • 视频报告控制台

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

      • 选择 Use Solution Variables
      • 选择保存

如果使用​新的报表包,请注意,新报表包可能只有4个evar和6个事件变量,而社区需要11个evar和7个事件变量。

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

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

注意

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

  • evar1evar11

  • event1event7

然后,在发布社区站点 之前,务必通过移动AEM变量来恢复先前存在的映射,当为社区站点启用分析时,这些变量会自动映射到Analytics变量。

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

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

视频心跳分析

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

要在配置视频报告的分析报告包后启用视频心跳报告:

  • 创建Analytics云服务
  • 为社区站点](#enable-analytics-for-a-community-site)启用[分析
  • Marketing Cloud Org Id与社区站点关联

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

marketing-org-id

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

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

AEMAnalytics Cloud服务配置

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

  • 从全局导航:工具 > 部署 > 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变量在报表包](#adobe-analytics-report-suite-for-video-reporting)中定义为[。

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变量呈现在服务器上后,才会设置到客户端。

对于​通用AEM站点,它包含Communities组件,但不是使用站点创建向导创建的,必须添加元素。 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的新自定义组件,则应将这些组件添加到已配置组件的此列表。

组件配置

component-configuration1

注意

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

将分析映射到AEM变量

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

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

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

地图分析

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

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

标题

路径
UGC
类型
UGC
标题
用户
(成员)
UGC
路径
站点
路径
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值示例:

  • MIME类型:video/mp4

  • 社区站点标题:Geometrixx社区

  • 社区函数名称:论坛

  • 社区组名称:远足

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

  • UGC组件资源类型: 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或事件从左边栏拖放到映射表中的相关行,在框架中更改映射。

要避免重复映射,请务必将替换的Analyticsevar或事件从行中删除,方法是将指针悬停在该行上,然后选择显示在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

发布社区站点

验证分析到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用于查询分析。

作者可以查询实时报告。

在主发布者上,查询用于提供准备报表导入程序的分析数据导入的信息。

查询间隔默认为10秒。

报表导入程序

一旦发布了启用分析的社区站点,主发布者的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​属性将覆盖报表导入程序间隔。
    • 该值以秒为单位,并设置为4小时(14400秒)。

component-report

在Analytics中管理用户数据

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

资源

在此页面上