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

SnowflakeでHubSpotデータを照会する

更新日時 2023年 1月 20日

対象製品

Operations Hub Enterprise

SnowflakeをHubSpotアカウントに接続したら、Snowflakeのデータ共有機能を使って、SnowflakeアカウントからHubSpotデータを照会できます。

データラグとSnowflakeのアカウントリージョン

アカウントのSnowflakeリージョンによって、HubSpotのデータが更新される頻度が決まります。お客様のSnowflakeアカウントのリージョンとHubSpotのSnowflakeアカウントのリージョンが一致する場合(EUデータセンターのHubSpotアカウントの場合はEU_CENTRAL_1_AWS、その他のHubSpotアカウントの場合はUS_EAST_1_AWS)、お客様のデータは最大で15分ごとに更新されることになります。

15分ごとに更新されるV2_LIVEスキーマと、毎日更新されるV2_DAILYスキーマにアクセスすることができます。そうでない場合、HubSpotアカウントのリージョンとSnowflakeのリージョンが一致しないと、毎日更新されるV2_DAILYスキーマにしかアクセスできないことになります。

Snowflake環境を設定する

SnowflakeでHubSpotデータを照会するには、照会元のウェアハウス、データベース、スキーマを選択する必要があります。ワークシートレベルでこれらを設定して自動的にクエリーに含めるか、または手動で追加することができます。

ワークシートレベルでウェアハウス、データベース、スキーマを選択するには、次の手順に従います。

  • ワークシートの一番上の行で、[Worksheet actions]バーをクリックします。

    snowflake-worksheet-settings0
  • ポップアップウィンドウで、次の操作を行います。
    • [Warehouse]ドロップダウンメニューをクリックして、ウェアハウスを選択します。
    • [Database]ドロップダウンメニューをクリックして、HubSpotデータベースを選択します。
    • [Schema]ドロップダウンメニューをクリックして、使用するスキーマを選択します。
        • V2_DAILY(ベータ):テーブルに基づいてデータを照会するためのデイリースキーマです。このスキーマのデータは1日1回更新されます。このスキーマを使用すると、クエリが高速になり、Snowflakeで直接クエリを実行することを推奨します。
        • V2_LIVE:HubSpotデータのセキュアビューに基づいたライブスキーマです。このスキーマのデータは最大で15分ごとに更新されます。大規模なデータセットを照会する場合、クエリーに時間がかかることがあります。このような場合は、まずETLプロセスで自分のテーブルにデータをコピーし、そのテーブルを照会することをお勧めします。このスキーマは現在、SnowflakeアカウントのリージョンとHubSpotのSnowflakeアカウントのリージョンが一致する場合のみ利用可能です。


      snowflake-worksheet-settings-window0

設定された環境では、HubSpotデータを照会するときに、データベースやスキーマタイプを手動でクエリーに追加する必要がありません。

データベースとスキーマタイプをクエリーに手動で追加するには、FROMフィールドの先頭にデータベース名とスキーマをこの順序で追加します。以下のような場合が挙げられます。


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_dealsを実行します。

LIMIT 1

データの概要

クエリーはSQLを使用して作成され、次のHubSpotデータを取得するために使用できます。

  • オブジェクトコンタクト、会社、製品など、標準およびカスタムのオブジェクト。 
  • レコード:コンタクト会社など、個々のレコード。 
  • 関連付け利用可能なすべての関連付けタイプと現在関連付けられているレコード。
  • イベントメール開封などの標準的なHubSpotイベントと、カスタム行動イベントの両方のイベントデータ。
  • リスト: HubSpotの連絡先や会社のリストです。
  • 所有者:レコードの所有者として設定されているHubSpotアカウントのユーザー。
  • パイプライン:取引パイプラインとチケットパイプライン(パイプラインステージを含む)。
  • プロパティー CRMレコードのプロパティーとその値(プロパティー履歴を含む)。

HubSpotのCRMデータモデルについて詳細をご確認ください。

ご注意:データシェアを進化させるにあたり、変更点を導入し、中には破壊的な変更もあります。HubSpot の開発者向け変更ログを購読することを強くお勧めします。これらの変更は、アップデートの前に必ず変更履歴に掲載されます。

返されるデータの制限と順序の設定

クエリーを作成するときに、返されるデータの量と、データが返される順序を制御できます。このためにはLIMITORDER BYをクエリーに追加します。例えば、すべてのコンタクトとそのプロパティーを照会するが、3件の結果だけをコンタクトIDの順で返すには、クエリーを次のように作成します。


SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;

列のデータ型

Snowflakeでデータを照会する場合、返される列は、照会するデータによって異なります。Snowflakeで、指定したテーブルまたはビューで利用可能な列を確認するには、左側のサイドバーでビューを選択します。

ご注意ください。このドキュメントの残りの部分では、テーブルとビューの両方に適用されるコンテキストでは、データベースオブジェクトという用語を使用します。

snowflake-sidebar-view-column-details0


特定の列を返すには、クエリーのSELECTフィールドにその列を含めます。例えば、次のクエリは、OBJECTIDUpdatedAt列のみを返します。


SELECT
objectId, updatedAt
FROM objects_contacts

以下に、クエリーが返す可能性のある列の一般的な定義を示します。以下に記載されていないその他の定義については、上記の各ビューの定義を参照してください。

  • OBJECTTYPEID:オブジェクトのタイプを表すVARCHAR値。例えば、「0-1」はコンタクトオブジェクト、「0-2」は会社オブジェクト、「2-1232」はアカウントのカスタムオブジェクトを表します。リストでは、リストのタイプ(コンタクトや会社など)を指します。object_and_event_type_definitionsビューを使って、アカウント内のすべてのオブジェクトとイベントのIDを照会できます。
  • OBJECTID:HubSpotアカウント内の特定タイプのオブジェクトの1つのレコードを表すBIGINT番号です。レコードを識別するには、オブジェクトタイプIDとオブジェクトIDの両方を使用する必要があります。
  • INGESTEDAT:データ行がSnowflakeに追加された時のタイムスタンプで、TIMESTAMP_NTZ値で表される。HubSpotでの作成操作または更新操作の論理タイムスタンプとは関係ありません。
    • HubSpotの内部処理により、行の他の列が変更されていなくても、行のインジェスチョンタイムスタンプが更新されることがあります。
    • 最近変更されたデータをコピーするETLプロセスを作成するときには、インジェスチョンタイムスタンプに基づいてクエリーを作成することをお勧めします。また、フローで毎日データをコピーする場合は、遅延を考慮して過去2日間のデータをコピーすることをお勧めします。
  • CREATEDATおよびUPDATEDAT:データがHubSpotで作成または更新された時点の論理タイムスタンプであり、TIMESTAMP_NTZ値で表されます。これらのタイムスタンプは、HubSpotのタイムスタンプと一致します。例えば、HubSpotでレコード作成日に表示される時刻は、Snowflakeの「CREATEDAT」列のタイムスタンプと同じになります。これらはインジェストのタイムスタンプとは直接関係がなく、これらのプロパティに基づいてETL処理を行うことは推奨されない。
  • COMBINEDASSOCIATIONTYPE:関連付け定義を一意に識別するVARCHAR値。

データ型を変換する

VARCHAR 型のカラムを持つクエリから、別の型のカラムを持つことが望ましいデータが返されることがあります。このような場合、Snowflakeの関数を使用してVARCHARデータ型を目的の型に変換することをお勧めします。例えば、オブジェクトレコードのプロパティは、ほとんどのデータベースオブジェクトではVARCHARデータ型として格納されるが、時には数値やdatetime値を含むこともある。
try_to_number, try_to_timestamp_ntzのような関数で、VARCHAR データをそれぞれNUMBER , DATETIME型に変換することができる。


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

オブジェクトのクエリー

以下では、特定のHubSpotオブジェクトやレコードのデータを照会する方法と、返されるデータを説明します。 

さまざまな種類のオブジェクトデータは、2つの方法で整理され、利用することができます。 

  • 個別です。各オブジェクトタイプは独自のビューに格納され、同じオブジェクトタイプのレコードのみを含みます。例えば、objects_contactsは連絡先レコードのみを含みます。これにより、問い合わせの際にobjecttypeidを指定する必要がなくなる。これらのビューは、ObjectTypeIds を知る必要がないため、クエリーが簡単です。また、各行がオブジェクトとそのプロパティの現在のバージョンに対応する、より使いやすいフォーマットでデータを返します。クエリーが遅くならない限り、これらのビューを使用してオブジェクトデータを取得することが推奨されます。詳しくは下記のObjects_X viewsでご覧ください。 
  • 結合される。すべてのオブジェクトタイプのすべてのレコードが1つのデータベースオブジェクトに結合されます。したがって、問い合わせの際には、「WHERE objectTypeId='0-1'」のようなフィルタを指定する必要があります。例えば、問い合わせの際に以下のようなobjecttypeidを使用することができる。
オブジェクト名 ObjectTypeId
コンタクト 0-1
会社 0-2
商品項目 0-8

カスタムオブジェクトには、作成時にIDが割り当てられ、「2-unique_ID」として識別されます。例えば「2-12345」などです。object_and_event_type_definitionsについて詳細をご確認ください。

これらのデータベースオブジェクトは、objects_xビューから得られるものより優れたクエリパフォーマンスが必要な場合に一般的に適しています。詳細は、下記のobject_with_object_properties、object_properties、object_properties_historyをご覧ください。

objects_x views

このデータベースオブジェクトでは、カスタムオブジェクトを含む利用可能な各オブジェクトタイプは、特定のビューを持ち、各ビューにはその特定のオブジェクトタイプのオブジェクトのレコードのみが含まれます。<object type name>これらのビューは OBJECTS_ <object type name>というフォーマットに従って命名されます。オブジェクトタイプの複数形ラベル (オブジェクトタイプが複数形を持たない場合、<object type name>は単にオブジェクトタイプ名の単数形ラベルに "S" を連結したものになることに注意してください)。

このビューに対するクエリは、オブジェクト内の各レコードに対して1行を返し、オブジェクトの各プロパティは個別のカラムとして利用できます。

HubSpot(つまり非カスタム)のオブジェクトタイプの一覧と、それらが表すデータの簡単な説明、および対応するビューは以下のとおりです。

 

HubSpot オブジェクトタイプ

ObjectTypeId

説明

コンタクト

0-1

あなたのビジネスに関わる個人に関する情報

COMPANY

0-2

個々の企業・団体に関する情報

ディール

0-3

連絡先や企業との収益機会に関する詳細。 

チケット

0-5

お客様からのヘルプやサポートの依頼を代行する。

クオータ

0-14

購入希望者と価格情報を共有するために使用します。

form_submission

0-15

HubSpotのフォームに対する個別投稿の詳細です。

LINE_ITEM

0-8

取引で販売される製品のサブセットを表す。製品は取引に添付されると、商品項目になります。

対談

0-11

複数のチャンネルからの受信メッセージの詳細。

ランディングページ

0-25

ランディングページの詳細

  タスク

0-27

ToDoリストに関する情報を格納

フォーム

0-28

訪問者や連絡先のリード情報を収集するために使用します。

マーケティングメール

0-29

マーケティングハブからのメールに関する詳細

AD_ACCOUNT

0-30

Linkedin、Facebook、Googleの広告アカウントに関する情報を保存します。

AD_CAMPAIGN

0-31

広告キャンペーンの詳細です。広告キャンペーンには、1つまたは複数の広告を含めることができます。

AD_GROUP

0-32

広告キャンペーン内の広告の論理的なグループ化

広告

0-33

個別広告の詳細

キャンペーン

0-35

関連するマーケティング資産やコンテンツの情報により、集合的なマーケティング活動の効果を容易に測定することができます。

SITE_PAGE

0-38

ウェブサイト内の個別ページに関するデータ

ブログ_投稿

0-39

ブログ記事に関するデータ

オブジェクトリスト

0-45

オブジェクトレコードのプロパティまたはアクティビティに基づくグループ化に関する情報

CALL

0-48

他のCRMレコードによる通話(例:コンタクト

請求書

0-53

請求書の管理および外部会計システムとの同期

メディアブリッジ

0-57

ハブスポットにインポートされたメディアアセットの情報

SEQUENCE

0-58

シーケンスとは、コンタクトを長期的に育成するための、ターゲットを絞った一連のメールテンプレートのことです。

DEAL_SPLIT

0-72

ディールスプリットは、複数のユーザー間でディールクレジットを共有するために使用されます。

SALES_DOCUMENT

0-83

セールスドキュメントは、チーム全体でコンテンツのライブラリを構築し、連絡先とドキュメントをアップロードして共有することができます。

フィードバック送信

0-19

フィードバックアンケートに投稿された情報を保存します。

購読申し込み

0-69

定期的な支払いの詳細が含まれています。

コマセ払い

0-101

お客様からお預かりした資金のデータが含まれます



各データベースオブジェクトは、以下のカラムを返す。

カラム名

タイプ

説明

OBJECTTYPEID

Varchar

オブジェクトタイプのID(例:コンタクトの場合は「0-1」)。

OBJECTID

数値

レコードのID (例:IDが「123752」のコンタクトレコード)。

UPDATEDAT

タイムスタンプ

このオブジェクトがHubSpotで最後に更新された日付と時刻。 

INGESTEDAT

タイムスタンプ

データが最後にSnowflakeにインジェストされた日時。 

PROPERTY_*

Varchar

オブジェクトのプロパティの最新バージョンを含む個々のカラム。property_definitionsで指定された) 日付や数値の型を持つ各オブジェクトのプロパティには、2つのカラムが存在します。 

  1. プロパティ値を文字列として含む列。カラム名はproperty_unparsed_[name]となります。例えば、DEALオブジェクトのプロパティであるdeal_amountは、property_unparsed_deal_amountカラムを持つことになります。
  2. ネイティブ型に変換された値を含む列。例えば、DEALオブジェクトのプロパティであるdeal_amountは、property_deal_amountというカラムを持つことになります。無効なデータのためにネイティブ型への変換に失敗した場合、このカラムにはNULLが含まれることに注意。

例1


すべてのコンタクトのファーストネーム、ラストネーム、ライフサイクルステージを取得します。

クエリーを実行します。


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage

FROM objects_contact

リターンです。

OBJECTID

FIRSTNAME

LASTNAME

LIFECYCLESTAGE

54325098

Hobbes

Baron

lead

96805401

Milo

Gold

lead

6922028

Henry

Riley

lead

例2

 

最大3つの案件の案件名とステージを取得します。

クエリーを実行します。


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

戻り値:

OBJECTID

プロパティディールネーム

property_dealstage

property_dealamount

38960439

案件名 1

閉所恐怖症

34199

321740651

テストディール 123

14845019

8383663

98392101

ポップアップキャノピー

閉所恐怖症

9309007

 

例3

 

金額上位3件の案件名とステージを取得する。

クエリー:

取引金額データは数値データ型として利用できるため、変換やキャストを行うことなく、順序付けに利用することができる。


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


戻り値:

OBJECTID

プロパティディールネーム

property_dealstage

property_dealamount

98392101

ポップアップキャノピー

閉所恐怖症

9309007

321740651

テストディール 123

14845019

8383663

38960439

案件名 1

閉所恐怖症

34199

object_with_object_properties

このデータベースオブジェクトには、HubSpotのレコードのデータが含まれています。このデータベースオブジェクトへの問い合わせは、オブジェクトタイプ内の各レコードに対して1行を返します(例:contactsオブジェクトタイプ内のすべてのcontactレコード)。すべてのプロパティーは「Properties」列(Snowflake Variant / JSON列)に格納されます。 

このビューでは、以下の列が返されます。

列名 タイプ 説明
OBJECTTYPEID Varchar オブジェクトタイプのID(例:コンタクトの場合は「0-1」)。
OBJECTID 数値 レコードのID (例:IDが「123752」のコンタクトレコード)
PROPERTIES バリアント レコードのプロパティーの値。
UPDAT タイムスタンプ HubSpotでのレコードの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

すべてのコンタクトとそのプロパティーを取得します。

クエリー:


SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'


戻り値:

OBJECTTYPEID OBJECTID PROPERTIES
0-1 38960439 {"createdate":"1504656970152"...}
0-1 321740651 { "createdate":"1590183081949"...} 
0-1 98392101 { "createdate":"1533566477279"...}
... ... ...

2

最大3つの取引の取引名とステージを取得します

クエリー:


SELECT

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;


戻り値:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 案件名 1
クローズド・ロスト
7488939
321740651 案件名 1
閉所恐怖症
9292029
98392101 案件名 1
クローズド・ロスト
62626528

objects

このデータベースオブジェクトは、object_with_object_properties データベースオブジェクトのデータのサブセットである。返される各行には、各レコードのオブジェクトIDが含まれています。このデータベースオブジェクトは、既存のレコードのみを返します。HubSpotでレコードが削除されると、このデータベースオブジェクトから削除されます。このデータベースオブジェクトは、object_with_object_propertiesテーブルのデータのサブセットである。返される各行には、各レコードのオブジェクトIDが含まれています。このビューでは、既存のレコードのみが返されます。HubSpotでレコードが削除されると、そのレコードはこのビューから除去されます。 

このデータベースオブジェクトは、アカウントに大量のデータがあり、object_with_object_propertiesやobject_xビューのパフォーマンスが低下している場合に有効でしょう。このデータベース・オブジェクトを object_properties データベース・オブジェクトと一緒に使うことで、 object_with_object_properties のデータを複製しつつ、どのプロパティが返されるかを 制御することが可能になります。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OBJECTTYPEID Varchar オブジェクトタイプのID(例:コンタクトの場合は「0-1」)。
OBJECTID 数値 レコードのID (例:IDが「123752」のコンタクトレコード)
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。列のデータ型について詳細をご確認ください。

例1

すべてのコンタクトレコードを取得します。

クエリー:


SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'


戻り値:

OBJECTTYPEID OBJECTID
0-1 36721864
0-1 103580363
0-1 56047670
... ...

object_properties

このデータベースオブジェクトはobject_with_object_propertiesデータベースオブジェクトのサブセットである。各行には、与えられたレコードに設定されている現在のプロパティ値が含まれています。例えば、コンタクトの場合は「First name」プロパティーと「Last name」プロパティーに対してそれぞれ1行ずつがあります。レコードがプロパティの値を持っていない場合、その行は空の文字列で表示されるか、まったく表示されません。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OBJECTTYPEID Varchar オブジェクトタイプのID(例:コンタクトの場合は「0-1」)。
OBJECTID 数値 レコードのID (例:IDが「123752」のコンタクトレコード)
NAME Varchar プロパティーの名前。
VALUE タイムスタンプ プロパティーの値。
UPDAT タイムスタンプ HubSpotでのレコードの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

すべてのコンタクトの名前、姓、市町村のプロパティーを取得します。

クエリー:


SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;


戻り値:

OBJECTTYPEID OBJECTID NAME VALUE
0-1 10401 firstname Brian
0-1 10401 city Dublin
0-1 10401 lastname Gallagher
0-1 23451 firstname Fernando
0-1 23451 lastname Fierro
0-1 25751 firstname Charles
... ... ... ...

例2

すべてのコンタクトの名前、姓、ライフサイクルステージを取得し、結合してコンタクトごとに1行にまとめます。この例では、SQL PIVOT構文を使用します。

クエリー:


SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);

 

戻り値:

OBJECTTYPEID OBJECTID FIRSTNAME LASTNAME LIFECYCLESTAGE
0-1 54325098 Hobbes Baron lead
0-1 96805401 Milo Gold lead
0-1 6922028 Henry Riley lead
... ... ... ... ...

object_properties_history

このデータベースオブジェクトは、過去のプロパティ値を含む。コンタクトの場合、最新の45個の値が含まれています。その他のすべてのオブジェクトでは、最新の20個の値が含まれています。過去のプロパティー値ごとに1行ずつ表示されます。プロパティーの現在の値は、プロパティーの履歴における最新の「UPDATEDAT」タイムスタンプによって決まります。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OBJECTTYPEID Varchar オブジェクトタイプのID(例:コンタクトの場合は「0-1」)。
OBJECTID 数値 レコードのID (例:IDが「123752」のコンタクトレコード)
NAME Varchar プロパティーの名前。
VALUE タイムスタンプ プロパティーの値。
UPDAT タイムスタンプ HubSpotでのデータの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

1つのコンタクトの1つのプロパティーの履歴を取得します。

クエリー:


SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1' です。
AND objectId = 136493192
AND name = 'hs_predictivescoringtier' (名前 = 'hs_predictivescoringtier')です。
order by updatedat desc;

   
戻り値:

OBJECTID NAME VALUE UPDAT

136493192

hs_predictivescoringtier

ティア1

2022-06-22 22:45:05.931

136493192

hs_predictivescoringtier

tier_2

2021-09-18 08:20:56.622

136493192

hs_predictivescoringtier

tier_3

2019-11-31 18:20:22.851

...

...

...

...

例2

ライフサイクルステージが「サブスクライバー」であったことがあるすべてのコンタクトの現在の名前を取得します。

クエリー:


SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);


戻り値:

OBJECTID FIRSTNAME LASTNAME
54325098 Hobbes Baron
96805401 Milo Gold
6922028 Henry Riley
... ... ...

関連付けのクエリー

オブジェクトデータと同様に、アソシエーションデータも2つの方法で整理される。

  • 個別です。各アソシエーションタイプは独自のビューに保存され、そのタイプのレコードのみが含まれます。例えば、associations_contacts_to_dealsには、コンタクトオブジェクトとディールオブジェクトの間の関連レコードのみが格納されます。これにより、問い合わせの際にassociationtypeidを指定する必要がなくなります。これらのビューは、CRMのデータモデルに精通している必要がないため、問い合わせが非常に簡単です。また、objects_xビューとの結合で簡単に使用できるように、2つのオブジェクト間の関連レコードの拡張された説明を返します。クエリーが遅くならない限り、これらのビューを使用して関連データを取得することをお勧めします。詳しくは下記のassociations_x_to_y viewsをご覧ください。 
  • 結合される。すべてのアソシエーションタイプのすべてのレコードが1つのデータベースオブジェクトに結合されます。したがって、問い合わせの際には、「WHERE combinedassociationtypeid='0-32' 」のようなフィルタを指定する必要があるのです。詳しくは、下記のassociationとassociation_definitionsをご覧ください。

関連付け_x_to_yビュー(BETA)

各関連付けのタイプは、associations_ <association type name>(例:associations_contacts_to_deals)とラベル付けされた独自のビューを持っています。各ビューは、associationデータベースオブジェクトのデータのサブセットであり、特定のcombinedassociationtypeidのレコードのみを含んでいます。

各データベースオブジェクトは、以下のカラムを返す。

カラム名

タイプ

説明

COMBINEDASSOCIATIONTYPEID

Varchar

関連付け定義の一意の識別子。

アソシエーションカテゴリ

Varchar

関連付けタイプのソース。のいずれかです。hubspot_defined, user_defined, integrator_defined のいずれか。

アソシエーションタイプID

Varchar

特定のアソシエーションカテゴリ内のアソシエーション定義の一意の識別子、すなわち、アソシエーションカテゴリ内の2つの定義が同じassociationtypeidを持つことはありません。 

FROMOBJECTTYPEID

Varchar

アソシエーション定義のソースとなるオブジェクトタイプID。

フロムオブジェクトタイプ

Varchar

アソシエーション定義のソースとなるオブジェクトタイプの名前です。

TOOBJECTTYPEID

Varchar

関連付けの定義の宛先となるオブジェクトタイプ ID。

TOOBJECTTYPE

Varchar

関連付けの定義の宛先となるオブジェクトタイプの名前です。

NAME

Varchar

関連付け定義の名前。

LABEL

Varchar

アソシエーション定義の説明です。

ISMAINASSOCIATIONDEFINITION

ブール型

関連付け定義がメインタイプであるかどうか。trueの場合、HubSpotが関連するレコードに表示する定義となります。

[FROMOBJECTTYPE_OBJECTID] 例:ASSOCIATIONS_CONTACTS_TO_DEALSビューの場合、これはCONTACT_OBJECTIDになります。

数値

ソースオブジェクトのオブジェクトID。

[TOOBJECTTYPE_OBJECTID] 例えば、ASSOCIATIONS_CONTACTS_TO_DEALSビューでは、これはDEAL_OBJECTIDになります。

数値

デスティネーションオブジェクトのオブジェクトID。

INGESTEDAT

タイムスタンプ

データが最後にSnowflakeにインジェストされた日時。

例1

 

特定の連絡先に関連するすべての案件を取得します。

クエリー:


SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

 

リターンです。

contact_objectid

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

例2

 

ボゴタのタイムゾーンにあるすべての連絡先とその案件を取得します。


SELECT contacts.property_firstname contact_firstname,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_jectid=contacts objectid JOIN objects_deals deals on 。contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'(アメリカン・スラッシュ・ボゴタ)

 

CONTACT_FIRSTNAME

CONTACT_LASTNAME

連絡先EMAIL

DEAL_TYPE

DEAL_AMOUNT

デビッド

マガルハイス

dmagalhaes@example.com

ニュービジネス

74848

Fernanda

ロドリゲス

fmoreira@example.com

ニュービジネス

253530

例3

 

全コンタクトと各コンタクトの成約金額の合計を取得します。


SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_jectid=contacts objectid JOIN objects_deals on assoc.contact_email JOIN objects_contacts_to_deals on as assoc.contact_email contact_objectid=contacts.objectid
、JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
、GROUP BY contact_email
、ORDER BY total_closed_amount DESC。

 

戻り値:

総閉鎖量

連絡先EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definitions

このデータベースオブジェクトには、HubSpotオブジェクト間で利用可能なすべての関連タイプに関する情報が含まれており、関連タイプごとに1行ずつあります。このデータベースオブジェクトとassociationsデータベースオブジェクトを結合して、レコード固有の関連情報を取得することができます。

同じオブジェクトの間に複数のタイプの関連付けを設定できます。メインの関連付けタイプ(レコードが関連付けられたときにHubSpotに表示されるタイプ)は、ISMAINASSOCIATIONDEFINITIONtrueである関連付けを使用します。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
結合アソシエーションタイプID Varchar 関連付け定義の一意の識別子。
カテゴリー Varchar 関連付けタイプのソース。のいずれかです。hubspot_defined , user_defined , integrator_definedのいずれか。
ID 数値 そのカテゴリー内の関連付け定義の識別子。
FROMOBJECTTYPEID Varchar 関連付け定義のソースであるオブジェクトのID。
TOOBJECTTYPEID Varchar 関連付け定義の宛先であるオブジェクトのID。
NAME Varchar 関連付け定義の名前。
LABEL Varchar 関連付け定義のラベル。
メインアソシエーションの定義 ブール型 関連付け定義がメインタイプであるかどうか。trueの場合、この定義はHubSpotで関連付けられているレコードに表示される定義です。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。列のデータ型について詳細をご確認ください。

例1 

アカウントで利用可能な関連付けのタイプを取得します。

クエリー:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

  
戻り値:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
0-1 0-1 0-2 CONTACT_TO_COMPANY
0-2 0-2 0-1 COMPANY_TO_CONTACT
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 CONTACT_TO_DEAL
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

例2

取引と会社の間で利用可能な関連付けタイプを取得します。

クエリー:


SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = true

ORDER BY category, id


戻り値:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

associations

このデータベースオブジェクトは、特定のレコード間の関連付けに関する情報を含んでいます。各行は、オブジェクト間の関連付けを表します。参照されたレコードが削除されても、このデータベースオブジェクトに行が存在する場合があります。レコードが存在しているかどうかは、objectsテーブルと結合することで確認できます。

このデータベースオブジェクトは、アカウントに大量のデータがあり、associations_x_to_yビューのパフォーマンスが低下している場合に有効です。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
結合アソシエーションタイプID Varchar 関連付け定義の一意の識別子。
FROMOBJECTID 数値 ソースオブジェクトのID。
TOOBJECTID 数値 ターゲットオブジェクトのID。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。列のデータ型について詳細をご確認ください。

例1

関連付けられている取引とコンタクトをすべて取得します。

クエリー:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

  
戻り値:

結合アソシエーションタイプID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

例2 

特定のコンタクト(コンタクトID:「3005」)に関連付けられているチケットをすべて取得します。

クエリー:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;


戻り値:

COMBINEDASSOCIATIONTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

例3 

特定のコンタクト(コンタクトID:「4464」)に関連付けられている取引をすべて取得します。この例では「combinedAssociationTypeId」をハードコーディングする代わりに、association_definitionsと結合しています。

クエリー:


SELECT combinedAssociationTypeId, fromObjectId toObjectId.SELECT fromObjectId toObjectId.SELECT combinedAssociationTypeId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'である。
AND toObjectTypeId = '0-3'である。
AND isMainAssociationDefinition)
AND fromObjectId = 4464;


戻り値:

結合アソシエーションタイプID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

オーナーからの問い合わせ

owners

このデータベースオブジェクトには、HubSpot アカウントのユーザーに関する情報が含まれています。ユーザーはレコード所有者として設定できます。ユーザーには、そのコンテキストに応じてユーザーIDと所有者IDの両方が含まれます。どちらのIDも同じユーザーを識別するために使用できます。 

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OWNERID 数値 ユーザーの所有者ID。
ユーザーID 数値 ユーザーのユーザーID。この列が「NULL」のユーザーは削除されています。
EMAIL Varchar ユーザーのEメールアドレス。
FIRSTNAME Varchar ユーザーの名前。
LASTNAME Varchar ユーザーの姓。
アーカイヴ ブール型 ユーザーが削除されているかどうか。
CREATEDAT タイムスタンプ HubSpotでのユーザーの作成日時。詳細については、列のデータ型を参照してください。
UPDAT タイムスタンプ HubSpotでのユーザーの最終更新日時。詳細については、列のデータ型を参照してください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。

例1 

すべてのユーザーを取得します。WHERE archived = falseフィルターは、返されたデータから削除されたユーザーを削除します。

クエリー:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE archived = false

  
戻り値:

OWNERID ユーザーID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Gold
... ... ... ... ...

例2

所有者IDで特定の所有者を取得します。

クエリー:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;


戻り値:

OWNERID ユーザーID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron

例3

すべてのコンタクトとその所有者を取得します。このクエリーは、object_with_object_propertiesとコンタクトプロパティー「hubspot_owner_id」を使用してオーナーにレコードを結合します。


SELECT
contact.objectId contactid,
contact.property_firstname contact_firstname,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objects_contacts contact

JOIN 所有者 所有者 ON contact.property_hubspot_owner_id = 所有者.ownerId


戻り値:

CONTACTID CONTACT_FIRSTNAME CONTACT_LASTNAME CONTACT_HUBSPOT_OWNER_ID OWNER_FIRSTNAME OWNER_LASTNAME OWNER_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Gold milo.g@business.com
... ... ... ... ... ... ...

パイプラインのクエリー

以下では、取引とチケットのパイプラインのデータ(アカウントで利用可能なパイプラインとそのステージなど)を照会する方法を説明します。 

このデータをオブジェクトデータと結合することで、パイプラインの全体像を把握できます。例えば、objects_deals_view やobject_with_object_propertiesデータとpipelinesデータを結合することで、取引とそのパイプラインを照会することができます。

pipelines

このデータベースオブジェクトは、アカウント内のディールおよびチケットパイプラインに関する情報を含んでいます。返される各行はそれぞれ1つのパイプラインを表しています。

このテーブルでは、以下の列が返されます。

列名 タイプ 説明
PIPELINEID Varchar パイプラインのID。
OBJECTTYPEID Varchar パイプラインに含めることができるオブジェクト(取引やチケットなど)のID。
LABEL Varchar HubSpotでのパイプラインの名前。
DISPLAYORDER 数値 HubSpotでパイプラインが表示される順序。
アーカイヴ ブール型 パイプラインが削除されているかどうか。
CREATEDAT タイムスタンプ パイプラインの作成日時。
UPDAT タイムスタンプ HubSpotでのデータの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

利用可能なすべての取引パイプラインを、HubSpotでの順序で取得します。

クエリー:


SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;

  
戻り値:

OBJECTTYPEID PIPELINEID LABEL
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Sales Pipeline
0-3 12659678 Licenses Pipeline
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 New Business
... ... ...

例2

特定のパイプライン内の取引を取得します。object_with_object_propertiespipelinesを結合します。

クエリー:


セレクト

deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0〜3';


戻り値:

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix Global Signup Sales Pipeline
605457408 Friskies Rebrand Sales Pipeline
604362473 Fresh Step App Build Sales Pipeline

 

例3

 

上記例2と同様に、特定のパイプライン内の案件を取得する。しかし、結合の際にobjects_dealsを使用するのではなく、以下のように使用します。オブジェクトとオブジェクトのプロパティ .


SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';

 

戻り値: 

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix Global Signup

Sales Pipeline

605457408

Friskies Rebrand

Sales Pipeline

604362473

Fresh Step App Build

Sales Pipeline

pipeline_stages

このビューには、パイプライン内の個々のステージに関する情報が含まれています。オブジェクトタイプID、パイプラインID、ステージIDの組み合わせによりステージを識別します。pipelinesとの結合には、オブジェクトタイプIDとパイプラインIDを使用します。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
PIPELINEID Varchar パイプラインのID。
STAGEID Varchar ステージのIDです。
LABEL Varchar HubSpotにおけるステージの名前です。
DISPLAYORDER 数値 HubSpotでパイプラインが表示される順序。
メタデータ バリアント ステージのJSON形式の説明(オープンかクローズかを含む
アーカイヴ ブール型 パイプラインステージが削除されたかどうか。
CREATEDAT タイムスタンプ パイプラインステージが作成されたとき。

例1 

「Sales pipeline」という名前の取引パイプラインのパイプラインステージを取得します。

クエリー:


SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

  
戻り値:

PIPELINEID STAGEID LABEL
941650 941651 Contacted
941650 941652 Appt scheduled
941650 941653 Invoice sent
... ... ...

例2

すべての取引とそれぞれのパイプラインステージを取得します。

クエリー:


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';


戻り値:

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix Global Signup Sales Pipeline Contract sent
605457408 Friskies Rebrand Sales Pipeline Appt scheduled
604362473 Fresh Step App Build Sales Pipeline Contract signed
... ... ... ...

物件に関するお問い合わせ

property_definitions

このデータベースオブジェクトには、HubSpot アカウントのオブジェクトプロパティとイベントプロパティに関する情報が含まれています。イベントプロパティーには、メールの開封やクリックなどの標準イベントと、カスタム行動イベントのプロパティーがあります。この情報は、object_propertiesおよびeventsのデータにある値を定義する際に役立ちます。

オブジェクトタイプIDと名前を組み合わせることで、特定のプロパティーを識別できます。同様の情報をproperties APIで取得できます。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
オブジェクティプライド Varchar イベントに関連するオブジェクトのID。
NAME Varchar プロパティーの内部名。
LABEL Varchar プロパティーのラベル。
DESCRIPTION Varchar プロパティーの説明。
TYPE Varchar プロパティーのタイプ(例:文字列、数値、日時)。
フィエルドタイプ Varchar プロパティーのフィールドタイプ。プロパティーがHubSpotとフォームでどのように表示されるかを定義します(例:checkbox、select)。
DISPLAYORDER 数値 プロパティーの表示順。
GROUPNAME Varchar プロパティーのグループ名。
オプション バリアント 列挙プロパティーの場合は、プロパティーのオプションの配列であり、各オプションの属性(表示順、ラベルなど)が含まれます。
CREATEDUSERID 数値 プロパティーを作成したユーザーのID。
参照対象種別 Varchar プロパティーが参照するオブジェクトのタイプ。所有者のプロパティーの場合は「OWNER」という値が返されます。
計算された ブール型 プロパティーが計算済みプロパティーであるかどうか。
外部オプション ブール型 プロパティーのオプションが外部システムで定義されているかどうか。
ハスニクエバリュー ブール型 プロパティーの値が一意であるかどうか。APIでプロパティーを作成するときにのみ設定できます。
HIDDEN ブール型 プロパティーがHubSpotで非表示であるかどうか。
ショウカレンシーシンボル ブール型 数値プロパティーの値の形式が通貨であるかどうか。
FORMFIELD ブール型 このプロパティーをフォームで使用できるかどうか。
よみとりせんようていぎ ブール型 プロパティーをHubSpotで編集できるかどうか。
READONLYVALUE ブール型 プロパティーの値をHubSpotで編集できるかどうか。
ハブスポットデフィニット ブール型 プロパティーがHubSpotによって作成されたのか、ユーザーによって作成されたのか。
アーカイヴ ブール型 プロパティーが削除されているかどうか。
CREATEDAT タイムスタンプ HubSpotでのプロパティーの作成日時。
UPDAT タイムスタンプ HubSpotでのデータの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

すべてのコンタクトプロパティーの名前と説明を取得します。

クエリー:


SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

   
戻り値:

NAME LABEL DESCRIPTION
entered_sql_stage Entered SQL stage SQLステージ日のカウントを開始する。
first_conversion_event_name
First Conversion このコンタクトが送信した最初のフォーム。
address Street address - 番地 コンタクトの住所。

イベントクエリー

イベントには、標準的なHubSpotイベントとカスタム行動イベントがあります。各イベントは、events_eventnameというラベルの付いた、独自のデータベースオブジェクトを持ちます。

Name  
イベント_広告_インタラクション 広告の詳細と、広告をクリックしたりフォームを送信したりして広告とインタラクションした連絡先。
イベント_広告_メトリックス_インポート_v0

広告の詳細とそのパフォーマンス指標。
イベント_コール_キーワード 通話中に参加者が発言したキーワードの詳細。
イベント_clicked_link_in_email_v2

コンタクトがマーケティングメール内でクリックしたリンク。
イベント_クリックされたリンク_追跡された受信箱_メール_v8 コンタクトがConversations Inboxメール内でクリックしたリンク。
イベント_クッキー_バナークリック クッキーをクリックした連絡先
イベント_クッキー_バナー_閲覧数 Cookieを閲覧した連絡先
イベント_ドキュメント_共有_v2 外部リンクで連絡先と共有される営業資料。
イベント_ドキュメント_ビューイング_v2 外部リンクを開いて閲覧した営業資料や連絡先。
イベント_ドキュメント_完了_v2 営業文書とそれをクローズした連絡先。
イベント_hs_scheduled_email_v2 HubSpotのメールサーバーに送信される電子メール。
イベント_mta_delivered_email_v2 HubSpotのメールサーバーから受信者に正常に配信されたメール。
イベント_mta_bounced_email_v2 受信者の電子メールサーバーによって拒否された電子メール配信の試み。
イベント_開封済み_メール_v2 連絡先別のメール開封数
イベント_報告されたスパムメール_v2 受信者がスパムとしてマークした電子メール。
イベント_アップデイト_メール_購読状況_v2 受信者による電子メール配信登録の変更。
イベント_開封済み_追跡済み_受信箱_メール_v8 コンサベーション・インボックスのメールを連絡先別に開封。
イベント_mb_media_played 連絡先別の動画再生アクティビティ。
events_v2_contact_booked_meeting_through_sequence コンタクトは、シークエンスを通じてミーティングを予約しました。
イベント_v2_contact_enrolled_in_sequence 連絡先は、順次登録されています。
イベント_v2_contact_finished_sequence シーケンスは終了しました。
イベント_v2_contact_replied_sequence_email シーケンスの送信メール(またはシーケンスの登録を解除した受信メール)に返信した担当者。
イベント_v2_contact_unenrolled_from_sequence シーケンスから登録されていない連絡先。
イベント_v2_contact_unenrolled_manually_from_sequence ユーザーが手動でコンタクトを登録解除しました。
イベント_v2_contact_unsubscribed_sequence_email コンタクトが購読を中止し、シーケンスが登録解除された。
イベント_v2_sequence_email_bounced シーケンスメールがバウンスされた。
イベント_v2_sequence_errored シーケンスエラーにより登録が解除されました。
events_v2_sequence_step_executed シーケンスステップを実行した。
イベント訪問ページ 連絡先別のウェブサイトページ訪問数。

イベントタイプIDとIDを組み合わせることで、イベントを識別できます。返される列はイベントによって異なります。イベントのプロパティーごとに1つの列が返されます。すべてのイベントで返される列を以下に示します。

ご注意ください。HubSpotは、すべてのイベントテーブルとビューに2つの新しいカラムを追加しました。

  • が発生しました。
  • に発生した。

これらのカラムは、2022年11月24日にoccuredatおよびoccuredatdateintカラムに置き換わる予定です。この日付になると、古いカラムは使用できなくなり、そのカラムを使用してイベントを含むデータベースオブジェクトやビューを照会しようとすると失敗します。Snowflakeデータ共有の変更点についての詳細はこちらをご覧ください。



列名 タイプ 説明
EVENTTYPEID Varchar OBJECTTYPEID に似たイベントタイプの ID
object_and_event_type_definitionsビューを使用して、アカウント内のすべてのイベントタイプ ID をクエリすることができます。
ID Varchar これはイベントの種類ごとにユニークです。あるイベントタイプにおいて、同じIDを持つレコードは2つ存在しない。
OBJECTTYPEID Varchar イベントを完了したオブジェクトのタイプ。例えば、メールのリンクのクリックの場合、この列にはコンタクトオブジェクトを表す「0-1」が表示されます。
OBJECTID 数値 イベントを完了したレコードのID。
OCCURREDAT タイムスタンプ イベントが発生した時点。

に発生した。

 

数値 イベントが発生した時点を表す数字。OCCURREDAT列と同じデータを含むが、数値としてフォーマットされ、テーブルのクラスタキーの一部として使用される。ほとんどの場合、この番号の代わりにOCCURREDATタイムスタンプを使用することができます。

にちれい

数値

イベントが発生した時点を表す数字。OCCURREDAT列と同じデータを含むが、数値としてフォーマットされ、テーブルのクラスタキーの一部として使用される。ほとんどの場合、この番号の代わりにOCCURREDATタイムスタンプを使用することができます。

注意:このカラムは2022年11月24日に非推奨となり、OCCURREDATDATEINTに置き換えられる予定です。

OCCUREDAT タイムスタンプ

イベントが発生した時点。

ご注意:この列は2022年11月24日に非推奨となり、OCCURREDATに置き換わります。

インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。列のデータ型について詳細をご確認ください。
PROPERTY_* Varchar イベントのプロパティーを含む個々の列。

例1

最新の50件のEメールのクリックイベントを取得します。

クエリー:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt

LIMIT 50;


戻り値:

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT HS_CLICK_RAW_URL
4-666288 0-1 45318579 2016-08-04 21:06:43.245 http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288 0-1 80701 2016-08-29 13:31:28.622 https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288 0-1 26146013 2017-11-30 14:27:11.528 https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
... ... ... ... ...

例2

クリックしたコンタクトのEメールのクリックイベントをすべて取得します。このクエリーは、object_with_object_propertiesと結合することでコンタクトデータを取得します。

クエリー:


SELECT
click.occuredat click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;


戻り値:

CLICK_TIMESTAMP CLICK_URL CONTACT_FIRSTNAME CONTACT_LASTNAME
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Baron
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Milo Gold
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

オブジェクトとイベントタイプのクエリ

object_and_event_type_definitions

このデータベースオブジェクトには、HubSpotアカウントで利用可能なすべてのオブジェクトとイベントの定義が含まれています。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OBJECTTYPEID Varchar パイプラインに含めることができるオブジェクト(取引やチケットなど)のID。
FULLYQUALIFIEDNAME Varchar オブジェクトまたはイベントの名前。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。列のデータ型について詳細をご確認ください。

例1

HubSpotアカウントで利用可能なすべてのオブジェクトとイベントを取得します。

クエリー:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

  
戻り値:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 CONTACT
0-8 LINE_ITEM
0-11 CONVERSATION
... ...

リストクエリ

以下では、利用可能なコンタクトリストと会社リスト、それらのリストに含まれるレコードなど、リストを照会する方法について説明します。

lists

このデータベースオブジェクトには、HubSpotの連絡先および企業リストに関する情報が含まれています。1つのリストにつき1つの行を返します。列にはリストの詳細(リストの名前、サイズ、含まれるレコードのオブジェクトタイプなど)が含まれます。各リスト内の個々のレコードに関する情報は含まれません(list_membershipを参照)。 

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
OBJECTTYPEID Varchar リスト内のレコードのタイプ(例:コンタクト、会社)。
LISTID 数値 リストのID。list-membershipsテーブルの「LISTID」に結合します。
CLASSICLISTID 数値 コンタクトリストに固有のIDで、HubSpotのリストのURLに含まれるIDと一致します。
NAME Varchar リストの名前。
SIZE 数値 リストのレコード数。
作成ユーザID 数値 リストを作成したユーザーのID。
CREATEDAT タイムスタンプ HubSpotでリストが作成された時点。
ユーザIDで更新 数値 リストを最後に更新したユーザーのID。
UPDAT タイムスタンプ HubSpotでの日付の最終更新日時。列のデータ型について詳細をご確認ください。 
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。

例1

すべてのコンタクトリストを取得します。

クエリー:


SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';

  
戻り値:

LISTID NAME SIZE
118131 Weekly outreach 103
66156 Blog subscribers 455
771852 Top subscribers 2021 37
... ... ...

例2

「Top subscribers 2021」という名前の特定のコンタクトリストを取得します。 

クエリー:


SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = 'トップサブスクライバー2021';


戻り値:

LISTID NAME SIZE
771852 Top subscribers 2021 37

list_membership

このデータベースオブジェクトは、どのレコードがどのリストのメンバーであるかの情報を持ち、リスト内のレコードごとに1行が存在する。例えば、500人の連絡先を持つBlog購読者リストがある場合、データベースオブジェクトは500行を返します。 

含まれるのはリストIDとオブジェクトIDのみです。詳しくは、listsデータベース・オブジェクトと結合してください。

このデータベースオブジェクトは、以下のカラムを返すことができる。

列名 タイプ 説明
LISTID Varchar リストのID。listsテーブルのHS_LIST_ID列に結合します。
OBJECTID Varchar リスト内のレコードのID。
UPDAT タイムスタンプ HubSpotでのデータの最終更新日時。列のデータ型について詳細をご確認ください。
インジェストデータ タイムスタンプ データが最後にSnowflakeにインジェストされた日時。 

例1

「Top subscribers 2021」リストに含まれているすべてのコンタクトのIDを取得します。

クエリー:


SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';

  
戻り値:

OBJECTID
54325098
96805401
6922028
...

例2

Top subscribers 2021リストに登録されている連絡先の詳細の姓と名を取得します。

クエリー:


セレクト

contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'.


戻り値:

OBJECTID

FIRST NAME

LAST NAME

54325098

Hobbes

Baron

96805401

Milo

Gold

6922028

Henry

Riley

...

...

...

よくある質問

ハブスポットアプリからレポートと同様のデータを作成したいのですが、どのようにすればよいですか?


一般的には、比較対象のレポートに存在する列を確認することになるでしょう。レポートの視覚化が表形式でない場合、表に変換すると、レポートに含まれる列が表示されます。これらのカラムは通常、オブジェクト・タイプまたはイベント・タイプのプロパティである。次のステップは、カラムが対応するオブジェクトタイプのプロパティを把握することです。property_definitionsに問い合わせることで可能です。


SELECT * FROM property_definitions

WHERE label = [column_name]です。

 

一部のプロパティ名は、通常、アプリ上でより説明的な名前に解決されるため、必ずしも完全に一致しない場合があります。このような場合、property_definitionsのlabel(あるいはdescription)列でLIKE演算子を使ったあいまい検索が有効です。

カラムがどのオブジェクトタイプに属するかを決定した後、何を問い合わせるかを決定するのは簡単なことです。その型に対応するobject_xビューを検索すればよいのです。

このデータ型を別のデータ型にリンクさせるにはどうすればよいですか(例:キャンペーン用のフォームを取得する方法)?


2つ以上の異なるレコードを互いにリンクさせる必要がある場合は、アソシエーションをご覧ください。関連付けは、HubSpotのCRM上のさまざまなオブジェクトの間の関係を表します。2つの型の間で可能なすべての異なる関連付けはassociation_definitionsにリストされている。上記の例では、キャンペーンがリンクされているすべてのフォームを知るために、ASSOCIATIONS_CAMPAIGNS_TO_FORMSをクエリする必要があります。


SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name

 

 

この記事はお役に立ちましたか?
This form is used for documentation feedback only. Learn how to get help with HubSpot.