跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

创建自定义事件

上次更新时间: 四月 8, 2025

可与以下任何订阅一起使用,除非另有说明:

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

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

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

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

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

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

  • 在 HubSpot 中定义事件,包括任何自定义事件属性。
  • 创建 Javascript 代码片段或定义 将触发事件的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 帐户中,导航到数据管理 > 自定义事件
  • 在右上角单击 "创建事件"。
  • 选择通过 API 发送
  • 输入活动名称,并可选择提供活动描述。单击下一步
  • 使用以下步骤添加属性。确保创建一个自定义事件属性来表示匹配的 ID。单击下一步
  • 链接对象:
    • 单击选择主要对象下拉菜单,然后选择关联对象。这样,您就可以将事件完成情况与不同的对象(包括联系人、公司、交易和门票)关联起来。
    • 单击自定义匹配,选择事件和对象记录之间的匹配 ID。只有当匹配 ID 相同时,事件才会链接到对象记录。如果使用自定义匹配 ID,则所选对象属性必须要求唯一值。
  • 单击下一步

请注意

  • 只能匹配相同数据类型的事件属性和对象属性。
  • 如有需要,您可以稍后编辑自定义匹配,但不能更改所选的主对象。

设置网络钩子

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

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

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

使用自定义事件数据

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

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

报告自定义事件

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

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

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

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

查看联系人时间轴上的活动详情:

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

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

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

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

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

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

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