文档TargetTarget开发人员指南

adobe.target.trackEvent(options)

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

创建对象：

  • 开发人员

此函数会触发用户操作（例如点击和转化）报告请求。它不会在响应中交付活动。

这些事件跟踪 mbox 调用可以用来定义活动中的量度。有关更多信息，请参阅成功量度和跟踪转化。

以下是该 API 的详细信息：

键类型必需描述
mbox字符串是

Mbox 名称

注意：如果通过页面上已触发的mbox名称触发trackEvent()调用，则trackEvent()的SDID将重置，并且将与页面上的Target调用不同。 但是，使用不同的mbox名称触发trackEvent()调用可使trackEvent()调用的SDID与页面上的Page Load Request/triggerView()调用一致。

selector字符串否用于查找 HTML 元素的 CSS 选择器。事件监听程序将附加到找到的元素。
type字符串否表示已注册的事件类型。它既可以是 HTML 已知的事件，如：click、mousedown 等，也可以是自定义 HTML 事件。
preventDefault布尔值否

表示是否在事件监听程序回调中使用 event.preventDefault()。默认为 false。

注释：仅支持form[submit]和a[click]。 由于复杂性和要支持的方案数量太多，因此其他方案不受支持。

参数对象否

Mbox 参数。键值对这一对象具有以下结构：

{ "param1": "value1", "param2": "value2"}

timeout数值否

以毫秒为单位的超时时间。

如果未指定，则使用默认值：

...timeoutInSeconds: 0.15...}

success函数否用于表示该事件已报告的回调函数。
error函数否用于表示该事件无法报告的回调函数。

示例

<a href="https://asite.com">click me!</a>

加上用于分配 trackEvent 的 javaScript 代码：

<script>
$('a').click(function(event){
  adobe.target.trackEvent({'mbox':'homePageHero'})
});
</script>

或：

adobe.target.trackEvent({
    "mbox": "clicked-cta",
    "params": {
        "param1": "value1"
    }
});
WARNING
如果未设置必填字段，则不会执行请求，并会引发错误。
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3