計算プロパティーとロールアップ集計プロパティーを作成する

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

注: アカウントでは、 各オブジェクトにパーソナライズされた名前 を使用することができます(例えば、「会社」ではなく「アカウント」)。このドキュメントでは、HubSpotでのデフォルトの名前でオブジェクトを参照しています。

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

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

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

関連付けられたレコードのプロパティーに基づいてロールアッププロパティーを作成

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

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

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

2. 左のサイドバーメニューで、［プロパティー］に移動します。

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

4. プロパティーの基本的な詳細を入力し、[フィールドタイプ]タブをクリックします。
5. ［ロールアップ］を選択します。
6. ［ロールアップタイプ］ドロップダウンメニューをクリックして、以下のタイプからいずれかを選択します。
   • 最小：選択されたオブジェクトの関連レコードについて、選択された数値プロパティーの最小値を表示します。
   • 最大：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの最大値を表示します。
   • 件数：選択されたオブジェクトのうち、選択された数値プロパティーの値が存在するオブジェクトの、関連レコードの合計件数を計算します。
   • 合計：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値を合計します。
   • 平均：選択されたオブジェクトの全ての関連レコードについて、選択された数値プロパティーの値の平均を計算します。
7. プロパティー値の書式を選択するには、［数値の書式］ドロップダウンメニューをクリックし、書式付きの数値、書式なし数値、通貨、パーセンテージ、または所要時間から選択します。
8. 取引プロパティーの書式として [通貨 ]を選択した場合、プロパティーには既定でアカウントの 「会社の通貨 」が使用されます。各取引レコードの通貨を使用するには、[会社通貨ではなくレコード通貨を使用 ]チェックボックスをオンにします。レコードの通貨を使用しても、値の表示にのみ影響し、為替レートは自動的に適用されません。
9. プロパティー計算の基となる関連オブジェクトと関連レコードのプロパティーを選択します。 
10. 特定のラベルを付けたレコードのみに基づいて計算するには、［関連付けラベルを選択］をクリックし、含めたいラベルを選択します。
11. 条件を追加するには、[ 条件を追加]をクリックします。追加条件を設定する場合、プロパティーを計算するにはそれらの条件を満たす必要があります(例: 最近の取引金額 が1000 > 、 取引確度 > =80の場合にプロパティーを計算します)。ロールアッププロパティーあたり最大50個の条件を設定できます。
    • 最初のドロップダウンメニューで、プロパティーを選択します。
    • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
    • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。
    • ［保存］をクリックします。
12. ［作成］をクリックします。作成後、プロパティーのフィールドタイプはロールアップとなります。

注：未加工の継続時間値はミリ秒単位で保存されます。他のHubSpotツール（フィルター、計算プロパティー式など）で時間計算プロパティーを使用している場合、ミリ秒単位の値が必要になることがあります。

「次の間の時間」、「基点からの時間」または「基点までの時間」の計算プロパティーを作成する

2つの日付の間の時間を計算するプロパティー、または日付／日時の入力プロパティーの値によって決定される、ある日付までの時間、またはその日付からの時間を追跡するプロパティーを作成できます。「次の間の時間」プロパティーは、同じオブジェクトのプロパティーでのみサポートされます。

以下に例を示します。

• 「次の間の時間」プロパティーを作成し、チケットの担当者が割り当てられてからチケットがクローズされるまでの時間を計算します。
• 「オープンからの経過時間」プロパティーを作成し、取引がオープンの状態である期間を追跡します。
• 「クローズまでの時間」プロパティーを作成し、今日から顧客のクローズ設定日までの期間を追跡します。

プロパティー値ではなく、今日の日付を基準とする相対時間を示す値を持つプロパティーを作成するには、相対的な日付／日時の入力プロパティーの作成方法を参照してください。また、カスタム式を使って 固定時間プロパティーを作成することもできます 。

「次の間の時間」、「基点からの時間」または「基点までの時間」の計算プロパティーを作成するには、次のようにします。

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

2. 左のサイドバーメニューで、［プロパティー］に移動します。

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

4. プロパティーの基本的な詳細を入力し、[フィールドタイプ]タブをクリックします。
5. フィールドタイプとして［計算］を選択します。
6. ［計算プロパティータイプ］ドロップダウンメニューをクリックし、タイプを選択して、計算を設定します。
   • 次の間の時間：［開始日］と［終了日］のプロパティーを選択します。
   • 基点からの時間：開始日となる値を示す日付／日時入力のプロパティーを選択します。終了日は常に今日の日付になります。
   • 基点までの時間：終了日となる値を示す日付／日時入力のプロパティーを選択します。開始日は、常に今日の日付になります。
7. [ プロパティー間の時間 のみ]で条件を追加するには、[ 条件を追加]をクリックします。追加条件を設定する場合、プロパティーを計算するにはそれらの条件を満たす必要があります(例: 最近の取引金額 が1000 > 、 取引確度 > =80の場合にプロパティーを計算します)。
   • 最初のドロップダウンメニューで、プロパティーを選択します。
   • 2番目のドロップダウンメニューで、最初のプロパティーの値を数値または別のプロパティーの値と比較する演算子を選択します。
   • 3番目のドロップダウンメニューで、最初のプロパティーと比較するプロパティーを選択するか、数値を入力します。
   • ［保存］をクリックします。
8. ［作成］をクリックします。作成後、プロパティーのフィールドタイプは「計算」となります。その後、「次の間の時間」、「基点からの時間」、「基点までの時間」のいずれであっても編集できなくなりますが、別の「開始日」または「終了日」プロパティーを選択できます。

継続期間値を表示する場合、以下のような動作が想定されます。

• タイムスタンプのない日付プロパティーの場合、計算に使用される既定の時刻は、選択された日の12:00 am UTCになります。
• 表示される値は、特定のしきい値に基づいて、秒、分、時間、日、月、または年単位となります。単位のしきい値は次のとおりです。
  • 2.5年以上は年単位で表示されます。
  • 3か月以上は月単位で表示されます。
  • 1日以上は日単位で表示されます。
  • 2.5時間以上は時間単位で表示されます。
  • 2.5分以上は分単位で表示されます。
  • 2.5分未満は秒単位で表示されます。

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

カスタム数式計算プロパティーを作成する

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

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

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

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

2. 左のサイドバーメニューで、［プロパティー］に移動します。

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

4. プロパティーの基本的な詳細を入力し、[フィールドタイプ]タブをクリックします。
5. フィールドタイプとして［計算］を選択します。
6. ［計算プロパティータイプ］ドロップダウンメニューをクリックし、カスタム式を選択します。
7. ［出力タイプ］ドロップダウンをクリックし、計算結果のタイプを選択します。数値、 ブール値、 文字列、 日付 、 または日時のいずれかを選択できます。

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

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

9. 式エディターで、関数やプロパティーの挿入、入力、貼り付けを行い、カスタム式を作成します。カスタム計算式の構文の詳細をご覧ください。数式の要素を挿入するには、次のようにします。
   
   • ［挿入］ドロップダウンメニューをクリックします。
   • 数式に関数を挿入するには、［関数］を選択して関数を選択します。
   • 式にプロパティーを挿入するには、[ プロパティー]を選択してから、 プロパティーを選択します。カスタム数式は、そのプロパティーを作成するのと同じオブジェクトのプロパティーを使用してのみ作成できます。
10. 数式にエラーがある場合は、エディターの上にある［◯件の問題］をクリックすると、エラーの理由が表示されます。数式のエラーが解決しないと、プロパティーを作成することはできません。詳しくはカスタム式の書式を設定する方法をご確認ください。
11. 式の出力をプレビューするには、［式のテスト］をクリックします。
12. ［作成］をクリックします。作成後、プロパティーのフィールドタイプは「計算」となります。

カスタム式の構文

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

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

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

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

  • 日付リテラル：ミリ秒単位の日付。たとえば、「 1698508800000」のように入力します。
• プロパティー構文：同じオブジェクトの他のプロパティーをカスタム式に含めることができます。
  • プロパティーがエディターに挿入されると、プロパティーは数式の一部として自動的に書式設定され、検証されます。
  • エディターでプロパティーを手動で入力するか貼り付ける場合には、[properties.{propertyInternalName}]という書式にする必要があります。例えば、プロパティー テストのスコアを追加する場合、そのスコアはTest_scoreで、エディターに[properties.Test_score]と入力します。
  • 数式に 列挙プロパティー(ドロップダウン選択、ラジオボタンなど)を使用する場合は、値が文字列とみなされるため、二重引用符で囲む必要があり(「 "subscriber"」など)、プロパティーオプション の内部名 ( "appointmentscheduled"など)も使用する必要があります。
  • 数式で日付プロパティーを使用する場合、値はUTC深夜10時(ミリ秒単位)として保存されます。
  • 数式で日時プロパティーを使用する場合、値はミリ秒単位のUTCエポックとして保存されます。この値はタイムゾーンに基づいて表示されます。つまり、タイムゾーンが異なるユーザーには異なる値が表示されます。

演算子

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

関数

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

カスタム式の例を確認

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

if else文を使用する

複数の条件を持つステートメントや関数内で、if elseステートメントを設定できます。

例えば、アクティブな取引にラベルを付ける計算を作成できます。以下では、取引のステータスがアクティブで 、[金額 ]が0より大きい場合にのみ true が返されます。

• if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")

null 値の計算を実行 

カスタム式にプロパティーを使用する場合、ifとis_knownの関数を使用すると、プロパティーが空のときに値を0に設定することができます。そうすることで、null 値を含むプロパティーに関係なく計算が実行されます。以下に例を示します。

•  if(is_known([properties.number]), [properties.number], 0).
  
  

為替レートを通貨の計算に追加

数式でレコード通貨を使用する場合、為替レートを追加するには、数式に exchange_rate 関数または dated_exchange_rate 関数 を含めることができます。以下に例を示します。

• [properties.amount] * exchange_rate('CAD').

固定時間計算を作成 

2つの日付間の固定時間を取得する計算を設定できます。デフォルトでは、未加工の値はミリ秒単位で返されます。除算と round_nearest関数を使用して、時間、日などに書式設定し、最終的な値の小数を省略できます。例えば、次の設定では固定日の値が返されます。

• round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0).

注: プロパティーの名前と説明を入力する際には、具体的に入力することをお勧めします。このようにして、ユーザーは計算される時間(時間や日数など)を確認できます。