通过Analytics Standard API将AEM与Adobe Analytics集成需要使用Adobe Developer控制台配置Adobe IMS (Identity Management System)。
AEM 6.5.12.0中新增了对Adobe Analytics Standard API 2.0的支持。此版本的API支持IMS身份验证。
为了向后兼容,仍支持在AEM中使用Adobe Analytics Classic API 1.4。 此 Analytics Classic API使用用户凭据.
API 选择由用于 AEM/Analytics 集成的身份验证方法驱动。
迁移到 2.0 API 下还提供了更多信息。
开始此过程之前:
Adobe 支持部门必须针对以下项目配置您的帐户:
您组织的系统管理员应使用 Admin Console 将您组织中所需的开发人员添加到相关的产品配置文件中。
配置的第一阶段是在 AEM 中创建 IMS 配置并生成公钥。
在 AEM 中,打开工具菜单。
在 安全性 部分,选择 Adobe IMS配置.
选择创建,打开 Adobe IMS 技术帐户配置。
使用云配置下的下拉列表,选择 Adobe Analytics。
激活新建证书并输入新别名。
选择创建证书来确认。
选择下载(或下载公钥)将文件下载到本地驱动器,以便在为 Adobe Analytics 与 AEM 的集成配置 IMS 时方便使用。
保持此配置处于打开状态;出现以下情况时再次需要: 在AEM中完成IMS配置.
使用Adobe Developer Console,创建一个与Adobe Analytics(供AEM使用)的项目(集成),然后分配所需的权限。
要使用AEM可以使用的Adobe Analytics创建项目,请打开Adobe Developer Console:
目前,Adobe仅支持Adobe Developer控制台的 服务帐户(JWT) 凭据类型。
不要使用 OAuth 服务器到服务器凭据类型(以后将支持此类型)。
为项目打开 Adobe Developer Console:
您拥有的任何项目都会显示出来。选择 创建新项目 — 位置和使用情况取决于以下因素:
如果您不具有任何项目,新建项目会位于底部中心。
如果您已经拥有现有项目,则会列出和 创建新项目 位于右上角。
依次选择 添加到项目和 API:
依次选择 Adobe Analytics 和下一步:
如果您已订阅 Adobe Analytics,但它并未列出,您应查看先决条件。
选择 服务帐户(JWT) 作为身份验证类型,然后继续 下一个:
上传公钥,完成后,选择下一步:
查看凭据,然后选择下一步:
选择所需的产品配置文件,然后选择保存配置的 API:
配置得到确认。
现在,将所需权限分配给集成:
打开 Adobe Admin Console:
导航到产品(顶部工具栏),然后选择 Adobe Analytics – <your-tenant-id>(从左侧面板)。
选择产品配置文件,然后从提供的列表中选择所需的工作区。例如,默认工作区。
选择 API 凭据,然后选择所需的集成配置。
选择编辑者作为产品角色;而不是选择观察者。
从“Adobe Developer 项目”控制台中,您可以查看所有集成项目的列表:
要显示有关配置的更多详细信息,请选择特定项目条目。 其中包括:
其中一些您必须在AEM中完成Adobe Analytics的集成。
通过返回到AEM,您可以添加针对Analytics的集成项目所需的值来完成IMS配置:
返回到 AEM 中打开的 IMS 配置。
选择下一步。
在这里,您可以使用 为Adobe Developer控制台集成项目存储的详细信息:
aud
行的内容,例如,以下示例中的 https://ims-na1.adobelogin.com
选择创建来确认。
您的 Adobe Analytics 配置会显示在 AEM 控制台中。
要确认配置是否按预期运行,请执行以下操作:
打开:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
例如:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
选择您的配置。
从工具栏中选择检查运行状况,然后选择查看。
如果成功,您将看到一条确认消息。
现在可为Cloud Service引用配置以使用Analytics Standard API:
打开 工具 菜单。 然后,在 Cloud Service 部分,选择 旧版Cloud Service.
向下滚动到 Adobe Analytics 并选择 立即配置.
此 创建配置 对话框打开。
输入 标题 如果你愿意,还有 名称 (如果留空,则从标题生成)。
您还可以选择所需的模板(如果有多个模板可用)。
选择创建来确认。
此 编辑组件 对话框打开。
请在以下位置输入详细信息 Analytics设置 选项卡:
身份验证: IMS
IMS配置:选择IMS配置的名称
要初始化与Adobe Analytics的连接,请单击 连接到Analytics.
如果连接成功,则将显示消息连接成功。
选择 确定 在消息上。
根据需要完成其他参数,然后 确定 ,以便您确认配置。
您现在可以继续访问 添加Analytics框架 以配置发送到Adobe Analytics的参数。