フォームのイベント追跡のカスタマイズ

最終更新日： 2024年7月15日
  • トピック：

作成対象：

  • ユーザー
  • 開発者

Analytics が有効になっているアダプティブフォームでは次のイベントがデフォルトで追跡されます。

イベント使用可能な変数
renderformName、formTitle、formInstance、source
abandonformName、formTitle、formInstance、panelName、panelTitle
保存formName、formTitle、formInstance、panelName、source
submitformName、formTitle、formInstance、source
エラーformName、formTitle、fieldName、fieldTitle、panelTitle
helpformName、formTitle、fieldName、fieldTitle、panelTitle
fieldVisitformName、formTitle、fieldName、fieldTitle、panelTitle
panelVisitformName、formTitle、panelName、panelTitle

fieldVisit イベントのタイムアウトのカスタマイズ

AEM Forms のデフォルト設定では、ユーザーが 60 秒以上フィールドにとどまると、fieldvisit イベントがトリガーされ、フィールドの詳細が Adobe Analytics に送信されます。AEM Configuration コンソール（/system/console/configMgr）で、AEM Forms Analytics Configuration の下にある Field time tracking baseline をカスタマイズすると、タイムアウト制限を調整できます。

追跡イベントのカスタマイズ

/libs/afanalytics/js/custom.js ファイルの trackEvent 関数を変更すると、イベント追跡をカスタマイズできます。アダプティブフォームで追跡中のイベントが発生すると、trackEvent 関数が呼び出されます。trackEvent 関数は 2 つのパラメーター（eventName および variableValueMap）を受け取ります。

eventName および variableValueMap 引数の値を評価して、イベントの追跡動作を変更できます。例えば、ある一定数のイベントが発生した場合、Analytics サーバーに情報を送信するように指定できます。また、次のカスタマイズを実行できます。

  • イベントが送信されるまでのしきい値を設定できます。

  • アクションを決定する状態を維持できます。例えば、fieldVisit は、最後のイベントのタイムスタンプに基づいてダミーのイベントをプッシュします。

  • pushEvent 関数を使用して Analytics サーバーにイベントを送信できます​ 。

  • Analytics サーバーにイベントを一切プッシュしないようにすることもできます。

サンプル

以下の例では、各 fieldName 属性の error イベントの状態が維持されています。エラーが再発した場合にのみ、Analytics サーバーにイベントが送信されます。

case 'error':
        if(errorOccurred[variableValueMap.fieldName] == true) {
            pushEvent(eventName, variableValueMap)
        }
        errorOccurred[variableValueMap.fieldName] = true;
        break;

panelVisit イベントのカスタマイズ

デフォルトの AEM Forms 設定では、60 秒ごとに、アダプティブフォームを含むウィンドウがアクティブになっているかどうかがチェックされます。ウィンドウがアクティブであれば、panelVisit イベントが Adobe Analytics に対してトリガされます。そうすることで、そのドキュメントまたはフォームがアクティブであることを確認し、対応するフォームまたはドキュメントでの滞在時間を計算できます。

NOTE
アクティビティの確認と滞在時間の計算に使用されるイベント名は、"panelVisit" です。このイベントは、上記の表に記載されているパネル訪問イベントとは異なります。

/libs/afanalytics/js/custom.js ファイルで提供されている scheduleHeartBeatCheck 関数を変更して、定期的に Adobe Analytics に送信されるこのイベントを変更または停止できます。

前のページカスタムツールバーアクションの作成
次のページアダプティブフォームフィールドのカスタム外観の作成

Experience Manager