カスタムイベントを作成する
更新日時 2024年 10月 15日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
Marketing Hub Enterprise |
Sales Hub Enterprise |
Service Hub Enterprise |
Operations Hub Enterprise |
Content Hub Enterprise |
カスタム・イベントを使用すると、お客さまのビジネスに固有のイベントを定義し、追跡することができます。カスタムイベントはイベントプロパティーに紐付けることができ、HubSpotのツール全体で使用することができます。
カスタムイベントを作成するには3つの方法があります:
- API経由で送信: Custom event definition endpointを使用してイベントを作成します。そこから、send Custom event endpointでイベントIDを使用し、イベントの完了をHubSpotに送信します。
- APIなしでウェブサイトからデータを取得します:
- コードJavascript:カスタムJavascriptを使用すると、コードエディターを使ってHubSpotトラッキングスクリプトにカスタムコードを挿入できます。
- イベントビジュアライザーの使用 ( Marketing Hub Enterpriseのみ):ページビューやクリックされた要素をウェブサイト上で選択して追跡します。、イベントビジュアル機能でカスタムイベントを作成するの詳細についてはこちらをご覧ください。
- スプレッドシートのインポート:イベントデータのスプレッドシートをアップロードしてオフラインアクティビティーを取り込みしたり、データを埋め戻したり、手動でツールをHubSpotと連携させることができます。
注:カスタムイベントツールは、以前のイベント旧ツールに取って代わります。旧ツールで作成されたイベントは引き続き機能します。また、旧ツールで引き続きこれらのイベントを管理および分析できます。
イベント作成プロセスには、次の2つの過程があります。
- カスタムイベントのプロパティーを含め、HubSpotでイベントを定義する。
- JavaScriptコードスニペットを作成するか、イベントをトリガーするAPI呼び出しを定義する。
API経由でのイベント作成
API経由でHubSpotにデータを送信する場合は、Custom event definition endpointを使用してイベントを作成する必要があります。次に、イベントをトリガーするAPIコールを定義する必要がある。HubSpotの開発者向けドキュメントで、API呼び出しの定義方法を確認してください。
API呼び出しに関するいくつかの情報が必要です。これは、HubSpot内から取得できます。
- イベント名:イベントの内部名。
- プロパティー名:データの送信先であるプロパティーの内部名。
API経由でデータを送信するイベントの作成を完了するには、次の手順に従います。
- [データをHubSpotに送信]を選択して、トラッキングIDをコピーします。
- [作成]をクリックします。
既存のイベントの内部イベント名とプロパティー名を確認するには、次の手順に従います。
- HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
- カスタムイベントをクリックする。
- イベントの名前をクリックします。イベントの詳細ページが表示されます。
- 上部で、内部名の下にあるイベント名を探す。
- 更新するプロパティーの内部名を確認するには、プロパティーの名前をクリックします。
- 右側のパネルで、コードアイコンをクリックして、[内部名]の下にある名前を確認します。
イベントにデータを送信する場合、以下の制限が適用されます:
- プロパティー名は最大50文字までです。
- URLとリファラーのプロパティーは最大1024文字まで、その他のプロパティーは最大256文字までです。
- 各イベント完了には、最大で50個のプロパティーのデータを含めることができます。
- プロパティーの内部名はアルファベットで始まる必要があり、使用できるのは小文字のa~z、数字の0~9、アンダースコアのみです。小文字にした後の内部名が同じプロパティーは重複しているとみなされ、完了時にはどちらか一方のプロパティーのみが使用されます。
Javascriptコードスニペットによるイベントの作成
- HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
- 右上の「イベントを作成」をクリックする。
- 選択コード Javascript .
- [次へ]をクリックします。
- イベント名を入力し、オプションでイベントの説明を入力してください。
- 関連付けられたオブジェクトを選択 .これにより、イベントの完了をHubSpotのさまざまなオブジェクト(「コンタクト」、「会社」、「取引」、「チケット」など)に関連付けることができます。
- [次へ]をクリックします。
プロパティーを追加する
イベントが作成されると、既定のイベントプロパティーが使用可能になります。または、独自のカスタムプロパティーを作成することもできます。イベントのプロパティーは他のCRMプロパティーとは個別に保管され、イベントに固有です(つまり、アカウント設定からこれらのプロパティーを編集することはできません)。
イベントのプロパティーを作成するには、次の手順に従います。
- プロパティーのフィールドタイプをクリックして、プロパティータイプを選択する。次のオプションがあります。
- カスタム文字列プロパティー:プレーンテキスト文字列のプロパティーを作成します。
- カスタム数値プロパティー:数値のプロパティーを作成します。
- カスタム タイムスタンプ プロパティー:日付値のプロパティーを作成します。エポックミリ秒またはISO8601形式でデータを送信する必要があります。
- カスタム列挙プロパティー:定義済みの値を持つプロパティーを作成します。
- プロパティーを選択したら、右側のパネルでプロパティーを設定します。
-
- プロパティーの名前と説明を入力します。
- 「列挙プロパティー」については、[次へ]をクリックしてプロパティーのラベルと値を入力します。データをプロパティーに送信する前に、値とラベルを設定する必要があります。リストにないデータを送信する前にこのステップを完了しないと、そのデータは使用できなくなります。複数の値を送信する場合は、それぞれの値をセミコロンで区切ります。
- [完了]をクリックします。
- 作成されたプロパティーは、「HubSpotの既定のイベントプロパティー」の下の表に表示されます。プロパティーを編集または削除するには、[アクション]ドロップダウンを選択して、[編集]または[削除]を選択します。
- 「次へ」をクリックする。
- イベントとプロパティーを追加設定した後、Javascriptコードスニペットを選択することで、このイベントをウェブサイトのトラッキングコードに追加することができます。
JavaScriptコードスニペットでイベントを作成すると、HubSpotトラッキングコードにJavaScriptを自動的に追加できます。これを使用して、トラッキングコードが既定ではキャプチャーしない、より複雑なイベントデータをキャプチャーすることができます。
- [JavaScriptコードスニペット]を選択します。右側のパネルのスニペットを使用して、HubSpotでイベントをトラッキングします。作成されたカスタムプロパティーは、コードスニペット内で事前定義されます。
- 必要に応じて、右側のパネルにテキストを入力してスニペットを変更します。追加したコードは、HubSpotトラッキングコードの一部として自動的に組み込まれます。
- 終了したら、「」をクリックしてイベントを作成し、自動的にトラッキングを開始します。
イベントデータのインポート
対面イベントの出席データ、HubSpotと連携していないアプリからのタイムスタンプデータ、ベンダーからの1回限りのリードデータやキャンペーンデータ、その他のイベントデータをスプレッドシートフォームでアップロードしましょう。イベントによって行動を把握し、その行動をHubSpot全体で利用することができます。
- HubSpotアカウントにて、[データ管理]>[カスタムイベント]の順に進みます。
- 右上の「イベントを作成」をクリックする。
- インポート・スプレッドシートを選択する。
- [次へ]をクリックします。
- イベント名を入力し、オプションでイベントの説明を入力してください。
- 関連付けられたオブジェクトを選択 .これにより、イベントの完了をHubSpotのさまざまなオブジェクト(「コンタクト」、「会社」、「取引」、「チケット」など)に関連付けることができます。
- ファイル選択セクションにファイルをドラッグ&ドロップするか、ファイル選択をクリックしてコンピューターからのファイルをアップロードします。ファイルをアップロードする場合は、以下の項目を必ず入力してください:
-
- Eメールアドレス.
- 発生時刻。、インポートファイルの日付プロパティーの形式について詳しくはこちら。
- ファイルタイプはcsv、.xlsx、.xlsのいずれかに限ります。
- 100万行まで。
- 今のところ、インポートで作成されたイベントは[コンタクト]にのみ関連付けすることができます。
- イベントはc コンタクトレコードの作成と更新を行います。Tインポートにより、新規レコードやアクティビティーが作成されるだけでなく、既存のレコードがID化され、更新されます。新規レコードまたはアクティビティーを作成するには、そのコンタクトに必要なプロパティーがファイルに含まれている必要があります。既存のレコードを更新するには、ファイルに固有IDを含める必要があります。
- イベントのインポートは、すでに発生したイベントに使用されるべきで、将来の日付のイベントはサポートされていません。
- ドロップダウンメニューをクリックして、列見出しの言語を選択します。
- [次へ]をクリックします。
- ファイルの列をHubSpotプロパティーにマッピング画面で、HubSpotはヘッダー、ヘッダー言語、プロパティー名に基づいて、ファイルの列をコンタクトやイベントのプロパティーにマッピングします。
- マッピングガイドには、コンタクトやイベントを作成・更新するために必要なプロパティーが表示されます。インポートの目標を完了するために必要なプロパティーがファイルに欠けている場合は、インポートファイルを修正し、エラーを避けるためにインポートを再開する必要があります。
- スプレッドシートの列をコンタクトプロパティーまたはイベントプロパティーにマッピングすることができます。次の形式としてインポートドロップダウンメニューをクリックして、ファイルのデータのインポート方法を選択します。次に、マッピングするHubSpotプロパティーを選択します。既存のプロパティーにマッピングすることも、新規プロパティーを作成することもできます。
- [次へ]をクリックします。
- インポートファイル名を確認してください。
- ][]チェックボックスをクリックして、コンタクトがあなたからの連絡を期待していること、およびインポートファイルに購入済みリストが含まれていないことに同意します。HubSpotの利用規約について詳しくはこちら .
- ドロップダウンメニューをクリックして、「発生時刻」プロパティーの日付形式を選択します。
- [インポート完了]をクリックします。
カスタムイベントデータの使用
カスタムイベントデータはHubSpotのツール全体で表示、使用できます。イベントの完了を確認する場所と、イベントデータを他のツールに取り込む方法について、以下で説明します。
選択したイベントは、イベントリストのアクションドロップダウン、単一イベント表示、または分析タブのチャートの右上隅から、選択したHubSpotツールで直接開くことができます。
カスタムイベントについて報告する
カスタムイベントの完了はカスタムイベントツールから分析でき、イベントデータはカスタム レポート ビルダーとアトリビューションレポートでも使用可能です。
コンタクトタイムラインでイベントの完了を表示する
イベントの完了は、取り込まれたすべてのプロパティーとともに、コンタクトレコードのタイムラインに表示されます。
コンタクトタイムラインでイベントの詳細を表示するには、次の手順を実行します。
- カスタムイベントが完了したコンタクトレコードに移動します。
- 完了したイベントでコンタクトタイムラインを絞り込むには、[アクティビティーを絞り込み]をクリックし、[カスタムイベント]を選択します。
- コンタクトタイムラインで、イベントをクリックして展開し、イベントの詳細を表示します。
ワークフローでカスタムイベントを使用箇所
ワークフローに登録すると、イベントの発生まで遅延アクションまたはイベント登録トリガーを使用して、カスタムイベントの完了に基づいて遅延させることができます。
- HubSpotのアカウントにて、[自動化]>[ワークフロー]の順に進みます。
- ワークフローの名前をクリックします。または、新規ワークフローを作成する方法をご覧ください。
- トリガーを追加する:
- ワークフローエディターで、[トリガーを設定]をクリックします。
- 左のパネルで、[イベント発生時]を選択します。条件を設定し、[フィルターを適用]をクリックします。
- トリガーをさらに絞り込むには、「絞り込みフィルターを追加」をクリックします。ワークフローに登録したいオブジェクトを絞り込むために、プロパティーを追加選択することができます。
- 既定では、レコードは初めて登録トリガーを満たした場合にだけワークフローに登録されます。再登録を有効にするには、[このワークフローにオブジェクトを再登録しますか?]セクションで、[はい、トリガーが発生するたびに登録を行います」を選択します。
- 遅延を追加する:
- ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
- 右側のパネルで、[イベントの発生まで遅延]を選択します。
- 遅延を設定するには、次の手順を実行します。
- イベントドロップダウンメニューをクリックし、カスタムイベントを選択します。
- 次に、それに基づいて遅延するイベントのプロパティーを選択します。
- イベントプロパティーのフィルターを選択します。
- [フィルターを適用]をクリックします。
-
- 最大待機時間を選択するか、[可能な限り遅延する]チェックボックスをオンにします。
- [保存]をクリックします。
注:全てのイベント登録トリガーはOR演算子で区切られます。つまり、レコードがワークフローに登録されるためには、イベント登録トリガーが1つだけ発生する必要があります。
ワークフローの[レコード]は、登録されたレコードが指定されたカスタムイベント条件を満たすまで遅延されるか、イベントが発生したときにトリガーされます。