計算プロパティーの作成
更新日時 2023年 9月 18日
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
を指定できます。
プロパティー構文
同じオブジェクトの他のプロパティーをカスタム式に含めることができます。プロパティーがエディターに挿入されると、数式の一部として自動的に書式設定され、検証されます。
プロパティーを手動で入力するか、エディターにペーストする場合は、[properties.{propertyInternalName}]
の書式にする必要があります。例えば、「Test_score」という内部値を持つ[テストスコア]プロパティーを追加するには、エディターに[properties.Test_score]
のように入力します。
演算子
方程式の中で演算子を使うと、定数やプロパティーの値を更新したり、評価したり、比較したりすることができます。複数の演算子を使用する場合は、PEMDASの演算子の順序に従います。使用するデータのタイプに応じて、以下の演算子をカスタム式に含めることができます。
演算子 | 説明 |
+ |
数値または文字列を加算します。数値を返します。 |
- |
数値を減算します。数値を返します。 |
* |
数値を乗算します。数値を返します。 |
/ |
数値を除算します。数値を返します。 |
< |
ある値が他の値より小さいかどうかを確認します。数値プロパティーまたは定数で使用できます。ブール値を返します。 |
> |
ある値が他の値より大きいかどうかを確認します。数値プロパティーまたは定数で使用できます。ブール値を返します。 |
<= |
ある値が他の値以下であるかどうかを確認します。数値プロパティーまたは定数で使用できます。ブール値を返します。 |
>= |
ある値が他の値以上であるかどうかを確認します。数値プロパティーまたは定数で使用できます。ブール値を返します。 |
! |
いずれの値もtrueでないことを確認します。ブール値を返します。 |
= または== |
ある値が別の値と等しいことを確認します。数値と文字列で使用できます。ブール値を返します。 |
!= |
ある値が別の値と等しくないことを確認します。数値と文字列で使用できます。ブール値を返します。 |
or または|| |
2つの値のいずれかがtrueであることを確認します。ブール値を返します。 |
and または&& |
両方の値がtrueであることを確認します。ブール値を返します。 |
関数
カスタム式内で関数を使用して、値を計算したり、データに対するアクションを実行できます。使用するデータのタイプに応じて、以下の関数をカスタム式に含めることができます。
関数 | 引数 | 例 |
文字列を1つの値にまとめます。文字列を返します。 |
arg1:arg2が追加される文字列。 arg2:arg1に追加する文字列。 |
|
通貨の小数桁数を取得します。数値を返します。 |
currency:小数桁数を計算する通貨文字列。 |
|
特定の時点における為替レートの値を取得します。数値を返します。 |
currency:特定の日付の為替レートを計算する通貨文字列(例: date : 為替レートを計算したい datetime プロパティー。 |
|
最新の為替レートを取得します。数値を返します。 |
currency:為替レートを計算する通貨文字列。 |
|
条件式をセットアップします。 |
condition:計算値を決めるブール値ステートメント。 arg2:条件が満たされた場合に、計算値となるブール、数値、または文字列。 arg3(任意):条件が満たされなかった場合の計算値。これを含める場合は、 |
|
トークンに値が存在するかどうかを判断します。ブール値を返します。 |
property:値をチェックするプロパティー。 |
|
トークンが最後に更新された日付を取得します。ミリ秒単位のタイムスタンプを文字列として返します。 |
property:最新の更新日をチェックするプロパティー。 |
|
全ての文字を小文字に変更します。文字列を返します。 |
text : 小文字に変更したい値を持つ文字列またはテキストプロパティー。 |
|
2つの数値の最大値を取得します。数値を返します。 |
arg1:最初の数値または数値プロパティー。 arg2:2つ目の数値または数値プロパティー。 |
|
2つの数値の最小値を取得します。数値を返します。 |
arg1:最初の数値または数値プロパティー。 arg2:2つ目の数値または数値プロパティー。 |
|
特定の日付の月を数値として取得します。数値を返します。 |
date : 月を計算したい datetime プロパティー。 |
|
数値を文字列に変換します。文字列を返します。 |
number_to_convert:文字列に変更する数値または数値プロパティー。 |
|
パイプラインステージの確度を取得します。数値を返します。 |
pipeline:確度を計算するパイプラインの名前。 |
|
数値の端数を指定の精度に切り下げます。数値を返します。 |
number_to_round:切り下げを行う数値または数値プロパティー。 precision:切り下げる小数桁数。 |
|
数値を指定の精度に端数処理します。数値を返します。 |
number_to_round:値を直近の整数に端数処理する数値または数値プロパティー。 |
|
数値の端数を指定の精度に切り上げます数値を返します。 |
number_to_round:切り上げる値の数値または数値プロパティー。 number_to_round:切り上げる小数桁数。 |
|
文字列を数値に変換します。数値を返します。 |
string_to_convert : 数値に変換したい文字列またはテキストプロパティー。 |
|
2つの日付間の時間差を取得します。数値を返します。 |
date1:開始日時プロパティー。 date2:終了日時プロパティー。 |
|
全ての文字を大文字に変更します。数値を返します。 |
text : 大文字に変更したい文字列またはテキストプロパティー。 |
|
特定の日付の年を数値として取得します。数値を返します。 |
date:年を計算する日時プロパティー。 |
|