カスタムイベントを作成する

カスタムイベントを使用すれば、ビジネスに固有のイベントを定義して追跡できます。カスタムイベントはイベントのプロパティーに関連付けることができ、これをHubSpotの全てのツールで使用できます。 

カスタムイベントはさまざまな方法で作成できます。 

• APIを使用して送信：カスタムイベント定義APIエンドポイントを使用してイベントを作成します。ここから、カスタムイベント送信APIエンドポイントでイベントIDを使用してHubSpotにイベント完了を送信します。
• APIを使用せずにウェブサイトからデータを取得する。
  • JavaScriptでのコード：カスタムJavaScriptを使用すると、コードエディターを使ってカスタムコードをHubSpotトラッキングスクリプトに挿入できます。
  • イベントビジュアル機能を使用（Marketing Hub Enterpriseのみ）：ウェブサイト上でページビューまたはクリックされる要素を選択して、それらをトラッキングします。、イベントビジュアル機能でカスタムイベントを作成するの詳細についてはこちらをご覧ください。
• スプレッドシートをインポート：イベントデータのスプレッドシートをアップロードして、オフラインアクティビティーをキャプチャーしたり、データをバックフィルしたり、任意のツールを手動でHubSpotと連携したりします。
• Webhookを設定（Operations Hub ProfessionalおよびEnterpriseのみ）：Webhookの起動をトリガーする条件と、送信されるデータをカスタマイズします。 

注: 旧バージョンのカスタムイベントツールで作成されたイベントは、2025年8月1日以降は機能しなくなります。

イベント作成プロセスには、次の2つの過程があります。

• カスタムイベントのプロパティーを含め、HubSpotでイベントを定義する。
• JavaScriptコードスニペットを作成するか、イベントをトリガーするAPI呼び出しを定義します。 

APIを使用したイベントの作成

APIを使用してHubSpotにデータを送信する場合は、［APIを使用して送信］オプションを使用するか、カスタムイベント定義APIエンドポイントを使用してイベントを作成することができます。API呼び出しを定義する方法については、HubSpotの開発者向けドキュメントをご確認ください。

API呼び出しに関するいくつかの情報が必要です。これは、HubSpot内から取得できます。

• イベント名：イベントの内部名。 
• プロパティー名：データの送信先であるプロパティーの内部名。

API経由でデータを送信するイベントの作成を完了するには、次の手順に従います。

• ［データをHubSpotに送信］を選択して、［トラッキングID］をコピーします。
• ［作成］をクリックします。

既存のイベントの内部イベント名とプロパティー名を確認するには、次の手順に従います。

1. HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. イベントの名前をクリックします。イベントの詳細ページが表示されます。
3. 上部の [内部名]の下にあるイベント名を見つけます。内部名をコピーするには、名前の横にある コピー アイコンをクリックします。
   
   
4. 更新するプロパティーの内部名を確認するには、プロパティーの名前をクリックします。
5. 右側のパネルで、コードアイコンをクリックし、［内部名］の下にある名前を確認します。

JavaScriptコードスニペットを使用してイベントを作成する

1. HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. 右上の［イベントを作成］をクリックします。
3. ［JavaScriptでのコード］を選択します。

4. イベント名を入力します。また、必要に応じてイベントの説明を入力します。
5. 関連付けられたオブジェクトを選択します。これにより、イベントの完了をHubSpotのさまざまなオブジェクト（「コンタクト」、「会社」、「取引」、「チケット」など）に関連付けることができます。 

6. ［次へ］をクリックします。

プロパティーを追加する

イベントが作成されると、デフォルトのイベントプロパティーが使用可能になります。独自のカスタムプロパティーを作成することもできます。イベントのプロパティーは他のCRMプロパティーとは個別に保管され、イベントに固有です（つまり、アカウント設定からこれらのプロパティーを編集することはできません）。 

1. HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. 右上の［イベントを作成］をクリックします。
3. ［JavaScriptでのコード］を選択します。
4. [イベント名] を入力し、必要に応じてイベントの説明を入力します。
5. デフォルトのイベントプロパティーの作成を無効にするには、［デフォルトのイベントプロパティー］をオフに切り替えます。
6. カスタムプロパティーを作成するには、 プロパティーのフィールドタイプ をクリックして プロパティータイプ を選択します。次のオプションがあります。 
   • カスタム文字列プロパティー：プレーンテキスト文字列のプロパティーを作成します。 
   • カスタム数値プロパティー：数値のプロパティーを作成します。
   • カスタム タイムスタンプ プロパティー：日付値のプロパティーを作成します。エポックミリ秒またはISO8601の形式でデータを送信する必要があります。
   • カスタム日付プロパティー：日付値であるプロパティーを作成します。
   • カスタム ブール プロパティー：ブール値のプロパティーを作成します。 
   • カスタム列挙プロパティー：事前定義済みの値のセットを持つプロパティーを作成します。
7. プロパティーを選択したら、右側のパネルでプロパティーを設定します。

8. プロパティーの名前と説明を入力します。
   • 「列挙プロパティー」については、［次へ］をクリックしてプロパティーのラベルと値を入力します。
     • 列挙プロパティーは、単一選択または複数選択にすることができます。複数選択値を有効にするには、［複数値をサポート］スイッチをオンに切り替えます。

• • • データをプロパティーに送信する前に、値とラベルを設定する必要があります。リストにないデータを送信する前にこのステップを完了しないと、そのデータを使用できなくなります。複数の値をAPI経由で送信するには、それぞれの値をセミコロンで区切ります。

9. ［次へ］をクリックします。
10. イベントとそのプロパティーを設定した後、JavaScriptコードスニペットを選択することで、このイベントをウェブサイトのトラッキングコードに追加できます。
11. ［完了］をクリックします。

JavaScriptコードスニペットでイベントを作成すると、HubSpotトラッキングコードにJavaScriptを自動的に追加できます。これを使用して、トラッキングコードがデフォルトではキャプチャーしない、より複雑なイベントデータをキャプチャーすることができます。 

• ［JavaScriptコードスニペット］を選択します。右側のパネルのスニペットを使用して、HubSpotでイベントをトラッキングします。作成されたカスタムプロパティーは、コードスニペット内で事前定義されます。 
• 必要に応じて、右側のパネルにテキストを入力してスニペットを変更します。追加したコードは、HubSpotトラッキングコードの一部として自動的に組み込まれます。
• 完了したら、［作成］をクリックしてイベントを完成させます。自動的にトラッキングが開始されます。
  

イベントデータのインポート

対面イベントの出席データ、HubSpotと連携していないアプリからのタイムスタンプ付きデータ、ベンダーからの単発のリードまたはキャンペーンのデータ、その他のイベントデータをスプレッドシート形式でアップロードします。イベントにより、行動をキャプチャーし、HubSpot全体でその行動を使用することができます。 

• コンタクトEメールアドレス
• 「発生時刻」タイムスタンプ。詳しくはインポートファイル内の日付プロパティーの書式設定についてご確認ください。

ファイルの例

カスタムイベントをインポートするには、次の手順に従います。

1. . HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. 右上の［イベントを作成］をクリックします。
3. ［スプレッドシートをインポート］を選択します。

4. イベント名を入力します。また、必要に応じてイベントの説明を入力します。
5. 関連付けられたオブジェクトを選択します。今のところ、インポートで作成されたイベントは［コンタクト］にのみ関連付けすることができます。

6. ファイルをアップロードします。オブジェクトのインポート方法とファイルの言語を選択し、［次へ］をクリックします。
7. イベントとコンタクトプロパティーに列をマッピングし、［次へ］をクリックします。
8. インポートファイルの名前を確認します。
9. チェックボックスをオンにして、コンタクトがあなたから連絡があると了承していること、さらにインポートファイルに購入済みリストが含まれていないことに同意します。HubSpotの利用規定について詳細をご確認ください。
10. 「発生時刻」プロパティーの日付形式を選択します。
11. ［インポート完了］をクリックします。

APIを使用したイベントの作成

1. HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. 右上の［イベントを作成］をクリックします。
3. ［APIを使用して送信］を選択します。

4. [イベント名] を入力し、必要に応じてイベント の説明を入力します。 

5. カスタムイベントプロパティーを追加するには:
   • プロパティー 名を入力します。この名前は内部名にも適用されます。
   • [フィールドタイプ ]ドロップダウンメニューをクリックし、フィールドタイプを選択します。
   • 必要に応じて、説明を追加します。
   • さらにカスタムプロパティーを追加する場合は、[+カスタムプロパティーを追加]をクリックします。
   • ［次へ］をクリックします。

6. オブジェクトをリンクするには、次の手順に従います。
   • ［プライマリーオブジェクトを選択］ドロップダウンメニューをクリックし、関連付けるオブジェクトを選択します。これにより、イベントの完了をコンタクト、会社、取引、チケットなどのさまざまなオブジェクトに関連付けることができます。
   • ［一致をカスタマイズ］をクリックし、イベントレコードとオブジェクトレコード間で一致するIDを選択します。このイベントは、一致するIDが同一の場合にのみオブジェクトレコードにリンクされます。カスタムマッチングIDを使用する場合、値が重複にならないオブジェクトプロパティーを選択する必要があります。
7. ［次へ］をクリックします。
8. HubSpotでイベントを追跡するには、トラッキングIDの横にある [広告アイコン]をクリックします。
9. イベントの作成」をクリックします。

Webhookの設定

Webhookをトリガーする条件を設定します。

1. HubSpotアカウントにて、［データ管理］＞［カスタムイベント］の順に進みます。
2. 右上の［イベントを作成］をクリックします。
3. ［Webhookを設定］を選択します。
4. ［イベント名］を入力し、［関連付けられたオブジェクト］を選択します。

5. ［次へ］をクリックします。
6. テストイベントを次のようにセットアップします。
   • ［Webhook URL］をコピーします。 
   • 連携先のサードパーティーアプリで、Webhook設定ページに移動します。
   • コピーしたURLを貼り付けます。
   • ［テストイベントを送信］をクリックします。
7. ［次へ］をクリックします。
8. Webhookのプロパティーを確認します。［プロパティータイプ］ドロップダウンメニューをクリックして、プロパティータイプを選択します。 

9. ［次へ］をクリックします。
10. サードパーティーWebhookから、HubSpotオブジェクトプロパティーに正確に一致するプロパティーを選択します。 

カスタム イベント データの使用

カスタム イベント データは、HubSpotの全てのツールで表示し、使用することができます。イベントの完了を確認する場所と、イベントデータを他のツールに取り込む方法について、以下で説明します。

選択したイベントを特定のHubSpotツールで直接開くことができます。その際、イベントリストのアクションドロップダウン、単一イベントビュー、または分析タブのチャートの右上隅を使用します。

カスタムイベントについて報告する

カスタム イベント ツールからカスタムイベント完了を分析できます。イベントデータは、カスタム レポート ビルダーとアトリビューションレポートでも使用できます。

詳しくは、カスタムイベントの分析をご覧ください。

コンタクトタイムラインでイベントの完了を表示する

イベントの完了は、取り込まれたすべてのプロパティーとともに、コンタクトレコードのタイムラインに表示されます。

コンタクトタイムラインでイベントの詳細を表示するには、次の手順を実行します。

1. カスタムイベントが完了したコンタクトレコードに移動します。
2. 完了したイベントでコンタクトタイムラインを絞り込むには、［アクティビティーを絞り込み］をクリックして、［カスタムイベント］を選択します。
3. コンタクトタイムラインで、イベントをクリックして展開し、イベントの詳細を表示します。

注: Webhookを使用して作成されたカスタムイベントでは、タイムラインアクティビティーを表示することはできません。

ワークフローでカスタムイベントを使用する

ワークフローに登録すると、イベントの発生まで遅延アクションまたはイベント登録トリガーを使用して、カスタムイベントの完了に基づいて遅延させることができます。

1. HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
2. ワークフローの名前をクリックします。または、新規ワークフローを作成する方法をご覧ください。
3. トリガーを追加するには、次の手順に従います。
   • ワークフローエディターで、［トリガーを設定］をクリックします。
   • 左のパネルで、［イベントの発生時］を選択します。トリガーを設定し、［フィルターを適用］をクリックします。
   • トリガーをさらに絞り込むには、［絞り込みフィルターを追加］をクリックします。追加のプロパティーを選択すると、ワークフローに登録するレコードを絞り込むことができます。
   • デフォルトでは、レコードは初めて登録トリガーを満たした場合にだけワークフローに登録されます。再登録を有効にするには、［このワークフローに［オブジェクト］を再登録する必要がありますか？］セクションで、［はい、トリガーが発生するたびに再登録］を選択します。
4. 遅延を追加するには、次の手順に従います。
   • ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
   • 右側のパネルで、［イベントの発生まで遅延］を選択します。
   • 遅延を設定するには、次の手順を実行します。
     • ［イベント］ドロップダウンメニューをクリックし、カスタムイベントを選択します。
     • 次に、それに基づいて遅延するイベントのプロパティーを選択します。
     • イベントプロパティーのフィルターを選択します。
     • ［フィルターを適用］をクリックします。
   • • 最大待機時間を選択するか、［可能な限り遅延する］チェックボックスをオンにします。
5. ［保存］をクリックします。

注：全てのイベント登録トリガーは、OR演算子を使用して区切られます。つまり、レコードをワークフローに登録するには、イベント登録トリガーを1つだけ発生させる必要があります。

その後、ワークフローでは、登録済みレコードが指定のカスタムイベント条件を満たすか、イベント発生時にトリガーされるまで、それらのレコードは遅延されるようになります。