Sintaxe
newrelic.interaction().setName(string $name[, string $trigger])Define o nome e o gatilho da interação do browser de um SPA que não é uma alteração de rota ou de URL.
Requisitos
Agente browser Pro+SPA (v963 ou superior)
Se estiver usando o npm para instalar o agente browser, você deverá ativar o recurso
spaao instanciar a classeBrowserAgent. Na matrizfeatures, adicione o seguinte:import { Spa } from '@newrelic/browser-agent/features/spa';const options = {info: { ... },loader_config: { ... },init: { ... },features: [Spa]}Para obter mais informações, consulte a documentação de instalação do browser npm.
Descrição
Este método de monitoramento SPA define o nome e o gatilho de uma interação do browser. O nome será exposto como o atributo browserInteractionName no evento BrowserInteraction . Também será usado para agrupamento na interface.
Por padrão, browserInteractionName recebe o nome de um URL ou rota associada. Use setName() quando quiser registrar uma interação que não seja uma alteração de rota ou de URL.
O método setCurrentRouteName() também nomeia a rota atual. Quando você usa ambos:
setName()tem precedência para nomear a interação.- O atributo
previousRouteNameetargetRouteNameainda são definidos com valores passados parasetCurrentRouteName().
Usar esses métodos juntos permite muitas opções de filtragem e agrupamento na interface. Por exemplo, você pode:
- Filtre até a interação de um determinado tipo, como
LikeButtonClick. - Em seguida, agrupe por
targetRouteNamepara ver quais rotas têm mais interaçãoLikeButtonClick.
Dica
Esta chamada de API se aplica a dados em visualizações de páginas SPA no browser e ao tipo de evento BrowserInteraction . Para definir um nome personalizado para visualizações de página padrão e o tipo de evento PageView , consulte setPageViewName. É recomendado usar as duas chamadas juntas.
Parâmetro
Parâmetro | Descrição |
|---|---|
corda | Obrigatório. Se for nulo, o nome será definido usando o atributo Se não for nulo, isso definirá o atributo |
corda | Opcional. Se não for nulo, isso definirá o atributo |
Valores de retorno
Este método retorna o mesmo objeto de API criado por interaction().
Exemplos
document.getElementById('subscribe').addEventListener('submit', () => { newrelic.interaction().setName('createSubscription'); createSubscription();});