与 Adobe Analytics 集成时使用的 IMS 配置 ims-configuration-for-integration-with-adobe-analytics

通过 Analytics Standard API 将 Adobe Experience Manager as a Cloud Service (AEMaaCS) 与 Adobe Analytics 集成需要配置 Adobe IMS (Identity Management System)。配置是通过 Adobe Developer Console 实现的。

NOTE
AEMaaCS 2022.2.0 中新增了对 Adobe Analytics Standard API 2.0 的支持。此版本的 API 支持 IMS 身份验证。
API 选择由用于 AEM/Analytics 集成的身份验证方法驱动。
迁移到 2.0 API 下还提供了更多信息。

前提条件 prerequisites

开始此过程之前:

  • Adobe 支持部门必须针对以下项目配置您的帐户:

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

    • 这将向特定开发人员提供使用 Adobe Developer Console 启用集成的权限。
    • 请参阅 管理开发人员.

配置 IMS 配置 – 生成公钥 configuring-ims-generating-a-public-key

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

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

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

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

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

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

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

    创建证书

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

    note caution
    CAUTION
    将此配置保持开放状态,供在 AEM 中完成 IMS 配置时再次使用。

    下载证书

为 Adobe Analytics 与 AEM 的集成配置 IMS configuring-ims-adobe-analytics-integration-with-aem

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

创建项目 creating-the-project

打开 Adobe Developer Console 以使用 Adobe Analytics(将由 AEM 使用)创建项目:

CAUTION
目前,我们仅支持 Adobe Developer Console 的​ 服务帐户 (JWT) 凭据类型。
不要使用 OAuth 服务器到服务器 ​凭据类型(以后将支持此类型)。
  1. 为项目打开 Adobe Developer Console:

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

  2. 您拥有的任何项目都会显示出来。选择​ 新建项目 – 位置和使用将取决于:

    • 如果您不具有任何项目,新建项目 ​会位于底部中心。

      新建项目 – 第一个项目

    • 如果您已拥有项目,这些项目会列出,新建项目 ​会位于右上方。

      新建项目 – 多个项目

  3. 依次选择 添加到项目 ​和 API

    开始使用新项目

  4. 依次选择 Adobe Analytics 和​ 下一步

    note note
    NOTE
    如果您已订阅 Adobe Analytics,但它并未列出,您应查看先决条件

    添加 API

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

    选择身份验证类型

  6. 上传公钥,完成后,选择​ 下一步

    上传公钥

  7. 查看凭据,然后选择​ 下一步

    查看凭据

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

    选择所需的产品配置文件

  9. 配置得到确认。

将权限分配给集成 assigning-privileges-to-the-integration

您现在必须将所需权限分配给集成:

  1. 打开 Adobe Admin Console

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

  3. 选择​ 产品配置文件,然后从提供的列表中选择所需的工作区。例如,默认工作区。

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

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

为 Adobe Developer Console 集成项目存储的详细信息 details-stored-for-the-ims-integration-project

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

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

  • 项目概述

  • 见解

  • 凭据

    • 服务帐户 (JWT)

      • 凭据详细信息
      • 生成 JWT
  • APIS

    • 例如,Adobe Analytics

其中某些组件必须在基于IMS的AEM中完成Adobe Analytics的集成。

在 AEM 中完成 IMS 配置 completing-the-ims-configuration-in-aem

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

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

  2. 选择​ 下一步

  3. 在这里,您可以使用 Adobe Developer Console 中项目配置的详细信息

    AEM IMS 配置详细信息

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

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

    IMS 配置

确认 IMS 配置 confirming-the-ims-configuration

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

  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 的集成 complete-the-integration-with-adobe-analytics

您现在可以使用此 IMS 配置来完成与 Adobe Analytics 的集成

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab