データセットの作成と使用

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

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

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

データセットの作成

データセットを作成するには

• HubSpotアカウントで、「Reports > Datasets」に移動します。
• 右上の「Create dataset」をクリックします。

すると、データセットビルダーの「結合」タブが表示されます。

結合

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

一次データソースがデータセットの中心となり、他のすべてのデータソースはその一次データソースに関連しています。これらのデータソースを接続するために、HubSpotはバックグラウンドで最短のパスを使ってデータを結合します。例えば、コンタクトとディールは直接関連しており、余分な結合を必要とせずに選択することができます。 

しかし、他のデータソースは直接関連付けることができず、データを結合するために追加のソースが必要になります。例えば、主要なソースがDealsで、ブログ投稿データをレポートに含めたい場合、HubSpotはContactsとWeb activitiesのソースを介してのみこれらのソースをリンクすることができます。これらの他のソースは自動的に選択され、データに参加します。

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

準備

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

プロパティーを追加

• データセットにプロパティを追加するには、左サイドバーから「Build your dataset」セクションにプロパティをドラッグ＆ドロップします。

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

フォーミュラフィールドの追加

フォーミュラフィールドは、データセットに固有のフィールドで、データセットのプロパティに基づいて値を計算するために使用することができます。 柔軟な式を使った数式の作成についてはこちらをご覧ください。

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

• 数式を作成すると、「数式」フィールドには検証状況が表示されます。計算式が無効な場合は、赤色のステータスインジケータが表示され、「検証」をクリックするとエラーの詳細が表示されます。
  
• フィールドを設定したら、右上の「Next」をクリックします。

フィルター

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

フィルターを追加するには

• 左のサイドバーから、クリックしてフィールドにドラッグします。アクティブでないフィルタセクションにドラッグします。
• フィールドをクリックすると、そのフィルターオプションが表示されます。を選択します。フィルターを選択してから適用.
• フィールドをクリックし、「別のフィルターでグループ化」ドロップダウンメニューをクリック することで、フィルターをグループ化することができます。他の選択アクティブフィルターをクリックし、次に適用.

• • フィルターの間にあるロジックセレクターをクリックして、「and」または「or」を選択することで、フィルターを「and」または「or 」でグループ化するかどうかを変更できます。
    
    
  • フィルターのグループ化を解除するには、フィルターをクリックし、「別のフィルターでグループ化」ドロップダウンメニューをクリックします。 None "を選択し、"Apply "をクリックします。
• フィルターの設定が完了したら次のページ.

確認

保存する前にデータセットを確認してください。 

• ソース」では、選択したデータソースが表示されます。 
• フィールド」では、データセットのフィールドを表示します。次に例を示します。
  • Field：フィールドの名前です。
  • Derived：フィールドが標準のHubSpotフィールドか、カスタム計算フィールドかを示します。

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

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

データセットの表示と管理

データセットダッシュボードでは、既存のデータセットを閲覧・編集することができます。

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

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

データセットを使ったレポートの作成

データセットを作成したら、レポートビルダーやデータセットツールから、データセットをもとにしたレポートを作成することができます。

• データセットの中からレポートを作成するには
• HubSpotアカウントで、「Reports > Datasets」に移動します。
• データセットの名前をクリックします。 
• 右上の「Build report」をクリックします。
• 続カスタムレポートビルダーでのレポート作成 . 
• カスタムレポートビルダーからレポートを作成するには
• HubSpotアカウントにて、［レポート］ > ［レポート］の順に進みます。
• 右上の［カスタムレポートを作成］をクリックします。
• 左のサイドバーで、［カスタム レポート ビルダー］を選択します。
• 右側の「データセットの参照」タブをクリックすると、既存のデータセットが表示されます。
  
  
• 使用したいデータセットを選択し、「次へ」をクリックします。

• 続きを読むカスタムレポートビルダーでレポートを作成する . 

参照

シンタックス

関数内では、プロパティやフィールドのデータ、またはリテラルデータを使用することができます。プロパティとフィールドのデータは、個々のデータソースに基づいて動的に変化しますが、リテラルデータは一定です。例：

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

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

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

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

リテラルシンタックス

リテラルを使うと、特定の静的な文字列、数字、真偽値、日付などを計算に加えることができます。

• 文字列リテラル：引用符で囲まれたテキスト。例えば、「My cool string」。

• 数字のリテラル：引用符を使わない数字。例えば、42。
• Boolean リテラル：trueまたはfalse。
• 日付リテラル："YYY-MM-DD "としてフォーマットされた文字列、または日付のタイムスタンプ番号（例：1635715904）。 

プロパティの構文

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

プロパティを参照する際には、以下の構文を使用してください。

• 参照表現は常に角括弧（[ and ]）で囲まれています。
• プロパティの参照では、オブジェクト名またはイベント名の後にピリオドを付け、内部プロパティ名を指定します。例：
  • [CONTACT.lifecyclestage]の
  • [COMPANY.name]の
  • [e_hs_scheduled_email_v2.__hs_event_native_timestamp] です。

フィールド参照構文

フィールド名を角括弧で囲むことで、数式内のフィールドを参照することができます。例：

• • [フィールド1]では
  • [My awesome custom field](私の素晴らしいカスタムフィールド)

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

• フィールド1 が[DEAL.name]の場合、文字列の値（ディールの名前）が入ります。
• CONCAT([Field 1], "Q4")は、2つの文字列値を含んでいるので有効です。
• CONCAT([DEAL.name], 2012)は、文字列と数値の両方の値を含んでいるため、有効ではありません。

演算子

演算子はリテラルやプロパティ／フィールドの値と一緒に使うことができ、演算子はPEMDASの標準的な操作順序で評価されます。これにより、括弧を使って演算子を入れ子にすることができます。例：

• プロパティ参照で数値を追加する1 + [DEAL.amount] の場合
• 括弧を使って演算を入れ子にする。(1 + 2) * (3 + 4)

数値関数

文字列機能

日付機能