addPageAction

Sintaxe

newrelic.addPageAction(string $name[, JSON object $attributes])

Relata um evento PageAction do browser junto com um nome e um atributo opcional.

Requisitos

• Browser Pro ou agente Pro+SPA (v593 ou superior)

• Se estiver usando o npm para instalar o agente browser, você deverá ativar o recurso page_action ao instanciar a classe BrowserAgent . Na matriz features , adicione o seguinte:

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

  Copiar

  Para obter mais informações, consulte a documentação de instalação do browser npm.

Descrição

Esta chamada de API envia um eventoPageAction do browser com seu nome definido pelo usuário e um atributo opcional para o dashboard, junto com vários atributo padrão. Isso é útil para rastrear qualquer evento que ainda não tenha sido rastreado automaticamente pelo agente browser, como clicar em um botão Subscribe ou acessar um tutorial.

• PageAction evento são enviados a cada 30 segundos, com no máximo 120 eventos por ciclo de coleta de 30 segundos, por browser.
• Depois que o limite de 120 eventos for atingido, eventos adicionais não serão capturados para esse ciclo de coleta.

Parâmetro

Exemplos

Registrar cliques em links (JavaScript)

Este exemplo registra um evento PageAction sempre que um usuário seleciona o link Try Me . O evento é registrado com um actionName de clickedTryMe:

<a href="/demo" id="try-me">Try Me!</a>
<script>
  document.getElementById('try-me').addEventListener('click', function (e) {
    newrelic.addPageAction('clickedTryMe');
  });
</script>

Você pode então consultar o número de vezes que o botão Try Me foi clicado com a seguinte consulta NRQL:

SELECT count(*) FROM PageAction WHERE actionName = 'clickedTryMe' SINCE 1 hour ago

Registrar cliques em links (jQuery)

Este exemplo envia um evento PageAction quando um usuário clica em um elemento com a classe copy-text. O actionName é copy-text-button e o valor é relatado como outro atributo chamado Result que corresponde aos métodos chamados success e error que tratam do resultado.

$('.copy-text').click(function() {
    var clipboard = new Clipboard('.copy-text');
    clipboard.on('success', function(event) {
        // Do stuff
        // Report data to New Relic
        if (typeof newrelic == 'object') {
            newrelic.addPageAction('copy-text-button', { result: 'success' });
        }
    });
    clipboard.on('error', function(event) {
        // Do stuff
        // Report data to New Relic
        if (typeof newrelic == 'object') {
            newrelic.addPageAction('copy-text-button', { result: 'error' });
        }
    });
});

Em seguida, no criador de consulta, você pode criar um gráfico de pizza para ver o detalhamento de quantos cliques em botões resultaram em sucesso versus erro nos últimos 30 dias:

SELECT count(*) AS 'Clicks' FROM PageAction WHERE actionName = 'copy-text-button' FACET result SINCE 30 days ago

Ou você pode criar uma consulta para ver quais páginas tiveram mais cliques no botão copiar nos últimos 30 dias:

SELECT count(*) AS 'Clicks' FROM PageAction WHERE actionName = 'copy-text-button' FACET currentUrl SINCE 30 days ago

Capturar entrada do formulário

Este exemplo captura a entrada do usuário (endereços de e-mail) de um formulário chamado Signup. O evento é registrado com um actionName de userSignup:

<form action="/signup" id="myform">
  <input id="email" name="email" />
  <input type="submit" value="Signup" />
</form>
<script type="text/javascript">
  document.getElementById('myform').addEventListener('submit', function (e) {
    var email = e.target.elements['email'].value;
    newrelic.addPageAction('userSignup', { email: email });
  });
</script>

Você pode então ver os e-mails coletados com a seguinte consulta NRQL:

SELECT uniques(email) FROM PageAction WHERE actionName = 'userSignup' SINCE 1 hour ago