_gaq
전역 객체는 push(...)
메서드를 통한 비동기 페이지 추적에 직접 사용할 수 있습니다. 추적기 객체를 생성하는 메서드도 있지만 드물게 사용해야 합니다.
기존 페이지 추적의 경우 _gat
전역 객체를 대신 사용하세요.
_gaq 객체 메서드
_createAsyncTracker(accountId, opt_name)
지원 중단됨_getAsyncTracker(opt_name)
지원 중단됨push(commandArray)
메서드 세부정보
_createAsyncTracker()
_createAsyncTracker(accountId, opt_name)
-
비동기 추적을 호출할 때 이름으로 참조할 수 있는 추적기 객체를 만듭니다. 이름을 지정하지 않으면 비동기 구문의
기본 추적기를 나타내는 빈 문자열
''
가
됩니다.
특정 이름의 비동기 추적기가 이미 있는 경우 새 추적기로 덮어씁니다.참고: 이 메서드는 일반적으로
_gaq
로 푸시된 함수 내에서만 안전하게 사용할 수 있습니다. 드물게만 사용해야 합니다.
_gaq._createAsyncTracker('UA-65432-1');
매개변수
String accountId
추적기 객체의 전체 웹 속성 ID (예: UA-65432-1)입니다.
String opt_name
추적기 객체를 저장할 이름입니다. 나중에 비동기 추적 호출에서 추적기 객체를 참조하려면 이 이름을 사용합니다.
returns
Tracker
생성된 추적 객체입니다._getAsyncTracker()
_getAsyncTracker(opt_name)
-
이전에 지정된 이름으로 만든 추적기 객체를 반환합니다.
이름을 지정하지 않으면 기본 추적기 이름 (빈 문자열
''
)이 사용됩니다. 지정된 이름의 추적기 객체가 없으면 새 추적기가 생성되고 해당 이름에 할당되어 반환됩니다.참고: 이 메서드는 일반적으로
_gaq
로 푸시된 함수 내에서만 안전하게 사용할 수 있습니다. 드물게만 사용해야 합니다.
_gaq._getAsyncTracker();
매개변수
String opt_name
검색할 추적기 객체의 이름입니다.
returns
Tracker
검색 또는 생성된 추적 객체입니다.push
push(commandArray)
-
다음 형식을 준수하는 간단한 JavaScript 배열인 지정된
command array
를 실행합니다. 배열의 첫 번째 요소는 문자열로 전달된 추적기 객체 메서드의 이름이어야 합니다. 나머지 배열 요소는 함수에 인수로 전달되는 값입니다.일반적인 사용법은 다음과 같습니다.
var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-65432-1']); _gaq.push(['_trackPageview']);
이 함수의 이름은
_gaq
대신 배열을 사용할 수 있습니다. 애널리틱스가 로드되는 동안 명령어가 배열로 푸시되거나 큐에 추가됩니다. 애널리틱스는 로드가 완료되면 배열을 _gaq
객체로 바꾸고 큐에 추가된 모든 명령어를 실행합니다. 후속 _gaq.push
호출은 이 함수로 확인되고, 이 함수는 푸시될 때 명령어를 실행합니다.메서드 이름 앞에 추적기 이름 앞에 점과 추적기 이름을 추가하여 추적기의 이름을 지정할 수 있습니다. 함수 이름이 추적기 이름으로 정규화된 경우 해당 추적기에서 실행됩니다.
다음 예에서는 myTracker라는 임의의 추적기를 만들고 사용합니다.
var _gaq = _gaq || []; _gaq.push(['myTracker._setAccount', 'UA-65432-2']); _gaq.push(['myTracker._setDomainName', 'foo.com']); _gaq.push(['myTracker._trackPageview']);
참고: 추적기는 명령어가 처음 참조할 때 생성됩니다. 기본 추적기는 추적기의 이름을 명시적으로 지정하지 않은 첫 번째 명령어를 통해 생성됩니다. 기본 추적기의 이름은 빈 문자열
''
입니다.명령어 배열을 푸시하는 것 외에 함수 객체도 푸시할 수 있습니다. 이는 값을 반환하는 추적기 메서드에 특히 유용합니다. 이러한 함수는
_gat
와 _gaq
를 모두 참조할 수 있습니다.var _gaq = _gaq || []; _gaq.push(function() { var tracker = _gat._getTracker('UA-65432-1'); tracker._trackPageview(); });
페이지의 HTML에서 직접 푸시 구문을 사용할 수도 있습니다.
onclick="_gaq.push(['_trackEvent', 'name', value]);"
비동기 애널리틱스 스니펫이 링크 위에 있으면 클릭 시점에 애널리틱스가 완전히 로드되지 않았더라도 오류 없이 클릭수가 캡처됩니다. 이는 비동기 추적의 여러 이점 중 하나입니다.
마지막으로, 각 명령어 배열에 _gaq.push(...)
를 입력하는 대신 모든 명령어를 한 번에 푸시할 수 있습니다. 다음 코드는 이 기법을 보여줍니다.
자세한 내용은 비동기 스니펫 사용 가이드를 참조하세요.
_gaq.push( ['_setAccount', 'UA-XXXXX-X'], ['_setDomainName', 'example.com'], ['_setCustomVar', 1, 'Section', 'Life & Style', 3], ['_trackPageview'] );
매개변수
Array commandArray
실행할 명령어입니다. 이들 중 하나 이상을 동일한 호출에서 푸시할 수 있습니다.
returns
Number
실행에 실패한 명령어 수