추적 코드: _gaq 전역 객체

_gaq 전역 객체는 push(...) 메서드를 통한 비동기 페이지 추적에 직접 사용할 수 있습니다. 추적기 객체를 생성하는 메서드도 있지만 드물게 사용해야 합니다.

기존 페이지 추적의 경우 _gat 전역 객체를 대신 사용하세요.

_gaq 객체 메서드

메서드 세부정보

_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']);

    이 함수의 이름은 push입니다. 그래야 애널리틱스가 완전히 로드되기 전에 _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 실행에 실패한 명령어 수