crm_object、crm_objects、crm_associationsのHubL関数を使用すると、CRMオブジェクトデータに基づいてロジックを表示および制御できます。
ウェブサイト上でCRMデータを使用することで、営業、マーケティング、ウェブサイトのデータが全て同じ場所に存在し、常に同じ情報が反映されることになります。さらに、CRMレコードを相互に関連付けることができるので、関連付けられたデータをウェブサイトページに取り込むこともできます。
同様に、CRMオブジェクトまたはHubDBデータを使用して自動生成される動的ページのセットを作成できます。
使用例
ページでCRMオブジェクトデータを使用する例の1つとして、不動産リストページがあります。「物件」と呼ばれるカスタムオブジェクトを使用すると、リストに掲載する必要のある家屋ごとにオブジェクトレコードを作成できます。_ _次に、不動産業者は物件オブジェクトに情報を追加して、場所、寝室の数、希望価格などの詳細を保存することができます。 その後、ウェブサイトページで各物件のレコードデータを取り込んで、リスティングページと各物件の詳細ページを作成できます。 この例全体を確認するには、GitHubリポジトリーをご参照ください。 この例の概要については、HubSpot Developer Day 2020の録画をご参照ください。サポートされるCRMオブジェクトタイプ
CMSページのデータの取得元として可能なCRMオブジェクトの種類を以下に示します。全てのページでデータを使用できるか、それとも非公開ページでのみデータを使用できるかは、オブジェクトタイプによって異なります。 以下の表は、CMSコンテンツで使用可能なオブジェクトタイプと、そのオブジェクトタイプ名および完全修飾名を示しています。全てのページで使用できるCRMオブジェクトデータ
次のCRMオブジェクトからのデータは、任意のCMSページで使用可能です。非公開ページで使用できるCRMオブジェクトデータ
以下のCRMオブジェクトからのデータは、パスワードまたはメンバーシップログインのいずれかを必要とするページでのみ使用可能です。crm_object関数を使用して単一のCRMレコードからのデータを表示する
crm_object関数を使用し、クエリーまたはCRMレコードIDを使ってHubSpotのCRMから単一のレコードを取得します。
オブジェクトレコードは、プロパティーと値から成るディクショナリーとして返されます。
- 入力
- 出力
crm_objects関数を使用して複数のCRMレコードからのデータを表示する
crm_objects()関数を使用し、クエリーまたはレコードIDを使ってHubSpotのCRMからオブジェクトタイプ別にCRMレコードを取得します。レコードは、プロパティーと値から成るディクショナリーとして返されます。
返されるオブジェクトにはresultsプロパティーが含まれ、これをループ処理することでレコード内の項目の情報を表示できます。
- 入力
- 出力
関連付けられたレコードの表示
crm_associationsのHubL関数を使用すると、特定のレコードID、関連付けカテゴリー、関連付け定義IDに基づき、関連付けられているレコードのリストをHubSpotのCRMから取得できます。
レコードは、プロパティーと値から成るディクショナリーとして返されます。
- 入力
- 出力
カスタムオブジェクトタイプの詳細を取得する
カスタムオブジェクトタイプのname、id、fullyQualifiedName、関連付けID、その他の詳細を取得するには、CRMオブジェクトスキーマAPIにGETリクエストを送信します。
CRMオブジェクトモジュールのフィールド
CRMオブジェクトフィールドを含むモジュールを構築すると、コンテンツ作成者は表示またはロジックを実行する対象のCRMレコードを選択できるようになります。 例えば、特定の製品、コンタクト、会社、取引、見積もり、チケット、またはカスタムオブジェクトからの情報を表示できます。