使用IMS与Adobe Analytics集成

上次更新: 2023-09-14

通过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 支持部门必须针对以下项目配置您的帐户:

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

    • 这将为特定开发人员提供在Adobe Developer控制台中启用集成的权限。
    • 请参阅 管理开发人员.

配置 IMS 配置 – 生成公钥

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

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

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

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

  4. 使用​云配置​下的下拉列表,选择 Adobe Analytics。

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

  6. 选择​创建证书​来确认。

    Adobe IMS技术帐户配置向导

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

    注意

    保持此配置处于打开状态;出现以下情况时再次需要: 在AEM中完成IMS配置.

    用于向Adobe I/O添加密钥的信息对话框

为 Adobe Analytics 与 AEM 的集成配置 IMS

使用Adobe Developer Console,创建一个与Adobe Analytics(供AEM使用)的项目(集成),然后分配所需的权限。

创建项目

要使用AEM可以使用的Adobe Analytics创建项目,请打开Adobe Developer Console:

注意

目前,Adobe仅支持Adobe Developer控制台的 服务帐户(JWT) 凭据类型。

不要使用 OAuth 服务器到服务器​凭据类型(以后将支持此类型)。

  1. 为项目打开 Adobe Developer Console:

    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 Developer Console 集成项目存储的详细信息

从“Adobe Developer 项目”控制台中,您可以查看所有集成项目的列表:

要显示有关配置的更多详细信息,请选择特定项目条目。 其中包括:

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

其中一些您必须在AEM中完成Adobe Analytics的集成。

在 AEM 中完成 IMS 配置

通过返回到AEM,您可以添加针对Analytics的集成项目所需的值来完成IMS配置:

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

  2. 选择​下一步

  3. 在这里,您可以使用 为Adobe Developer控制台集成项目存储的详细信息

    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 Service 部分,选择 旧版Cloud Service.

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

    创建配置 对话框打开。

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

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

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

    编辑组件 对话框打开。

  5. 请在以下位置输入详细信息 Analytics设置 选项卡:

    • 身份验证: IMS

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

  6. 要初始化与Adobe Analytics的连接,请单击 连接到Analytics.

    如果连接成功,则将显示消息​连接成功

  7. 选择 确定 在消息上。

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

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

在此页面上