要通过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支持 必须为您的帐户配置:
贵组织的系统管理员应使用Admin Console将组织中所需的开发人员添加到相关的产品配置文件中。
配置的第一步是在AEM中创建IMS配置并生成公钥。
在AEM中,打开 工具 菜单。
在 安全性 部分选择 Adobe IMS配置.
选择 创建 打开 Adobe IMS技术帐户配置.
使用下拉菜单 云配置,选择 Adobe Target.
激活 创建新证书 并输入新别名。
使用确认 创建证书.
选择 下载 (或 下载公钥)将文件下载到本地驱动器,以便在 为Adobe Target与AEM集成配置IMS.
保持此配置处于打开状态,在 在AEM中完成IMS配置.
使用Adobe开发人员控制台,您需要与AEM将使用的Adobe Target创建一个项目(集成),然后分配所需的权限。
打开Adobe开发人员控制台,以使用AEM将使用的Adobe Target创建项目:
打开项目的Adobe开发人员控制台:
您所有的项目都将显示出来。 选择 创建新项目 — 位置和使用情况取决于:
如果您还没有任何项目, 创建新项目 中间,底部。
如果您已经拥有现有项目,则将列出这些项目,并 创建新项目 右上方。
选择 添加到项目 后跟 API:
选择 Adobe Target,则 下一个:
如果您订阅了Adobe Target,但未在列表中看到它,则应查看 先决条件.
上传您的公钥,完成后,继续 下一个:
查看凭据,并继续 下一个:
选择所需的产品配置文件,然后继续 保存配置的API:
显示的产品配置文件取决于您是否具有:
将确认创建。
您现在必须为集成分配所需的权限:
打开Adobe Admin Console:
导航到 产品 (顶部工具栏),然后选择 Adobe Target - <your-tenant-id> (从左侧面板)。
选择 产品配置文件,则会从显示的列表中找到所需的工作区。 例如,默认工作区。
选择 API凭据,则是所需的集成配置。
选择 编辑器 作为 产品角色;而不是 观察者.
从Adobe开发人员控制台 — 项目中,您可以看到所有集成项目的列表:
选择 查看 (位于特定项目条目的右侧)以显示有关配置的更多详细信息。 这些功能包括:
其中一些功能需要基于IMS完成AEM中Adobe Target的集成。
返回AEM后,您可以通过从Target的Adobe开发人员控制台集成添加所需的值来完成IMS配置:
返回到 在AEM中打开IMS配置.
选择下一步。
在此,您可以使用 有关Adobe开发人员控制台中项目配置的详细信息:
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 Services 选择 旧版Cloud Services.
向下滚动到 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配置:选择用于定位活动目标和量度的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设置选项卡)。
单击 连接到Target 初始化与Adobe Target的连接。
如果连接成功,则显示消息 连接成功 中。
选择 确定 在留言上,然后 确定 ,以确认配置。
您现在可以继续 添加Target框架 配置将发送到Target的ContextHub或ClientContext参数。 请注意,将AEM体验片段导出到Target时可能不需要执行此操作。
使用 Adobe Experience Manager 6.5.8.0,则“客户端代码”字段已添加到Target配置窗口中。
在配置租户ID和客户端代码字段时,请注意以下事项:
在这两种情况下,请注意:
如前所述,第一个案例是AEM 6.5中最常见的案例。无论哪种情况,请确保 both 字段包含正确的信息,具体取决于您的要求。
如果要更改现有Target配置: