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

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

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に対してトリガーされます。 そうすることで、そのドキュメントまたはフォームがアクティブであることを確認し、対応するフォームまたはドキュメントでの滞在時間を計算できます。

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