文档TargetTarget开发人员指南

at.js 的工作原理

最近更新: 2025年5月5日
  • 主题:

创建对象:

  • 开发人员

在客户端实施 Adobe Target 必须使用 at.js JavaScript 库。

在 Adobe Target 的客户端实施中,Target 会将与活动相关联的体验直接交付给客户端浏览器。浏览器将决定要显示的体验,然后显示该体验。借助客户端实施,您可以使用 WYSIWYG 编辑器、可视化体验编辑器 (VEC),或者非可视化界面(基于表单的体验编辑器)来创建测试和个性化体验。

什么是 at.js?

at.js库是Adobe Target的客户端实施的实施库。 使用 at.js 库可缩短 Web 实施的页面加载时间,并为单页应用程序提供更好的实施选项。at.js 是推荐使用的实施库,会经常更新功能。我们建议所有客户实施或迁移到最新版本的at.js。

有关更多信息,请参阅 Target JavaScript 库。

在下图所示的Target实现中,已实现以下Adobe Experience Cloud解决方案: Analytics、Target和Audience Manager。 此外,还实施了以下Experience Cloud个核心服务: Adobe Experience Platform、Audiences和Visitor ID Service。

at.js 1.x 和 at.js 2.x 工作流程图之间有何差异?

请参阅从 at.js 1.x 升级到 at.js 2.x,以了解有关 2.O 与 1.x 之间的差异。

从高层次来看,两个版本之间存在一些差异:

  • at.js 2.x 没有全局 mbox 请求概念,但有页面加载请求概念。页面加载请求可以视为检索应该被应用于网站初始页面加载的内容的请求。
  • at.js 2.x管理名为Views的概念,这些概念用于单页应用程序(SPA)。 at.js 1.x 并没有此概念。

at.js 2.x 图

下图可帮助您了解含有Views的at.js 2.x工作流程以及其如何增强SPA集成。 要更好地了解 at.js 2.x 中使用的概念,请参阅单页应用程序实施。

(单击图像可展开至全宽。)

使用at.js 2.x 的Target流程

步骤详细信息
1如果用户通过了身份验证,则调用会返回 Experience Cloud ID;另一调用会同步客户 ID。
2at.js 库会同步加载,并隐藏文档正文。
也可以选择预先隐藏页面上实施的代码段,以异步方式加载 at.js。
3将会发出页面加载请求,其中包括已配置的所有参数(例如,MCID、SDID 和客户 ID)。
4配置文件脚本在执行后进入Profile Store。 Sto从Audience Library重新请求符合条件的受众(例如,从Adobe Analytics、Audience Manager等共享的受众)。
客户属性会以批量过程发送到Profile Store。
5根据 URL 请求参数和配置文件数据,Target 可决定将哪些活动和体验返回给查看当前页面和未来视图的访客。
6目标内容会发送回页面,其中可能包含其他个性化的配置文件值。
当前页面上的目标内容会在默认内容不发生闪烁的情况下尽快显示。
作为用户在 SPA 中操作结果而显示的视图的针对性内容,将缓存在浏览器中,这样便可在通过 triggerView() 触发视图时即时应用而无需额外的服务器调用。
7Analytics数据被发送到Data Collection服务器。
8目标数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。然后,便可以在Analytics和Target中通过(A4T)报表查看
Analytics数据。

现在,无论在SPA上执行什么位置triggerView(),都会从缓存中检索Views和操作并向用户显示,而无需服务器调用。 triggerView() 还会向 Target 后端发出通知请求,以增加和记录展示次数计数。有关带有视图的 SPA 的 at.js 的更多信息,请参阅单页应用程序实施。

(单击图像可展开至全宽。)

Target流程at.js 2.x triggerView

步骤详细信息
1在SPA中调用triggerView()以渲染View并应用操作来修改可视化元素。
2从缓存中读取视图的目标内容。
3目标内容会在默认内容不发生闪烁的情况下尽快显示。
4通知请求将发送到Target Profile Store以计算活动中的访客和递增量度。
5Analytics数据已发送至Data Collection Servers。
6Target数据通过SDID与Analytics数据匹配,并且已处理到Analytics报表存储中。 然后,便可以在Analytics和Target中通过A4T报表查看Analytics数据。

视频 - at.js 2.x 架构图

at.js 2.x 增强了 Adobe Target 对 SPA 的支持,并与其他 Experience Cloud 解决方案集成。该视频介绍了如何将所有内容结合到一起。

https://video.tv.adobe.com/v/26250/?quality=12

有关更多信息,请参阅了解 at.js 2.x 的工作方式。

at.js 1.x 流程图

下图可帮助您了解at.js 1.x的工作流程。

(单击图像可展开至全宽。)

Target流程at.js 1.x

步骤描述调用描述
1如果用户通过了身份验证,则调用会返回Experience CloudID (MCID);另一调用会同步客户ID。2at.js 库会同步加载,并隐藏文档正文。
3将会发出全局 mbox 请求,其中包括已配置的所有参数,例如 MCID、SDID 和访客 ID(可选)。4配置文件脚本在执行后进入配置文件存储区。存储区向受众库请求符合条件的受众(例如,从Adobe Analytics、Audience Manager等共享的受众)。
客户属性会以批量过程发送到配置文件存储区。
5Target 根据 URL、mbox 参数和配置文件数据确定要返回给访客的活动和体验。6目标内容会发送回页面,其中可能包含其他个性化的配置文件值。
体验会在默认内容不发生闪烁的情况下尽快显示。
7Analytics 数据会发送到数据收集服务器。8Target数据会通过SDID匹配到Analytics数据,并且会进行相应处理以保存到Analytics报表存储中。然后,便可以在Analytics和Target中通过Analytics for Target (A4T)报表查看
Analytics数据。

视频 - 办公时间:at.js 提示和概述(2019 年 6 月 26 日)

此视频是“办公时间”的录像,“办公时间”是Adobe Customer Care团队发起的一项计划。

  • 使用 at.js 的优点
  • at.js 设置
  • 处理闪烁的情况
  • 调试 at.js
  • 已知问题
  • 常见问题解答
https://video.tv.adobe.com/v/27959/?quality=12

at.js 如何渲染带有 HTML 内容的选件

在渲染带有 HTML 内容的选件时,at.js 会应用以下算法:

  1. 预先加载图像(如果 HTML 内容中包含任何 <img> 标记)。

  2. 将 HTML 内容附加到 DOM 节点。

  3. 执行内联脚本(代码包含在 <script> 标记中)。

  4. 以异步方式加载并执行远程脚本(<script> 标记具有 src 属性)。

重要说明:

  • at.js 对远程脚本的执行顺序不提供任何保证,因为它们是异步加载的。
  • 内联脚本不应对远程脚本有任何依赖关系,因为远程脚本稍后才会加载和执行。
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3