Show Menu
主题×

at.js 自定义事件

有关 at.js custom events 的信息,可让您知道 mbox 请求或选件何时失败或成功。
一直以来,mbox.js 并不允许在页面上运行的其他 JavaScript 代码了解后台的情况。随着 at.js 的进步,我们有一个难得的机会来解决此问题。
根据客户的反映,他们想要在几种情况出现时得到通知,包括:
  • 由于超时、状态码错误、JSON 解析错误等原因,mbox 请求失败。
  • 某个 mbox 请求成功。
  • 由于封装 mbox 元素缺失、无法找到选择器等原因,导致选件渲染失败。
  • 选件渲染成功。已应用 DOM 更改。
预定义事件具有一个结构,允许您根据事件类型提取所需的数据。
为了确保可以在不同方案中使用事件,自定义事件具有一个有效负荷对象,该对象被分配给事件对象的详细属性(传递给处理程序)。另外,为了避免将字符串作为事件名称传递,系统会使用 adobe.target.event 命名空间将这些事件作为常量显示。

结构

键值
类型
描述
type
字符串
在有些情况下,您希望了解如何跟踪、调试和自定义与 at.js 的交互。
下面列出的每个自定义事件都有两种格式:“常量”和“字符串值”。
  • 常量 :前面预置 adobe.target.event. ,全部大写,并包含下划线字符。要在加载 at.js 之后 、收到 mbox 响应​ 之前 ​订阅自定义事件,请使用常量。
  • 字符串值 :小写并包含破折号。要在加载 at.js 之前 ​订阅自定义事件,请使用字符串值。
请求失败
常数:字 adobe.target.event.REQUEST_FAILED
符串值:描 at-request-failed
述:由于超时、错误的状态代码、JSON解析错误等原因,mbox请求失败。
请求成功
常量: adobe.target.event.REQUEST_SUCCEEDED
字符串值: at-request-succeeded
描述:mbox 请求成功。
内容渲染失败
常量: adobe.target.event.CONTENT_RENDERING_FAILED
字符串值: at-content-rendering-failed
描述:由于封装 mbox 元素缺失、无法找到选择器等原因,选件渲染失败。
内容渲染成功
常量: adobe.target.event.CONTENT_RENDERING_SUCCEEDED
字符串值: at-content-rendering-succeeded
描述:选件渲染已成功。已应用 DOM 更改。
已加载库
常量: adobe.target.event.LIBRARY_LOADED
字符串值: at-library-loaded
描述:此事件非常适用于跟踪 at.js 完全加载的时间。您可以使用此事件来自定义全局 mbox 执行。您也可以使用此事件来禁用全局 mbox,然后侦听此事件以便稍后再触发全局 mbox。
请求启动
常量: adobe.target.event.REQUEST_START
字符串值: at-request-start
描述:此事件在执行 HTTP 请求之前触发。您可以使用此事件进行使用 Resource Timing API 的性能测量。
内容渲染启动
常量: adobe.target.event.CONTENT_RENDERING_START
字符串值: at-content-rendering-start
描述:此事件在启动选择器轮询并将内容渲染到页面之前触发。您可以使用此事件来跟踪内容渲染进度。
内容渲染(无选件)
常量: adobe.target.event.CONTENT_RENDERING_NO_OFFERS
字符串值: at-content-rendering-no-offers
描述:此事件在未返回选件时触发。
内容渲染重定向
常量: adobe.target.event.CONTENT_RENDERING_REDIRECT
字符串值: at-content-rendering-redirect
描述:此事件在选件是重定向选件并且 Target 将重定向到其他 URL 时触发。
mbox
字符串
mbox 名称
message
字符串
包含通俗易懂的描述,例如出现什么错误、错误消息等。
tracking
对象
包含 sessionId deviceId 。在某些情况下, deviceId 可能缺失,因为 Target 无法从边缘服务器检索到它。

使用情况

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) { 
  console.log('Event', event); 
});

培训视频:响应令牌和 at.js 自定义事件

观看以下视频,了解如何使用响应令牌和 at.js 自定义事件将 Target 中的配置文件信息共享到第三方系统。