建立計算與匯總屬性

建立可根據其他屬性的計算結果填入資料的屬性。透過彙總屬性，您可以自動計算相關記錄中各屬性的最小值、最大值、計數、總和、最早日期、最新日期或平均值。透過計算屬性，您可以根據「之間」、「至」或「自」等屬性值設定公式，或依據物件的屬性建立自訂公式。 

請注意：您的帳戶可能會針對每個物件使用自訂名稱（例如，使用「帳戶」而非「公司」）。本文以 HubSpot 的預設名稱來指稱這些物件。

開始之前

例如，您可以建立：

• 一個根據自訂公式計算新客戶獲取成本的公司屬性。
• 一個聯絡人屬性，用以計算該聯絡人相關交易之平均金額。 
• 一個交易屬性，用於計算自交易開啟以來經過的時間。
• 一個能計算適用折扣後利潤金額的發票、訂閱或付款屬性。

根據您的 HubSpot 訂閱方案，您可以建立的計算屬性數量有所限制。

根據關聯記錄的屬性建立彙總屬性

您可以為某個物件建立屬性，該屬性將根據該物件關聯記錄的特定屬性值進行計算。您可以基於該物件的所有關聯記錄進行計算，或針對特定的關聯標籤進行計算，包括同物件關聯。

例如，您可以建立一個交易屬性，用以統計交易中標有「決策者 」標籤的 關聯聯絡人所記錄的銷售活動總數。

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選擇物件」下拉式選單，並選擇[物件] 屬性，以建立該物件的屬性。

3. 點擊「建立屬性」。
4. 輸入屬性的基本詳細資訊。
5. 點選「欄位類型」下拉式選單，並選擇「彙總」。
6. 點選「彙總類型」下拉式選單，然後選擇以下其中一種類型：
   • 「最小值」：顯示所選物件相關記錄中，所選數值屬性的最小值。
   • 最大值：顯示所選物件所有相關記錄中，所選數字屬性的最大值。
   • 計數：統計所選物件中，具有該數值屬性值的相關記錄總數。
   • 總和：將所選物件所有相關記錄中，所選數值屬性的值相加。
   • 平均值：計算所選物件所有相關記錄中，所選數字屬性的數值平均值。
   • 最早日期：回傳所選物件中，所選屬性的最早日期（例如，相關交易的最早已建立日期）。
   • 最新日期：回傳所選物件中，所選屬性的最新日期（例如，相關交易中的最新下次活動日期）。
7. 點擊「數字格式」下拉式選單，然後從以下格式中進行選擇：「格式化 數字」、「未格式化數字」、「貨幣」、「百分比」或「持續時間」。此設定將配置該屬性值的格式。
   • 若您為交易屬性選取「貨幣」作為格式，該屬性預設將使用您帳戶的「公司貨幣」。
   • 若要使用各交易記錄的貨幣，請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。使用記錄貨幣僅會影響數值的顯示方式，並不會自動套用匯率。
8. 請選取關聯物件及關聯記錄屬性，以據此計算該屬性。 
9. 點擊「選取關聯標籤」，然後選取您要納入計算的標籤，以便僅針對具有特定標籤的記錄進行計算。
10. 點擊「新增條件」以新增可選條件，記錄必須符合這些條件才能計算該屬性（例如：當「最近交易金額」> 1000 且「交易機率」>=80 時計算該屬性）。每個彙總屬性最多可設定 50 個數字型與枚舉型欄位類型的條件。
    • 在第一個下拉式選單中，選取一個屬性。
    • 在第二個下拉式選單中，選擇一個運算子，用以將第一個屬性的值與一個數字或另一個屬性的值進行比較。
    • 在第三個下拉式選單中，選取一個屬性或輸入一個數值，該數值 將與第一個屬性進行比較。
    • 點擊「儲存」。
11. 點擊「建立」。建立完成後，該屬性的顯示欄位類型將為「彙總」。

請注意：原始持續時間值以毫秒為單位儲存。如果您在其他 HubSpot 工具（例如篩選器、計算屬性公式）中使用持續時間計算屬性，您可能需要使用毫秒值。

建立「時間間隔」、「自某日時起」或「

至某日時止

」的計算屬性

您可以建立屬性，用以計算兩個日期之間的時間，或追蹤自某日時起或至某日時止的時間長度，這些時間長度由日期或日期與時間選擇器屬性的值決定。「時間間隔」屬性僅支援同一物件的屬性。

例如：

• 建立「時間間隔」屬性，以計算工單負責人被指派之日與工單關閉之日之間的時間。
• 建立「自開啟以來時間」屬性，以追蹤一筆交易已開啟多久。
• 建立「距離關閉剩餘時間」屬性，以追蹤客戶設定的關閉時間距離今日還有多久。

若要建立其值基於今日日期（而非屬性值）顯示相對時間的屬性，請參閱如何建立相對時間的日期／日期與時間選擇器屬性。您也可以使用自訂公式建立固定時間屬性。

要建立「時間間隔」、「自開啟以來」或「至關閉為止」的計算屬性：

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選取物件」下拉式選單，然後選取[物件] 屬性，以建立該物件的屬性。

3. 輸入屬性的基本詳細資訊。
4. 點擊「欄位類型」下拉式選單，並選擇「計算」。
5. 點擊「計算屬性類型」下拉式選單，然後選擇類型並設定計算方式：
   • 「時間間隔」：選擇您的「開始日期」和「結束日期」屬性 。
   • 「自...起的時間」：選擇其值將作為起始日期的日期／日期與時間選擇器 屬性。結束日期將始終為今日日期。
   • 「至時間」：選擇其值將作為結束日期的日期／日期與時間 選擇器屬性。開始日期將始終為今日日期。
6. 僅限「時間區間」屬性，請設定其他選項：
   • 條件準則：點擊「新增條件」以新增計算時必須滿足的可選條件。
   • 僅計算工作日：「排除週末」核取方塊，僅計算起始日期與結束日期之間的平日。週末的定義為週六凌晨 12:00 至週日晚上 11:59，以您的帳戶時區為準。
7. 點擊「建立屬性」。 

顯示持續時間值時，預期會出現以下行為：

• 對於沒有時間戳記的日期屬性，計算中使用的預設時間將為所選當日的 UTC 凌晨 12:00。
• 顯示的值將根據特定閾值，以秒、分鐘、小時、天、月或年為單位呈現。各單位的閾值如下：
  • 2.5 年或更長將以年為單位顯示。
  • 3 個月或更長時間將以月為單位顯示。
  • 1 天或更長將以天為單位顯示。
  • 2.5 小時或更長時間將以小時為單位顯示。
  • 2.5 分鐘或以上將以分鐘顯示。
  • 少於 2.5 分鐘的時長將以秒為單位顯示。

請注意：在 HubSpot 中，「時間間隔」與「平均值」屬性類型的原始值均以毫秒為單位儲存。若使用這些值進行運算後，結果高於預期，請使用毫秒轉換器將其轉換為您所需的時間單位。

建立自訂公式計算屬性

您也可以建立根據自身條件計算數值的屬性。自訂公式僅能針對您正在建立新屬性之同一物件內的數值屬性進行設定。例如，您可以建立一個公式，用以計算某公司最近一筆交易（最近一筆交易金額）的金額，並與貴公司聯繫該公司的次數（聯繫次數）進行比較。

您可以使用算術運算子、比較運算子、邏輯運算子、條件陳述式及其他函數來建立自訂

方程式

。這些方程式可返回數字、布林值、字串、日期或日期時間值。進一步了解可用的運算子、函數以及如何 格式化公式。您也可以參考常用公式的範例。

要建立自訂方程式計算屬性：

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選取物件」下拉式選單，然後選取[物件] 屬性，以建立該物件的屬性。

3. 輸入屬性的基本詳細資訊。
4. 點擊「欄位類型」下拉式選單，並選擇「計算」。
5. 點擊「計算屬性類型」下拉式選單，然後選擇「自訂方程式」。
6. 點擊「輸出類型」下拉選單，然後選擇計算結果將回傳的輸出類型。您可以從以下選項中選擇其一：數字、布林值、字串、日期或 日期時間。

請注意：所選的輸出類型必須與編輯器右上角顯示的輸出類型相符，否則將無法建立該屬性。對於返回日期的屬性，您可以使用「數值」或「日期」輸出類型，這將決定數值的顯示方式（即「數值」以毫秒為單位顯示日期，「日期」則顯示格式化的日期）。

8. 若您已選取「數值」輸出類型：
   • 點擊「數字格式」下拉式選單，然後選擇屬性值的格式化方式。您可以從以下選項中選擇其一：「格式化數字」、「未格式化數字」、「貨幣」、「百分比」或「持續時間」。
   • 若您為交易屬性選取「貨幣」作為數字格式，該屬性預設將使用您帳戶的「公司貨幣」 。若要使用各交易記錄的貨幣，請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。

9. 在編輯器中，插入、輸入或貼上函數與屬性以建立您的自訂方程式。進一步了解自訂計算方程式語法。要 插入公式元素：
   
   • 點擊「插入」下拉式選單。
   • 若要將函數插入方程式中，請選取「函數」，然後選擇一個函數。
   • 若要將屬性插入方程式中，請選取「屬性」，然後選擇一個屬性。您只能使用與該物件相同的屬性來建立自訂方程式，且該屬性必須是您正在建立的物件所擁有的屬性。
10. 若您的方程式有錯誤，請點擊編輯器上方的[x] 問題圖示，以查看錯誤原因。若方程式中有未解決的錯誤，您將無法建立該屬性。進一步了解如何格式化方程式。
11. 若要預覽公式的輸出結果，請點擊「測試公式」。
12. 點擊「建立屬性」。

請注意：您可在計算公式中嵌套最多 70 個左括號（例如，(((1+2)+3)+4)的嵌套層數為 4）。

使用 AI 建立自訂計算屬性

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選取物件」下拉式選單，然後選取[物件] 屬性，以建立該物件的屬性。

3. 點擊「建立屬性」。
4. 輸入該屬性的基本詳細資訊。
5. 點擊「欄位類型」下拉式選單，並選擇「計算」。
6. 在公式文字欄位下方，點擊「產生公式」。
7. 在彈出視窗中：
   • 將游標懸停在「範例」連結上，以查看建議的提示文字。
   • 在「您希望此屬性為您計算什麼？」文字欄位中，輸入提示文字。
   • 點擊「產生」。
8. 檢視生成的公式，並視需要進行修改。
9. 點擊「輸出類型」下拉式選單，並選擇與公式文字欄位中顯示的值相符的類型（例如：字串）。
10. 若要預覽公式的輸出結果，請點擊「測試公式」。
11. 點擊「建立屬性」。

自訂方程式語法

• 文字常數語法：透過文字常數，您可以在方程式中加入文字字串、數字，以及「真」或「假」的值。您可以透過以下方式格式化文字、數字、布林值和日期常數：

  • 字串常數：以引號包圍的文字。可使用單引號（'constant'）或雙引號（"constant"）表示。

  • 數字文字常數：不帶引號的數字。常數可以是任何實數，並可包含小數點表示法。例如，1005和1.5589都是有效的常數。

  • 布林常數：布林常數可以是true或false。

  • 日期字面值：以毫秒為單位的日期。例如，1698508800000。
• 屬性語法：您可以在自訂方程式中包含同一物件的其他屬性。
  • 若將屬性插入 編輯器中，系統會自動將其格式化並作為方程式的一部分進行驗證。
  • 若您選擇手動輸入或將屬性貼上至編輯器中，其格式應為[properties.{propertyInternalName}]。例如，要新增 內部值 為 Test_score 的 「測驗分數」屬性 ，您應在編輯器中輸入 [properties.Test_score]。
  • 在方程式中使用枚舉屬性 （例如下拉式選單、單選按鈕）時，其值會被視為字串，因此必須以雙引號包圍（例如："subscriber"），同時也必須使用屬性選項的內部名稱（例如："appointmentscheduled"）。
  • 在方程式中使用日期屬性時，值會以毫秒為單位儲存為 UTC 午夜時間。
  • 在方程式中使用日期時間屬性時，值會以 UTC 紀元為基準，以毫秒為單位儲存。此值會根據您的時區進行顯示。這表示位於不同時區的用戶將看到不同的數值。

運算子

您可以在方程式中使用運算子來更新、評估或比較常數與屬性值。當使用多個運算子時，它們將遵循 PEMDAS 運算順序。根據您使用的資料類型，您可以在自訂方程式中包含以下運算子。

函式

您可以在自訂公式中使用函式來計算數值，並對資料執行操作。根據您使用的資料類型，可在自訂公式中包含以下函式。

檢視自訂公式範例

以下是根據常見使用情境所提供的公式範例。

使用 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)。

請注意：建議在輸入屬性的名稱和描述時盡量具體。這樣使用者就能清楚了解所計算的時間單位（例如：小時或天）。

以百分比

計算交易折扣

在交易中使用明細項目時，您可以使用匯總屬性與計算屬性來追蹤總折扣的百分比。匯總屬性會將 所有相關明細項目的「計算總折扣」屬性相加 。計算屬性則會將匯總屬性除以其自身值加上交易的預設「金額」 屬性。

建立匯總屬性的方法：

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選取物件」下拉式選單，並選取「交易屬性」。

3. 點擊「建立屬性」。

4. 在「屬性標籤」文字欄位中，輸入「計算折扣金額」。
5. 點擊「欄位類型」下拉式選單，並選擇「匯總」。
6. 點選「匯總類型」下拉式選單，並選擇「總和」。
7. 點選「數字格式」下拉式選單，並選擇「貨幣」。
8. 點選「選擇相關記錄類型」下拉式選單，並選取「明細項目」。
9. 點選「選擇相關記錄屬性」下拉式選單，並選擇「計算出的總折扣」。
10. 點擊「建立屬性」。

要建立計算屬性：

1. 在左側邊欄選單中，導航至「屬性」。

2. 點擊「選擇物件」下拉式選單，並選擇「交易屬性」。

3. 點擊「建立屬性」。

4. 在「屬性標籤」文字欄位中，輸入「計算出的折扣百分比」。 
5. 點擊「欄位類型」下拉式選單，並選擇「計算」。
6. 點擊「數字格式」下拉式選單，並選擇「百分比」。
7. 在「計算公式」文字欄位中，輸入(Calculated discount amount / (Calculated discount amount + Amount))。您也可以點擊「產生公式」 按鈕，由資料代理程式自動生成公式。
8. 點擊「建立屬性」。