使用IMS与Adobe Target集成

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

前提条件

开始此过程之前：

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

  • Adobe Console
  • Adobe Developer Console
  • Adobe Target 和
  • Adobe IMS (Identity Management System)

• 您组织的系统管理员应使用Admin Console将您组织中所需的开发人员添加到相关的产品配置文件中。

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

配置 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 Developer Console，您需要使用AEM将使用的Adobe Target创建项目（集成），然后分配所需的权限。

创建项目

打开 Adobe Developer Console 以使用 Adobe Target（将由 AEM 使用）创建项目：

1. 为项目打开 Adobe Developer Console：

   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：

   • https://adminconsole.adobe.com

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

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

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

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

为 Adobe Developer Console 集成项目存储的详细信息

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

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

选择​查看（特定项目条目右侧）以显示有关配置的更多详细信息。其中包括：

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

要在基于 IMS 的 AEM 中完成 Adobe Target 的集成，您需要其中的一些项。

在 AEM 中完成 IMS 配置

通过返回到AEM，您可以通过从Target的Adobe Developer控制台集成添加所需的值来完成IMS配置：

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

2. 选择​下一步。

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

   • 标题：您的文本。
   • 授权服务器：复制并粘贴以下​有效负载​部分的 aud 行的内容，例如，下面的示例中的 https://ims-na1.adobelogin.com
   • API密钥：从以下位置复制此代码： 概述 部分
   • 客户端密码：在中生成此ID 概述 部分，并复制
   • 有效负载：从生成 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 配置：选择用于 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时才显示。

   注意

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

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

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

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

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

租户ID和客户端代码

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

在配置“租户ID”和“客户端代码”字段时，请注意以下事项：

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

在这两种情况下，请注意：

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

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

Business.Adobe.com 资源