跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

创建自定义事件

上次更新時間: 一月 7, 2025

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

行銷 Hub   Enterprise
銷售 Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

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

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

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

 

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

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

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

通过应用程序接口创建事件

如果通过 API 向 HubSpot 发送数据,则需要使用自定义事件定义端点来创建事件。然后,你需要定义 API 调用来触发事件。在HubSpot 的开发人员文档中了解如何定义 API 调用。

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

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

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

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

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

  • 在你的 HubSpot 帳戶中,瀏覽「資料管理」>「自訂事件」。
  • 单击自定义事件
  • 单击事件名称。然后您将进入事件详细信息页面。
  • 在顶部,找到内部名称下的事件名称。

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

用 Javascript 代码段创建事件

  • 在你的 HubSpot 帳戶中,瀏覽「資料管理」>「自訂事件」。
  • 在右上角单击 "创建事件"。
  • 选择代码 Javascript
code-javascript
  • 单击下一步
  • 输入事件名称,并可选择提供事件描述。
  • 选择关联对象。这样,您就可以将事件完成情况与 HubSpot 中的不同对象关联起来,包括联系人公司交易门票
custom-event-details

  • 单击下一步

添加属性

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

为事件创建属性

  • 点击属性的字段类型,选择属性类型。选项包括
    • 自定义字符串属性:创建纯文本字符串属性。
    • 自定义数字属性:创建一个数值属性。
    • 自定义时间戳属性:创建日期值属性。您必须以纪元毫秒或 ISO8601 的形式发送数据。
    • 自定义枚举属性:创建一个具有一组预定义值的属性。

      create-property-custom-behavioral-event
    • 选择属性后,在右侧面板中配置属性:

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

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

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

导入事件数据

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

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

same-custom-events-file

文件示例

导入自定义事件:

  • 在你的 HubSpot 帳戶中,瀏覽「資料管理」>「自訂事件」。
  • 在右上角单击 "创建事件"。
  • 选择导入电子表格
import-spreadsheet
  • 单击下一步
  • 输入事件名称,并可选择提供事件描述。
  • 选择关联对象目前,通过导入创建的事件只能与联系人关联。

custom-event-details

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

设置网络钩子

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

  • 在你的 HubSpot 帳戶中,瀏覽「資料管理」>「自訂事件」。
  • 在右上角单击 "创建事件"。
  • 选择设置网络钩子
  • 单击下一步
  • 输入事件名称并选择关联对象

webhook-event

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

unique-property-webhook

使用自定义事件数据

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

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

报告自定义事件

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

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

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

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

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

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

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

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

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

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

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

這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助