使用IMS与Adobe Analytics集成

要通过Analytics Standard API将AEM与Adobe Analytics集成,需要使用Adobe开发人员控制台配置Adobe IMS(Identity Management系统)。

注意

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支持 必须为您的帐户配置:

    • Adobe控制台
    • Adobe Developer Console
    • Adobe Analytics和
    • Adobe IMS(Identity Management系统)
  • 贵组织的系统管理员应使用Admin Console将组织中所需的开发人员添加到相关的产品配置文件中。

    • 这为特定开发人员提供了在Adobe开发人员控制台中启用集成的权限。
    • 有关更多详细信息,请参阅 管理开发人员.

配置IMS配置 — 生成公钥

配置的第一步是在AEM中创建IMS配置并生成公钥。

  1. 在AEM中,打开 工具 菜单。

  2. 安全性 部分选择 Adobe IMS配置.

  3. 选择 创建 打开 Adobe IMS技术帐户配置.

  4. 使用下拉菜单 云配置,选择 Adobe Analytics.

  5. 激活 创建新证书 并输入新别名。

  6. 使用确认 创建证书.

  7. 选择 下载 (或 下载公钥)将文件下载到本地驱动器,以便在 为Adobe Analytics与AEM集成配置IMS.

    注意

    保持此配置处于打开状态,在 在AEM中完成IMS配置.

为Adobe Analytics与AEM集成配置IMS

使用Adobe开发人员控制台,您需要与Adobe Analytics(供AEM使用)创建项目(集成),然后分配所需的权限。

创建项目

打开Adobe开发人员控制台,以使用AEM将使用的Adobe Analytics创建项目:

  1. 打开项目的Adobe开发人员控制台:

    https://developer.adobe.com/console/projects

  2. 您所有的项目都将显示出来。 选择 创建新项目 — 位置和使用情况取决于:

    • 如果您还没有任何项目, 创建新项目 中间,底部。

      新建项目 — 第一个项目

    • 如果您已经拥有现有项目,则将列出这些项目,并 创建新项目 右上方。

      创建新项目 — 多个项目

  3. 选择 添加到项目 后跟 API:

    开始使用新项目

  4. 选择 Adobe Analytics,则 下一个:

    注意

    如果您订阅了Adobe Analytics,但未在列表中看到它,则应查看 先决条件.

    添加API

  5. 选择 服务帐户(JWT) 作为身份验证类型,然后继续 下一个:

    选择身份验证类型

  6. 上传您的公钥,完成后,继续 下一个:

    上传您的公钥

  7. 查看凭据,并继续 下一个:

    查看凭据

  8. 选择所需的产品配置文件,然后继续 保存配置的API:

    选择所需的产品配置文件

  9. 将确认配置。

为集成分配权限

您现在必须为集成分配所需的权限:

  1. 打开Adobe Admin Console:

  2. 导航到 产品 (顶部工具栏),然后选择 Adobe Analytics - <your-tenant-id> (从左侧面板)。

  3. 选择 产品配置文件,则会从显示的列表中找到所需的工作区。 例如,默认工作区。

  4. 选择 API凭据,则是所需的集成配置。

  5. 选择 编辑器 作为 产品角色;而不是 观察者.

存储的Adobe开发人员控制台集成项目的详细信息

从Adobe开发人员项目控制台中,您可以看到所有集成项目的列表:

选择特定项目条目以显示有关配置的更多详细信息。 这些功能包括:

  • 项目概述
  • 分析
  • 凭据
    • 服务帐户(JWT)
      • 凭据详细信息
      • 生成JWT
  • API
    • 例如,Adobe Analytics

其中一些内容需要完成AEM中的Adobe Analytics集成。

在AEM中完成IMS配置

返回AEM后,您可以通过从Analytics集成项目中添加所需值来完成IMS配置:

  1. 返回到 在AEM中打开IMS配置.

  2. 选择​下一步

  3. 在此,您可以使用 存储的Adobe开发人员控制台集成项目的详细信息:

    AEM IMS配置详细信息

  4. 选择​创建​来确认。

  5. 您的Adobe Analytics配置将显示在AEM控制台中。

    IMS 配置

确认IMS配置

要确认配置可按预期运行,请执行以下操作:

  1. 打开:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    例如:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. 选择您的配置。

  3. 选择 检查运行状况 ,然后 检查.

    IMS配置 — 检查运行状况

  4. 如果成功,您将看到一条确认消息。

配置Adobe Analytics Cloud服务

现在,可以为Cloud Service引用配置以使用Analytics Standard API:

  1. 打开 工具 菜单。 然后,在 Cloud Services 选择 旧版Cloud Services.

  2. 向下滚动到 Adobe Analytics 选择 立即配置.

    创建配置 对话框。

  3. 输入 标题 如果你愿意, 名称 (如果留空,则从标题生成)。

    您还可以选择所需的模板(如果有多个模板可用)。

  4. 选择​创建​来确认。

    编辑组件 对话框。

  5. Analytics设置 选项卡:

    • 身份验证:IMS

    • IMS配置:选择IMS配置的名称

  6. 单击 连接到Analytics 初始化与Adobe Analytics的连接。

    如果连接成功,则显示消息 连接成功 中。

  7. 选择 确定 消息中。

  8. 根据需要完成其他参数,然后是 确定 ,以确认配置。

  9. 您现在可以继续 添加Analytics框架 以配置将发送到Adobe Analytics的参数。

在此页面上