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

手動でトラッキングされるカスタム行動イベントを作成する

更新日時 2021年 9月 29日

対象製品

Marketing Hub Enterprise

手動でトラッキングされるカスタム行動イベントを使用して、自社のビジネスに特有のイベントを定義してトラッキングすることができます。カスタム行動イベントはコンタクトのプロパティーに関連付けることができ、これをHubSpotのすべてのツールで使用できます。手動でトラッキングされるイベントではアナリティクスAPIを使用し、開発者がセットアップする必要があります。 

カスタム行動イベントツールを使用して、要素クリックイベントおよびURL訪問イベントを作成する方法をご覧ください。

注:従来の行動イベントのレガシーツールの代わりに、このカスタム行動イベントツールが使用されます。レガシーツールで作成されたイベントは引き続き機能します。また、レガシーツールで引き続きこれらのイベントを管理および分析できます。 

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

  • イベントに関連付けるコンタクトのプロパティーを含め、HubSpotでイベントを定義する。
  • イベントをトリガーするAPI呼び出しを定義する。 

HubSpotでイベントを作成する

カスタム行動イベントを設定するには、まずイベントを作成してから、イベントにプロパティーを関連付けます。

  • HubSpotアカウントにて、[レポート] > [アナリティクスツール]の順に進みます。
  • [カスタム行動イベント]をクリックします。
  • 右上の[イベントを作成]をクリックします。
  • 右側のパネルで、イベントの名前を入力し、[手動でトラッキングされるイベント]を選択します。
     create-manually-tracked-event
  • イベントが作成され、APIリクエストを行うときに使用される内部名をコピーできるようになります。内部名をコピーするには、[コピー]をクリックします。

次に、API呼び出しで使用するプロパティーを設定します。

イベントプロパティーを追加して管理する

イベントのプロパティーを作成すると、イベントAPI呼び出しでコンタクトプロパティーのデータを送信および保管できるようになります。イベントを作成する際には、既定のイベントプロパティーを使用できるほか、独自のカスタムプロパティーを作成することもできます。イベントのプロパティーは他のCRMプロパティーとは個別に保管され、イベントに固有です(つまり、アカウント設定からこれらのプロパティーを編集することはできません)。 

イベントのプロパティーを表示および作成するには、次の手順を実行します。

  • HubSpotアカウントにて、[レポート] > [アナリティクスツール]の順に進みます。
  • [カスタム行動イベント]をクリックします。
  • 表示または更新するイベントの名前をクリックします。イベントの詳細ページが表示されます。
  • [プロパティー]テーブルで、イベントに対して作成された既定のプロパティーを表示します。 
  • プロパティーを編集するには、次の手順を実行します。
    • プロパティー名をクリックします。
    • 右側のパネルで、新しい名前または説明を入力することができます。プロパティー名を変更しても内部名は変更されないため、プロパティーの名前を変更した場合にAPI呼び出しを更新する必要はありません。
    • フィールドタイプを変更し、さらにプロパティーを設定するには、[フィールドタイプ]タブをクリックしてから、ドロップダウンメニューを使用して新しいフィールドタイプを選択し、プロパティーの詳細を設定します。 
    • [保存]をクリックします。
  • 新しいプロパティーを作成するには、次の手順を実行します。
    • 右上の[プロパティーを作成]をクリックします。
    • 右側のパネルで、プロパティーを設定します。
      • [グループ]ドロップダウンメニューをクリックし、グループを選択して、プロパティーのグループを選択します。
      • プロパティーの名前を設定するには、[ラベル]フィールドに名前を入力します。入力した名前から、プロパティーの内部名が自動的に作成されます。
        • 内部名を編集するには、codeコードアイコンをクリックし、[内部名]フィールドをクリックして新しい名前を入力します。プロパティーが作成された後で内部名を更新することはできません。

          注:プロパティーラベルと内部名は50文字に制限されています。
        • 名前を保存するには、[保存]をクリックします。 
      • 必要に応じて、[説明]フィールドにプロパティーの説明を入力します。
      • [次へ]をクリックします。
      • [フィールドタイプ]ドロップダウンメニューをクリックし、フィールドタイプを選択して、プロパティータイプを選択します。既定では、プロパティーはフォームとボットで使用できます。フォームとボットでフィールドが使用されないようにするには、[フォームで表示]チェックボックスをクリックしてオフにします。
    • [作成]をクリックします。

API呼び出しを定義する

イベントとそのプロパティーを設定したら、イベントをトリガーするAPI呼び出しを定義する必要があります。HubSpotの開発者向けドキュメントで、API呼び出しの定義方法を確認してください。

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

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

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

  • HubSpotアカウントにて、[レポート] > [アナリティクスツール]の順に進みます。
  • [カスタム行動イベント]をクリックします。
  • イベントの名前をクリックします。イベントの詳細ページが表示されます。
  • 上部にある[内部名]の下にイベント名が示されています。

    custom-event-internal-name
  • 更新するプロパティーの内部名を確認するには、プロパティーの名前をクリックします。
  • 右側のパネルで、codeコードアイコンをクリックし、[内部名]の下にある名前を確認します。

注:イベントにデータを送信する際には、以下の制限に留意してください。

  • プロパティーラベルと内部名は50文字に制限されています。 
  • URLとリファラーのプロパティーは最大1024文字まで、その他のプロパティーは最大256文字までです。
  • 各イベント完了には、最大で50個のプロパティーのデータを含めることができます。
  • プロパティーの内部名はアルファベットで始まる必要があり、使用できるのは小文字のa~z、数字の0~9、アンダースコアのみです。小文字にした後の内部名が同じプロパティーは重複しているとみなされ、完了時にはどちらか一方のプロパティーのみが使用されます。

HTTP APIリクエストの際にこれらの制限を超えた場合、リクエストは失敗します。JS APIリクエストの際にこれらの制限を超えた場合、HubSpotはプロパティー名の値を許容される長さに切り詰め、イベント完了ごとに50個のプロパティーのみを更新します。

カスタム行動イベントデータを使用する

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

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

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

カスタム行動イベントの分析の詳細を確認してください。

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

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

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

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

custom-behavioral-events-contact-timeline-filter

  • コンタクトタイムラインで、イベントをクリックして展開し、イベントの詳細を表示します。
     custom-behavioral-events-contact-timeline-info

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

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

  • HubSpotアカウントにて、[自動化] > [ワークフロー]の順に進みます。
  • ワークフローの名前をクリックします。または、新規ワークフローの作成方法を参照してください。
  • ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
  • 右側のパネルで、[イベントの発生まで遅延]を選択します。

workflow-delay-until-event-happens-action

  • 遅延を設定するには、次の手順を実行します。
    • [イベント]ドロップダウンメニューをクリックし、[カスタム行動イベント]を選択します。
    • 次に、それに基づいて遅延するイベントのプロパティーを選択します。
    • イベントプロパティーのフィルターを選択します。
    • [フィルターを適用]をクリックします。

      workflow-delay-until-event-device-type
    • 最大待機時間を選択するか、[可能な限り遅延する]チェックボックスをオンにします。
  • [保存]をクリックします。

ワークフローで、登録レコードが指定されたカスタム行動イベント条件を満たすまで遅延されるようになります。