使用IMS与Adobe Target集成 integration-with-adobe-target-using-ims

通过Target Standard API将AEM与Adobe Target集成需要使用Adobe Developer控制台配置Adobe IMS (Identity Management System)。

NOTE
AEM 6.5中新增了对Adobe Target Standard API的支持。Target Standard API使用IMS身份验证。
为了向后兼容,仍支持在AEM中使用Adobe Target Classic API。 此 Target Classic API使用用户凭据.
API 选择由用于 AEM/Target 集成的身份验证方法驱动。
另请参阅 租户ID和客户端代码 部分。

前提条件 prerequisites

开始此过程之前:

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

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

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

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

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

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

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

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

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

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

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

    Adobe IMS技术帐户配置向导

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

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

    用于在Adobe I/O上添加证书的信息消息

为 Adobe Target 与 AEM 的集成配置 IMS configuring-ims-for-adobe-target-integration-with-aem

使用Adobe Developer Console,通过AEM可以使用的Adobe Target创建项目(集成),然后分配所需的权限。

创建项目 creating-the-project

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

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

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

  2. 您拥有的任何项目都会显示出来。选择 创建新项目 — 位置和使用情况取决于以下因素:

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

      新建项目 – 第一个项目

    • 如果您已经拥有现有项目,则会列出和 创建新项目 在右上角。

      新建项目 – 多个项目

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

    Adobe Developer控制台

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

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

    单击“下一步”

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

    使用开发人员控制台添加集成

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

    创建项目

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

    note note
    NOTE
    显示的产品配置文件取决于您是否拥有:
    • Adobe Target Standard – 仅​ 默认工作区 ​可用
    • Adobe Target Premium – 列出了所有可用的工作区,如下所示

    选择要添加的API

  8. 这会确认创建。

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

现在,将所需权限分配给集成:

  1. 打开 Adobe Admin Console

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

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

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

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

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

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

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

  • 项目概述

  • 见解

  • 凭据

    • 服务帐户 (JWT)

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

    • 例如,Adobe Target

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

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

通过返回到AEM,您可以添加针对Target的Adobe Developer控制台集成中所需的值来完成IMS配置:

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

  2. 选择​ 下一步

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

    • 标题:您的文本。
    • 授权服务器:复制并粘贴以下​ 有效负载 ​分区中 aud 行的内容,例如,以下示例中的 https://ims-na1.adobelogin.com
    • API密钥:从以下位置复制此 概述 部分
    • 客户端密码:在中生成此 概述 部分,并复制
    • 有效负载:从生成 JWT 部分中复制此有效负载

    技术帐户配置

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

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

    Adobe 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. 从工具栏中选择​ 检查运行状况,然后选择​ 查看

    Adobe IMS配置

  4. 如果成功,您将看到以下消息:

    检查配置

配置Adobe TargetCloud Service configuring-the-adobe-target-cloud-service

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

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

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

    创建配置 对话框打开。

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

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

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

    编辑组件 对话框打开。

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

    • 身份验证: IMS

    • 租户ID:Adobe IMS租户ID。 另请参阅 租户ID和客户端代码 部分。

      note note
      NOTE
      对于IMS,必须从Target本身获取此值。 您可以登录Target并从URL中提取租户ID。
      例如,如果URL为:
      https://experience.adobe.com/#/@yourtenantid/target/activities
      然后您使用 yourtenantid.
    • 客户代码:请参阅 租户ID和客户端代码 部分。

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

    • API类型:REST

    • A4T Analytics Cloud配置:选择用于Target活动目标和量度的Analytics Cloud配置。 如果您在定位内容时使用Adobe Analytics作为报表源,则需要此项。 如果您看不到云配置,请参阅中的注释 配置A4T Analytics Cloud配置.

    • 使用准确定位:默认情况下,此复选框处于选中状态。 如果选中,云服务配置会等待上下文加载完后再加载内容。 请参阅以下注释。

    • 从Adobe Target同步区段:选择此选项可下载在Target中定义的分段,以便在AEM中使用它们。 当API类型属性为REST时,选择此选项,因为内联区段不受支持,并且您必须始终使用Target中的区段。 (AEM术语“区段”等同于Target“受众”。)

    • 客户端库:选择是需要AT.js客户端库,还是mbox.js(已弃用)。

    • 使用Tag Management System提供客户端库:使用DTM(已弃用)、AdobeLaunch或任何其他标签管理系统。

    • 自定义AT.js:如果选中Tag Management框或使用默认的AT.js,则保留为空。 或者,上传您的自定义AT.js。 仅当您选择了AT.js时才显示。

    note note
    NOTE
    配置使用Target Classic API的Cloud Service 已弃用(使用Adobe Recommendations的“设置”选项卡)。
  6. 单击 连接到Target 初始化与Adobe Target的连接。

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

  7. 选择 确定 在消息上,后接 确定 ,以便您确认配置。

  8. 您现在可以继续访问 添加Target框架 以配置发送到Target的ContextHub或ClientContext参数。 请注意,将AEM体验片段导出到Target时可能不需要此项。

租户ID和客户端代码 tenant-client

替换为 Adobe Experience Manager 6.5.8.0,则Client Code字段已添加到Target配置窗口中。

配置租户ID和客户端代码字段时,请注意以下事项:

  1. 对于大多数客户来说,租户 ID 和客户代码是相同的。这意味着,这两个字段包含相同的信息并且是相同的。确保在这两个字段中输入租户 ID。
  2. 对于遗留问题,您还可以在“租户 ID”和“客户端代码”字段中输入不同的值。

在这两种情况下,请注意以下事项:

  • 默认情况下,客户端代码(如果首先添加)也会自动复制到“租户 ID”字段中。
  • 您可以选择更改默认租户ID集。
  • 因此,对Target的后端调用基于租户ID,而客户端对Target的调用基于客户端代码。

如前所述,对于AEM 6.5,第一种情况最常见。无论哪种方式,确保 两者 字段包含正确的信息,具体取决于您的要求。

NOTE
如果要更改现有 Target 配置,请:
  1. 重新输入租户 ID。
  2. 重新连接到 Target。
  3. 保存配置。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2