2023년 7월 1일부터 표준 유니버설 애널리틱스 (UA) 속성의 데이터 처리가 중단되었습니다. 2024년 7월 1일부터 UA 360 속성의 데이터 처리가 중단되며, Google 애널리틱스 4로 이전됨에 따라 일부 UA 360 기능이 그전에 지원 중단됩니다. 기존 구현에 Google 애널리틱스 4를 추가합니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

구문 비교

본 도움말에서는 자주 사용하는 추적 맞춤설정에 대한 추적 코드 삽화를 보여줍니다. Google 애널리틱스 추적 스니펫에 urchin.js 마크업 또는 기존 ga.js 구문이 포함된 경우 추적을 개선된 비동기 스니펫으로 이전하려면 이 가이드를 사용하세요.

비동기 추적으로 이전

먼저 기존의 추적 코드 맞춤설정을 복사하여 워드 프로세서 문서가 아닌 텍스트 파일에 저장하는 것이 좋습니다. 백업 사본을 사용하면 사이트의 모든 맞춤설정을 이전했는지 확인할 수 있습니다.

비동기 스니펫을 사용하도록 페이지를 전환하려면 다음 단계를 따르세요.

기존 추적 코드 스니펫과 맞춤설정한 내용을 모두 삭제합니다.
오류를 줄이려면 웹페이지에 기존의 추적 코드를 삽입하는 포함 파일 또는 메커니즘에서 기존 추적 코드 스니펫을 삭제하는 것이 좋습니다. 기존의 추적 코드 스니펫을 텍스트 파일에 붙여넣으면 맞춤설정한 방법을 추적할 수 있습니다.
페이지 또는 템플릿에서 사용할 수 있는 다른 스크립트 뒤의 페이지 <head> 섹션 하단에 비동기 스니펫을 삽입합니다.
비동기 스니펫의 주요 장점 중 하나는 HTML 문서의 상단에 배치할 수 있다는 점입니다. 이렇게 하면 사용자가 페이지를 떠나기 전에 추적 표지가 전송될 가능성이 높아집니다. 대부분의 페이지에서 비동기 스니펫의 최적 위치는 <head> 섹션 하단, 즉 닫는 </head> 태그 바로 앞에 있습니다.
웹 속성 ID를 사용하여 _setAccount 메서드를 수정합니다.

웹 속성 ID에 대한 자세한 내용은 계정 및 보기 (프로필) 문서의 '웹 속성' 섹션을 참고하세요.
비동기 구문을 사용하여 맞춤설정을 다시 추가합니다. 이 가이드의 나머지 부분에 설명된 맞춤설정을 사용하세요. 비동기 추적 코드에 대한 자세한 내용은 비동기 추적 사용 가이드를 참고하세요.

참고: 다른 스크립트와 관련하여 비동기 스니펫 작업을 가장 간소화하려면 사이트에 다음 방법 중 하나로 다른 스크립트를 배치하는 것이 좋습니다.

HTML <head> 섹션의 추적 코드 스니펫 앞
추적 코드 및 모든 페이지 콘텐츠 다음 (예: HTML 본문 하단)

그렇게 할 수 없는 경우에도 페이지 하단에 비동기 스니펫을 배치할 수 있습니다. 또한 스니펫을 분할하여 비동기 추적의 이점을 유지할 수도 있습니다.

기본 페이지 추적

비동기 문법을 숙지하려면 기본 페이지 추적을 사용하는 것이 가장 좋습니다. 이 예에서는 올바른 계정으로 추적 객체를 설정하고 페이지 추적 메서드를 호출합니다.

비동기 스니펫 (권장)

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

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-XXXXX-X";
urchinTracker();

맨 위로

브라우저 설정 감지

다음 예는 플래시 감지 사용 중지, 브라우저 이름/버전 감지 사용 중지 등과 같은 브라우저 설정 맞춤설정을 보여줍니다.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setClientInfo(false);
pageTracker._setAllowHash(false);
pageTracker._setDetectFlash(false);
pageTracker._setDetectTitle(false);
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-XXXXX-X";
_ufsc = 0;    // track browser info
_uhash = "on"; // (on|off) unique domain hash for cookies
_uflash = 0;  // detect Flash version
_utitle = 0;  // track title in reports
urchinTracker();

맨 위로

캠페인 운영 기간

기본적으로 Google Ads 캠페인의 기간은 6개월로 설정되어 있습니다. _setCampaignCookieTimeout() 메서드를 사용하여 캠페인 기간을 조정할 수 있습니다.

비동기 스니펫 (권장)

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

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignCookieTimeout(31536000000);
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-XXXXX-X";
_ucto = "31536000"; // the number of seconds in 1 year
urchinTracker();
</script>

맨 위로

캠페인 필드 - 맞춤

Google Ads 계정을 애널리틱스 계정에 연결하면 Google 애널리틱스에서 Google Ads 데이터를 자동으로 수집합니다. 다른 광고 소스나 이메일 캠페인 또는 유사한 소스의 키워드 링크를 추적하려면 아래 방법을 사용하여 맞춤 캠페인 필드를 만드세요. 자세한 내용은 트래픽 소스 가이드의 '캠페인 추적'을 참고하세요.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampNameKey('ga_campaign');       // name
pageTracker._setCampMediumKey('ga_medium');       // medium
pageTracker._setCampSourceKey('ga_source');       // source
pageTracker._setCampTermKey('ga_term');           // term/keyword
pageTracker._setCampContentKey('ga_content');     // content
pageTracker._setCampNOKey('ga_nooverride');       // don't override
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-12345-1";
_uccn = "ga_campaign"; // name [default: utm_campaign]
_ucmd = "ga_medium"; // medium [default: utm_medium]
_ucsr = "ga_source"; // source [default: utm_source]
_uctr = "ga_term"; // term/keyword [default: utm_term]
_ucct = "ga_content"; // content [default: utm_content]
_ucid = "ga_id"; // id number [default: utm_id]
_ucno = "ga_nooverride"; // don't override [default: utm_nooverride]
urchinTracker();

맨 위로

캠페인 추적 — 사용 중지됨

Google 애널리틱스에서는 캠페인 추적을 자동으로 사용 설정하지만 _setCampaignTrack() 메서드를 사용하여 중지할 수 있습니다.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignTrack(false);       // Turn off campaign tracking
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-12345-1";
_uctm = "disable";
urchinTracker();

맨 위로

교차 도메인 연결

도메인 간 트래픽을 추적하려면 _setAllowLinker() 함수를 사용하여 두 도메인 간의 사용자 클릭을 추적하면 됩니다. 교차 도메인 추적 설정에 대한 자세한 내용은 교차 도메인 추적을 참고하세요.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<a href="http://example.com/test.html"
onclick="pageTracker._link('http://example.com/test.html'); return false;">click me</a>

urchin.js 추적

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();

...
<a href="http://newsite.com/test.html"
onclick="__utmLinker('http://newsite.com/test.html'); return false;">click me</a>

맨 위로

교차 도메인 양식 데이터

두 도메인에 대해 교차 도메인 추적이 사용 설정된 경우 _linkByPost() 메서드를 사용하여 한 도메인에서 다른 도메인으로 사용자 데이터를 전달할 수 있습니다. 교차 도메인 추적 설정에 대한 자세한 내용은 교차 도메인 추적을 참조하세요.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<form name="f" method="post" onsubmit="pageTracker._linkByPost(this);">
...
</form>

urchin.js 추적

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();
...
<form name="f" method="post" onsubmit="__utmLinkPost(this)">
...
</form>

맨 위로

전자상거래 추적

전자상거래 추적에는 추적 설정에서 세 가지 주요 메서드를 호출하는 작업이 포함됩니다. 자세한 내용은 전자상거래 추적을 참고하세요.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
pageTracker._addTrans(
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
);
pageTracker._addItem(
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
);
pageTracker._trackTrans();

urchin.js 추적

_uacct = "UA-12345-1";
urchinTracker();
</script>
<form name="utmform" id="utmform">
<textarea name="utmtrans" id="utmtrans" style="display:none">
UTM:T|1234|Mountain View|11.99|1.29|5|San Jose|California|USA
UTM:I|1234|DD44|T-Shirt|Green Medium|11.99|1
</textarea>
</form>
<script type="text/javascript">
__utmSetTrans();

맨 위로

이벤트 추적

이벤트 추적을 사용하려면 onclick 핸들러와 같은 페이지의 적절한 위치에서 이벤트를 호출해야 합니다. 이벤트 추적에 대한 자세한 내용은 이벤트 추적 가이드를 참고하세요. 참고: urchin.js 추적 코드에서는 이벤트 추적을 사용할 수 없습니다.

비동기 스니펫 (권장)

이 섹션에서는 비동기식 구문을 사용하여 추적을 설정하는 두 가지 방법을 보여줍니다. 이벤트 추적을 사용하는 경우 onclick 핸들러는 정확히 동일한 구문을 사용합니다.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
...
<a onclick="pageTracker._trackEvent('category', 'action', 'opt_label', opt_value);">click me</a>

맨 위로

세션 만료

기본적으로 사용자 세션은 사이트에서 30분 동안 활동이 없으면 타임아웃됩니다. 다음 예에서는 _setSessionCookieTimeout() 메서드를 사용하여 이를 수정하는 방법을 보여줍니다.

비동기 스니펫 (권장)

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

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setSessionCookieTimeout(3600000);
pageTracker._trackPageview();

urchin.js 추적

<script type="text/javascript">
_uacct = "UA-12345-1";
_utimeout = "3600"; // the number of seconds in 1 hour
urchinTracker();
</script>

맨 위로

소스 — 검색엔진, 키워드, 리퍼러

기본적으로 Google 애널리틱스는 보고서에서 웹사이트 목록을 검색엔진 추천으로 식별합니다. 이러한 메서드를 사용하여 검색엔진 목록을 변경할 수 있습니다. 자세한 내용은 트래픽 소스 가이드의 '검색엔진'을 참고하세요. 특정 도메인의 추천을 무시하거나 특정 키워드 검색을 직접 트래픽으로 취급하도록 Google 애널리틱스를 구성할 수도 있습니다.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._addIgnoredOrganic('ignore');
pageTracker._addIgnoredRef('urchin.com');
pageTracker._addOrganic('new_search_engine','q');
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-12345-1";
_uOno[0] = "ignore"; // keyword to treat as referral
_uRno[0] = "urchin.com"; // referral to treat as direct
_uOsr[41] = "new_search_engine"; // new search engine to treat as referral
_uOkw[41] = "query"; // keyword query parameter for new search engine

urchinTracker();

맨 위로

추적이 하위 디렉터리로 제한됨

하위 디렉터리를 모든 추적의 기본 경로로 설정하려면 _setCookiePath() 메서드를 사용합니다. 이렇게 하면 모든 추적을 사이트의 하위 디렉터리로 제한할 수 있습니다.

비동기 스니펫 (권장)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCookiePath('/path/of/cookie/');
pageTracker._trackPageview();

urchin.js 추적

<script type="text/javascript">
_uacct = "UA-12345-1";
_utcp = "/path/of/cookie/";
urchinTracker();
</script>

맨 위로

로컬 서버 사용

독립형 Apigee 소프트웨어와 Google 애널리틱스를 사용하여 웹사이트를 추적하는 경우 이 방법을 사용합니다. 자세한 내용은 Tracking API 참조의 Urchin 서버 섹션을 참고하세요.

비동기 스니펫

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

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setLocalRemoteServerMode();
pageTracker._trackPageview();

urchin.js 추적

_uacct = "UA-12345-1";
_userv = 0;
urchinTracker();

맨 위로

가상 페이지뷰

사이트의 실제 웹사이트 페이지로 연결되지 않는 사용자의 클릭을 추적하려면 조작 URL과 함께 _trackPageview() 메서드를 사용합니다. 일반적으로 다운로드, 아웃바운드 링크, PDF 또는 이와 유사한 종류의 사용자 상호작용을 추적하려면 이벤트 추적을 사용하는 것이 좋습니다. 가상 페이지뷰가 총 페이지 조회수에 추가되기 때문입니다.

비동기 스니펫

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

기존 (ga.js) 스니펫

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview('/downloads/pdfs/corporateBrief.pdf');

urchin.js 추적

urchinTracker('/downloads/pdfs/corporateBrief.pdf');

맨 위로