有关 at.js custom events
的信息,可让您知道 mbox 请求或选件何时失败或成功。
一直以来,mbox.js 并不允许在页面上运行的其他 JavaScript 代码了解后台的情况。随着 at.js 的进步,我们有一个难得的机会来解决此问题。
根据客户的反映,他们想要在几种情况出现时得到通知,包括:
预定义事件具有一个结构,允许您根据事件类型提取所需的数据。
为了确保可以在不同方案中使用事件,自定义事件具有一个有效负荷对象,该对象被分配给事件对象的详细属性(传递给处理程序)。另外,为了避免将字符串作为事件名称传递,系统会使用 adobe.target.event
命名空间将这些事件作为常量显示。
键值 | 类型 | 描述 |
---|---|---|
type | 字符串 | 在有些情况下,您希望了解如何跟踪、调试和自定义与 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 自定义事件将 Target 中的配置文件信息共享到第三方系统。