使用IMS与Adobe Target集成

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

注意

AEM 6.5中新增了对Adobe Target Standard API的支持。Target Standard API使用IMS身份验证。

为了向后兼容,仍支持在AEM中使用Adobe Target Classic API。 的 Target Classic API使用用户凭据身份验证.

API选择由用于AEM/Target集成的身份验证方法驱动。
另请参阅 租户ID和客户端代码 中。

前提条件

在开始此过程之前:

  • Adobe支持 必须为您的帐户配置:

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

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

配置IMS配置 — 生成公钥

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

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

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

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

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

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

  6. 使用确认 创建证书.

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

    注意

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

为Adobe Target与AEM集成配置IMS

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

创建项目

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

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

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

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

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

      新建项目 — 第一个项目

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

      创建新项目 — 多个项目

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

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

    注意

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

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

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

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

    注意

    显示的产品配置文件取决于您是否具有:

    • Adobe Target Standard — 仅 默认工作区 可用
    • Adobe Target Premium — 列出了所有可用工作区,如下所示

  8. 将确认创建。

为集成分配权限

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

  1. 打开Adobe Admin Console:

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

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

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

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

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

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

选择 查看 (位于特定项目条目的右侧)以显示有关配置的更多详细信息。 这些功能包括:

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

其中一些功能需要基于IMS完成AEM中Adobe Target的集成。

在AEM中完成IMS配置

返回AEM后,您可以通过从Target的Adobe开发人员控制台集成添加所需的值来完成IMS配置:

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

  2. 选择​下一步

  3. 在此,您可以使用 有关Adobe开发人员控制台中项目配置的详细信息:

    • 标题:你的短信。
    • 授权服务器:从 aud负载 ,例如 https://ims-na1.adobelogin.com 在以下示例中
    • API密钥:从 概述 部分
    • 客户端密钥:在 概述 部分和复制
    • 负载:从 生成JWT 部分

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

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

确认IMS配置

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

  1. 打开:

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

    例如:

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

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

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

配置Adobe TargetCloud Service

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

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

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

    创建配置 对话框。

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

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

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

    编辑组件 对话框。

  5. Adobe Target设置 选项卡:

    • 身份验证:IMS

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

      注意

      对于IMS,需要从Target本身中获取此值。 您可以登录Target并从URL中提取租户ID。

      例如,如果URL为:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      那你就用 yourtenantid.

    • 客户端代码:请参阅 租户ID和客户端代码 中。

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

    • API类型:REST

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

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

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

    • 客户端库:选择您是希望使用AT.js客户端库,还是mbox.js(已弃用)。

    • 使用标签管理系统来交付客户端库:使用DTM(已弃用)、LaunchAdobe或任何其他标签管理系统。

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

    注意

    配置Cloud Service以使用Target Classic API 已弃用(使用Adobe Recommendations设置选项卡)。

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

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

  7. 选择 确定 在留言上,然后 确定 ,以确认配置。

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

租户ID和客户端代码

使用 Adobe Experience Manager 6.5.8.0,则“客户端代码”字段已添加到Target配置窗口中。

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

  1. 对于大多数客户,租户ID和客户端代码是相同的。 这表示两个字段包含相同的信息且相同。 请确保在这两个字段中输入租户ID。
  2. 出于旧版目的,您还可以在租户ID和客户端代码字段中输入不同的值。

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

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

如前所述,第一个案例是AEM 6.5中最常见的案例。无论哪种情况,请确保 both 字段包含正确的信息,具体取决于您的要求。

注意

如果要更改现有Target配置:

  1. 重新输入租户ID。
  2. 重新连接到Target。
  3. 保存配置。

在此页面上