コードウィザードでカスタムビヘイビアイベントを作成する

カスタムビヘイビアイベントでは、お客様のビジネスに特化したイベントを定義して追跡することができます。カスタム行動イベントはイベントのプロパティーに関連付けることができ、これをHubSpotのすべてのツールで使用できます。Javascriptコードスニペット」で作成したイベントは、サイトのHubSpotトラッキングコードにイベントデータを自動的に追加するため、Javascriptに詳しい人が設定する必要があります。手動で追跡されたイベントは、アナリティクス APIを使用し、開発者がセットアップする必要があります。 

カスタムビヘイビアイベントツールを使用して、クリックされたエレメントイベントと訪問したURLイベントを作成する方法について説明します。

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

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

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

HubSpotでイベントを作成する

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

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

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

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

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

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

イベント用のプロパティーを作成する：

• プロパティのフィールドタイプをクリックして、プロパティタイプを選択します。次のオプションがあります。 
• カスタム文字列プロパティー：プレーンテキスト文字列であるプロパティーを作成します。 
• カスタムナンバープロパティ：数値の値となるプロパティを作成します。
• カスタムタイムスタンププロパティ：日付の値であるプロパティを作成します。エポック・ミリ秒またはISO8601の形式でデータを送信する必要があります。 
• Custom enumeration property：あらかじめ定義された値のセットを持つプロパティーを作成します。
  
  
• プロパティーを選択したら、右のパネルでプロパティーを設定します：

• • プロパティの名前を入力し、プロパティの説明を入力します。
  • Enumerationプロパティの場合は、「Next」をクリックし、プロパティの「Labels」と「Values」を入力します。データを送る前に、価値観やラベルを設定する必要があります。リストにないデータを送信する前にこの手順が完了していないと、データを利用することができません。複数の値を送信する場合は、セミコロンで区切ってください。
  • ［完了］をクリックします。

• • プロパティーが作成されると、HubSpotのデフォルトイベントプロパティーの下にあるテーブルに表示されます。プロパティーを編集または削除するには、「アクション」ドロップダウンを選択し、「編集」または「削除」を選択します。 
• ［次へ］をクリックします。

• イベントとプロパティーを設定したら、Javascript code snippetを選択してこのイベントをウェブサイトのトラッキングコードに追加するか、Send data to HubSpotを選択してAPI経由でHubSpotにデータを送信することができます。 

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

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

• Javascriptのコードスニペットを選択します。右パネルのスニペットを使用して、HubSpotでイベントを追跡します。作成されたカスタムプロパティーは、コードスニペット内で事前定義されます。 
• 右側のパネルにテキストを入力し、必要に応じてスニペットを修正します。追加したコードは、自動的にHubSpotのトラッキングコードの一部として含まれます。
• 入力が終わったら、「作成」をクリックしてイベントを完成させ、自動的にトラッキングを開始します。
  

データをHubSpotに送信

HubSpotにデータを送信する場合、イベントをトリガーするためのAPIコールを定義する必要があります。API コールの定義方法については、HubSpot の開発者向けドキュメントをご覧ください。

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

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

API経由でデータを送信するイベントの作成を終了します：

• Send data to HubSpotを選択し、Tracking IDをコピーします。
• 作成］をクリックします。

既存のイベントやプロパティー名の内部イベント名を検索する場合：

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

• 更新するプロパティの内部名称を調べるには、プロパティの名称をクリックします。
• 右のパネルで、コードのアイコンをクリックし、「内部名」の下にある名前を表示します。

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

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

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

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

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

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

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

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

• カスタム行動イベントを完了したコンタクトレコードに移動します。
• コンタクトタイムラインを完了したイベントで絞り込むには、「アクティビティーをフィルターリング」をクリックし、「カスタム行動イベント」を選択します。
• コンタクトタイムラインで、イベントをクリックして展開すると、イベントの詳細が表示されます。

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

ワークフローでは、Delay until event happensアクションを使用して、カスタムビヘイビアイベントの完了に基づいて遅延させることができます：

• HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
• ワークフローの名前をクリックします。または、新しいワークフローを作成する方法を学ぶ。
• ワークフローエディターで、＋プラスアイコンをクリックし、ワークフローアクションを追加します。
• 右のパネルで、「イベントが発生するまでの遅延」を選択します。
• 遅延を設定するには、次の手順を実行します。
• ［イベント］ドロップダウンメニューをクリックし、［カスタム行動イベント］を選択します。
• 次に、それに基づいて遅延するイベントのプロパティーを選択します。
• イベントプロパティーのフィルターを選択します。
• ［フィルターを適用］をクリックします。

• 最大待機時間を選択するか、［可能な限り遅延する］チェックボックスをオンにします。
• ［保存］をクリックします。

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