プロパティー変更イベントを作成する

オブジェクト値の変更をトラッキングして、リスト、ワークフロー、レポートでデータを使用します。これは、レコード検証の追跡など、監査証跡を作成する場合に便利です。

例えば、コンタクトを営業担当に割り当てする前に「確認」する必要があるCRMを維持しているとします。is_verified プロパティーをトラッキングすれば、手動でデータ入力しなくても、誰がいつレコードを確認したかを自動的に取得できます。

要件と制限

プロパティー変更イベントを作成する際には、以下の制限が適用されます。

• アカウントごとに最大25個のプロパティー変更イベントを作成できます。
• プロパティー変更イベントは、1か月あたり合計イベント発生制限である3,000万件にカウントされます。
• プロパティー変更イベントは、30M の制限に達すると回復できなくなります。

プロパティー変更イベントを作成する

プロパティー変更イベントは、プロパティー設定またはカスタムイベントを使用して作成できます。

プロパティー設定

1. HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。
2. 左側のサイドバーで、[プロパティー]に移動します。
3. [オブジェクトを選択 ]ドロップダウンメニューをクリックし、[ [オブジェクト]プロパティー を選択して、そのオブジェクトのプロパティーの変更をトラッキングします。
4. 左上のドロップダウンメニューを使用して、プロパティーグループ( is_verifiedなど)、フィールドタイプ、またはプロパティーを作成したユーザーによって絞り込みます。または、検索ボックスにプロパティーの名前を入力して、特定のプロパティーを検索します。

5. プロパティーの上にマウスポインターを置き、[続き]をクリックします。次に、[変更を追跡]を選択します。
   
   
   
6. 演算子を選択します。演算子は、プロパティー値の変更を追跡するタイミングを決定します。プロパティーと演算子を選択すると、プロパティーが毎月更新される頻度に関する情報が表示されます。全てのプロパティー変更イベントは、月間イベント発生制限にカウントされます。
7. イベントの作成」をクリックします。

カスタムイベント

1. HubSpotアカウントにて、［データ管理］＞［イベント管理］の順に進みます。
2. 右上の[イベントを作成]をクリックし、[カスタムイベントを作成]をクリックします。
3. [オブジェクトの変更を追跡] を選択します。
4. ［次へ］をクリックします。
5. ドロップダウンメニューをクリックして、トラッキングするオブジェクトと オブジェクトプロパティー を選択します。プロパティー値が変更されると、変更イベントがトリガーされます。

6. 演算子を選択します。演算子は、プロパティー値の変更を追跡するタイミングを決定します。プロパティーと演算子を選択すると、プロパティーが毎月更新される頻度に関する情報が表示されます。全てのプロパティー変更イベントは、月間イベント発生制限にカウントされます。
7. ［次へ］をクリックします。
8. 任意で 、[イベント名]と[説明 ]を入力します。 
9. イベントに対してデフォルトのイベントプロパティーが作成されます。

使用例:プロパティー変更イベントの実装

is_verifiedのプロパティー変更イベントを作成したら、エディターの詳細をスタンプする「コーディング不要のメソッド」または「カスタムコーディングのメソッド」のどちらかを選択できます。

ノーコード方式

イベントを作成した後:

1. HubSpotアカウントにて、［データ管理］＞［イベント管理］の順に進みます。
2. イベントの上にカーソルを置きます。[アクション]をクリックし、[ 次で使用]を選択します。ドロップダウンメニューから [レポート]を選択します。HubSpotでは以下を自動的に取得します。
   • タイムスタンプ: 値が変更された日時
   • イニシエーター: 変更を行った特定のユーザーまたは連携。

カスタムコーディング方式

外部連携で使用するためにエディターの名前を コンタクト レコードに直接保存する必要がある場合は、ワークフローでカスタム コード アクションを使用します。

1. タイムスタンププロパティーを変換する:HubSpotの標準の日付プロパティーでは、深夜0時のタイムスタンプのみがサポートされます。正確な分/秒数をサポートするには、APIを使用して verified_at プロパティーを更新します。

2. ワークフローコードの使用: is_verified の変更時にコンタクトを登録します。このスクリプトを使用して、プロパティー履歴から updatedByUserId を取得し、 verified_by_owner_idスタンプを付けます。

プロパティー変更イベントデータの使用

プロパティー変更イベントが作成された後に生成される既定のプロパティーは、 リスト、 ワークフロー、レポートで使用できます。 

1. HubSpotアカウントにて、［データ管理］＞［イベント管理］の順に進みます。
2. イベントの上にマウスポインターを置き、[アクション]をクリックします。次に、[次で使用]を選択します。オプションから、イベントデータを使用するツールを選択します。

3. 設定を行える選択したツールにリダイレクトされます。