建立計算和滾動屬性
上次更新時間: 2025年9月8日
可搭配下列任何訂閱使用,除非另有註明:
-
行銷 Hub Professional, Enterprise
-
銷售 Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional
-
Content Hub Professional, Enterprise
您可以根據其他屬性的計算結果,建立填充資料的屬性。使用滾動屬性,您可以自動計算相關記錄上屬性的最小值、最大值、計數值、總和值或平均值。使用計算屬性,您可以根據屬性值之間、直到或自屬性值以來的時間設定等式,或根據物件的屬性建立自訂等式。
請注意:您的帳戶可能會為每個物件使用個人化的名稱(例如:帳戶而非公司)。本文件使用 HubSpot 預設名稱來稱呼物件。
例如,您可以建立:
- 根據自訂公式計算取得新客戶成本的公司屬性。
- 連絡人屬性,可計算連絡人相關交易的平均金額。
- 交易屬性,可計算交易開啟後的時間。
根據您的 HubSpot 訂閱,您可以建立的計算屬性數量是有限制的。
根據關聯記錄的屬性建立滾動屬性
您可以為一個物件建立將根據該物件關聯記錄的特定屬性值計算的屬性。您可以根據該物件的所有關聯記錄或特定關聯標籤(包括相同物件關聯)進行計算。
例如,您可以建立一個交易屬性,用來計算具有決策者 標籤的交易關聯聯絡人的銷售活動記錄總數。
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側功能表中,導覽到內容。
-
按一下 選取物件 下拉式功能表,然後選取[物件] 屬性 ,為該物件建立屬性。
- 輸入屬性的基本詳細資訊,然後按一下欄位類型索引標籤。
- 選擇捲動 。
- 按一下捲動類型下拉式功能表,然後選擇下列其中一種類型:
- 最小值:顯示所選物件相關記錄中所選數字屬性的最小值。
- 最大:顯示所選物件所有相關記錄中,所選數字屬性的最大值。
- 計數:計算所選物件中具有所選數字屬性值的相關記錄總數。
- 總和:總和選取物件所有相關記錄中選取數字屬性的值。
- 平均值:計算選取物件所有相關記錄中所選數值屬性的平均值。
- 若要選擇如何格式化屬性值,請按一下數字格式下拉式功能表,然後從下列格式中選擇:格式化 數字、非格式化數字、貨幣、百分比或時間。
- 如果您選擇「貨幣」作為交易屬性的格式,該屬性預設會使用您帳戶的公司 貨幣。若要使用每個交易記錄的貨幣,請選擇 使用記錄貨幣而非公司貨幣核取方塊。使用記錄貨幣只會影響數值的顯示方式,而不會自動套用匯率。
- 選擇關聯物件和關聯記錄屬性,以據此計算屬性。
- 若要僅基於具有特定標籤的記錄進行計算,請按一下選擇關聯標籤,然後選擇要包含的標籤。
- 若要新增其他條件,請按一下新增條件。設定附加條件時,必須滿足這些條件才能計算該屬性 (例如,當Recent deal amount> 1000 且Deal probability>=80 時,計算該屬性)。每個滾動屬性最多可設定 50 個條件。
- 在第一個下拉式功能表中,選擇屬性。
- 在第二個下拉式功能表中,選擇運算符號,將第一個屬性的值與一個數字或另一個屬性的值比較。
- 在第三個下拉式功能表中,選擇要與第一個屬性比較的屬性或輸入數字 。
- 按一下儲存。
- 按一下建立。建立後,該屬性顯示的欄位類型將會是Rollup。
請注意:原始的持續時間值以毫秒為單位儲存。如果您在其他 HubSpot 工具中使用持續時間計算屬性 (例如篩選器、計算屬性公式),您可能需要使用毫秒值。
建立間隔時間、自開始時間或直到時間的計算屬性
您可以建立計算兩個日期之間時間的屬性,或追蹤自某個日期起或至某個日期為止的時間量的屬性,這些時間量由日期或日期和時間選擇器屬性的值決定。時間間屬性只支援同一物件的屬性。
舉例來說
- 建立Time between 屬性,以計算票單擁有人被指派到票單關閉之間的時間。
- 建立Time since open 屬性,以追蹤交易開啟的時間。
- 建立Time until close屬性,追蹤客戶距離今天結束的時間。
若要建立一個屬性,其值根據今天的日期顯示相對時間,而不是屬性值,請學習如何建立相對時間日期/日期和時間選擇器屬性。您也可以使用自訂公式建立固定時間屬性。
要建立Time between、Time since 或Time until計算屬性:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側功能表中,導覽至屬性。
-
按一下選 取物件 下拉式功能表,然後選擇[物件] 屬性 ,以為該物件建立屬性。
- 輸入屬性的基本詳細資訊,然後按一下 欄位類型 索引標籤。
- 選擇「計算」作為欄位類型。
- 按一下計算屬性類型下拉式功能表,然後選擇類型並設定計算:
- 兩日期間的時間:選擇您的開始日期和結束日期 屬性。
- Time since:選擇日期/日期和時間選擇器 屬性,其值將作為開始日期。結束日期永遠是今天的日期。
- 直到時間:選擇日期/日期和時間選擇器 屬性,其值將作為結束日期。開始日期永遠是今天的日期。
- 僅針對Time between 屬性,若要新增附加條件,請按一下新增條件。設定附加條件時,必須滿足這些條件才能計算該屬性 (例如,當最近成交金額> 1000 且成交機率>=80 時,計算該屬性)。
- 在第一個下拉式功能表中,選擇屬性。
- 在第二個下拉式功能表中,選擇運算符號,將第一個屬性的值與一個數字或另一個屬性的值進行比較。
- 在第三個下拉式功能表中,選擇一個要與第一個屬性比較的屬性或輸入一個數字 。
- 按一下儲存。
- 按一下建立。建立後,該屬性顯示的欄位類型將會是計算。 接下來,您無法編輯是Time between、Time since或Time until, 但可以選擇不同的開始或結束日期屬性。
顯示持續時間值時,預期會有以下行為:
- 對於沒有時間戳記的日期屬性,計算中使用的預設時間將為所選日期的 12:00 am UTC。
- 顯示的值將根據特定臨界值以秒、分、小時、天、月或年為單位。單位的臨界值為
- 2.5 年或更長時間會以年為單位顯示。
- 3 個月或更長時間會以月為單位顯示。
- 1 天或更長時間會以天顯示。
- 2.5 小時或更長時間會以小時為單位顯示。
- 2.5 分鐘或更長時間會以分鐘顯示。
- 2.5 分鐘以下會以秒為單位顯示。
請注意:在 HubSpot 內,Time between 和Average 屬性類型的原始值以毫秒為單位儲存。如果使用這些值的等式產生比預期更高的值,請使用毫秒轉換器轉換為您所需的時間單位。
建立自訂公式計算屬性
您也可以根據自己的條件建立計算值的屬性。自訂等式只能在您為其建立新屬性的相同物件中為數字屬性設定。例如,您可以建立一個等式,以計算公司最近交易的金額(最近交易金額) 與您的業務聯繫該公司的次數 (聯繫次數) 的比較。
您可以使用算術運算元、比較運算元、邏輯運算元、條件語句和其他函數建立自訂公式。這些方程式可以傳回數字、布林、字串、日期或日期時間值。進一步瞭解可用的運算符號、函 式,以及如何 格式化您的公式。您也可以檢視常用公式的範例。
建立自訂公式計算屬性:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側功能表中,導覽至 [屬性]。
-
按一下 選取物件 下拉式功能表,然後選擇[物件] 屬性 ,為該物件建立屬性。
- 輸入物業的基本詳細資訊,然後按一下欄位類型索引標籤。
- 選擇「計算」作為欄位類型。
- 按一下計算屬性類型下拉式功能表,然後選擇自訂公式。
- 按一下輸出類型下拉式功能表,然後選擇計算將返回的輸出類型。您可以選擇下列其中一種:數字、布林值、字串、日期或日期時間。
請注意:選取的輸出類型必須符合編輯器右上方顯示的輸出類型,否則無法建立屬性。對於回傳日期的屬性,您可以使用數字或日期輸出類型,它們決定數值的顯示方式(即數字顯示以毫秒為單位的日期,日期顯示格式化的日期)。
- 如果您選擇了數字輸出類型:
- 按一下數字格式下拉式功能表,然後選擇如何格式化屬性值。您可以選擇下列其中一種:格式化數字、非格式化數字、貨幣、百分比或時間長度。
- 如果您選擇「貨幣」作為交易屬性的數字格式,該屬性預設會使用您帳戶的公司 貨幣 。若要使用每筆交易記錄的貨幣,請選擇 使用記錄貨幣而非公司貨幣核取方塊。
- 在編輯器中,插入、鍵入或貼上函數和屬性,以建立您的自訂公式。進一步瞭解自訂計算公式語法。 插入公式元素:
- 按一下插入下拉式功能表。
- 若要在公式中插入函數,請選取函數,然後選取函數。
- 若要在公式中插入屬性,請選取屬性, ,然後選取一個屬性。您只能使用建立屬性的相同物件的屬性建立自訂公式。
- 如果您的公式有錯誤,請按一下編輯器上方的[x] 問題,以檢視出錯的原因。如果您的公式有未解決的錯誤,您將無法建立屬性。進一步了解如何格式化您的公式。
- 若要預覽公式的輸出,請按一下測試公式。
- 按一下建立。建立後,該屬性顯示的欄位類型將會是計算。
自訂公式語法
- 字面語法:使用字面資料,您可以在公式中加入文字串、數字和真假值。您可以以下列方式格式化字串、數字、布林值和日期常數:
-
字串字面意義:由引號包圍的文字。可以使用單引號 (
'constant'
) 或雙引號 ("constant"
) 表示。 -
數字字面意義:不含引號的數字。常數可以是任何實數,也可以包含點符號。例如,
1005
和1.5589
都是有效的常數。 -
布林字面意義:常數布林可以是
true
或false
。 - 日期字面意義:以毫秒為單位的日期。例如,
1698508800000
。
-
- 屬性語法:您可以在自訂公式中包含同一物件的其他屬性。
- 如果在編輯器中 插入 屬性,它會自動格式化並作為公式的一部分進行驗證。
- 如果您選擇手動輸入或貼入一個屬性到編輯器中,它的格式應該是
[properties.{propertyInternalName}]
。例如,若要新增 內部值 為 Test_score 的 屬性 Testscore,您可以將它輸入到編輯器中,格式為[properties.Test_score]
。 - 在公式中使用枚舉屬性 (例如,下拉選項、單選選項)時,值被視為字串,因此必須用雙引號包裝("例如,
"subscriber"
), 您也必須使用屬性選項的內部名稱(例如,"appointmentscheduled"
)。 - 在公式中使用日期屬性時,值會以毫秒為單位儲存為 UTC 午夜。
- 在公式中使用日期時間屬性時,值會儲存為以毫秒為單位的 UTC 時元。此值根據您的時區顯示。這表示不同時區的使用者會看到不同的值。
運算符號
您可以在公式中使用運算符號來更新、評估或比較常數和屬性值。當使用多個運算符時,它們遵循 PEMDAS 的操作順序。根據您使用的資料類型,您可以在自訂公式中包含下列運算符號。
操作員 | 說明 |
+ |
新增數字或字串。返回數字。 |
- |
減數。返回一個數字。 |
* |
乘數。傳回一個數字。 |
/ |
除數傳回一個數字。 |
< |
檢查一個數值是否小於另一個數值。由數屬性或常數支援。返回一個布林值。 |
> |
檢查數值是否大於另一個數值。由數字屬性或常數支援。返回一個布林值。 |
<= |
檢查數值是否小於或等於其他數值。由數字屬性或常數支援。返回一個布林值。 |
>= |
檢查數值是否大於或等於另一個數值。由數字屬性或常數支援。返回一個布林值。 |
! |
檢查是否沒有任何值為 True。返回一個布林值。 |
= 或== |
檢查一個值是否等於另一個值。支援數字和字串。返回一個布林值。 |
!= |
檢查一個值是否不等於另一個值。由數字和字串支援。傳回一個布林值。 |
or 或|| |
檢查兩個值中是否有一個為真。傳回一個布林值。 |
and 或&& |
檢查兩個值是否都為真。傳回一個布林值。 |
函數
您可以在自訂公式中使用函數來計算數值,並利用您的資料完成動作。根據您使用的資料類型,您可以在自訂公式中包含下列函數。
函式 | 參數 | 範例 |
取得數字的絕對值。傳回一個數字。 |
number:要取得絕對值的數字。 |
|
|
|
|
將最多 100 個字串合併為一個值。返回一個字串。 |
arg1:要追加 arg 2 的字串。 arg2:要追加到 arg 1 的字串。 |
|
判斷字串是否包含另一個字串(大小寫敏感)。傳回一個布林值。 |
text:要檢查子串的字串或文字屬性。 substring:文字應包含的字串。 |
contains("HubSpot", "Spot") |
取得貨幣的小數位數。傳回一個數字。 |
currency:要計算小數點位數的貨幣字串。 |
|
取得指定時間的匯率值。傳回一個數字。 |
currency:您要計算特定日期匯率的貨幣字串 (例如: date:日期時間屬性,您要計算該日期的匯率。 |
|
取得最新匯率。返回一個數字。 |
currency:您要計算匯率的貨幣字串。 |
|
|
|
|
設定條件表達式。 |
condition:決定計算值的布林值語句。 arg2:布林值、數字或字串,如果符合條件,該值將成為計算值。 arg3(可選):不符合條件時的計算值。如果包含,則必須與 |
|
判斷是否已知代號的值。傳回一個布林值。 |
property:要檢查值的屬性。 |
|
取得代號最後更新的日期。傳回以毫秒為單位的時間戳記字串。 |
property:要檢查最近更新日期的屬性。 |
|
將所有字元改為小寫。傳回字串。 |
text:要改為小寫的字串或文字屬性值。 |
|
取得兩個數字的最大值。傳回一個數字。 |
arg1:第一個數字或數字屬性。 arg2:第二個數字或數字屬性。 |
|
取得兩個數字的最小值。傳回一個數字。 |
arg1:第一個數字或數字屬性。 arg2:第二個數字或數字屬性。 |
|
取得指定日期的數字月份。傳回一個數字。 |
date:要計算月份的日期時間屬性。 |
|
將數字轉換為字串。傳回字串。 |
number_to_convert:要轉換為字串的數字或數字屬性。 |
|
取得管道階段的機率。傳回一個數字。 |
pipeline:您要計算機率的管道名稱。 |
|
將一個數字提升為另一個數字的值。傳回一個數字。 |
base:基數。 exponent:將基數提升至的數值。 |
|
將一個數字向下捨入到指定的精確度。傳回一個數字。 |
number_to_round:要向下舍入的數字或數字屬性。 precision: 要向下舍入的小數位數。 |
|
將一個數字四捨五入到指定的精確度。返回一個數字。 |
number_to_round:要進行四捨五入的數字或數字屬性。 precision: 要四捨五入的小數位數。 |
|
將一個數字四捨五入到指定的精確度。傳回一個數字。 |
number_to_round:要進位的數字或數字屬性。 precision: 要四捨五入的小數位數。 |
|
取得一個數字的平方根。返回一個數字。 |
number:要取得平方根的數字。 |
|
判斷字串是否以另一個字串開頭(大小寫敏感)。傳回一個布林值。 |
text:要檢查子串的字串或文字屬性。 substring:文字應以其開頭的字串。 |
|
|
|
|
將字串轉換為數字。傳回一個數字。 |
string_to_convert:要將其值轉換為數字的字串或文字屬性。 |
|
|
|
subtract_time(1699320015000, 1, "second") = 1699320014000 |
取得兩個日期間的時間差。傳回一個數字。 |
date1:起始日期時間屬性。 date2:結束日期時間屬性。 |
|
將所有字元改為大寫。傳回字串。 |
text:要改為大寫的字串或文字屬性。 |
|
取得指定日期的數字年份。傳回一個數字。 |
date:您要計算年份的日期時間屬性。 |
|
檢視自訂公式範例
以下是基於常見使用個案的公式範例。
使用 if else 語句
您可以設定 if else 語句,包括具有多重條件的語句和函數內的語句。
例如,您可以建立一個標示活躍交易的計算。只有當交易狀態為活躍且金額大於零時,下面的公式才會回傳True。
if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")
執行空值計算
在自訂公式中使用數字屬性時,您可以包含if
和is_known
函數,以便在數字屬性為空時將值設為 0。這樣,無論屬性是否包含空值,您的計算都會執行。舉例來說:
if(is_known([properties.number]), [properties.number], 0)
.
將匯率附加到貨幣計算
在公式中使用記錄貨幣時,若要添加匯率,您可以在公式中包含exchange_rate
或dated_exchange_rate
函數。舉例來說:
[properties.amount] * exchange_rate('CAD')
.
建立固定時間計算
您可以設定一個計算來取得兩個日期之間的固定時間。預設情況下,原始值會以毫秒為單位傳回。您可以使用除法和round_nearest
函式格式化為小時、天等,並消除最終數值中的小數。例如,以下將傳回定日值:
round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0)
.
請注意:建議輸入物業名稱和描述時要具體。這樣使用者就能知道所計算的時間(例如小時或天)。