通过Target Standard API将AEM与Adobe Target集成需要使用Adobe Developer控制台配置Adobe IMS (Identity Management System)。
AEM 6.5中新增了对Adobe Target Standard API的支持。Target Standard API使用IMS身份验证。
为了向后兼容,仍支持在AEM中使用Adobe Target Classic API。 此 Target Classic API使用用户凭据.
API 选择由用于 AEM/Target 集成的身份验证方法驱动。
另请参阅 租户ID和客户端代码 部分。
开始此过程之前:
Adobe 支持部门必须针对以下项目配置您的帐户:
您组织的系统管理员应使用 Admin Console 将您组织中所需的开发人员添加到相关的产品配置文件中。
配置的第一阶段是在 AEM 中创建 IMS 配置并生成公钥。
在 AEM 中,打开工具菜单。
在 安全性 部分,选择 Adobe IMS配置.
选择创建,打开 Adobe IMS 技术帐户配置。
使用云配置下的下拉列表,选择 Adobe Target。
激活新建证书并输入新别名。
选择创建证书来确认。
选择下载(或下载公钥)以将文件下载到本地驱动器,以便在为 Adobe Target 与 AEM 的集成配置 IMS 时方便使用。
保持此配置处于打开状态;出现以下情况时再次需要: 在AEM中完成IMS配置.
使用Adobe Developer Console,通过AEM可以使用的Adobe Target创建项目(集成),然后分配所需的权限。
要使用AEM可以使用的Adobe Target创建项目,请打开Adobe Developer Console:
目前,Adobe仅支持Adobe Developer控制台的 服务帐户(JWT) 凭据类型。
不要使用 OAuth 服务器到服务器凭据类型(以后将支持此类型)。
为项目打开 Adobe Developer Console:
您拥有的任何项目都会显示出来。选择 创建新项目 — 位置和使用情况取决于以下因素:
如果您不具有任何项目,新建项目会位于底部中心。
如果您已经拥有现有项目,则会列出和 创建新项目 在右上角。
依次选择 添加到项目和 API:
依次选择 Adobe Target 和下一步:
如果您已订阅 Adobe Target,但它并未列出,您应查看先决条件。
上传公钥,完成后,选择下一步:
查看凭据,然后选择下一步:
选择所需的产品配置文件,然后选择保存配置的 API:
显示的产品配置文件取决于您是否拥有:
这会确认创建。
现在,将所需权限分配给集成:
打开 Adobe Admin Console:
导航到产品(顶部工具栏),然后选择 Adobe Target – <your-tenant-id>(从左侧面板)。
选择产品配置文件,然后从提供的列表中选择所需的工作区。例如,默认工作区。
选择 API 凭据,然后选择所需的集成配置。
选择编辑者作为产品角色;而不是选择观察者。
从“Adobe Developer Console – 项目”中,您可以查看所有集成项目的列表:
要显示有关配置的更多详细信息,请选择 视图 (特定项目条目右侧)。 其中包括:
其中某些组件必须在基于IMS的AEM中完成Adobe Target的集成。
通过返回到AEM,您可以添加针对Target的Adobe Developer控制台集成中所需的值来完成IMS配置:
返回到 AEM 中打开的 IMS 配置。
选择下一步。
在这里,您可以使用 Adobe Developer Console 中项目配置的详细信息:
aud
行的内容,例如,以下示例中的 https://ims-na1.adobelogin.com
选择创建来确认。
您的 Adobe Target 配置会显示在 AEM 控制台中。
要确认配置是否按预期运行,请执行以下操作:
打开:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
例如:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
选择您的配置。
从工具栏中选择检查运行状况,然后选择查看。
如果成功,您将看到以下消息:
现在可为Cloud Service引用配置以使用Target Standard API:
打开 工具 菜单。 然后,在 Cloud Service 部分,选择 旧版Cloud Service.
向下滚动到 Adobe Target 并选择 立即配置.
此 创建配置 对话框打开。
输入 标题 如果你愿意,还有 名称 (如果留空,则从标题生成)。
您还可以选择所需的模板(如果有多个模板可用)。
选择创建来确认。
此 编辑组件 对话框打开。
请在以下位置输入详细信息 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的“设置”选项卡)。
单击 连接到Target 初始化与Adobe Target的连接。
如果连接成功,则将显示消息连接成功。
选择 确定 在消息上,后接 确定 ,以便您确认配置。
您现在可以继续访问 添加Target框架 以配置发送到Target的ContextHub或ClientContext参数。 请注意,将AEM体验片段导出到Target时可能不需要此项。
替换为 Adobe Experience Manager 6.5.8.0,则Client Code字段已添加到Target配置窗口中。
配置租户ID和客户端代码字段时,请注意以下事项:
在这两种情况下,请注意以下事项:
如前所述,对于AEM 6.5,第一种情况最常见。无论哪种方式,确保 两者 字段包含正确的信息,具体取决于您的要求。
如果要更改现有 Target 配置,请: