HubSpot的目的地


HubSpot的是一个入站营销和销售平台,可帮助公司吸引访客,转换潜在客户和近距离客户。manbetx客户端应用下载这analytics.jsHubSpot目的地是开源的。您可以浏览代码GitHub上

开始

在开始之前,请确保Hubspot支持您选择实现的源类型和连接模式。您可以了解更多信息这里的连接模式

网络 移动的 服务器
设备模式
☁️云模式
  1. 从段Web应用程序中,点击目录
  2. 在目录中搜索“HubSpot”,选择它,并选择将目标连接到哪个源。
  3. 如果您还没有这样做,添加您的API Key fromHubSpot的并在Segment web app的“API Key”字段中输入。
  4. 导航到HubSpot UI的“设置”页面,找到Hub ID,并在网段应用程序的“Hub ID”字段中输入它。

当您从段Web应用程序激活目的地时,您的更改将在段CDN中显示在大约45分钟内,然后Analytics.js开始异步加载Hubspot片段和录制数据。

页面

如果你对细分市场的规格不熟悉,可以看一看页面的方法所做的事。一个示例调用如下所示:

分析页面()

重要的是:一个初始页面使用Analytics.js将数据发送到HubSpot需要调用。这是默认包含在您的段代码片段

识别

如果你对细分市场的规格不熟悉,可以看一看识别方法所做的事。一个示例调用如下所示:

分析识别(user1234,{电子邮件:petergibbon.com,firstname:彼得,:长臂猿})

重要的是:HubSpot的设备模式集成有两个条件识别成功创建或更新联系人。一种traits.email值必须包含在其中页面或者追踪必须调用call。你可以从HubSpot的文档中阅读更多内容在这里。如果您使用的是Hubspot的云模式集成,则识别呼叫将在没有a的情况下更新记录页面或者追踪呼叫被需要。

HubSpot不接受任何包含大写字母或空格的trait键。所以对于任何你发送的自定义特征段将特征转换为小写,并用下划线替换任何空格。

HubSpot中没有联系字段的任何特征将从请求中删除。要找出可以设置哪些字段,请在其中签出自定义字段名称联系人>联系人设置。例如字段名是“firstname”,“lastname”,“company”,“phone”等。新万博app2.0下载

如果您指定一个公司名称(using新万博app2.0下载traits.新万博app2.0下载company.name.),它似乎是一个财产联系人的(你可以在HubSpot的用户界面中找到它使用关于[contact] > View >查看所有属性),但它并不显示为用户的公司新万博app2.0下载[联系]的公司新万博app2.0下载

以下特征在HubSpot中被标记为特殊字段:

  • 地址
  • 城市
  • 新万博app2.0下载公司名称
  • 电子邮件
  • firstName
  • 位置
  • 电话
  • 邮政编码

追踪

如果你对细分市场的规格不熟悉,可以看一看跟踪方法所做的事。一个示例调用如下所示:

分析。追踪(”点击ed Buy Now button", { value: 20.5 })

重要的是:你必须有一个HubSpot企业账户,用于描述来自于识别打电话给你的追踪呼叫并被成功发送HubSpot的自定义事件

事件将出现在HubSpot UI中,但可能需要60分钟才能出现在图形可视化中。

服务器

当从我们的任何服务器端资源调用时,您必须提供联系人的电子邮件作为properties.email.这样HubSpot就可以将事件与合适的联系人联系起来。Python中的调用示例如下:

分析追踪(user_id=“YOUR_USER_ID”,事件=购买物品的,特性={“电子邮件”:“peter@example.com”,})

在这种情况下,你的HubSpoteventId是买了物品的。如果您想使用现有的eventId,您可以使用它而不是事件值(即。买了物品)。如果你不想匹配现有的eventId,您可以使用任何事件标签,并且Hubspot将为您自动创建活动。

在轨道上设置触点属性

虽然我们建议你发送特征使用识别,您还可以在跟踪调用上设置Hubspot属性,允许其允许活动API.。如果您在识别请求上运行过API呼叫,您可能希望使用此方法。

将HubSpot联系人属性包含到context.traits对象:

分析追踪(user_id=“YOUR_USER_ID”,事件=购买物品的,特性={“电子邮件”:“peter@example.com”,},语境={“特征”:{“firstname”:'彼得',“姓”:“长臂猿”}})

集团

注意:组调用与我们的Analytics.js库不兼容。

如果你对细分市场的规格不熟悉,可以看一看组方法所做的事。一个示例调用如下所示:

分析集团({groupId:some_group_id,用户标识:some_user_id,特征:{网站:https://www.example.com,的名字:示例Inc.}});

群组呼叫映射到HubSpot公司的API。段的集成负责创建和更新公司对象与您所设置的任何特征,以及新万博app2.0下载将个别联系人与公司联系起来新万博app2.0下载

重要的:创建公司和关联联系人有三个要求:

  1. 组调用只在使用服务器端库或移动库调用时生效,而不使用我们的客户端javascript库。
  2. 您的联系人必须是在HubSpot(称为使用分析)中识别并创建的。首先识别这个用户id)。
  3. 你必须包括网站特征,并且它必须是完整的、有效的和完整的URL。HubSpot使用网站特征域作为公司的唯一标识符。要创建一个新公司,您必须使用完整新万博app2.0下载的URL,而不仅仅是子域名。

Segment可以将以下组特征作为特殊属性发送到HubSpot:

  • 地址
  • 城市
  • 状态
  • 邮政编码
  • 国家
  • 描述
  • 员工
  • 行业
  • 电话
  • 网站

故障排除

API调用的限制

Hubspot限制了每小时和日常请求的总量,我们可以代表您对他们的API作出。阅读更多关于这些限制的更多信息在这里

HubSpot计划:免费和入门

  • 每10秒,每个键或令牌的最大API呼叫数:100.
  • 每天每个键或令牌的最大API调用数:250000年

HubSpot计划:专业化、企业化

  • 每10秒,每个键或令牌的最大API呼叫数:100.
  • 每天每个键或令牌的最大API调用数:500000年

HUBSPOT计划:API附加(任何一层)

  • 每10秒,每个键或令牌的最大API呼叫数:120.
  • 每天每个键或令牌的最大API调用数:1000000年

将日期作为属性值发送

公司HubSpot的API具体要求在日期作为带有日期类型的联系人属性交付之前,日期应该如何格式化。

为了确保这些属性的正确转换,将它们传递给Segment asiso - 8601格式化字符串和UNIX时间戳。下面是一个Javascript示例:

分析识别(用户标识,{offerDate:日期()/ /不是Date.now () !});

无效的“Lifecyclestage”

当使用任何服务器端源时,连接器将推断traits.lifecycle_stage作为Lifecyclestage。如果您正在使用自定义生命周期阶段的自定义联系人,则应为属性提供一个不同的名称,例如custom_lifecycle_stage

加载形式SDK

段提供了加载的选项HUBSPOT FORMS SDK.在他们的追踪库旁边。这可以通过启用负载形式SDK在配置HubSpot集成时进行设置。

注意:Forms SDK希望同步加载,但analytics.js是异步加载的。因此,为了与API交互,您需要在一个analytics.ready回调。这里有一个例子:

分析准备好(函数(){hbspt形式创建({Portalid.:'',formId:'',css:'',cssRequired:''});})

使用HubSpot和人物角色

您可以发送计算的特征和观众,你在人物角色创建HubSpot,以便您可以使用数据在实时聊天,自动电子邮件,和其他HubSpot功能,以个性化的互动与您的客户。manbetx客户端应用下载

您可以为计算的特征和受众设置一个“回顾窗口”,这将限制计算特征或受众时考虑数据的时间周期。例如,你可能会设置一个7天的回顾窗口,对象或特征如下new_users_7_days,但您不会向没有时间限制的trait添加一个向后窗口lifetime_value.

当您指定一个回顾窗口时,Personas每小时更新一次受众或特征。如果您没有指定一个回望窗口,角色将不断地实时更新计算特征和受众。

同步自定义特征到HubSpot

HubSpot要求您在HubSpot UI中创建和定义任何自定义特征之前您可以将任何角色数据发送到HubSpot。如果你尝试从HubSpot中不存在的段同步属性,同步失败。

如何运作:用户级特征和受众

角色发送用户级数据到Hubspot以更新用户上的属性(或联系人在HubSpot)记录,使用识别调用以添加或更新标准财产或计算特征时,和一个追踪当观众进入或退出时呼叫。

  • 计算特征:当trait第一次被计算时,Personas发送一个识别调用以更新计算特征中包含的所有用户的记录。每次计算trait之后,Personas都会发送a识别调用HubSpot更新值。例如,如果一个计算特性计算了用户访问您的定价页面的次数,并且该用户访问您的定价页面五次,Segment首先发送一个带有该属性的识别调用pricing_page_visits: 5,然后在这个号码更新时发送一个识别呼叫。这在HubSpot中显示为a财产的接触。

  • 观众: Personas使用Identify调用将受众的名字作为特征添加到用户的配置文件中,并包含一个布尔值,该值指示该用户是否是受众的成员。例如,当用户在过去30天内第一次完成一个订单时,Personas发送一个带有属性的标识呼叫order_completed_last_30days:真。当用户不再满足这些条件时(例如,从最后一次购买到现在已经超过30天),Personas使用一个Identify呼叫将该值设置为错误的。这表现为财产用于HubSpot中的联系人。如果使用追踪呼叫,事件将被发送观众进入或者观众退出

    • 当您第一次创建受众时,Personas为受众中的每个用户发送一个识别呼叫。之后的同步只更新自上次同步以来添加或删除的用户。

它是如何运作的:帐户级特征和受众

角色发送帐户级别的数据HubSpot的使用识别调用将帐户特征添加到用户的配置文件,以及识别在trait重新计算时调用来更新它,并将发送a追踪当群组进入或退出观众时呼叫。用户添加到一个帐户使用单个集团调用,它将附加一个groupID帐户内的每个用户。

  • 计算特征:当你用账户级别的数据构建计算特征时,角色会根据特征或用户行为聚合来计算每个账户。然后,您可以导出每个帐户或帐户内的每个用户的特征。Personas向组中的每个用户的用户配置文件添加一个新特征(设置为计算出的特征的名称),并设置该计算出的特征的值。

    例如:假设您有一个计算特性,它计算特定公司的用户访问您的定价页面的次数。新万博app2.0下载如果5个不同的用户分别访问你的定价页面一次,Personas就会发送一个与该房产的识别电话pricing_page_visits: 5组中的每个用户。

  • 观众:使用帐户级数据构建受众时,Personas返回一组符合条件的帐户或一组符合标准的用户。Personas将受众的名称添加到用户的配置文件中作为特征(对于个人用户以及帐户中的用户),并设置布尔值以指示用户是否在受众中。例如,如果帐户中的用户首先在过去30天内完成订单,则PersonAs发送与属性的标识呼叫order_completed_last_30days:真。当该帐户中的用户不再满足这些条件时(例如,从最后一个订单到现在已经超过30天),Personas将该值设置为错误的。如果使用追踪呼叫,事件将被发送观众进入或者观众退出

    • 当您第一次创建受众时,Personas发送一个识别呼叫观众账户里的每一个用户。后来同步只会为自上次同步以来添加或删除的单个帐户和用户发送更新。请注意:对于用户级事件或特征,您可以指定没有用户,任何用户, 或者所有用户当你建立受众标准时。

在HubSpot上创建角色受众

  1. 创建您的受众标准,并在部分中预览受众。点击选择目的地。

  2. 接下来,选择HubSpot作为受众的目的地。使用默认设置,它发送一个Identify调用来将用户标记为受众的成员,或者当他们具有特定的特征时。

  3. 输入观众的名称和描述。写下观众钥匙(你需要它在下一步中配置Hubspot),但不要点击创建受众然而。

  4. 转到HubSpot设置。
  5. 创建一个新的财产在HubSpot中,你想让HubSpot接收来自角色的每个观众。这是必需的,因为HubSpot的模式是显式定义的。你必须这么做之前您将任何PersonAs数据从段发送到Hubspot。

  6. 设置对象类型。
    • 对于用户级受众,请设置对象类型接触集团联系信息
    • 对于帐户级别的受众,设置对象类型新万博app2.0下载集团新万博app2.0下载公司信息
  7. 输入自定义属性的标签,并确保它与您从Personas受众构建器中写下的受众键相匹配(参见下面的提示)。点击下一个

    提示:受众标签在HubSpot中的“内部名称”必须精确匹配这个部分观众的关键。您可以通过单击图标,并进行修改。

  8. 在下一个屏幕上,设置字段类型为观众单一的复选框。(这表示一个布尔值,表示受众成员)(对于计算的特征,取决于输出是字符串还是数字,选择单行的文本或者数字。)

    点击创造完成添加受众联系物业。

  9. 回到Personas Audience builder,点击创建受众。Personas将任何满足观众标准的用户立即发送到HubSpot。

验证受众

您可以在您的角色空间中使用调试器来查看发送到HubSpot的调用。编辑下面的URL,将YOUR_WORKSPACE和YOUR_PERSONAS_SPACE替换为工作空间和personas空间。

https://app.www.asianminres.com/YOUR_WORKSPACE/sources/YOUR_PERSONAS_SPACE/debugger

您可以在HubSpot中查看受众布尔值作为联系属性。对于上面示例中创建的受众,您可以检查单个联系人配置文件并看到一个名为contact的属性邮件30天内打开=是的

您还可以在每个用户记录的联系人属性历史记录中看到这一点。

HubSpot人物快速信息

  • personas目的地类型:事件方法(数据实时地一个接一个地传递到目的地)
  • 特质和受众的创造:识别呼叫添加和更新特征和受众作为用户的特征,跟踪呼叫发送事件观众进入观众退出
  • 必须在PersonAs可以更新这些值之前创建Audience_name字段?:是的,在发送自定义特征或受众之前,您必须在Hubspot中手动创建联系人属性。
  • 观众似乎是:受众名的散文文本版本(例如,订单完成30天:是的),是的表示用户在听众中。
  • 目的地速率限制:是的。HubSpot的利率限制取决于您在HubSpot中拥有的账户层,但它是通常每十秒100次呼叫,或者说每秒钟10次。
  • Lookback窗口允许:无限
  • 标识符需要:用户身份或者电子邮件
  • 标识符接受:用户身份电子邮件
  • 客户端或服务器端连接: 服务器端

设置

Segment让你改变这些目标设置从Segment应用程序,而不需要碰触任何代码。

API密匙

您可以从Hubspot申请API密钥。请按照帮助中心的文章。它应该是这样的:DFDBFE6F-E7BF-4938-8E82-7D1938E48AB8

中心ID

你可以在设置你的页HubSpot的账户。应该是一串数字,比如997086

负载形式SDK

如果您希望段自动加载,请选择此选项Hubspot的形式SDK到你的网站。这将减轻将嵌入代码添加到站点头部所需的手工工作。

重要的:表单API希望脚本加载到页面上同步但是分析.js被加载异步。为防止错误,请确保您正在与中内的表单API交互analytics.ready回调。

最后更改:2021年1月07日



开始使用细分

细分是将网站和移动应用数据整合到300多个分析和增长工具的最简单方法。
或者
创建免费帐户