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

概述 overview

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

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

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

此外，分析对于以下各项是必要的：

支持的社区功能包括：

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

先决条件 prerequisites

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

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

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

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

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

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

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

视频心率分析 video-heartbeat-analytics

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

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

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

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

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

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

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

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

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

Analytics设置对话框 analytics-settings-dialog

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

要保存设置，请执行以下操作：

创建框架 create-framework

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

创建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

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

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

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

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

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

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

为自定义站点启用 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

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

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

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

以下是默认映射的示例：

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

eVar值的​ 示例：

修改Analytics变量映射 modifying-analytics-variable-mapping

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

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

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

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

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

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

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

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

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

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

请参阅以下部分：

主要发布者 primary-publisher

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

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

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

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

复制加密密钥 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

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

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

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

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

资源 resources