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

概述 overview

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

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

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

此外，对于以下情况，需要进行分析：

支持的社区功能包括：

文档的此部分介绍如何将Analytics报表包与社区功能连接起来。 基本步骤包括：

前提条件 prerequisites

要配置Analytics for Communities功能，需要与您的客服专员合作来设置Adobe Analytics帐户和 报表包. 建立后，应提供以下信息：

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

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

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

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

如果使用 现有报表包，则可能需要 修改变量映射 在为社区站点激活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

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

创建配置对话框 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

在 创建新社区站点:

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

将Analytics云服务添加到 现有社区站点:

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

为了使Analytics跟踪和导入功能对社区站点正常工作，使用 scf-js-site-title 类和href属性必须存在。 页面上只应存在一个此类元素，如未修改的中所示 sitepage.hbs 社区站点脚本。 的值 siteUrl 将作为 网站路径.

# present in default sitepage.hbs

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/cn/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=zh-Hans).
# only one scf-js-site-title class should be included

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/cn/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=zh-Hans).
# this example sets it to be hidden as it serves no visual purpose

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/cn/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=zh-Hans).
<div
    class="navbar-brand scf-js-site-title"
    href="{{siteUrl}}.html"
    style="visibility: hidden;"
>
</div>

对于 自定义社区网站 覆盖 sitepage.hbs 脚本中，确保元素存在。 的 siteUrl变量在提供给客户端之前，将在服务器上呈现时进行设置。

对于 通用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会自动用于多个社区功能。

创作环境的 OSGi配置, AEM Communities Analytics Component Configuration，提供已用于Analytics的组件列表。 变量的自动映射由列出的组件决定。

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

组件配置 component-configuration

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

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

在启用Analytics并选择云配置框架后保存社区网站，AEM变量将自动映射到以evar1和event1开始的Analytics evar和事件，并增加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或事件，方法是将鼠标悬停在该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云服务和框架）之前验证变量映射。

请参阅以下章节：

主发布者 primary-publisher

当选择的部署是 发布场，则必须将一个AEM发布实例标识为用于轮询Adobe Analytics以将报表数据写入的主发布者 SRP.

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

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

有关具体说明，请参阅 部署社区.

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

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

为此，请按照 复制加密密钥.

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

为社区站点启用Analytics云服务后，如有必要，还可以 已调整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