データセットを作成して使用する

データセットとは、HubSpotアカウント全体のデータの集合であり、カスタムレポートで使用できます。データセットには、CRMオブジェクトやHubSpotアセットのプロパティー、必要に応じてデータを計算するための数式などを含めることができます。例えば、取引額のプロパティーに基づいて年間経常収益を計算するフィールドを作成できます。 

チーム用のデータセットを複数作成しておくと、レポート作成者は、レポートを作成する必要が生じるたびにデータソースを選択する必要がなくなります。また、データセットは作成後に更新できるので、そのデータセットを使用するすべてのレポートを同時に更新できます。

以下では、データセットの作成方法、レポートでのデータセットの使用方法、データセットツールで使用できる関数の定義について説明します。

データセットを作成する

データセットを作成するには、次の手順に従います。

• HubSpotアカウントで、［レポート］>［データセット］に移動します。
• 右上の［データセットを作成］をクリックします。

データセットビルダーの［結合］タブが表示されます。

結合

まず、データセットに含めるデータソースを選択します。この場合のデータソースとは、レポートの対象となるオブジェクト、アセット、イベントを指します。これには、すべてのCRMオブジェクト（コンタクトやカスタムオブジェクトなど）とアセット（ウェブサイトのページやメール、会話、セールスアクティビティーなど）が含まれます。1つのデータセットにつき最大5つのデータソースを選択できます。

データセットはプライマリー データ ソースを中心に構成され、そのプライマリーソースに関連する他のすべてのデータソースが追加されます。これらのデータソースを接続するために、HubSpotではバックグラウンドで最短パスを使ってデータが結合されます。例えば、コンタクトと取引は直接関連しているので、追加の結合を必要とせずに選択できます。 

ただしその他のデータソースは直接関連付けることができないため、データを結合するには追加のソースが必要となります。例えば、［取引件数］をプライマリーソースとするレポートにブログ記事のデータを含める場合、HubSpotでは［コンタクト］と［ウェブアクティビティー］ソースを介してのみこれらのソースをリンクできます。データを結合するときに、このような他のソースが自動的に選択されます。

• プライマリー データ ソースを選択するには、［プライマリー データ ソース］ドロップダウンメニューをクリックして、データソースを選択します。
  
  
• 引き続き追加のデータソースを選択します。右側のパネルで、現在選択されているデータソース間の関係を確認できます。
• ソースを選択するときに、画面下部の［プレビュー］ペインでデータのプレビューを確認します。 
• データソースを選択したら、右上の［次へ］をクリックします。

準備

データセットに含めるフィールドを選択します。既存のHubSpotプロパティーをデータセットに追加したり、カスタム数式フィールドを追加したりできます。

プロパティーを追加する

• データセットにプロパティーを追加するには、左側のサイドバーから［データセットを構築］セクションにプロパティーをドラッグ＆ドロップします。

• プロパティーの名前を変更するか、またはそのデータのプレビューを表示するには、［データセットを構築］の下でそのプロパティーをクリックして、右側の［名前］フィールドに新しい名前を入力します。プロパティーの名前を変更すると、このデータセットでのみ名前が更新されます。これにより、レポートビルダーでのこれらのフィールドの表示方法をカスタマイズできますが、既存のプロパティーの名前には影響しません。

数式フィールドを追加する

数式フィールドはデータセットに固有のフィールドであり、データセットのプロパティーに基づいて値を計算するために使用できます。柔軟な式を使った数式の作成について、詳細をご確認ください。

• 数式フィールドを作成するには、［式フィールドを作成］をクリックします。
  
  
• 右側に、フィールドの名前を入力します。
• ［式］フィールドに、数式を入力します。データセットに追加したプロパティーや、データセット外のその他のHubSpotプロパティーを参照し、関数を使ってプロパティーやリテラルデータに基づいて計算することができます。式の構文と定義については、以下をご確認ください。
  • 手動で数式を入力するには、［式］フィールドへの入力を開始します。既定では、HubSpotではテキストの入力時にオートコンプリートオプションが表示されます。オートコンプリートをオフにするには、［式ガイダンスを表示］チェックボックスをオフにします。
    
    
  • データセットに追加したプロパティーを挿入するには、［フィールドを作成しました］ドロップダウンメニューをクリックして、プロパティーを選択します。
  • データセットにないプロパティーを挿入するには、［HubSpotのプロパティー］ドロップダウンメニューをクリックし、プロパティーを選択します。
  • 関数を挿入するには、［機能］ドロップダウンメニューをクリックして関数を選択します。

• 数式を作成すると、［式］フィールドに検証状況が表示されます。数式が無効な場合は赤色のステータスインジケーターが表示され、［検証］をクリックしてエラーの詳細を確認できます。
  
• フィールドの設定が完了したら、右上の［次へ］をクリックします。

条件付きフィールドの追加

ご注意：このセクションには、現在ベータ版の機能に関する情報が含まれています。

条件付きフィールドは、ユーザーが設定した条件に基づいてデータをグループ化したり、バケット化したりすることを可能にします。これらのフィールドは、データセットまたはカスタムレポートビルダーでのみ使用することができます。条件付きフィールドを使用して、案件の規模に応じて異なるコミッションを計算したり、フィードバックの回答をカテゴリーに変換して、たとえば1～6のラベルを付けるとdetractorと表示したりすることが可能です。

条件付きフィールドでは、IF()関数を使って計算式を構築することができます。条件付きフィールドを使用して構築されたフィールドは、標準的な数式作成フィールドのIF()関数を使用して再作成することができます。

• 条件フィールドの作成」をクリックして、条件フィールドを新規に作成します。
  
• 右側に、フィールドの名前を入力します。この名前は、このセグメントを使用してレポートを作成する際に表示されます。
• 条件]セクションで、IF条件を入力します。データの各行について、このセクションで設定された条件が真であれば、その行にはThen フィールドで設定された値でラベルが付けられる。条件が false の場合、その行はDefault value フィールドに設定された値でラベル付けされます。データセットに追加したプロパティや、データセット外のHubSpotのプロパティを参照したり、プロパティやリテラルデータを基に計算する関数を使用したりすることができます。式の構文と定義については、以下をご確認ください。
  • 数式を手入力するには、IFフィールドで入力を開始します。デフォルトでは、HubSpotはテキストを入力する際にオートコンプリートオプションを表示します。
    
    
  • HubSpotプロパティ、データセットに追加したプロパティ、または関数を挿入するには、「挿入」ドロップダウンメニューをクリックし、「HubSpotプロパティ」「作成済みフィールド」「関数」のいずれかを選択します。
    
    
  • Thenのフィールドに、条件がtrueの場合に割り当てたい値を入力します。
  • また、「高度な式」チェックボックスを選択すると、ラベルの代わりに値を計算したり、プロパティを参照したりすることができます。例えば、手数料の計算には、Advanced expressionsを使用することができます。

• 別の条件フィールドを追加する場合は、「条件ブロックの追加」をクリックします。条件ブロックは順次処理され、最初の条件が真であれば、そのブロックに定義された値が設定される。もし、それが真実でなければ、HubSpotは次のブロックに行き、といった具合です。設定された条件を満たさない行には、Default 値が割り当てられます。
  
  
• Default valueの項目で、条件を満たさない場合のElseの値を入力します。
  
  
• フィールドの設定が完了したら、右上の［次へ］をクリックします。

フィルター

フィールドにフィルターを追加することで、データをさらに絞り込むことができます。

フィルターを追加するには、次の手順に従います。

• 左側のサイドバーから、フィールドをクリックして［無効なフィルター］セクションにドラッグします。
• フィールドをクリックすると、そのフィルターオプションが表示されます。フィルターを選択してから［適用］をクリックします。
• フィルターをグループにまとめるには、1つのフィールドをクリックして、［別のフィルターとグループ化］ドロップダウンメニューをクリックします。別のアクティブフィルターを選択して、［適用］をクリックします。

• • 「and」ロジックまたは「or」ロジックを使ってフィルターをグループにまとめるかどうかを変更できます。これには、フィルターの間にあるロジックセレクターをクリックして、［and］また［or］を選択します。
    
    
  • フィルターのグループ化を解除するには、フィルターをクリックし、［別のフィルターとグループ化］ドロップダウンメニューをクリックします。［なし］を選択してから、［適用］をクリックします。
• フィルターの設定が終わったら［次へ］をクリックします。

確認

保存する前にデータセットを確認します。 

• ［ソース］で、選択したデータソースを確認します。 
• ［フィールド］で、データセットのフィールドを確認します。次に例を示します。
  • フィールド：フィールドの名前。
  • 派生：フィールドが、HubSpotの標準フィールドとカスタム計算フィールドのどちらであるかを示します。

• データタイプ：フィールドに含まれるデータのタイプ。
• 入力：フィールドの式。
• ソース：データのソース（例：「コンタクト」）。
• ［プレビュー］パネルで、データのプレビューを確認します。［テーブルの関係を表示］をクリックすると、データがどのように接続しているかを確認できます。
• データを確認したら、［保存］をクリックしてデータセットを保存します。
• 右側のパネルで、データセットの名前と説明を入力します。
• ［適用］をクリックします。

その後、レポートビルダーが表示されます。レポートビルダーでは、データセットに基づいてレポートを作成できます。

データセットを表示して管理する

データセットダッシュボードでは、既存のデータセットを表示、編集できます。

• HubSpotアカウントで、［レポート］>［データセット］に移動します。
• テーブルの上部にあるフィルターを使って、既存のデータセットをフィルタリングできます。
• データセットを編集するには、データセットにカーソルを合わせて、［編集］をクリックします。データセットの詳細ページが表示されます。
  • ［プレビュー］タブで、データセットのデータのプレビューを確認します。 
  • ［メタデータ］タブで、データセットに含まれるデータソースとフィールドを確認します。次に例を示します。
    • フィールド：フィールドの名前。
    • 派生：フィールドが、HubSpotの標準フィールドとカスタム計算フィールドのどちらであるかを示します。
    • データタイプ：フィールドに含まれるデータのタイプ。
    • 入力：フィールドにデータを取り込むために使用される文字列。
    • ソース：データのソース（例：「コンタクト」）。
  • ［レポート］タブで、データセットを使って作成されたレポートを確認します。

  • データセットの詳細ページで［レポートを作成］をクリックして、そのデータセットを使って新しいレポートを作成することもできます。

データセットを使ってレポートを作成する

データセットを作成したら、レポートビルダーまたはデータセットツールから、データセットに基づいてレポートを作成できます。

• データセット内からレポートを作成するには、次の手順に従います。
• HubSpotアカウントで、［レポート］>［データセット］に移動します。
• データセットの名前をクリックします。 
• 右上にある［レポートを作成］をクリックします。
• 次にカスタム レポート ビルダーでレポートを作成します。 
• カスタム レポート ビルダーからレポートを作成するには、次の手順に従います。
• HubSpotアカウントにて、［レポート］ > ［レポート］の順に進みます。
• 右上の［カスタムレポートを作成］をクリックします。
• 左のサイドバーで、［カスタム レポート ビルダー］を選択します。
• 右側の［データセットを参照］タブをクリックして、既存のデータセットを確認します。
  
  
• 使用するデータセットを選択し、［次へ］をクリックします。

• 次にカスタム レポート ビルダーでレポートを作成します。 

リファレンス

構文

関数内では、プロパティーとフィールドのデータ、またはリテラルデータを使用できます。プロパティーとフィールドのデータは、個々のデータソースに基づいて動的に設定されますが、リテラルデータは定数です。次に例を示します。

• 2021-03-05はリテラルの日付であり、定数です。
• [CONTACT.createdate]は、プロパティーに基づく日付で、コンタクトレコードごとに動的に設定されます。

関数には、リテラルデータとプロパティー／フィールドデータの両方を含めることができます。ただし、データ型が関数の必須引数と互換である場合に限ります。次に例を示します。

DATEDIFF("MONTH", "2021-01-01", “[CONTACT.createdate]”)

以下に、リテラルとプロパティー／フィールドデータの構文、これらのデータを数式に組み込む方法を説明します。

リテラル構文

テキストの静的文字列、数値、true／false値、日付を計算に追加するには、リテラルを使用します。

• 文字列リテラル：引用符で囲まれたテキスト。例：“My cool string”。

• 数字リテラル：引用符で囲まれていない数字。例：42。
• ブール値リテラル：trueまたはfalse。
• 日付リテラル："YYY-MM-DD " の形式の文字列、または日付のタイムスタンプ数値（例：1635715904）。 

プロパティー構文

プロパティー参照を使用して、選択したデータソースのプロパティーから値を直接取り込むことができます。プロパティーを参照するために、プロパティーをデータセットのフィールドとして追加する必要はありません。 

プロパティーを参照するときには、以下の構文を使用します。

• 参照表現は常に角括弧（[と]）で囲みます。
• プロパティー参照では、オブジェクト名またはイベント名、ピリオド、内部プロパティー名をこの順序で指定します。次に例を示します。
  • [CONTACT.lifecyclestage]
  • [COMPANY.name]
  • [e_hs_scheduled_email_v2.__hs_event_native_timestamp]

フィールド参照構文

数式でフィールドを参照するには、フィールド名を角括弧で囲みます。次に例を示します。

• • [Field 1]
  • [My awesome custom field]

数式の演算子や関数がフィールドのデータ型を受け入れる限り、数式でそのフィールドを参照できます。例えば、文字列を含む新しいフィールドを作成した場合、文字列を受け入れる関数の中でそのフィールドを参照できます。

• 「Field 1」が[DEAL.name]の場合、文字列値（取引の名前）が含まれています。
• CONCAT([Field 1], "Q4")は、2つの文字列値が含まれているため、有効です。
• CONCAT([DEAL.name], 2012)は、文字列と数値の両方が含まれているため、有効ではありません。

演算子

演算子はリテラルやプロパティー／フィールドの値とともに使用できます。演算子は、標準的な演算順（PEMDAS）で評価されます。これにより、括弧を使って演算子を入れ子にできます。次に例を示します。

• プロパティの参照で数値を追加する。1 + [DEAL.mount]（ディールアマウント
• 括弧を使った演算のネスト(1 + 2) * (3 + 4)

IF

IFロジックとは、ある条件を満たした場合に実行されるルールの集合体です。IFロジックでデータを区別することができます。例えば、IFロジックを使って

• 取引の大きさに応じて手数料を計算する（例：大きな取引には高い％を与える）。
• 案件を階層別に分類し、レポートでの分析・対策に役立てることができます。
• フィードバックの回答をカテゴリーに変換する（例：ラベル1～6はdetractor）。
• リードとしてマークされた日数に基づいてコンタクトの優先順位を定義します。
   

数値関数

文字列関数

日付関数