メインコンテンツにスキップ
お客さまへの大切なお知らせ:膨大なサポート情報を少しでも早くお客さまにお届けするため、本コンテンツの日本語版は人間の翻訳者を介さない自動翻訳で提供されております。正確な最新情報については本コンテンツの英語版をご覧ください。

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

更新日時 2021年 11月 17日

対象製品

Operations Hub Enterprise

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

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

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

データセットの作成

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

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

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

結合

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

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

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

  • プライマリデータソースを選択するには、「プライマリデータソース」ドロップダウンメニューをクリックし、データソースを選択します。

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

準備

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

プロパティーを追加

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

2021-10-28_11-28-34 (1)

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

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

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

  • 数式フィールドを作成するには、「数式フィールドの作成」をクリックします。

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

      データセット・フォーミュラー・フィールド・オートコンプリート0
    • データセットに追加したプロパティを挿入するには、「 Created field」ドロップダウンメニューをクリックして、プロパティを選択します。
    • データセットにないプロパティを挿入するには、「HubSpotプロパティ」のドロップダウンメニューをクリックし、プロパティを選択します。
    • 関数を挿入するには、「関数」ドロップダウンメニューをクリックして、関数を選択します。
フォーミュラフィールドオプション0
  • 数式を作成すると、「数式」フィールドには検証状況が表示されます。計算式が無効な場合は、赤色のステータスインジケータが表示され、「検証」をクリックするとエラーの詳細が表示されます。
    データセット-数式-フィールド-バリデーション0
  • フィールドを設定したら、右上の「Next」をクリックします。

フィルター

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

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

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

データセット-グループ-フィルタ0

    • フィルターの間にあるロジックセレクターをクリックして、「and」または「or」を選択することで、フィルターを「and」または「or でグループ化するかどうかを変更できます。

      データセットとフィルター0
    • フィルターのグループ化を解除するには、フィルターをクリックし、「別のフィルターでグループ化」ドロップダウンメニューをクリックします。 None "を選択し、"Apply "をクリックします。
  • フィルターの設定が完了したら次のページ.

確認

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

  • ソース」では、選択したデータソースが表示されます。 
  • フィールド」では、データセットのフィールドを表示します。次に例を示します。
    • Field:フィールドの名前です。
    • Derived:フィールドが標準のHubSpotフィールドか、カスタム計算フィールドかを示します。
    • データタイプ:フィールドに含まれるデータのタイプ。
    • 入力:フィールドの表現。
    • ソース:データのソース(例:Contacts)。
  • プレビューパネルで、データのプレビューを表示します。 テーブルの関係を表示」をクリックすると、データがどのようにつながっているかを確認することができます。
  • データを確認したら、「Save」をクリックしてデータセットを保存します。
  • 右のパネルでは、データセットの名前説明を入力します。
  • [適用]をクリックします。

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

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

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

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

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

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

  • データセットの中からレポートを作成するには
  • カスタムレポートビルダーからレポートを作成するには
    • HubSpotアカウントにて、[レポート] > [レポート]の順に進みます。
    • 右上の[カスタムレポートを作成]をクリックします。
    • 左のサイドバーで、[カスタム レポート ビルダー]を選択します。
    • 右側の「データセットの参照」タブをクリックすると、既存のデータセットが表示されます。

      ブラウズ・データセット・タブ0
    • 使用したいデータセットを選択し、「次へ」をクリックします。

参照

シンタックス

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

  • 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)
演算子 説明 使用例

+

数字を追加します。数値を返します。

1 + 1
= 2

[DEAL.amount] + 100

-

数字の引き算数値を返します。

100 - 1
= 99

exp(1) - exp(1)
= 0

WEEKNUM([DEAL.closedate])-WEEKNUM([DEAL.createdate])

*

数字の掛け算。数値を返します。

2 * 2
= 4

パウダー(10, 2) * -1
= -100

[DEAL.amount] * 0.5

/

数字の割り算。数値を返します。

10/ 2
= 5

[DEAL.amount] / DATEDIFF("DAY", [DEAL.createdate], [DEAL.closedate])

-

数値を否定します。

-100
= -100

-[DEAL.money]

&&

2つのブール値の両方が真であるかどうかをチェックします。真偽値を返します。

真&& 偽
= false

CONTAINS("HubSpot", "Hub")&& CONTAINS("HubSpot", "Spot")
= 真

CONTAINS("HubSpot", "Hub")&& CONTAINS("HubSpot", "CRM")
= false

||

2つのブール値のどちらかが真であるかどうかをチェックします。真偽値を返します。

真 || 偽
= true

CONTAINS("HubSpot", "Hub") || CONTAINS("HubSpot", "CRM")
= 真

CONTAINS("HubSpot", "Sales")&& CONTAINS("HubSpot", "Marketing")
= false

!

ブール値を否定します。別のブール値を返します。

本当です。
= false

==

等価演算子です。ブール値を返します。

==true
= true

数値関数

機能 定義 議論 使用例

ABS

数字の絶対値を計算する。数値を返します。

ABS(数字)

number:絶対値を取る数値。

ABS(-10)
= 10

ABS(10)
= 10

CEIL

10進数の値を最も近い整数に丸める。数値を返します。

CEIL(数字)

の番号を表示します。の天井を取る番号です。

CEIL(3.14)
= 4

CEIL(EXP(1))
= 3

CEIL(LN([DEAL.amount]))

DIV0

数値の除算を行いますが、除算値がゼロの場合はゼロを返します。数値を返します。

DIV0(配当、除数)

配当割り算の配当として使用する数値です。

割り算の割り算の際に除数として使用する数値で、0の場合は全体で0の値になります。

DIV0(5, 2)
= 2.5

DIV0(5, 0)
= 0

DIV0([DEAL.amount], DATEDIFF("DAY", [DEAL.createdate], [DEAL.closedate]))

EXP

コンピュータのオイラー数を値に上げたもの。数値を返します。

EXP(指数)

指数をオイラー数を上げるための指数です。

EXP(1)
= 2.7182818459045

EXP(0)
= 1

フロアー

10進数の値を最も近い整数に丸める。数値を返します。

フロア(数字)

の数になります。オイラーの数を上げるための指数。

フロア(3.14)
= 3

CEIL(EXP(1))
= 2

FLOOR(LN([DEAL.amount]))

LN

ある値の自然対数を計算する。数値を返します。

LN(数字)

number:自然対数を取る値。

LN(1)
= 0

LN(EXP(1))
= 1

LN([DEAL.amount])

LOG

指定された基数での値の対数を計算します。数値を返します。

LOG(ベース、バリュー)

base:値の対数計算に使用する基数。

value:対数をとる数値。

LOG(10, 1)
= 0

LOG(10, 10)
= 1

LOG(10, [DEAL.amount])

POWER

基準となる値を指定されたパワーに引き上げる。数値を返します。

POWER(ベース、指数)

base:累乗を計算する数値。

指数:ベースを上げるための数値。

POWER(2, 10)
= 1024

パワー(100, 0.5)
= 10

POWER([DEAL.hs_arr], 2)

SQRT

非負の数の平方根を取る。数値を返します。

SQRT(数値)

number:平方根を取る数。

SQRT(100)
= 10

SQRT([DEAL.hs_arr])

幅のあるバケット

数値を同じ幅のバケツに入れます。値が入っているバケツの番号を返します。

返された値が最小値を下回る場合は0を返します。返された値が最大値を超える場合は、バケット数+1を返します。

WIDTH_BUCKET(value, minValue, maxValue, bucketCount)

value:ビン番号で計算する数値。

minValue:ビニングを開始する最小値。

maxValue:ビンに入れる最大値。

bucketCount:minValuemaxValueの間に値を入れるための等幅のバケットの数 

width_bucket(25, 0, 100, 10)
= 3

width_bucket(95, 0, 100, 10)
= 10

ワイドバケット(-1000, 0, 100, 10)
= 0

ワイドバケット(9999, 0, 100, 10)
= 11

WIDTH_BUCKET([DEAL.amount], 0, 10000, 1000)

文字列機能

機能 定義 議論 使用例

CONTAINS

文字列に部分文字列が含まれているかどうかを判定する。ブール値を返します。

CONTAINS("string ", " substring")

string:テストする文字列の値。

substring:文字列の内部をチェックする値。

CONTAINS("HubSpot ", " Hub")
= 真

CONTAINS("foo ", " bar")
= false

CONTAINS([CONTACT.firstname], "Mike")

CONCAT

2つの文字列を連結します。文字列を返します。

CONCAT("string1 ", " string2")

string1: string2が付加される文字列の値。

string2: string1に追加する文字列の値。

CONCAT("ハブ", "スポット")
= "HubSpot"

CONCAT([CONTACT.firstname], CONCAT(" ", [CONTACT.lastname]))

長さ

文字列の長さを計算します。数値を返します。

LENGTH("文字列")

string:長さを計算する文字列の値。

LENGTH("HubSpot")
= 7

LENGTH([FEEDBACK_SUBMISSION.hs_content])

TRIM

文字列から先頭と末尾のホワイトスペースを削除します。文字列を返します。

TRIM("文字列")

string : ホワイトスペースをトリムする文字列。

TRIM(" Cats are great ")
= "Cats are great"

日付機能

機能 定義 議論 使用例

date_from_parts

年、月、日のパーツから日付の値を作成します。日付を返します。

DATE_FROM_PARTS(年、月、日)

年:希望する日付の西暦部分。

month:希望する日付の月部分。

day:希望する日付の曜日部分。

date_from_parts(2021, 1, 1)
= 2021-01-01

DATEDIFF

指定された時間単位で、最初の日付値と2番目の日付値の間の時間単位の数を返す。数値を返します。

DATEDIFF("datePart", "date1", "date2")

datePart:差分計算に使用する年、四半期、月、週、日の単位。 

date1: date2から差し引く開始日の値。

date2: date1から差し引かれる終了日の値。

datediff("day ", " 2021-01-01 ", " 2021-02-01")
= 31

datediff("月", " 2021-01-01", date_from_parts(2021, 2, 1))
= 1

DATEDIFF("QUARTER", [DEAL.createdate], [DEAL.closedate])

DATEPART

日付の値から年、四半期、月、週、日を抽出します。数値を返します。

DATEPART("datePart", "date")

datePart:抽出する年、四半期、月、週、日の単位。

date:日付部分を抽出するための日付の値。

datepart("day ", " 2021-03-15")
= 15

datepart("month", date_from_parts(2021, 3, 15))
= 3

DATEPART("YEAR", [DEAL.createdate])

DATETRUNC

日付の値を年、四半期、月、週、日のいずれかに切り詰めます。

DATETRUNC("datePart", "date")

datePart:切り捨てる年、四半期、月、週、または日の単位。

date:切り捨てられる日付の値。

datetrunc("year", date_from_parts(2021, 3, 15))
= 2021-01-01

datetrunc("month ", " 2021-03-15")
= 2021-03-01

DATETRUNC("DAY", [e_visited_page.__hs_event_native_timestamp])

timestamp_from_parts

年、月、日、時、分、秒の各パーツからタイムスタンプの値を作成します。datetimeの値を返します。

TIMESTAMP_FROM_PARTS(年、月、日)

年:希望する日付の西暦部分。

month:希望する日付の月部分。

day:希望する日の部分。 

タイムスタンプ・フロム・パーツ(2021, 1, 1)
= 2021-01-01

WEEKNUM

ある日付の1年以内の週番号を計算します。数値を返します。

WEEKNUM("日付")

date:年内の週番号を計算するための日付時間値。

weeknum("2021-03-15")
= 11

weeknum("1609459200")
= 11

WEEKNUM("[deal.createdate]")

NOW

アカウントのタイムゾーンに基づいて、現在の時刻を返します。datetimeの値を返します。

NOW()

 

NOW()
= 1633611966314