手动配置与Adobe Target的集成 manually-configuring-the-integration-with-adobe-target
您可以修改使用向导时所做的选择加入向导配置,也可以不使用向导手动与Adobe Target集成。
修改选择加入向导配置 modifying-the-opt-in-wizard-configurations
此 选择加入向导 该 将AEM与Adobe Target集成 自动创建一个名为已设置Target配置的Target云配置。 该向导还会为名为“已设置的Target框架”的云配置创建一个Target框架。 您可以修改云配置和框架的属性(如有必要)。
您还可以通过配置A4T Analytics Cloud配置,将Adobe Target配置为在定位内容时使用Adobe Target作为报表源。
要找到云配置和框架,请导航到 Cloud Service via 工具 > 部署 > 云. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)在Adobe Target下,单击 显示配置.
已设置的目标配置属性 provisioned-target-configuration-properties
以下属性值用于选择加入向导创建的已设置Target配置云配置中:
-
客户端代码: 在选择加入向导中输入。
-
电子邮件: 在选择加入向导中输入。
-
密码: 在选择加入向导中输入。
-
API类型: REST
-
从Adobe Target同步区段: 已选定。
-
客户端库: mbox.js.
-
使用DTM提供客户端库: 未选择。 如果符合以下条件,请选择此选项 使用DTM 或其他标记管理系统来托管mbox.js或AT.js文件。 Adobe建议您使用DTM而不是AEM来交付库。
-
自定义mbox.js: 未指定以便使用默认的mbox.js文件。 根据需要指定要使用的自定义mbox.js文件。 仅当您选择了mbox.js时显示。
-
自定义AT.js: 未指定以便使用默认的AT.js文件。 根据需要指定要使用的自定义AT.js文件。 仅当您选择了AT.js时才显示。
- 缩短了 Web 实现的页面加载时间
- 提高了安全性
- 改善了针对单页应用程序的实施选项
- AT.js包含target.js中包含的组件,因此不再需要调用target。
已设置的目标框架属性 provisioned-target-framework-properties
选择加入向导创建的预配目标框架配置为从配置文件数据存储中发送上下文数据。 默认情况下,存储区的年龄和性别数据项会发送到Target。 您的解决方案可能需要发送其他参数。
您可以配置框架以向Target发送其他上下文信息,如中所述 添加Target框架.
配置A4T Analytics Cloud配置 configuring-a-t-analytics-cloud-configuration
您可以将Adobe Target配置为在定位内容时使用Adobe Analytics作为报表源。
为此,您可以指定将您的Adobe Target云配置连接到的A4T云配置:
-
导航到 Cloud Service 通过 AEM徽标 > 工具 > 部署 > Cloud Service.
-
在 Adobe Target 部分中,单击 立即配置。
-
重新连接到您的Adobe Target配置。
-
在 A4T Analytics Cloud配置 下拉菜单中,选择框架。
note note NOTE 只有为A4T启用的Analytics配置可用。 使用AEM配置A4T时,您可能会看到缺少条目的配置引用。 要能够选择分析框架,请执行以下操作: - 导航到 工具 > 常规 > CRXDE Lite.
- 导航至 A4T分析配置对话框 (见下文)
- 设置属性 disable 到 false.
- 单击 全部保存。
A4T分析配置对话框 a4t-analytics-config-dialog
/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
单击 确定. 使用Adobe Target定位内容时,您能够 选择您的报表源.
手动与Adobe Target集成 manually-integrating-with-adobe-target
手动与Adobe Target集成,而不是使用选择加入向导。
- 缩短了 Web 实现的页面加载时间
- 提高了安全性
- 改善了针对单页应用程序的实施选项
- AT.js 包含 target.js 具有的组件,因此不再调用 target.js
创建 Target 云配置 creating-a-target-cloud-configuration
要启用 AEM 以便与 Adobe Target 交互,请创建 Target 云配置。要创建配置,您需要提供 Adobe Target 客户端代码和用户凭据。
您只需创建一次 Target 云配置,因为您可以将该配置与多个 AEM 活动关联。如果您有多个 Adobe Target 客户端代码,请为每个客户端代码创建一个配置。
您可以配置云配置以从 Adobe Target 同步片段。如果启用同步,则在保存云配置时,将在后台从Target导入区段。
使用以下过程可在 AEM 中创建 Target 云配置:
-
导航到 Cloud Service 通过 AEM徽标 > 工具 > Cloud Service > 旧版Cloud Service. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
此 Cloud Service “概述”页面将打开。
-
在 Adobe Target 部分中,单击 立即配置。
-
在 创建配置 对话框中:
- 为配置提供 标题。
- 选择 Adobe Target 配置 模板。
- 单击 创建。
此时将打开编辑对话框。
note note NOTE 使用AEM配置A4T时,您可能会看到缺少条目的配置引用。 要能够选择分析框架,请执行以下操作: - 导航到 工具 > 常规 > CRXDE Lite.
- 导航到 /libs/cq/analytics/components/testandtargetpage/dialog/items/tables/items/tab1_general/items/a4tAnalyticsConfig
- 设置属性 disable 到 false.
- 单击 全部保存。
-
在对话框中,提供这些属性的值。
-
客户端代码:Target 帐户的客户端代码
-
电子邮件:Target帐户电子邮件。
-
密码:Target帐户密码。
-
API类型:REST或XML
-
A4T Analytics Cloud配置:选择用于Target活动目标和量度的Analytics Cloud配置。 如果您在定位内容时使用Adobe Analytics作为报表源,则需要此配置。 如果您看不到云配置,请参阅中的注释 配置A4T Analytics Cloud配置.
-
使用准确定位: 默认情况下,此复选框处于选中状态。如果选中,云服务配置会等待上下文加载完后再加载内容。 请参阅以下注释。
-
从Adobe Target同步区段: 选择此选项后,您可以下载Target中定义的区段以在AEM中使用它们。 当API类型属性为REST时,选择此选项,因为内联区段不受支持,您必须从Target使用区段。 (AEM术语“区段”等同于Target“受众”。)
-
客户端库: 选择需要mbox.js还是AT.js客户端库。
-
使用DTM提供客户端库 — 选择此选项可使用DTM或其他标记管理系统中的AT.js或mbox.js。 配置 dtm集成 以使用此选项。 Adobe建议您使用DTM而不是AEM来交付库。
-
自定义mbox.js:如果选中DTM框或使用默认的mbox.js,则保留为空。 或者,上传您的自定义mbox.js。 仅当您选择了mbox.js时显示。
-
自定义AT.js:如果选中DTM框或使用默认的AT.js,则保留为空。 或者,上传您的自定义AT.js。 仅当您选择了AT.js时才显示。
note note NOTE 默认情况下,当您选择加入 Adobe Target 配置向导时,将启用“准确定位”。 准确定位意味着,云服务配置将等到上下文加载完后,再加载内容。因此,就性能而言,准确定位可能会导致加载内容前有几毫秒的延迟。 对于创作实例,“准确定位”始终处于启用状态。但在发布实例上,您可以通过清除云服务配置中“准确定位”旁边的复选标记来选择全局关闭准确定位 (http://localhost:4502/etc/cloudservices.html)。无论您在云服务配置中的设置如何,您都可以为各个组件打开和关闭“准确定位”。 如果您 已经 创建目标组件并更改此设置,则您的更改不会影响这些组件。直接更改这些组件。 -
-
单击 连接到Target 初始化与Target的连接。 如果连接成功,则将显示消息 连接成功。单击消息上的 确定,然后单击对话框上的 确定。
如果无法连接到 Target,请参阅疑难解答部分。
添加 Target 框架 adding-a-target-framework
配置 Target 云配置后,可以添加 Target 框架。此框架标识从可用发送到Adobe Target的默认参数 客户端上下文 或 ContextHub 组件。 Target 使用参数来确定适用于当前上下文的分段。
您可以为单个 Target 配置创建多个框架。当您必须为网站的不同部分向Target发送一组不同的参数时,多个框架会很有用。 为您发送的每组参数创建一个框架。 将网站的每个部分与适当的框架关联。一个网页一次只能使用一个框架。
-
在Target配置页面上,单击 + (加号)图标。
-
在“创建框架”对话框中,指定 标题,选择 Adobe Target 框架,然后单击 创建。
这将打开框架页面。Sidekick提供的组件表示来自以下各项的信息: 客户端上下文 或 ContextHub 可以映射的图象。
-
将表示要用于映射的数据的客户端上下文组件拖动到放置目标。或者,拖动 ContextHub存储 组件添加到框架。
note note NOTE 映射时,参数通过简单字符串传递给 mbox。无法从 ContextHub 映射数组。 例如,要使用 配置文件数据 关于要控制Target促销活动的网站访客,请拖动 配置文件数据 组件添加到页面。 可用于映射到 Target 参数的配置文件数据变量随即显示。
-
通过选中相应列中的 共享 复选框,选择要对 Adobe Target 系统可见的变量。
note note NOTE 同步参数是唯一方式 – 从 AEM 到 Adobe Target。
此时将创建您的框架。要将框架复制到发布实例,请使用 sidekick 中的 激活框架 选项。
将活动与Target云配置关联 associating-activities-with-the-target-cloud-configuration
关联您的 AEM活动 使用Target云配置,以便镜像中的活动 Adobe Target.
-
如果 xt_only 在AEM端使用的Adobe Target租户(clientcode)上启用选项以连接到Adobe Target,然后您可以创建 仅限 AEM XT活动。
-
如果 xt_only 选项为 非 已在Adobe Target租户(clientcode)上启用,然后您可以创建 两者 AEM中的XT和A/B活动。
将Target框架与您的站点关联 associating-the-target-framework-with-your-site
在AEM中创建Target框架后,将网页与该框架关联。 页面上的目标组件会将框架定义的数据发送到Adobe Target进行跟踪。 (请参阅 内容定位.)
将页面与框架关联时,子页面将继承关联。
Target连接问题疑难解答 troubleshooting-target-connection-problems
要排除连接到Target时出现的问题,可以执行以下任务:
- 确保您提供的用户凭据正确。
- 确保AEM实例可以连接到Target服务器。 例如,请确保防火墙规则未阻止出站AEM连接,或者已将AEM配置为使用必要的代理。
- 在AEM错误日志中查找有用的消息。 error.log文件位于 crx-quickstart/logs 安装AEM的目录。
- 在Adobe Target中编辑活动时,URL指向本地主机。 通过将AEM外部化器设置为正确的URL来解决此理解。