カスタムオブジェクトの作成と編集

サマリー

標準CRMオブジェクト以外の関係やプロセスが必要な場合は、データモデル または APIを使用してカスタムオブジェクトを作成および定義します。カスタムオブジェクトを使用すれば、HubSpotの全ての定義済みオブジェクトに当てはまるビジネス固有のデータをトラッキングできます。

この記事では、カスタムオブジェクトのさまざまな活用方法を説明します。続いて、カスタムオブジェクトを作成および管理し、カスタムオブジェクト関連付けをセットアップします。 

一度定義すれば、プロパティーの作成、パイプラインの管理、カスタムオブジェクトと他のオブジェクトの関連付けをカスタマイズすることができます。マーケティングEメール、 ワークフロー、レポートなど、他のHubSpotツールでカスタムオブジェクトを使用する 。

注：契約内容によっては、使用できるカスタムオブジェクトとプロパティーの数に上限があります。適用される上限について詳しくは、HubSpot製品・サービスカタログをご覧ください。

始める前に

カスタムオブジェクトを定義する前に、それがお客さまのビジネスやHubSpotのデータの品質にとって正しい選択肢であるかどうかを評価することが重要です。

独自のオブジェクトを作成する前に考慮すべき質問には、次のようなものがあります。

• カスタムオブジェクトの代わりに、既存のCRMオブジェクトとそのプロパティーを使用してデータを整理することは可能ですか？
• カスタムオブジェクトと既存のオブジェクトの間で、データの重複や不整合はないでしょうか？
• 既存のオブジェクトに固有の機能で、使いたいものはありますか？例えば、一括 マーケティングEメール はコンタクトにのみ送信でき、他のオブジェクトには送信できません。
• 既存のオブジェクトに接続された既成のレポートで、使いたいものがあるか？例えば、案件の属性レポートや売上フォーキャストは、他のオブジェクトではなく、案件に直接接続されます。

既存のオブジェクトの関係とデータを理解するために、アカウントの データモデルの概要を表示できます。カスタムオブジェクトを作成するタイミングについての詳しいガイドは、 HubSpotアカデミーのこのレッスン を参照するか、 カスタマーサクセスマネージャーにお問い合わせください。

カスタムオブジェクトの用語集

カスタムオブジェクトを作成する前に知っておくべき用語やコンセプトがあります。

• オブジェクト名：カスタムオブジェクトのタイトルです。複数形の名前と単数形の名前を定義するよう求められます。例えば、会社は複数形のオブジェクト名で、会社はオブジェクトの単数形の名前です。

• プライマリー表示プロパティー：オブジェクトのレコードに名前を付けるために使用されるプロパティーです。これはオブジェクトの主要な識別プロパティーであり、インデックスページでのレコードの検索に使用できます。デフォルトでは、オブジェクト インデックス ページの最初の列に表示され、各レコードの左上に表示されます。例えば、会社名は、会社の主要な表示プロパティーである。

• ラベル：レコードやインデックスページなど、HubSpot CRMに表示されるプロパティー名です。例えば、会社のプロパティーであるCompany nameはラベルです。プロパティーラベルは変更される可能性があるため、連携やAPIで使用するべきではありません。
• 内部名：連携やAPIで使用されるプロパティーの内部値です。例えば、「 会社名 」プロパティー の内部値は「 name」です。内部名は変更できないので、連携やAPIでプロパティーを参照するために使用する必要があります。

• セカンダリープロパティー：オブジェクトの追加識別プロパティー。これらのプロパティーは、レコードのプロファイルカード上で、主表示プロパティーの下に表示されます。また、インデックスページ上のレコードを検索するためにも使用できます。カスタムオブジェクトの場合は、インデックスページに追加のクイックフィルターとして表示されます。例えば、「会社」のセカンダリープロパティーは「会社ドメイン名」と「電話番号」であり、「ペット」のカスタムセカンダリープロパティーは「ペットの種類」とすることができる。

カスタムオブジェクトにはどのような用途があるか

以下の例は、カスタムオブジェクトがアカウントのデータにどのような影響を与えるかを理解するための一般的な使用例に基づいていますが、全てのシナリオに対するアドバイスとして意図されているわけではありません。カスタムオブジェクトの使用がお客さまの特定のユースケースに適しているかどうかについては、 カスタマーサクセスマネージャーにお問い合わせください。

以下は、カスタムオブジェクトの良い例です。

• ペットホテルは、預けたペットを記録し、ペットと飼い主を紐づけ、それぞれのペットに関連するアクティビティーを記録したいと考えます。彼らは、Pet nameを主表示プロパティーとし、Pet typeを副表示プロパティーとするPetsオブジェクトを作成します。インデックスページで担当するペットを表示・検索し、ペットの種類に基づいて ビューを保存し 、コンタクトをペットと関連付け、ペットのレコード内でアクティビティーやアポイントメントを管理することができます。
• 自動車販売会社は、現在在庫にある車や販売した車をデータベース化し、各車に関連する販売問い合わせを追跡したいと考えています。これらは、Modelを主要な表示プロパティーとするCarsオブジェクトを作成します。これにより、車が「新規在庫」、「購入手続き中」、「売約済み」などのステージに移動するときに追跡する カスタムオブジェクト パイプラインが作成されます。車種ごとに記録された問い合わせの電話やメールを閲覧し、車を売却する際のコンタクトや案件の関連付けを行います。

以下は、カスタムオブジェクトを作成することが推奨されない例です。

• 学校には、生徒、保護者、教師のデータベースがあります。彼らは、コンタクトタイプを区別するために、ParentsとTeachersのカスタムオブジェクトを作成したいと考えています。カスタムオブジェクトは既存のCRMオブジェクトを複製してはならないため、これは良い使用事例ではありません。1人の人が親と教師の両方になることもあり、その場合はデータが重複することになります。さらに、保護者や教師はコンタクトではないので、学校側は一括送信Eメールを送ることができません。その代わりに、全てのコンタクトタイプをコンタクトオブジェクトに含め、「生徒」、「保護者」、「教師」の選択肢を持つ「コンタクトタイプ」というカスタムプロパティーを作成することができます。
• あるホームセンターでは、HubSpotのレコードのメモを利用して、業者への社内依頼を行っています。彼らは、全ての要求を追跡するためにNotesオブジェクトを作成したいと考えています。しかしカスタムオブジェクトはアクティビティーを置き換えるべきではないため、これは良い使用例ではありません。また、他のレコードの アクティビティーが自動的にメモレコードに関連付けられることはありません し、あらかじめ作成されたアクティビティーレポートを使用することもできません。さらに、ユーザーがカスタム メモ レコードと別の関連レコードの両方を更新する場合、1つのプロジェクトに関する情報が複数の場所に保存され、データの重複や矛盾が発生する可能性があります。その代わりに、レコードにメモを作成し、他のレコードに関連付け、HubSpotユーザーをタグ付けし、あらかじめ作成されたレポートを使用してメモのアクティビティーを追跡することができます。

カスタムオブジェクトの作成方法

HubSpotでカスタムオブジェクトを作成するには。

1. HubSpotアカウントにて、［データ管理］＞［データモデル］の順に進みます。
2. 左側のパネルで、[ カスタムオブジェクトを作成]をクリックします。
3. 右のパネルで、カスタムオブジェクトを設定します。
   • カスタムオブジェクトの名前を設定する。
     • オブジェクト名（単数形）：カスタムオブジェクトの単数形タイトルを入力します（例：ペット）。
     • オブジェクト名（複数形）：カスタムオブジェクトの複数形タイトルを入力します（例：ペット）。
   • アカウントのユーザーに対し、オブジェクトの内容や使用方法を説明するオブジェクトの説明（任意）を入力します。

• オブジェクトの主表示プロパティーを作成する。 
  • 「プライマリー表示プロパティー」：オブジェクトのレコードに名前を付けるために使用するプロパティーのラベルを入力します（例：ペットのペット名）。このプロパティーは、カスタムオブジェクトレコードを作成するために必要です。
  • プロパティータイプ:プライマリー表示プロパティー のタイプ を選択します。例えば、単行テキスト、数値、 日付入力、 単一チェックボックス、 ドロップダウン選択などです。  

• ラベルの下にある edit 編集アイコンをクリックして 、プロパティーの内部名を編集し、[ 保存 ]をクリックして確認します。内部名は、連携やAPIで使用され、、オブジェクトが一度作成されると編集することはできません。
• チェックボックスを選択すると、プライマリー表示プロパティーに固有の値を求めます。これをオンにすると、ユーザーは複数のレコードに同じ値を入力できなくなります（例えば、「注文」オブジェクトに対して、プライマリープロパティー「注文番号」は固有の値が必要とされるはずです）。

• カスタム・オブジェクトのセカンダリー・プロパティーを作成する。
  • 二次表示プロパティー：レコード上で一次プロパティーの下に表示されるプロパティーのラベルを入力します（例：ペットの種類、ペットの飼い主の電話番号など）。セカンダリープロパティーは、カスタムオブジェクトレコードを作成するために必須ではありません。カスタムオブジェクトの編集で、後で追加または削除することができます。。
  • プロパティータイプ:プライマリー表示プロパティー のタイプ を選択します。例えば、 単行テキスト、 数値、 日付入力、 単一チェックボックス、 ドロップダウン選択などです。
  • ラベルの下にあるedit鉛筆アイコンをクリックしてプロパティーの内部名を編集し、保存をクリックして確定します。内部名は、連携やAPIで使用され、、オブジェクトが一度作成されると編集することはできません。

• [+ プロパティーを追加 ]をクリックしてセカンダリー表示プロパティーを追加します。これは、最初のセカンダリープロパティーにラベルとプロパティーの種類を設定した場合にのみ表示されます。
• 既存のセカンダリープロパティーを削除するには、プロパティーの横にある delete 削除 アイコンをクリックします。

4. 完了したら、パネル下部にある［作成］をクリックします。

データモデルやBreeze Copilot を使用してカスタムオブジェクトを作成することもできます。

注: カスタムオブジェクトの名前を既存の HubSpot定義のオブジェクトに一致させることはできません。カスタムオブジェクトの作成時にエラーが発生した場合は、異なる単数または複数形の名前を使用してください。

カスタムオブジェクトの追加設定を行う

カスタムオブジェクトを定義したら、 カスタムオブジェクト設定で以下の操作を行います。

• カスタムオブジェクトレコードを手動で作成する際に表示されるプロパティーの設定など、カスタムオブジェクト用のプロパティーの作成と編集が可能です。
• 関連付けラベルを作成して 、カスタムオブジェクトと他のオブジェクトとの関連付けを定義します。
• カスタムオブジェクトパイプラインを作成して管理し、カスタムオブジェクトのプロセスをトラッキングするステージを使用します。
• カスタムオブジェクトレコードを作成する
• カスタムオブジェクトレコードのサイドバー、 関連付けカード、 ボードカードに表示されるプロパティーをカスタマイズします。
• アカウントの データモデルに対するカスタムオブジェクトの位置付けをご覧ください。

カスタムオブジェクトを編集または削除する方法

カスタムオブジェクトを作成したら、その名前やプロパティーを編集したり、HubSpotアカウントからオブジェクトを削除したりできます。カスタムオブジェクト設定または APIを使用して、 カスタムオブジェクト を編集および削除することもできます。

データモデルで編集または削除するには、次の手順に従います。 

1. HubSpotアカウントにて、［データ管理］＞［データモデル］の順に進みます。
2. カスタムオブジェクトに移動します。
3. カスタムオブジェクトカードで、横に 並んだ3つのドットの ellipses アイコン をクリックし、次の項目を選択します。
   
   

• オブジェクトの使用状況を表示:HubSpotでオブジェクトが現在使用されている場所を表示する セクション をクリックして展開します。アセットの名前をクリックしてツールに移動します。
• オブジェクトを編集:オブジェクトの単数形の名前、複数形の名前、説明を編集できるほか、 セカンダリー表示プロパティーを追加または削除できます。プライマリー表示プロパティーを編集する必要がある場合は、 カスタムオブジェクトAPIを使用して編集できます。オブジェクトやプロパティーの内部名を編集することはできません。
  • 既存のプライマリーまたはセカンダリー表示プロパティーの名前を編集するには、[ プロパティーラベルを編集 ]をクリックして プロパティー設定に移動します。
  • 他のセカンダリープロパティーを追加するには、+「プロパティーを追加」をクリックし、次にプロパティーの名を入力し、プロパティータイプを選択します。
  • セカンダリープロパティーを削除するには、プロパティーにマウスポインターを合わせ、delete削除アイコンをクリックします。セカンダリープロパティーを削除しても、カスタムオブジェクトレコードでは引き続きアクセスできますが、プロファイルカードやインデックスページのフィルターには表示されなくなります。プロパティーを削除する場合は、プロパティー設定でプロパティーを アーカイブして削除 する方法をご確認ください。
  • ［保存］をクリックして変更を確定します。
• オブジェクトを削除:ダイアログボックスで、削除したカスタムオブジェクトを復元することができないことを確認する チェックボックス をオンにしてから、[ オブジェクトを削除 ]をクリックして確定します。他のツールで現在使用されているカスタムオブジェクトは削除できないため、削除する前にそれらのツールからオブジェクトへの参照を削除する必要があります。

カスタムオブジェクト間の関連付けを定義する方法

関連付けられたレコードをカスタムオブジェクトレコードに追加するには(コンタクトからペットなど)、その前に設定で関連付け関係を作成する必要があります。コンタクト、会社、取引、チケットなどのオブジェクトとの関連付けを設定できます。関連付けられたオブジェクトの可能性について詳細をご確認ください。

新しい関連付け定義を追加するには、次の手順に従います。

1. HubSpotアカウントにて、［データ管理］＞［データモデル］の順に進みます。
2. 右上の[ データモデルを編集]をクリックします。
3. 左側のサイドバーで[ 関連付け] タブをクリックします。
4. 関連付けを定義する カスタムオブジェクト を選択します。
5. データモデルで、 add add 関連付けアイコンをクリックします。
   
   
6. ダイアログボックスで オブジェクトを選択し、[作成]をクリックします。

これで、選択したオブジェクトの レコードを関連付け 関連付けを説明するラベルを作成できるようになりました。

関連付け定義を削除するには、次の手順に従います。

1. HubSpotアカウントにて、［データ管理］＞［データモデル］の順に進みます。
2. 右上の[ データモデルを編集]をクリックします。
3. 左側のサイドバーで[ 関連付け] タブをクリックします。
4. 関連付け定義を削除する カスタムオブジェクト を選択します。
5. データモデルで、定義を削除するオブジェクト上で、横 ellipses 3つのドットアイコンをクリックします。
   
   
6. [ 関連付けを削除 ] をクリックします。
7. アセットが原因で削除がブロックされている場合:
   • 関連付け定義(ワークフロー、計算プロパティーなど)の削除をブロックしているアセットを確認します。
   • 確認して削除する(例:ワークフローを削除する)には、アセット の名前 をクリックします。
   • ［次へ］をクリックします。
   • レコードの関連付けを削除する(該当する場合)。
   • [ 関連付けを削除 ] をクリックします。
8. レコードの関連付けによって削除がブロックされている場合:
   • 関連付け定義の削除をブロックしているレコードを確認してください。
     
     
   • [すべて削除]をクリックします。
   • ダイアログボックスに 番号を入力し、[削除]をクリックします。
   • ［次へ］をクリックします。
   • 該当する場合、[すべての関連付けラベルを削除]をクリックします。
   • [ 関連付けを削除 ] をクリックします。
9. 削除をブロックするアセットまたはレコードがない場合は、[ 確認 ]チェックボックスをオンにしてから、[ 削除]をクリックします。