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

コードウィザード(ベータ版)を使用してカスタム動作イベントを作成する

更新日時 2022年 8月 12日

対象製品

Marketing Hub Enterprise

カスタム行動イベントを使用すると、ビジネス固有のイベントを定義して追跡できます。カスタム行動イベントはイベントのプロパティーに関連付けることができ、これをHubSpotのすべてのツールで使用できます。「Javascriptコードスニペット」を使用して作成されたイベントは、サイトのHubSpotトラッキングコードにイベントデータを自動的に追加し、Javascriptに精通しているユーザーが設定する必要があります。手動でトラッキングされたイベントは、分析APIを使用し、開発者が設定する必要があります。 

カスタム動作イベントツールを使用して、クリックされた要素イベントとアクセスされたURLイベントを作成する方法について説明します。

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

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

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

HubSpotでイベントを作成する

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

  • HubSpotアカウントにて、[レポート] > [アナリティクスツール]の順に進みます。
  • [カスタム行動イベント]をクリックします。
  • 右上の[カスタムイベントを作成]をクリックします。
  • [コードウィザード]を選択します

  • イベント を入力し、必要に応じてイベントの説明を入力してください
  • ドロップダウンメニューで、関連付けられたオブジェクトを選択します。これにより、イベントの完了を連絡先会社取引チケットなど、HubSpotのさまざまなオブジェクトに関連付けることができます。 

name - custom - behavioralイベント

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

イベントのプロパティを追加

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

イベントのプロパティを作成するには:

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

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

    • プロパティの名前を入力し、プロパティの説明を入力します。
    • 列挙プロパティについては、[次へ]をクリックし、プロパティの[ラベル]を入力します。データを送信する前に、値とラベルを設定する必要があります。リストにないデータを送信する前にこの手順を完了しないと、データを使用できなくなります。複数の値を送信するには、セミコロンで区切ります。
    • [完了]をクリックします。
    • プロパティが作成されると、HubSpotの既定のイベントプロパティの下のテーブルに表示されます。[アクション]ドロップダウンを選択し、[編集]または[削除]を選択して、プロパティを編集または削除できます。 
  • [次へ]をクリックします。
  • イベントとそのプロパティを設定した後、Javascriptコードスニペットを選択してこのイベントをウェブサイトのトラッキングコードに追加するか、データをHubSpotに送信を選択してAPIを介してHubSpotにデータを送信できます。 

Javascriptコードスニペットを作成する

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

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

データをHubSpotに送信

HubSpotにデータを送信する場合は、イベントをトリガーするAPI呼び出しを定義する必要があります。HubSpotの開発者ドキュメントでAPIコールを定義する方法について説明します。

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

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

API経由でデータを送信するイベントの作成を完了するには:

  • [データをHubSpotに送信]を選択し、追跡IDをコピーします。
  • [作成]をクリックします。

既存のイベントの内部イベント名とプロパティ名を検索するには:

  • HubSpotアカウントにて、[レポート] > [アナリティクスツール]の順に進みます。
  • [カスタム行動イベント]をクリックします。
  • イベントの名前をクリックします。イベントの詳細ページが表示されます。
  • 上部で、イベント名を[ Internal name ]の下に表示します。
    internal - name - custom - event
  • 更新するプロパティの内部名を検索するには、プロパティの名前をクリックします。
  • 右側のパネルで、コードアイコンをクリックし、内部名の下に名前を表示します。
注意:イベントにデータを送信する
場合は、次の制限が適用されます。

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

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

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

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

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

カスタム行動イベントの分析について詳しくは、こちらをご覧ください

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

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

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

  • カスタム動作イベントを完了した取引先責任者レコードに移動します。
  • 完了したイベントで取引先責任者のタイムラインをフィルタリングするには、[アクティビティのフィルタリング]をクリックし、[カスタム動作イベント]を選択します。
  • 連絡先のタイムラインで、をクリックしてイベントを展開し、イベントの詳細を表示します。

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

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

  • HubSpotアカウントにて、[自動化] > [ワークフロー]の順に進みます。
  • ワークフローの名前をクリックします。または、新しいワークフローを作成する方法を学びます。
  • ワークフローエディターで、[++]アイコンをクリックして、ワークフローアクションを追加します。
  • 右側のパネルで、イベントが発生するまで[遅延]を選択します。
  • 遅延を設定するには、次の手順を実行します。
    • [イベント]ドロップダウンメニューをクリックし、[カスタム行動イベント]を選択します。
    • 次に、それに基づいて遅延するイベントのプロパティーを選択します。
    • イベントプロパティのフィルタを選択します。
    • [フィルターを適用]をクリックします。
    • 最大待機時間を選択するか、[可能な限り遅延する]チェックボックスをオンにします。
  • [保存]をクリックします。

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

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.