추적 코드: 기본 구성

이 참조 페이지에서는 Google 애널리틱스 보고의 모든 측면을 맞춤설정하는 데 사용하는 메서드를 설명합니다.

ga.js 기본 메서드

메서드 세부정보

_deleteCustomVar()

_deleteCustomVar(index)

이 방법은 제공된 색인에 할당된 변수를 삭제합니다(존재하는 경우). 예를 들어 방문자 수준 맞춤 변수를 설정한 후 나중에 이 방문자 수준 변수를 더 이상 사용하지 않기로 결정할 수 있습니다.

비동기 스니펫 (권장)

_gaq.push(['_deleteCustomVar', 1]);

매개변수

Int   index: 삭제할 맞춤 변수의 색인입니다.

_getName()

_getName()

추적기가 생성되었을 때 제공된 이름을 반환합니다.

비동기 스니펫 (권장)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

returns

String: 추적기의 이름입니다.

_getAccount()

_getAccount()

이 추적기 객체의 Google 애널리틱스 ID를 반환합니다. 여러 계정으로 웹사이트의 페이지를 추적하는 경우 이 방법을 사용하여 특정 추적기 객체에 연결된 계정을 확인할 수 있습니다.

비동기 스니펫 (권장) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

returns

String 이 추적기 객체를 인스턴스화하는 계정 ID입니다.

_getVersion()

_getVersion()

GATC 버전 번호를 반환합니다.

비동기 스니펫 (권장) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

returns

String GATC 버전 번호

_getVisitorCustomVar()

_getVisitorCustomVar(index)

지정된 색인에 대해 할당된 방문자 수준 맞춤 변수 값을 반환합니다.

비동기 스니펫 (권장) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

매개변수

Int   index 방문자 수준 맞춤 변수의 색인입니다.

returns

String: 방문자 수준 맞춤 변수의 값입니다. 지정된 색인의 변수를 가져올 수 없는 경우 정의되지 않은 항목을 반환합니다.

_initData()는

_initData()지원 중단되었습니다. 이제 initData()가 ga.js 추적 코드에서 자동으로 실행됩니다.

GATC (Google 애널리틱스 추적 코드) 객체를 초기화하거나 다시 초기화합니다.

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

비동기 추적에서만 사용됩니다. 추적 객체의 웹 속성 ID를 설정합니다.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

매개변수

String accountID: 추적기 객체의 전체 웹 속성 ID (예: UA-65432-1)

_setCookiePersistence()

_setCookiePersistence(milliseconds)

이 메서드는 지원 중단되었습니다. 대신 _setVisitorCookieTimeout(cookieTimeoutMillis)를 사용하세요.

Google 애널리틱스 방문자 쿠키 만료 시간을 밀리초 단위로 설정합니다. 기본적으로 방문자 쿠키는 2년 후에 만료되도록 설정되어 있습니다. 원하는 경우 이 메서드를 사용하여 방문자 쿠키의 만료일을 변경할 수 있습니다. 예를 들어 방문자 쿠키의 만료 시간을 7일로 설정하려면 다음 코드를 사용합니다.

pageTracker._setCookiePersistence(604800000);

매개변수

Number   milliseconds 새 방문자 쿠키 만료 시간

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

변수에 제공된 이름, 값, 범위를 사용하여 맞춤 변수를 설정합니다. name과 value를 합쳐 128바이트 글자 수 제한이 있습니다.

비동기 스니펫 (권장) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

returns

Boolean 이 메서드는 맞춤 변수가 설정된 경우 true을 반환하고 그렇지 않으면 false를 반환합니다 (예: 이름/값 문자열 길이가 128바이트를 초과하거나 잘못된 슬롯을 사용한 경우).

매개변수

Int      index       필수사항. 맞춤 변수에 사용되는 슬롯입니다. 가능한 값은 1-5(양 끝값 포함)입니다.

String   name        필수사항. 맞춤 변수의 이름입니다.

String   value       필수사항. 맞춤 변수의 값입니다.

Int      opt_scope   선택사항. 맞춤 변수에 사용되는 범위입니다. 가능한 값은 방문자 수준의 경우 1, 세션 수준의 경우 2, 페이지 수준의 경우 3입니다.

_setSampleRate()

_setSampleRate(newRate)

새 샘플링 레이트를 설정합니다. 웹사이트가 매우 크고 트래픽이 급증하는 경우 샘플링 레이트를 설정하면 보고서 추적이 중단되지 않습니다. Google 웹로그 분석의 샘플링은 순 방문자를 대상으로 일관되게 이루어지므로 샘플링을 사용 설정한 경우에도 샘플링을 시작할 때 설정된 순 방문자는 샘플에 포함되거나 제외된 상태로 유지되므로 동향 및 보고서에서 무결성이 유지됩니다.

이 메서드는 _setAccount() 호출과 동시에 지정하면 됩니다. 일반적으로 페이지 또는 애플리케이션당 한 번씩만 지정하면 됩니다 (추적 코드 자체를 초기화할 때마다). 지정한 샘플링 레이트 값은 추적 객체 자체가 존재하는 한 계속 적용됩니다.

비동기 스니펫 (권장) 

_gaq.push(['_setSampleRate', '2.5']);

매개변수

String newRate 설정할 새 샘플링 레이트입니다. 0에서 100 사이의 숫자 문자열 (소수점 이하 두 자리까지 정밀함)을 제공합니다.

_setSessionTimeout()

_setSessionTimeout(newTimeout)

이 메서드는 지원 중단되었습니다. 대신 _setSessionCookieTimeout(cookieTimeoutMillis)를 사용하세요.

새 세션의 제한 시간을 초 단위로 설정합니다. 기본적으로 세션 제한 시간은 30분 (1, 800초)으로 설정됩니다. 세션 시간 제한은 방문수를 계산하는 데 사용됩니다(애널리틱스에서 세션을 정의하는 방법 참고). 특정 요구사항에 맞게 '세션'의 정의를 변경하려는 경우 초 단위로 새 값을 정의하면 됩니다. 이는 방문수가 계산되고 다른 값을 계산하는 데 방문이 사용되는 모든 섹션의 방문 보고서에 영향을 미칩니다. 예를 들어 일반적으로 세션 시간 제한을 줄이면 방문수가 증가하고 세션 제한 시간을 늘리면 감소합니다.

매개변수

String newTimeout 새 세션 제한 시간을 초 단위로 설정합니다.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

새 세션 쿠키 제한 시간을 밀리초 단위로 설정합니다. 기본적으로 세션 제한 시간은 30분으로 설정됩니다. 브라우저 활동이 멈춘 후 30분 동안 또는 브라우저가 종료될 때 방문이 종료되므로 세션 시간 제한은 방문수를 계산하는 데 사용됩니다. 특정 요구사항에 맞게 '세션'의 정의를 변경하려는 경우, 밀리초를 전달하여 새 값을 정의할 수 있습니다. 이는 방문수가 계산되고 다른 값을 계산하는 데 방문이 사용되는 모든 섹션의 방문수 보고서에 영향을 미칩니다. 예를 들어 세션 시간 제한을 줄이면 방문수가 증가하고 세션 시간 제한을 늘리면 방문수가 줄어듭니다. 만료 시간 제한을 0으로 변경하여 브라우저를 닫을 때 이 쿠키가 삭제되도록 할 수 있습니다.

비동기 스니펫 (권장) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


매개변수

Number cookieTimeoutMillis 새 세션 제한 시간(밀리초) 또는 0(브라우저가 닫힐 때 쿠키 삭제 시)입니다.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

사이트 속도 데이터 수집을 위한 새 샘플 세트 크기를 정의합니다. 기본적으로 사이트 방문자의 1% 고정 샘플링이 사이트 속도 측정항목을 도출하는 데이터 풀을 구성합니다. 사이트의 일일 방문자 수가 상대적으로 적은 경우(예: 100,000명 이하) 샘플링을 더 큰 비율로 조정하는 것이 좋습니다. 이렇게 하면 페이지 로드 시간 및 기타 사이트 속도 측정항목을 더욱 상세하게 확인할 수 있습니다. 사이트 속도 보고서에 대한 자세한 내용은 고객센터의 사이트 속도를 참고하세요.

_setSiteSpeedSampleRate() 메서드를 _trackPageview() 전에 호출해야 효과가 있습니다.

애널리틱스에서는 이 기능에 대한 시스템 리소스의 균등한 분배를 보장하기 위해 단일 속성의 사이트 속도 수집 조회수를 사용자 1% 또는 일일 조회수 10,000회 중 더 큰 값으로 제한합니다.

참고: 일일 조회수가 100만 회를 초과하는 사이트는 샘플 선택을 기본값인 1% 로 설정하는 것이 좋습니다. 샘플 크기를 더 큰 수로 조정해도 샘플 크기는 늘어나지 않습니다.

비동기 스니펫 (권장) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

매개변수

Number sampleRate 0~100 사이의 값으로 사이트 속도를 높이기 위해 사이트 방문자의 비율을 측정합니다. 예를 들어 값이 5이면 사이트 속도 수집 샘플이 5%로 설정됩니다.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Google 애널리틱스 방문자 쿠키 만료 시간을 밀리초 단위로 설정합니다. 방문자 쿠키는 기본적으로 2년 후에 만료되도록 설정되어 있습니다. 원하는 경우 이 방법을 사용하여 방문자 쿠키의 만료일을 변경할 수 있습니다. 만료 시간 제한을 0으로 변경하여 브라우저가 닫힐 때 이 쿠키가 삭제되도록 할 수 있습니다.

비동기 스니펫 (권장) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

매개변수

Number cookieTimeoutMillis 새 방문자 쿠키 만료 시간(밀리초) 또는 브라우저가 닫힐 때 쿠키를 삭제하려면 0입니다.

_setVar()

_setVar(newVal)

이 메서드는 지원 중단되었습니다. 대신 _setCustomVar()를 사용하세요.

제공된 문자열로 맞춤 방문자 세그먼트를 설정하거나 정의합니다. 이 값을 사용하여 웹사이트 사용자를 추가로 세분화할 수 있습니다. 예를 들어 로그인 페이지 또는 방문자의 입력(예: 방문자가 선택한 환경설정, 개인 정보 보호 옵션)에 따라 값을 트리거하는 양식이 있을 수 있습니다. 그런 다음 이 변수는 해당 방문자의 쿠키에서 업데이트됩니다. 사이트에 구현하고 이 방법으로 데이터가 수집되면 새로 정의된 세그먼트가 애널리틱스 보고서의 방문자 섹션에 있는 맞춤 설정 보고서에 표시됩니다. 또한 콘텐츠 세부정보 보고서의 사용자 정의 값 세그먼트에 액세스하여 자신이 정의한 특정 세그먼트에 속하는 페이지 방문자의 비율을 확인할 수 있습니다.

매개변수

String newVal 설정할 새 맞춤 설정값입니다.

_trackPageLoadTime()

_trackPageLoadTime()

사이트 속도 보고가 모든 사용자에 대해 자동으로 사용 설정되므로 이 방법은 지원 중단되었습니다. _setSiteSpeedSampleRate()를 사용하여 사이트 속도 보고를 위한 샘플링 레이트를 조정하세요.

이 페이지에 대한 사이트 속도 보고서를 사용하도록 설정합니다. 사이트 속도를 보고하려는 사이트의 모든 페이지에 이 방법을 삽입합니다. 애널리틱스의 사이트 속도 보고서에 관한 자세한 내용은 고객센터의 사이트 속도 문서를 참조하세요.

변경사항 확인

보고서에 데이터가 표시되면 올바르게 설정된 것입니다. 24시간 후에도 데이터가 표시되지 않으면 맞춤설정에 오류가 없는지 확인하세요. 일반적인 추적 코드 오류의 목록은 추적 코드 문제 해결을 참고하세요. 이 문제해결 가이드에는 기본 디버깅 단계와 디버깅에 관한 자세한 내용도 포함되어 있습니다.

사이트에 대해 사이트 속도 추적을 사용 설정하면 페이지뷰에 대해 실행되는 페이지 추적 GIF 요청과는 별개로 Google 웹로그 분석 서버로 추가 요청이 들어갑니다. 전체 사이트 지연 시간에 미치는 영향을 최소화하기 위해 이 요청은 사이트에서 발생한 페이지뷰의 샘플만을 대상으로 합니다. 이러한 이유 때문에 Firebug와 같은 도구에서 이 기능을 디버깅하려고 할 때 사이트 속도 GIF 요청이 안보일 수 있습니다. 이는 정상적이고 예상되는 현상입니다.

비동기 스니펫 (권장) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

GATC (Google 애널리틱스 추적 코드)의 기본 로직입니다. 링커 기능이 사용 설정된 경우 URL에서 쿠키 값을 추출하려고 시도합니다. 그렇지 않으면 document.cookie에서 쿠키 값을 추출하려고 시도합니다. 또한 필요에 따라 쿠키를 업데이트하거나 만든 후 문서 객체에 다시 씁니다. UCFE (Urchin Collector Front-end)로 전송할 적절한 측정항목을 모두 수집합니다.

비동기 스니펫 (권장) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

매개변수

String opt_pagePath 측정항목을 추적할 페이지의 경로를 나타내는 선택적 매개변수입니다. 이 옵션을 사용하는 경우 시작 슬래시 (/)를 사용하여 페이지 경로를 나타냅니다.