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

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

更新日時 2025年9月3日

以下の 製品でご利用いただけます(別途記載されている場合を除きます)。

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

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

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

 

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

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

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

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

API経由でHubSpotにデータを送信する場合は、[API経由で送信]オプションを使用するかカスタムイベント定義エンドポイントを使用してイベントを作成できます。HubSpotの開発者ドキュメントでAPI呼び出しの定義の詳細をご確認ください。

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

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

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

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

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

  1. HubSpotアカウントにて、[営業]>[データ管理]>[イベント管理]の順に進みます。
  2. イベントの名前をクリックします。イベントの詳細ページが表示されます。
  3. 上部の [内部名]の下にあるイベント名を見つけます。内部名をコピーするには、名前の横にある コピー アイコンをクリックします。

    カスタムイベント内部名
  4. 更新するプロパティーの内部名を確認するには、プロパティーの名前をクリックします。
  5. 右側のパネルで、コードアイコンをクリックし、[内部名]の下にある名前を確認します。
注:
イベントにデータを送信する際には、以下の制限が適用されます。
  • プロパティー名は最大50文字までです。 
  • URLとリファラーのプロパティーは最大1024文字まで、その他のプロパティーは最大256文字までです。
  • 各イベント完了には、最大で50個のプロパティーのデータを含めることができます。
  • プロパティーの内部名はアルファベットで始まる必要があり、使用できるのは小文字のa~z、数字の0~9、アンダースコアのみです。小文字にした後の内部名が同じプロパティーは重複しているとみなされ、完了時にはどちらか一方のプロパティーのみが使用されます。
HTTP APIリクエストの際にこれらの制限を超えた場合、リクエストは失敗します。JS APIリクエストの際にこれらの制限を超えた場合、HubSpotはプロパティー名の値を許容される長さに切り詰め、イベント完了ごとに50個のプロパティーのみを更新します。

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

  1. HubSpotアカウントにて、[データ管理>イベント管理]の順に進みます。  
  2. 右上の[イベントを作成]をクリックします。
  3. [JavaScriptでのコード]を選択します。
code-javascript
  1. イベント名を入力します。また、必要に応じてイベントの説明を入力します。
  2. 関連付けられたオブジェクトを選択します。これにより、イベントの完了をHubSpotのさまざまなオブジェクト(「コンタクト」、「会社」、「取引」、「チケット」など)に関連付けることができます。 

custom-event-details
  1. [次へ]をクリックします。

プロパティーを追加する

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

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

custom-event-property

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

multi-value-enumeration-property-1
      • データをプロパティーに送信する前に、値とラベルを設定する必要があります。リストにないデータを送信する前にこのステップを完了しないと、そのデータを使用できなくなります。複数の値をAPI経由で送信するには、それぞれの値をセミコロンで区切ります。
注:複数選択の列挙プロパティーをインポートすることはできません。
  1. [次へ]をクリックします。
  2. イベントとそのプロパティーを設定した後、JavaScriptコードスニペットを選択することで、このイベントをウェブサイトのトラッキングコードに追加できます。
  3. [完了]をクリックします。

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

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

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

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

インポートではコンタクトレコードを作成および更新できます。イベントのインポートは、すでに発生済みのイベントに関してのみ使用できます。カスタムイベントのインポートファイルには以下を含める必要があります。

same-custom-events-file

ファイルの例

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

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

one-time-import

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

custom-event-details

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

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

  1. HubSpotアカウントにて、[データ管理>イベント管理]の順に進みます。  
  2. 右上の[イベントを作成]をクリックします。
  3. [APIを使用して送信]を選択します。
send-via-api
  1. [イベント名] を入力し、必要に応じてイベント の説明を入力します。 
custom-event-details
  1. カスタムイベントプロパティーを追加するには:
    • プロパティー 名を入力します。この名前は内部名にも適用されます。
    • [フィールドタイプ ]ドロップダウンメニューをクリックし、フィールドタイプを選択します。
    • 必要に応じて、説明を追加します。
    • さらにカスタムプロパティーを追加する場合は、[+カスタムプロパティーを追加]をクリックします。
    • [次へ]をクリックします。
カスタムイベント定義イベントプロパティ
  1. オブジェクトをリンクするには、次の手順に従います。
    • [プライマリーオブジェクトを選択]ドロップダウンメニューをクリックし、関連付けるオブジェクトを選択します。これにより、イベントの完了をコンタクト、会社、取引、チケットなどのさまざまなオブジェクトに関連付けることができます。
    • [一致をカスタマイズ]をクリックし、イベントレコードとオブジェクトレコード間で一致するIDを選択します。このイベントは、一致するIDが同一の場合にのみオブジェクトレコードにリンクされます。カスタムマッチングIDを使用する場合、値が重複にならないオブジェクトプロパティーを選択する必要があります。
  2. [次へ]をクリックします。
  3. HubSpotでイベントを追跡するには、トラッキングIDの横にある [広告アイコン]をクリックします。
  4. イベントの作成」をクリックします。

注:

  • 一致させることができるのは、同じデータ型のイベントプロパティーとオブジェクトプロパティーのみです。
  • 必要に応じて、カスタムマッチを後で編集できますが、選択したプライマリーオブジェクトを変更することはできません。

Webhookの設定

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

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

webhook-event

  1. [次へ]をクリックします。
  2. テストイベントを次のようにセットアップします。
    • [Webhook URL]をコピーします。 
    • 連携先のサードパーティーアプリで、Webhook設定ページに移動します。
    • コピーしたURLを貼り付けます。
    • [テストイベントを送信]をクリックします。
  3. [次へ]をクリックします。
  4. Webhookのプロパティーを確認します。[プロパティータイプ]ドロップダウンメニューをクリックして、プロパティータイプを選択します。 
map-property-type
  1. [次へ]をクリックします。
  2. サードパーティーWebhookから、HubSpotオブジェクトプロパティーに正確に一致するプロパティーを選択します。 

unique-property-webhook

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

この記事はお役に立ちましたか?
こちらのフォームではドキュメントに関するご意見をご提供ください。HubSpotがご提供しているヘルプはこちらでご確認ください。