跳到内容

创建自定义事件

上次更新时间: 二月 13, 2025

除非另有说明,否则适用于以下任何订阅

营销 Hub   Enterprise
销售 Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
内容 Hub   Enterprise

自定义事件允许您定义和跟踪企业特有的事件。自定义事件可与事件属性绑定,然后可在 HubSpot 的工具中使用。

创建自定义事件有多种方法:

  • 通过 API 发送: 使用自定义事件定义端点创建事件。然后,使用事件 ID 和发送自定义事件端点将事件完成情况发送到 HubSpot。
  • 无需 API 即可从网站获取数据:
    • 代码 Javascript:使用自定义 Javascript,您可以通过代码编辑器在 HubSpot 跟踪脚本中插入自定义代码。
    • 使用事件可视化器(仅限Marketing Hub Enterprise):通过在网站上选择页面浏览量或点击的元素来跟踪页面浏览量或点击的元素。了解有关使用事件可视化器创建自定义事件的更多信息。
  • 导入电子表格:上传事件数据电子表格,以捕获离线活动、回填数据或手动将任何工具与 HubSpot 集成。
  • 设置网络钩子(仅限Operations Hub 专业版和企业版): 自定义触发网络钩子的条件以及将发送的数据。

请注意:自定义事件工具取代了以前的事件传统工具。在传统工具中创建的任何事件都将继续工作,您仍可以在传统工具中管理和分析这些事件

事件创建过程包括两个部分:

  • 在 HubSpot 中定义事件,包括任何自定义事件属性。
  • 创建 Javascript 代码片段或定义 将触发事件的API 调用

通过 API 创建事件

如果要通过 API 向 HubSpot 发送数据,可以使用通过 API 发送 选项 或使用 自定义事件定义端点 创建事件。在HubSpot的开发者文档中了解有关定义API调用的更多信息。

你需要为你的API调用提供一些信息,你可以从HubSpot内部获取这些信息:

  • 事件名称:事件的内部名称。
  • 属性名称:你要发送数据的属性的内部名称。

完成创建事件,通过 API 发送数据:

  • 选择向 HubSpot 发送数据 ,然后复制跟踪 ID。
  • 点击创建。

为现有事件和属性名称查找内部事件名称:

  • 在 HubSpot 帐户中,导航到数据管理 > 自定义事件
  • 单击自定义事件。
  • 单击事件名称。然后你将进入事件详细信息页面。
  • 在顶部,找到内部名称下的事件名称。

  • 要查找要更新的属性的内部名称,请单击属性名称。
  • 在右侧面板中,单击代码图标,然后查看内部名称下的名称。
请注意:
在向事件发送数据时,以下限制适用:
  • 属性名称限制为 50 个字符。
  • URL 和推荐人属性最多可接收 1024 个字符,所有其他属性最多可接收 256 个字符。
  • 每个事件完成最多可包含 50 个属性的数据。
  • 属性内部名称必须以字母开头,且只包含小写字母 a-z、数字 0-9 和下划线。内部名称小写后相同的属性会被视为重复,完成时只会使用其中一个属性。
如果 HTTP API 请求超出这些限制,请求将失败。如果在进行 JS API 请求时超过这些限制,HubSpot 将把任何属性名称值截断到允许长度,并且/或者每个事件完成时只更新 50 个属性。

使用 Javascript 代码片段创建事件

  • 在 HubSpot 帐户中,导航到数据管理 > 自定义事件
  • 在右上角单击 "创建事件"。
  • 选择代码 Javascript。

  • 单击下一步。
  • 输入事件名称,并可选择提供事件描述。
  • 选择关联对象。这样,您就可以将事件完成情况与 HubSpot 中的不同对象关联起来,包括联系人、公司、交易和门票。


  • 单击下一步。

添加属性

创建事件时,将提供默认事件属性。您也可以创建自己的自定义属性。事件属性与其他 CRM 属性分开存储,并且是事件的唯一属性(即无法从账户设置中编辑这些属性)。

  • 要关闭创建默认事件属性,请将默认事件属性切换为关闭。
  • 要创建自定义属性,请单击属性的字段类型来选择属性类型。选项包括
    • 自定义字符串属性:创建纯文本字符串属性。
    • 自定义数字属性:创建一个数字值属性。
    • 自定义时间戳属性:创建日期值属性。您必须以纪元毫秒或 ISO8601 的形式发送数据。
    • 自定义枚举属性:创建一个具有一组预定义值的属性。

    • 选择属性后,在右侧面板中配置属性:

    • 输入属性名称和属性描述。
    • 对于枚举属性,单击下一步并输入属性标签和值。
      • 枚举属性可以是单选或多选值。要启用多选值,请打开支持多选值切换。

      • 在发送数据之前,必须先设置值和标签。如果在发送不在列表中的数据前没有完成这一步骤,数据将无法使用。要通过 API 发送多个值,请用分号分隔它们。
请注意: 无法导入多选枚举属性。
    • 单击完成。
  • 单击下一步。
  • 设置好事件及其属性后,就可以通过选择 Javascript 代码片段将此事件添加到网站的跟踪代码中。

使用 Javascript 代码片段创建事件可以自动将 Javascript 添加到 HubSpot 跟踪代码中。这可用于捕获跟踪代码默认不捕获的更复杂的事件数据。

  • 选择Javascript 代码片段。使用右侧面板中的代码段在 HubSpot 中跟踪事件。代码段中将预定义创建的任何自定义属性。
  • 在右侧面板中输入文本,根据需要修改代码段。你添加的任何代码都将自动包含在 HubSpot 跟踪代码中。
  • 完成后,单击 "创建 " 完成事件并自动开始跟踪。

导入事件数据

上传您的个人活动出席数据、来自未与 HubSpot 集成的应用程序的带有时间戳的数据、来自供应商的一次性潜在客户或活动数据,或任何其他电子表格形式的活动数据。事件允许你捕捉行为,然后在 HubSpot 中使用这些行为。

导入可以 创建和更新 联系人记录。 事件导入只能用于已经发生的事件。 自定义事件导入文件必须包含以下内容:

文件示例

导入自定义事件:

  • 在 HubSpot 帐户中,导航到数据管理 > 自定义事件
  • 在右上角单击创建事件。
  • 选择导入电子表格。

  • 单击下一步。
  • 输入事件名称并选择提供事件描述。
  • 选择关联对象。目前,通过导入创建的事件只能与联系人关联。

  • 将列映射到事件和联系人属性,然后单击下一步。
  • 确认导入文件的名称。
  • 单击复选框,同意联系人希望收到您的来信,以及您的导入文件不包括已购买列表。了解有关HubSpot 可接受使用政策的更多信息。
  • 选择 "发生在 "属性的日期格式。
  • 单击完成导入。

设置网络钩子

设置触发网络钩子的条件。

  • 在 HubSpot 帐户中,导航到数据管理 > 自定义事件
  • 在右上角单击 "创建事件"。
  • 选择设置网络钩子。
  • 单击下一步。
  • 输入事件名称并选择关联对象。



  • 单击下一步。
  • 设置测试事件:
    • 复制Webhook URL。
    • 导航到要集成的第三方应用程序的Webhook 设置页面。
    • 粘贴复制的 URL。
    • 单击发送测试事件。
  • 单击下一步。
  • 查看 webhook 的属性。单击属性类型 下拉菜单,选择属性类型。
  • 点击下一步。
  • 从第三方网络钩子中选择与 HubSpot 对象属性完全匹配的属性。

使用自定义事件数据

自定义事件数据可在 HubSpot 工具中查看和使用。下面,我们将介绍在哪里查看活动完成情况,以及将这些数据纳入其他工具的方法。

您可以使用事件列表中的操作下拉菜单、单个事件视图或分析选项卡中图表的右上角,在选定的 HubSpot 工具中直接打开所选事件。

报告自定义事件

可通过自定义事件工具分析自定义事件完成情况,自定义报告生成器和归因报告中也将提供事件数据。

了解有关分析自定义事件的更多信息。

在联系人时间轴上查看事件完成情况

事件完成情况将显示在联系人记录时间轴上,同时显示已填充的任何属性。

要在联系人时间轴上查看事件详情,请执行以下操作

  • 导航到已完成自定义事件的联系人记录
  • 要按已完成事件筛选联系人时间线,请单击筛选活动,然后选择自定义事件。
  • 在联系人时间轴中,单击展开事件以显示事件详情。

在工作流程中使用自定义事件

在工作流程中,您可以使用 "延迟直到事件发生" 操作或事件注册触发器,根据自定义事件完成情况进行延迟。

  • 在 HubSpot 帐户中,导航到自动化 > 工作流
  • 单击工作流程的名称。或者,了解如何创建新工作流
  • 添加触发器
    • 在工作流程编辑器中,单击设置触发器。
    • 在左侧面板中,选择事件发生时。设置触发器,然后单击应用筛选器。
    • 要进一步细化触发器,请单击添加细化筛选器。您可以选择其他属性来细化要加入工作流程的对象。
    • 默认情况下,记录只有在首次满足注册触发器时才会注册到工作流程中。要启用重新注册,请在[对象]应重新注册到此工作流中吗?部分中选择是,每次触发时都重新注册。
  • 要添加延迟
    • 在工作流程编辑器中,单击+ 加号图标添加工作流程操作。
    • 在右侧面板中,选择 "延迟直到事件发生"。
    • 配置延迟时间:
      • 单击事件下拉菜单,然后选择自定义事件。
      • 然后,选择要延迟的事件属性。
      • 选择事件属性的过滤器。
      • 单击应用过滤器。
      • 选择最长等待时间,或选择尽可能长的延迟 复选框。
  • 单击保存。

请注意:所有事件注册触发器都将使用 OR 运算符分隔。这意味着只有一个事件注册触发器发生,记录才能注册到工作流程中。

然后,工作流程将延迟注册记录,直到它们满足指定的自定义事件标准或在事件发生时触发。

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助