통사론
newrelic.addPageAction(string $name[, JSON object $attributes])이름 및 선택적 속성과 함께 브라우저 PageAction 이벤트를 보고합니다.
요구 사항
Browser Pro 또는 Pro+SPA 에이전트(v593 이상)
npm을 사용하여 브라우저 에이전트를 설치하는 경우
BrowserAgent클래스를 인스턴스화할 때generic_events기능을 활성화해야 합니다.features배열에 다음을 추가합니다.import { GenericEvents } from '@newrelic/browser-agent/features/generic_events';const options = {info: { ... },loader_config: { ... },init: { ... },features: [GenericEvents]}자세한 내용은 npm 브라우저 설치 설명서를 참조하세요.
설명
이 API 호출은 사용자 정의 이름과 선택적 속성,그리고 몇 가지 기본 속성을 대시보드 에 포함하는 브라우저 PageAction 이벤트를 전송합니다. 이것은 브라우저 에이전트가 자동으로 추적하지 않는 이벤트(예: Subscribe 버튼 클릭이나 튜토리얼 액세스)를 추적하는 데 유용합니다.
PageAction이벤트는 30초마다 전송됩니다.- 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다.
중요
이전 에이전트 버전에서는 이벤트가 120개 관찰된 후에 삭제되었습니다. 버전 1.264.0 에서는 이벤트 제한이 120에서 1,000으로 늘어났으며 더 이상 삭제되지 않습니다.
매개변수
매개변수 | 설명 |
|---|---|
끈 | 필수의. 작업의 이름 또는 범주입니다. 속성이나 값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오. |
JSON 객체 | 선택 과목. 하나 이상의 키/값 쌍이 있는 JSON 객체. 예: 속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오. |
예
링크 클릭 기록(JavaScript)
이 예제에서는 사용자가 Try Me 링크를 선택할 때마다 PageAction 이벤트를 기록합니다. 이벤트는 clickedTryMe 의 actionName 로 기록되었습니다.
<a href="/demo" id="try-me">Try Me!</a><script> document.getElementById('try-me').addEventListener('click', function (e) { newrelic.addPageAction('clickedTryMe'); });</script>그러면 다음 NRQL 쿼리를 사용하여 Try Me 버튼이 클릭된 횟수를 쿼리할 수 있습니다.
SELECT count(*) FROM PageAction WHERE actionName = 'clickedTryMe' SINCE 1 hour ago링크 클릭 기록(jQuery)
이 예는 사용자가 클래스가 copy-text 인 요소를 클릭할 때 PageAction 이벤트를 보냅니다. actionName 은 copy-text-button 이고 값은 결과를 처리하는 success 및 error 라는 메서드에 해당하는 Result 이라는 다른 속성으로 보고됩니다.
$('.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' }); } });});그런 다음 쿼리 작성기에서 파이 차트를 만들어 지난 30일 동안 성공과 오류로 이어진 버튼 클릭 수를 분석할 수 있습니다.
SELECT count(*) AS 'Clicks' FROM PageAction WHERE actionName = 'copy-text-button' FACET result SINCE 30 days ago또는 쿼리를 만들어 지난 30일 동안 가장 많은 복사 버튼 클릭이 발생한 페이지를 확인할 수 있습니다.
SELECT count(*) AS 'Clicks' FROM PageAction WHERE actionName = 'copy-text-button' FACET currentUrl SINCE 30 days ago캡처 양식 입력
이 예제에서는 Signup 이라는 양식에서 사용자 입력(이메일 주소)을 캡처합니다. 이벤트는 userSignup 의 actionName 로 기록되었습니다.
<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>그러면 다음 NRQL 쿼리로 수집한 이메일을 볼 수 있습니다.
SELECT uniques(email) FROM PageAction WHERE actionName = 'userSignup' SINCE 1 hour ago