使用Adobe I/O与Adobe Target集成

通过Target Standard API将AEM与Adobe Target集成需要配置AdobeIMS(Identity Management系统)和Adobe I/O。

前提条件

在开始此过程之前：

• Adobe 支持必须为以下项目配置您的帐户：

  • Adobe控制台
  • Adobe I/O
  • Adobe Target
  • AdobeIMS(Identity Management系统)

• 贵组织的系统管理员应使用该Admin Console将贵组织中所需的开发人员添加到相关产品用户档案。

  • 这为特定开发人员提供了在Adobe I/O内实现集成的权限。
  • 有关详细信息，请参阅管理开发人员。

配置IMS配置——生成公钥

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

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

2. 在​安全​部分，选择​AdobeIMS配置。

3. 选择​创建​以打开​AdobeIMS技术帐户配置。

4. 使用​云配置​下的下拉框，选择​Adobe Target。

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

6. 使用​创建证书​进行确认。

   

7. 选择​下载（或​下载公钥）将文件下载到本地驱动器，以便在配置Adobe I/O以与AEM集成时使用它。

   注意

   保持此配置打开，当完成AEM中的IMS配置时，将再次需要此配置。

   

配置Adobe I/O以与AEM集成

您需要创建与AEM将使用的Adobe I/O项目（集成），然后分配所需的权限。

创建项目

打开Adobe I/O控制台，与AEM使用的Adobe Target创建I/O项目：

1. 打开“项目”的Adobe I/O控制台：

   https://console.adobe.io/projects

2. 将显示您拥有的任何项目。 选择​创建新项目 —— 位置和使用情况取决于：

   • 如果您还没有任何项目，创建新项目​将居中，底部。

     

   • 如果已有项目，将列出这些项目，并且​创建新项目​将位于右上方。

     

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

   

4. 选择​Adobe Target，然后选择​下一个:

   注意

   如果您订阅了Adobe Target，但未看到它列出，则应检查Prerequistes。

   

5. 上传您的公钥，完成后，继续执行下 一步:

   

6. 查看凭据，然后继续使用​Next:

   

7. 选择所需的产品用户档案，然后继续​保存配置的API:

   注意

   显示的产品用户档案取决于您是否具有：

   • Adobe Target标准——仅​默认工作区​可用
   • Adobe Target高级版——列出所有可用工作区，如下所示

   

8. 将确认创建。

为集成分配权限

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

1. 打开Adobe Admin Console:

   • https://adminconsole.adobe.com

2. 导航到​产品（顶部工具栏），然后选择​Adobe Target- <您的租户-id（从左侧面板）。

3. 选择​产品用户档案，然后从显示的列表中选择所需的工作区。 例如，默认工作区。

4. 选择​集成，然后选择所需的集成配置。

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

存储在Adobe I/O集成项目的详细信息

从“Adobe I/O项目”控制台中，您可以看到所有集成项目的列表:

• https://console.adobe.io/projects

选择​视图（特定项目条目的右侧）以显示有关配置的更多详细信息。 这些 Cookie 包括：

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

其中一些需要完成Adobe I/O整合，以便在AEM建立目标。

在AEM中完成IMS配置

返回到AEM后，您可以通过从Adobe I/O集成添加所需值来完成IMS配置，以便目标:

1. 返回至在AEM](#configuring-an-ims-configuration-generating-a-public-key)中打开的[IMS配置。

2. 选择​下一步。

3. 您可以在此使用Adobe I/O](#details-stored-for-the-adobe-io-integration-project)的[详细信息：

   • 标题:您的文本。
   • 授权服务器:从以下Payloads部分 "aud" 的行复 ​​制／粘贴此组件， "https://ims-na1.adobelogin.com" 例如在以下示例中
   • API密钥:从Adobe I/O集 成概述部分复制此内容以供目标
   • 客户端机密:在Adobe I/O集成 的概述部分生成此内容以供目标，并复制
   • 有效负荷:从Adobe I/O集 成 的“生成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:adobeIMS租户ID

     注意

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

     例如，如果URL为：

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

     然后使用yourtenantid。

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

   • API类型:休息

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

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

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

   • 客户端库:选择是要AT.js客户端库，还是mbox.js（已弃用）。

   • 使用标签管理系统交付客户端库:使用DTM（已弃用）、Adobe启动或任何其他标签管理系统。

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

   注意

   已弃用使用Cloud Service经典API的目标 配置(使用“Adobe Recommendations设置”选项卡)。

   例如：

   

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

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

7. 在消息上选择​OK，在对话框中选择​OK​以确认配置。

8. 您现在可以继续添加目标框架以配置将发送到目标的ContextHub或ClientContext参数。 请注意，将AEM Experience Fragments导出到目标时可能不需要这样做。