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

创建自定义事件

上次更新时间： 2025年10月24日

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

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

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

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

请注意：在传统的自定义事件工具中创建的任何事件在 2025 年 8 月 1 日之后将不再有效。

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

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

通过 API 创建事件

如果你通过API向HubSpot发送数据，你可以使用通过API发送 选项 ，或者使用 自定义事件定义端点 创建事件。有关定义 API 调用的更多信息，请参阅HubSpot 的开发人员文档。

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

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

完成创建通过API发送数据的事件：

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

查找现有事件的内部事件名称和属性名称：

  1. 在 HubSpot 账户中，导航至数据管理>事件管理。
  2. 点击事件名称。然后你将进入事件详细信息页面。
  3. 在顶部，找到内部名称下的事件名称。要复制内部名称，请单击名称旁边的复制图标。

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

使用 Javascript 代码段创建事件

  1. 在 HubSpot 账户中，导航至数据管理>事件管理。
  2. 在右上角单击 "创建事件"，然后选择 "创建自定义事件"。
  3. 选择代码 Javascript。
custom-event-code-javascript
  1. 输入事件名称并选择提供事件描述。
  2. 选择关联对象。这样，您就可以将事件发生与 HubSpot 中的不同对象关联起来，包括联系人、公司、交易和门票。
custom-event-event-name
  1. 单击下一步。

添加属性

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

  1. 要关闭创建默认事件属性，请将默认事件属性切换为关闭。
  2. 要创建自定义属性，请单击属性的字段类型来选择属性类型。选项包括
    • 自定义字符串属性：创建纯文本字符串属性。
    • 自定义数字属性：创建一个数值属性。
    • 自定义时间戳属性：创建日期值属性。您必须以纪元毫秒或 ISO8601 的形式发送数据。
    • 自定义日期属性：创建一个日期值属性。
    • 自定义布尔属性：创建一个布尔值属性。
    • 自定义枚举属性：创建具有一组预定义值的属性。
  3. 选定属性后，在右侧面板中配置属性：

custom-event-create-a-custom-property

  1. 输入属性名称和属性描述。
    • 对于枚举属性，单击下一步并输入属性标签和值。
      • 枚举属性可以是单选或多选值。要启用多选值，请打开支持多选值切换。
custom-event-enumeration-form
      • 您必须在发送数据前设置值和标签。如果在发送不在列表中的数据前没有完成这一步骤，数据将无法使用。要通过 API 发送多个值，请用分号分隔它们。
请注意： 无法导入多选枚举属性。
  1. 单击下一步。
  2. 设置好事件及其属性后，您可以通过选择 Javascript 代码片段将此事件添加到网站的跟踪代码中。
  3. 单击完成。

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

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

    custom-event-javascript-code-snippet

导入活动数据

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

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

same-custom-events-file

示例文件

导入自定义事件：

  1. 在你的 HubSpot 账户中，导航至数据管理>事件管理。
  2. 在右上角单击 "创建事件"，然后选择 "创建自定义事件"。
  3. 选择导入电子表格。
  4. 输入事件名称并选择提供事件描述。
  5. 选择关联对象。目前，通过导入创建的事件只能与联系人关联。
  6. 上传文件。选择导入对象的方式和文件语言，然后单击下一步。
  7. 将列映射到事件和联系人属性，然后单击下一步。
  8. 确认导入文件的名称。
  9. 单击复选框，同意联系人希望收到您的回复，以及您的导入文件不包括已购买列表。了解有关HubSpot 可接受使用政策的更多信息。
  10. 选择 "发生在 "属性的日期格式。
  11. 单击完成导入。

通过 API 创建事件

  1. 在您的 HubSpot 账户中，导航至数据管理>事件管理。
  2. 在右上角，单击 "创建事件"，然后选择 "创建自定义事件"。
  3. 选择通过 API 发送。
  1. 输入事件名称，并选择提供事件描述。
  1. 添加自定义事件属性：
    • 键入属性名称。此名称也将应用于内部名称 。
    • 单击字段类型下拉菜单，选择字段类型。
    • 可选择添加描述。
    • 如果要添加更多自定义属性，请单击+ 添加自定义属性。
    • 单击下一步。
  1. 链接对象
    • 单击选择主要对象下拉菜单，然后选择关联对象。这样，您就可以将事件发生与不同的对象关联起来，包括联系人、公司、交易和门票。
    • 单击自定义匹配，选择事件和对象记录之间的匹配 ID。只有当匹配 ID 相同时，事件才会链接到对象记录。如果使用自定义匹配 ID，则所选对象属性必须要求唯一值。
  2. 单击下一步。
  3. 要在 HubSpot 中跟踪事件，请单击跟踪 ID 旁的 "复制"。
  4. 单击创建事件。

请注意

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

设置网络钩子

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

  1. 在 HubSpot 账户中，导航至数据管理>事件管理。
  2. 在右上角，单击 "创建事件"，然后选择 "创建自定义事件"。
  3. 选择设置网络钩子。
  4. 输入事件名称并选择关联对象。
  5. 单击下一步。
  6. 设置一个测试事件：
    • 复制网络钩子 URL。
    • 导航到要集成的第三方应用程序的Webhook 设置页面。
    • 粘贴复制的 URL。
    • 单击发送测试事件。
  7. 单击下一步。
  8. 查看 webhook 的属性。单击属性类型 下拉菜单，选择属性类型。
  1. 单击下一步。
  2. 从第三方网络钩子中选择与 HubSpot 对象属性完全匹配的属性。

unique-property-webhook

使用自定义事件数据

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

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

报告自定义事件

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

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

在联系人时间轴上查看事件发生情况

事件发生将显示在联系人记录时间轴上，同时显示已填充的任何属性。

在联系人时间轴上查看事件详情：

  1. 导航到发生自定义事件的联系人记录。
  2. 要根据事件发生情况过滤联系人时间轴，请单击过滤活动，然后选择自定义事件。
  3. 在联系人时间轴中，单击展开事件以显示事件详细信息。

请注意：您无法查看使用网络钩子创建的自定义事件的时间轴活动。

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

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

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

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

然后，工作流程会延迟注册记录，直到它们满足指定的自定义事件标准或在事件发生时触发。
这篇文章有帮助吗？
此表单仅供记载反馈。了解如何获取 HubSpot 帮助。
目录 菜单

相关内容

New call-to-action