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

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

更新日時 2024年 11月 8日

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

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise

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

カスタムイベントを作成するには3つの方法があります: 

  • API経由で送信: イベントを作成するには、 カスタムイベント定義エンドポイント を使用します。そこから、send Custom event endpointでイベントIDを使用し、イベントの完了をHubSpotに送信します。
  • APIなしでウェブサイトからデータを取得します:
    • コードJavascript:カスタムJavascriptを使用すると、コードエディターを使ってHubSpotトラッキングスクリプトにカスタムコードを挿入できます。
    • イベントビジュアル機能の使用 ( Marketing Hub Enterpriseのみ):ページビューやクリックされた要素をウェブサイト上で選択して追跡します。、イベントビジュアル機能でカスタムイベントを作成するの詳細についてはこちらをご覧ください。
  • スプレッドシートのインポート:イベントデータのスプレッドシートをアップロードしてオフラインアクティビティーを取り込みしたり、データを埋め戻したり、手動でツールをHubSpotと連携させることができます。

 

注:カスタムイベントツールは、以前のイベント旧ツールに取って代わります。旧ツールで作成されたイベントは引き続き機能します。また、旧ツールで引き続きこれらのイベントを管理および分析できます。 

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

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

API経由でのイベント作成

API経由でHubSpotにデータを送信する場合は、 カスタムイベント定義エンドポイント を使用してイベントを作成する必要があります。次に、イベントをトリガーするAPIコールを定義する必要がある。HubSpot の開発者向けドキュメントで API呼び出し の定義方法をご確認ください。

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

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

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

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

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

  • HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
  • カスタムイベントをクリックする。
  • イベントの名前をクリックします。イベントの詳細ページが表示されます。
  • 上部で、内部名の下にあるイベント名を探す。

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

Javascriptコードスニペットによるイベントの作成

  • HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
  • 右上の「イベントを作成」をクリックする。
  • 選択コード Javascript .
コード・ JavaScript
  • [次へ]をクリックします。
  • イベント名を入力し、オプションでイベントの説明を入力してください。
  • 関連付けられたオブジェクトを選択 .これにより、イベントの完了をHubSpotのさまざまなオブジェクト(「コンタクト」、「会社」、「取引」、「チケット」など)に関連付けることができます。 
カスタムイベント詳細

  • [次へ]をクリックします。

プロパティーを追加する

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

イベントのプロパティーを作成するには、次の手順に従います。

  • プロパティーのフィールドタイプをクリックして、プロパティータイプを選択する。次のオプションがあります。 
    • カスタム文字列プロパティー:プレーンテキスト文字列のプロパティーを作成します。 
    • カスタム数値プロパティー:数値のプロパティーを作成します。
    • カスタム タイムスタンプ プロパティー:日付値のプロパティーを作成します。エポックミリ秒またはISO8601形式でデータを送信する必要があります。 
    • カスタム列挙プロパティー:定義済みの値を持つプロパティーを作成します。

      create-property-custom-behavioral-event
    • プロパティーを選択したら、右側のパネルでプロパティーを設定します。

    • プロパティーの名前説明を入力します。
    • 列挙プロパティー」については、[次へ]をクリックしてプロパティーのラベルを入力します。データをプロパティーに送信する前に、値とラベルを設定する必要があります。リストにないデータを送信する前にこのステップを完了しないと、データを使用できません。API経由で複数の値を送信するには、セミコロンで区切ります。
注:複数選択のエミュメレーションプロパティーをインポートすることはできません。
    • [完了]をクリックします。
  • 「次へ」をクリックする。
  • イベントとプロパティーを追加設定した後、Javascriptコードスニペットを選択することで、このイベントをウェブサイトのトラッキングコードに追加することができます。

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

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

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

対面イベントの出席データ、HubSpotと連携していないアプリからのタイムスタンプデータ、ベンダーからの1回限りのリードデータやキャンペーンデータ、その他のイベントデータをスプレッドシートフォームでアップロードしましょう。イベントによって行動を把握し、その行動をHubSpot全体で利用することができます。 

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

カスタムイベントファイル

ファイル例

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

  • HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
  • 右上の「イベントを作成」をクリックする。
  • インポート・スプレッドシートを選択する。
インポート・スプレッドシート
  • [次へ]をクリックします。
  • イベント名を入力し、オプションでイベントの説明を入力してください。
  • 関連付けられたオブジェクトを選択 .現時点では、インポートによって作成されたイベントはコンタクトにのみ関連付けることができます。

カスタムイベント詳細

  • インポートファイル の名前 を確認します。
  • チェックボックス をクリックして、コンタクトがあなたから連絡があることに同意し、インポートファイルに購入者リストが含まれないことに同意します。HubSpotの利用規約について詳しくはこちら .
  • [発生時刻 ]プロパティーの 日付形式 を選択します。
  • [インポート完了]をクリックします。

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

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

選択したイベントは、イベントリストのアクションドロップダウン、単一イベント表示、または分析タブのチャートの右上隅から、選択したHubSpotツールで直接開くことができます。

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

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

カスタムイベントの分析について詳しくはこちら .

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

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

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

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

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

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

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

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

ワークフローの[レコード]は、登録されたレコードが指定されたカスタムイベント条件を満たすまで遅延されるか、イベントが発生したときにトリガーされます。

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