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
spa
ao 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
previousRouteName
etargetRouteName
ainda 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
targetRouteName
para 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();});