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

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

イベント 使用可能な変数
render formName、formTitle、formInstance、source
abandon formNam、formTitle、formInstance、source
保存 formName、formTitle、formInstance、panelName、source
submit formName、formTitle、formInstance、source
エラー formName、formTitle、fieldName、fieldTitle、panelTitle
help formName、formTitle、fieldName、fieldTitle、panelTitle
fieldVisit formName、formTitle、fieldName、fieldTitle、panelTitle
panelVisit formName、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にトリガされます。 そうすることで、そのドキュメントまたはフォームがアクティブであることを確認し、対応するフォームまたはドキュメントでの滞在時間を計算できます。

メモ

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

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

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free