setName (SPA API)

構文

newrelic.interaction().setName(string $name[, string $trigger])

ルート変更やURL変更ではない、SPAのブラウザとの対話の名前とトリガーを設定します。

要件

• ブラウザ Pro+SPA エージェント (v963 以降)

• npm を使用してブラウザ エージェントをインストールしている場合は、 BrowserAgentクラスをインスタンス化するときにspa機能を有効にする必要があります。features配列に以下を追加します。

  import { Spa } from '@newrelic/browser-agent/features/spa';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      Spa
    ]
  }

  コピー

  詳細については、 npm ブラウザのインストールに関するドキュメントを参照してください。

説明

このSPA監視方法は、ブラウザ操作の名前とトリガーを設定します。名前は、 BrowserInteractionイベントでbrowserInteractionName属性として公開されます。 UIでのグループ化にも使用されます。

デフォルトでは、 browserInteractionNameは関連付けられたURLまたはルートにちなんで名付けられています。ルートの変更やURLの変更ではないインタラクションを記録する場合は、 setName()を使用します。

setCurrentRouteName()メソッドは、現在のルートにも名前を付けます。両方を使用する場合：

• setName() インタラクションの命名に優先されます。
• previousRouteName属性とtargetRouteName属性は、 setCurrentRouteName()に渡された値で引き続き設定されます。

これらの方法を併用することで、UIでのフィルタリングやグループ化に多くのオプションが可能になります。例えば、以下のようになります。

• LikeButtonClickなどの特定のタイプのインタラクションにフィルターをかけます。
• 次に、 targetRouteNameでグループ化して、最もLikeButtonClickの相互作用があるルートを確認します。

パラメーター

戻り値

このメソッドは、 interaction()によって作成されたものと同じAPIオブジェクトを返します。

例

document.getElementById('subscribe').addEventListener('submit', () => {
  newrelic.interaction().setName('createSubscription');
  createSubscription();
});