計算プロパティーを作成する

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

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

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

注：作成できる計算プロパティーの上限数はご契約のHubSpot製品に応じて異なります。

計算プロパティーを作成する

計算プロパティーは、関連レコードのプロパティー値、2つのプロパティー値の間の時間、または独自のカスタム式など、さまざまな条件に基づいて設定することができます。計算プロパティーまたはロールアッププロパティーを作成するには：

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

• 左のサイドバーメニューで、［プロパティー］を選択します。

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

• プロパティーの基本詳細を入力し、フィールドタイプタブをクリックします。
• カスタム式または「次の間の時間」式を作成するには、フィールドタイプとして［計算］を選択します。［計算プロパティータイプ］のドロップダウンメニューをクリックし、作成したい式のタイプを次の中から選択します。
  • カスタム式：カスタム式に基づいて値を計算します。このタイプの計算プロパティーの作成について詳しくはこちらをご覧ください。

• • 間の時間：同じオブジェクト内の2つの日付入力プロパティー間の時間に基づいて値を計算します。詳しくはこのタイプの計算プロパティーを作成する方法をご確認ください。
• 最小値、最大値、件数、合計、または平均を計算するプロパティーを作成するには、［ロールアップ］を選択します。［ロールアップタイプ］ドロップダウンメニューをクリックし、作成したい式のタイプを選択します。詳しくは、これらのタイプのプロパティーの作成についてご確認ください。

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

オブジェクトのプロパティーを作成すると、そのオブジェクトの関連レコードの特定のプロパティー値に基づいて、プロパティーが計算されます。そのオブジェクトの全ての関連レコード、または同じオブジェクト間の関連付けを含む特定の関連付けラベル , に基づいて計算することができます。

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

• ［ロールアップタイプ］ドロップダウンメニューをクリックし、以下のタイプからいずれかを選択します。
  • 最小：選択されたオブジェクトの関連レコードについて、選択された数値プロパティーの最小値を表示します。
  • 最大：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの最大値を表示します。
  • カウント：選択されたオブジェクトのうち、選択された数値プロパティーの値が存在する関連レコードの合計件数をカウントします。
  • 合計：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値を合計します。
  • 平均：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値の平均を計算します。
• プロパティー値の書式を選択するには、［数値の書式］ドロップダウンメニューをクリックし、書式付きの数値、書式なし数値、通貨、パーセンテージ、または所要時間から選択します。
• 取引プロパティーのフォーマットとして通貨を選択した場合、プロパティーはアカウントの会社通貨を既定値として使用します。各取引レコードの通貨を使用するには、［会社通貨ではなくレコード通貨を使用］チェックボックスをオンにします。レコード通貨を使用することは、値の表示方法に影響するだけであり、、自動的に為替レートが適用されることはありません。

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

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

注：生の継続時間値はミリ秒単位で保存されます。他のHubSpotツール(フィルター、計算プロパティー計算式など)で期間計算プロパティーを使用している場合、ミリ秒値を使用する必要があるかもしれません。

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内では、間の時間および平均プロパティータイプの未加工の値はミリ秒単位で保存されます。数式でこれらの値を使用していて想定よりも高い値を使用する結果になる場合は、ミリ秒変換ツールを使用して目的の時間単位に変換します。

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

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

算術演算子、比較演算子、論理演算子、条件文、その他の関数を使ってカスタム式を作成できます。これらの数式は、数値、ブール値、文字列、または日付の値を返すことができます。詳しくは、利用可能な演算子および関数と数式の書式設定についてご確認ください。 

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

• ［計算プロパティータイプ］ドロップダウンメニューをクリックし、カスタム式を選択します。
• ［出力タイプ］ドロップダウンをクリックし、計算結果のタイプを選択します。数値、ブール値、文字列、日付から選択できます。

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

• 数値の出力タイプを選択した場合は、続いて以下の操作を行います。
  • ［数値の書式］ドロップダウンメニューをクリックし、プロパティー値の書式を選択します。書式付きの数値、書式なし数値、通貨、パーセンテージ、所要時間から選択できます。
  • 取引プロパティーの数値の書式として通貨を選択した場合、取引プロパティーはアカウントの会社通貨を既定値として使用します。各取引レコードの通貨を使用するには、［会社通貨ではなくレコード通貨を使用］チェックボックスをオンにします。

注：レコード通貨の使用は、値の表示方法のみに影響し、自動的に為替レートが適用されることはありません。為替レートを追加するには、exchange_rateまたはdated_exchange_rateの関数を使用します。

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

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

注：カスタム式内の数値プロパティーのいずれかに値がない、または値がnullである場合、計算は実行されず、計算プロパティーの値は空になります。式に定数が含まれていても、値は空になります。このような場合、ifとis_knownの関数を使って、代わりに値を0に設定することができます。

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

カスタム式の構文

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

リテラル構文

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

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

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

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

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

プロパティー構文

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

プロパティーを手動で入力するか、エディターに貼り付ける場合は、[properties.{propertyInternalName}]の書式にする必要があります。例えば、内部値 Test_scoreを持つプロパティーTest score,を追加するには、[properties.Test_score]とエディターにタイプします。

列挙プロパティーを式で使用する場合（ドロップダウン選択、ラジオボタン選択など）：

• 値は文字列とみなされるので、二重引用符で囲む必要があります。例えば、"subscriber"のように入力します。
• プロパティーオプションの内部名を使用する必要があります。例えば、"appointmentscheduled"です。

演算子

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

関数

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

例

以下に、一般的なユースケースに基づく計算式の例をご紹介します。

• 複数の条件を持つステートメントや関数内のステートメントなど、if elseステートメントを設定することができます。
  • if([properties.number] < 4, "less than four", "more than four")
  • if([properties.number] < 4, if([properties.other_number] < 2, "both true", "one true"), "not true")
  • concatenate(if([properties.number] < 4, "less", "more"), " than four")
• カスタム式で数値プロパティーを使用する場合、ifとis_knownの関数を使用すると、数値プロパティーが空のときに値を0に設定することができます。例えば、if(is_known([properties.number]), [properties.number], 0)です。
• レコード通貨を数式に使用する場合、exchange_rateまたはdated_exchange_rateの関数を使用すると、為替レートを追加することができます。例えば、[properties.amount] * exchange_rate('CAD')のように入力します。