計算プロパティーの作成

HubSpotの計算プロパティーを使用すると、関連レコードのプロパティーについて、最小値、最大値、件数、合計、平均の値を自動的に計算することや、他のプロパティーに基づいてカスタム式を設定することができます。 

例えば、次のものを作成できます。

• コンタクトに関連付けられている取引の平均「金額」を計算するコンタクトプロパティー。 
• カスタム式に基づいて、新規顧客の獲得コストを計算する会社プロパティー。

注：HubSpotのご契約に応じて、作成できる計算プロパティーの数に上限があります。

計算プロパティーの作成

計算プロパティーは、関連付けられたレコードのプロパティー値、2つのプロパティー値の間の時間、または独自のカスタム式など、さまざまな基準に基づいて設定することができます。計算プロパティーを作成するには、次のようにします。

• HubSpotアカウントにて、メインのナビゲーションバーに表示される設定アイコンsettingsをクリックします。

• 左側のサイドバーメニューで、［プロパティー］に進みます。

• ［オブジェクトを選択］ドロップダウンメニューをクリックし、［［オブジェクト］プロパティー］を選択して、そのオブジェクトのプロパティーを作成します。

• プロパティーの基本情報を入力し、［次へ］をクリックします。
• ［フィールドタイプ］で［計算］を選択します。計算プロパティーが作成されると、フィールドタイプが編集できなくなります。
• ［計算を作成］をクリックします。
• ［Calculated property type（計算済みプロパティータイプ）］のドロップダウンメニューをクリックし、作成したい式のタイプを次の中から選択します。
  • 最小、最大、件数、合計、平均：関連付けられているレコードのプロパティーに基づいて値を計算します。このタイプの計算プロパティーの作成について詳しくはこちらをご覧ください。
  • Time between : 同一オブジェクト内の2つの日付入力・プロパティー間の時間に基づいて値を計算します。このタイプの計算プロパティーの作成について詳しくはこちらをご覧ください。
  • 切り下げのみ、切り上げのみ、四捨五入：同じオブジェクトのスコア、計算、または数値プロパティーの丸めに基づいて値を計算します。このタイプの計算プロパティーの作成について詳しくはこちらをご覧ください。
  • カスタム式：カスタム式に基づいて値を計算します。シンプルエディターまたはアドバンス モード エディターのいずれかを使用して、このタイプの計算プロパティーを作成する方法をご確認ください。

関連付けられているレコードのプロパティーに基づいて値を計算する

オブジェクトのプロパティーを作成すると、そのオブジェクトの関連レコードの特定のプロパティー値に基づいて、プロパティーが計算されます。そのオブジェクトの全ての関連レコードに基づいて、または特定の関連付けラベル（親会社と子会社の関係など）に対して、計算を行うことができます。

例えば、「Decision maker」ラベルを持つ取引の関連付けコンタクトに対して記録されたセールスアクティビティーの総数をカウントする取引プロパティーを作成することができます。

• 計算プロパティーの種類ドロップダウンメニューをクリックし、以下の種類のいずれかを選択します：
  • 最小：選択されたオブジェクトの関連レコードについて、選択された数値プロパティーの最小値を表示します。
  • 最大：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの最大値を表示します。
  • 件数：選択されたオブジェクトのうち、選択された数値プロパティーの値が存在するオブジェクトの、関連レコードの合計件数を計算します。
  • 合計：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値を合計します。
  • 平均：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値の平均を計算します。
• プロパティーの値のフォーマット方法を選択するには、Number formatドロップダウンメニューをクリックし、以下のフォーマットから選択します：書式付き数字 , 書式なし 数字 , 通貨 , 割合 , または期間 .

注：通貨を数値フォーマットとして使用するすべての計算プロパティーは、お客さまのアカウントの会社通貨を使用します。 

• プロパティー計算の基となる関連付けされたオブジェクトと関連付けされたレコードプロパティーを選択します。 
• 条件を追加するには、［条件を作成］をクリックします。追加条件を設定した場合、その条件が満たされなければプロパティーは計算されません（例：最近の取引金額>1,000の場合にプロパティーを計算）。
  • 最初のドロップダウンメニューで、プロパティーを選択します。
  • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
  • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。

• ［作成］をクリックします。作成後、プロパティーの表示フィールドタイプは「ロールアップ」となります。

2つのプロパティー間の時間に基づいて値を計算する

同じオブジェクト内の選択された2つの日付入力プロパティー間の時間を計算するプロパティーを作成することができます。例えば、チケットの担当者が割り当てられてから、チケットがクローズされるまでの時間を計算することができます。［次の間の時間］計算プロパティー値の表示について詳しくはこちらをご覧ください。

• 計算プロパティーの種類ドロップダウンメニューをクリックし、間の時間を選択します。
• ドロップダウンメニューをクリックし、開始日と終了日のプロパティーを選択します。

• 条件を追加するには、［条件を作成］をクリックします。追加条件を設定した場合、その条件が満たされなければプロパティーは計算されません（例：最近の取引金額>1,000の場合にプロパティーを計算）。
  • 最初のドロップダウンメニューで、プロパティーを選択します。
  • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
  • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。
• ［作成］をクリックします。作成後、プロパティーの表示フィールドタイプは「ロールアップ」となります。

計算間隔プロパティーの値を表示する場合、以下のような動作が想定されます：

• 時間の表示方法は、HubSpotのツールごとに異なります。
• タイムスタンプのない日付プロパティーの場合、計算に使用される既定の時刻は、選択された日の12:00 am UTCになります。
• オブジェクトレコード（例えば、コンタクトレコード）では、表示される値は、時間、日、月、または年で、特定のしきい値に基づいて次の単位に丸められ ます。例えば、計算された時間が1か月と20日であれば、表示される値は「1か月」となりますが、計算された時間が1か月と27日であれば、表示される値は「2か月」となります。しきい値は次のとおりです。
  • 45秒以上は1分に切り上げられます。
  • 45分以上は1時間に切り上げられます。
  • 22時間以上は1日に切り上げられます。
  • 26日以上は1か月に切り上げられます。
  • 11か月以上は1年に切り上げられます。
• このフィールドタイプのプロパティーを使用しているカスタムレポートでは、表示される値が日数単位になります。たとえば、計算結果の時間が1年と20日の場合、表示される値は385日になります。

注： HubSpot内では、Time between and Averageプロパティータイプの生の値はミリ秒単位で保存されます。数式でこれらの値を使用していて想定よりも高い値を使用する結果になる場合は、ミリ秒変換ツールを使用して目的の時間単位に変換します。

プロパティー値の四捨五入に基づいて値を計算する

他のプロパティーの数値の丸め方を指定する計算プロパティーを作成することができます。例えば、コミッションプロパティーを小数点以下2桁まで四捨五入する計算プロパティーを作成することができます。

• ［計算プロパティータイプ］ドロップダウンメニューをクリックして、端数処理オプションを選択します。
  • ［切り下げのみ］：常に、指定した小数点以下桁数まで値を切り下げます。 
  • ［切り上げのみ］：常に、指定した小数点以下桁数まで値を切り上げます。
  • ［四捨五入］：指定した小数点以下桁数に値を四捨五入します。
• プロパティーの値のフォーマット方法を選択するには、Number formatドロップダウンメニューをクリックし、以下のフォーマットから選択します：書式付き数字 , 書式なし 数字 , 通貨 , 割合 , または期間 .

• Choose the record propertyドロップダウンメニューをクリックし、丸めたい値のあるプロパティーを選択する。そのオブジェクト内のスコア、計算、または数値プロパティーを選択することができます。
• ［次の小数へ端数処理］テキストボックスに、値を端数処理する小数点以下の桁数を入力します。

注：通貨プロパティーに対して、この機能は選択された精度に値を丸めますが、正しい桁数の通貨として値を表示します。

• 条件を追加するには、［条件を作成］をクリックします。追加条件を設定した場合、その条件が満たされなければプロパティーは計算されません（例：最近の取引金額>1,000の場合にプロパティーを計算）。

• • 最初のドロップダウンメニューで、プロパティーを選択します。
  • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
  • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。
• ［作成］をクリックします。作成後、プロパティーの表示フィールドタイプは、「計算」となります。

カスタム式に基づいて値を計算する

独自の基準に基づいて値を計算するプロパティーを作成することもできます。カスタム方程式は、新しいプロパティーを作成する同じオブジェクト内の数値プロパティーにのみ設定できます。例えば、自分の会社がその会社に連絡した回数（［連絡の回数］）を基準として、会社の最近の取引の金額（［最近の取引金額］）を計算する数式を作成できます。

シンプルエディターまたはアドバンスエディターを使用して、カスタム数式を作成できます。

• シンプルエディター：事前定義されたオプションからプロパティー、値、演算子を選択して、数式を作成します。これらの数式で返すことができるのは数値のみです。
• アドバンスモードエディター : 算術演算子、比較演算子、論理演算子、条件文、その他の関数を使って方程式を書きます。これらの数式は、数値、ブール値、文字列、または日付の値を返すことができます。利用可能な演算子および関数と数式の書式設定の方法について、詳細をご確認ください。

カスタム数式の計算プロパティーを作成するには、次のようにします。

• 計算プロパティーの種類ドロップダウンメニューをクリックし、カスタム式を選択します。
• シンプルエディターで数式を作成するには、次のようにします。
  • ［数値の形式］ドロップダウンメニューをクリックし、プロパティー値の形式を選択します。以下のいずれかを選択できます：［書式付きの数値］、［書式なし数値］、［通貨］、［パーセンテージ］、または［期間］。

• • ドロップダウンメニューをクリックして数値プロパティーを選択するか数値を入力し、［定数：［入力値］］オプションをクリックして、数式に整数定数を含めます。
  • 演算記号のドロップダウンメニューをクリックして、加算（+）、減算（-）、乗算（*）、除算（/）のいずれかを追加します。
  • 式の要素を追加するには、［Add to equation（式に追加）］をクリックします。式の途中にさらに要素を追加するには、カッコ内の［展開］をクリックします。

• 詳細モードエディターで数式を作成するには、次のようにします。
  • ［詳細モード］スイッチをオンにします。

• • ［出力タイプ］ドロップダウンをクリックし、計算結果のタイプを選択します。以下のいずれかを選択できます：［数値］、［ブール値］、［文字列］、［日付］。

注：選択する出力タイプは、エディターの右上に表示されている出力タイプと一致している必要があります。一致していない場合、プロパティーを作成できません。ただし、日付を返すプロパティーの場合は、数値または日付のいずれの出力タイプでも使用できます。これは、値がどのように表示されるかに影響します（例えば、数値を使用すると日付がミリ秒単位で表示され、日付を使用すると書式設定された日付が表示されます）。

• • ［数値］出力タイプを選択した場合は、［数値の書式］ドロップダウンメニューをクリックして、プロパティーの値の書式を選択します。以下のいずれかを選択できます：［書式付きの数値］、［書式なし数値］、［通貨］、［パーセンテージ］、または［期間］。

• • エディターで、関数やプロパティーを挿入、入力、または貼り付けて、カスタム方程式を構築します。カスタム計算式の構文の詳細をご覧ください。数式の要素を挿入するには、次のようにします。
    
    • ［挿入］ドロップダウンメニューをクリックします。
    • 数式に関数を挿入するには、［関数］を選択して、関数を選択します。
    • 数式にプロパティーを挿入するには、［プロパティー］を選択してから、プロパティーを選択します。カスタム式を作成するときに使用できるプロパティーは、プロパティーを作成する同じオブジェクトのプロパティーのみです。

• • 数式にエラーがある場合は、エディターの上にある［［x］件の問題］をクリックすると、エラーの理由が表示されます。数式に未解決のエラーがある場合、プロパティーを作成することはできません。数式の形式を設定する方法をご覧ください。
  • 式の出力をプレビューするには、［テスト式］をクリックします。

注：カスタム数式内の数値プロパティーのいずれかに値がないか値がnullである場合、計算は実行されず、計算プロパティーの値は空になります。式に定数が含まれている場合でも、値は空になります。

• 条件を追加するには、［条件を作成］をクリックします。追加条件を設定した場合、その条件が満たされなければプロパティーは計算されません（例：［最近の取引金額］> 1,000の場合にプロパティーを計算）。
  • 最初のドロップダウンメニューで、プロパティーを選択します。
  • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
  • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。

• ［作成］をクリックします。作成後、プロパティーの表示フィールドタイプは、「計算」となります。

カスタム式の構文

詳細モードでは、リテラルデータ、他のプロパティーからのデータ、演算子、関数を使用して、独自のカスタム式を作成することができます。以下で、カスタム計算式を作成するための構文について説明します。

リテラル構文

リテラルデータを使用すると、テキスト文字列、数値、trueまたはfalseの値を数式に追加できます。文字列、数値、ブール値、および日付定数は、次のように書式設定できます。

• 文字列リテラル：引用符で囲まれたテキスト。これらは、単一引用符（'constant'）または二重引用符（"constant"）のいずれかを使用して表現できます。

• 数字リテラル：引用符で囲まれていない数字。定数は任意の実数にできます。小数点表現を含めることもできます。例えば、1005と1.5589は、どちらも有効な定数です。

• ブール値リテラル：ブール型定数には、trueまたはfalseを指定できます。

• 日付リテラル：ミリ秒単位の日付。例えば、1698508800000です。

プロパティー構文

同じオブジェクトの他のプロパティーをカスタム式に含めることができます。プロパティーがエディターに挿入されると、数式の一部として自動的に書式設定され、検証されます。

プロパティーを手動で入力するか、エディターにペーストする場合は、[properties.{propertyInternalName}]の書式にする必要があります。例えば、「Test_score」という内部値を持つ［テストスコア］プロパティーを追加するには、エディターに[properties.Test_score]のように入力します。

数式で列挙プロパティーを使用する場合は（ドロップダウン選択、ラジオボタン選択など）、値が文字列とみなされるため、二重引用符で囲む必要があります。例えば、"subscriber"です。

演算子

方程式の中で演算子を使うと、定数やプロパティーの値を更新したり、評価したり、比較したりすることができます。複数の演算子を使用する場合は、PEMDASの演算子の順序に従います。使用するデータのタイプに応じて、以下の演算子をカスタム式に含めることができます。

関数

カスタム式内で関数を使用して、値を計算したり、データに対するアクションを実行できます。使用するデータのタイプに応じて、以下の関数をカスタム式に含めることができます。