gtag.js 스니펫 정보
현재 유니버설 애널리틱스 속성에 analytics.js를 사용하는 경우 새 Google 애널리틱스 4 속성을 위한 gtag.js 스니펫을 추가해야 합니다. gtag.js 스니펫의 구조는 다음과 같습니다.
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
7행: gtag 'config' 지시어는 <일부 속성 ID A>와 연결된 속성에 대한 데이터 수집을 사용 설정합니다. 예를 들어 이 지시어를 Google 애널리틱스 4 속성의 태그 ID와 함께 추가하면 해당 속성에 page_view
이벤트가 전송됩니다.
속성 ID는 UA 속성('UA-XXXXXXXX'), Google 애널리틱스 4 속성('G-XXXXXXXX'), Google Ads('AW-XXXXXXXX') 또는 플러드라이트('DC-XXXXXXXX') 등 다양한 Google 제품을 나타낼 수도 있습니다.
11행: gtag 'event' 지시문은 이벤트를 전송합니다. 여러 속성에 대해 여러 'config' 지시문이 있는 스니펫에서는 이벤트가 모든 속성으로 전송됩니다.
이 예시에서 'sign_up' 매개변수는 이벤트 이름입니다. 마지막 매개변수는 이벤트 매개변수의 집합이 포함된 객체입니다. 이 경우 'method'는 값이 'email'인 매개변수입니다.
13행: 여기서 이벤트의 매개변수는 'send_to'입니다. 이 매개변수는 연결된 이벤트를 특정 속성으로 '라우팅'하는 특수 매개변수입니다. 즉, 이 이벤트는 <Some Property ID B>로 표시되는 속성에만 전송됩니다.
Google 애널리틱스 4 속성의 기본 데이터 수집은 gtag 'config' 지시문을 통해 사용 설정되며, 페이지에 로드될 때 page_view 이벤트 수집을 자동으로 수집되는 이벤트로 사용 설정합니다.
페이지 조회 또는 page_view 이벤트는 특정 매개변수를 통해 수정 또는 차단될 수 있습니다.
속성 식별자
유니버설 애널리틱스 속성 ID의 형식은 'UA-XXXXXXXX'입니다. 이 ID는 추적 ID라고도 합니다. 이 가이드에서는 이를 UA 속성 ID라고 하겠습니다.
Google 애널리틱스 4 속성의 웹 데이터 스트림에서는 'G-XXXXXXXX' 형식의 태그 ID를 사용합니다.
일부 코드 예시 및 문서에서는 둘 모두를 'TAG_ID'라고 하기도 합니다.
기본 데이터 수집
Google 애널리틱스 4 속성의 기본 데이터 수집을 사용 설정하면 다음 항목을 수집할 수 있습니다.
- page_view 이벤트
- 자동 수집 이벤트
- 향상된 측정 이벤트(UI에서 사용 설정된 경우)
Google 애널리틱스 4 속성의 기본 데이터 수집을 사용 설정하려면 각 페이지의 <head>
섹션에 gtag.js 스니펫(Google 태그)을 추가하세요.
gtag.js 스니펫과 analytics.js 스니펫 비교
Google 애널리틱스 4 속성의 gtag.js 스니펫은 유니버설 애널리틱스 속성의 analytics.js 스니펫과 비슷한 목적으로 사용됩니다.
두 스니펫의 가장 큰 차이는 analytics.js 코드에는 별도의 '페이지 조회 전송' 호출이 포함되지만 gtag.js 코드에는 포함되지 않는다는 점입니다. gtag.js에서 페이지 조회는 'config' 지시문과 함께 전송되는 자동으로 수집되는 이벤트입니다.
유니버설 애널리틱스 속성(analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Google 애널리틱스 4 속성(gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
gtag.js 구성 설정
기본 gtag.js 스니펫을 구성하여 analytics.js와 유사하게 IP 마스킹, 쿠키 맞춤설정, Google 신호 데이터 등의 데이터 수집 설정을 관리할 수 있습니다. gtag.js에서 'config' 또는 'set' 지시어를 사용하여 구성합니다(analytics.js에서는 'set,' 'create', 'require' 지시어를 사용하여 구성).
Google 애널리틱스 4('G-XXXXXXXX') 속성에서는 gtag.js를 통해 유사한 config 설정을 구현할 수 있습니다. 유니버설 애널리틱스와 Google 애널리틱스 4 속성의 이러한 설정 간에는 차이가 있습니다. 다음 사항을 고려하세요.
- IP 마스킹은 'true'로 표준화되며 Google 애널리틱스 4 속성에서 구성을 변경할 수 없습니다. 따라서 표준 이벤트를 통해 Google 애널리틱스 4 속성('G-XXXXXXXX')으로 IP 주소가 자동 마스킹됩니다.
- 구성된 모든 속성에 전체 설정을 적용해야 하는 경우 모든 태그 ID 및 속성 ID에 적용하려면 gtag.js에 'set' 명령어를 사용해야 합니다.
- 'set' 행을 사용하여 가장 일반적으로 구현되는 analytics.js의 광고 및 광고 개인 최적화 기능에 특별히 주의를 기울이세요.
현재 analytics.js 구현에서 'set', 'create', 'require' 지시문을 사용하는 경우 Google 애널리틱스 4 속성에서 자동으로 설정되는 지시문과 Google 애널리틱스 4 웹 속성 코드에서 지정해야 하는 지시문(매개변수 매핑)을 참고하세요.
analytics.js(UA 속성의 경우) 및 gtag.js(Google 애널리틱스 4 속성의 경우)에서 코드 샘플을 사용한 구성의 예시가 아래에 설명되어 있습니다.
기본 데이터 수집 사용, User-ID 구성
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
쿠키 설정 구성
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // Time in seconds.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
page_view 이벤트 차단
config 코드를 로드할 때 page_view 이벤트를 전송하지 않아도 되는 경우(예를 들어 iframe을 로드하는 경우) page_view 이벤트를 차단하도록 구성 설정을 조정할 수 있습니다. page_view 이벤트가 전송된 후 사용자가 사이트에 로그인하는 경우를 고려해 보겠습니다. 로그인 상호작용의 경우 'config' 지시문을 사용하여 사용자 ID를 설정하되 다른 page_view 이벤트는 전송하고 싶지 않을 수 있습니다. 다음 코드는 page_view 이벤트가 전송되지 않도록 하는 방법을 보여줍니다.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
태그 이름
analytics.js에서 여러 유니버설 애널리틱스 속성으로 데이터를 전송하려는 경우 태그 이름('추적 도구'라고 함)이 사용됩니다. analytics.js에서 추적 도구는 데이터를 전송할 속성을 정의합니다. 초기 'create' 조회 후의 조회에서는 더 이상 유니버설 애널리틱스 속성 ID를 지정하지 않아도 되며 추적 도구 이름만 지정하면 됩니다.
gtag.js에서는 Google 애널리틱스 4 또는 유니버설 애널리틱스 속성에 추적 도구를 사용할 수 없습니다. 모든 조회를 다양한 속성(Google 애널리틱스 4 속성의 여러 데이터 스트림)으로 보내려면 'config' 행에 모든 태그 ID 또는 속성 ID를 지정합니다.
이벤트
이벤트 이전 가이드를 참고하세요.맞춤 측정기준 및 측정항목
맞춤 측정기준 및 측정항목은 웹사이트에서 측정되는 정보를 확장하고 CRM 시스템 등에서 오프라인 데이터를 가져오는 데 사용됩니다. 유니버설 애널리틱스 속성('UA-XXXXXXXX')의 경우 UI에서 맞춤 측정기준과 측정항목을 만들어야 하며, ID를 할당한 후 이를 구현하거나 가져올 수 있습니다. 조회, 세션, 사용자, 제품, 이 4가지 범위로 맞춤 측정기준과 측정항목을 만들 수 있습니다.
Google 애널리틱스 4 속성('G-XXXXXXXX')의 경우 맞춤 측정기준 및 측정항목 사용 사례가 다른 방식으로 구현됩니다. analytics.js를 통해 구현된 UA 속성의 맞춤 측정기준 및 측정항목 측정값은 Google 애널리틱스 4 속성의 매개변수로 다시 구현되어야 합니다.
유니버설 애널리틱스 속성의 맞춤 측정기준은 다음과 같이 analytics.js를 통해 구현할 수 있습니다.
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
OR
ga('set', 'dimension5', 'custom data');
이러한 맞춤 측정기준은 다음과 같이 gtag.js를 통해 Google 애널리틱스 4 속성으로 변환될 수 있습니다.
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
OR
gtag('set', {'dimension5': 'custom data'});
다음과 같은 두 가지 주의사항이 있습니다.
- 매개변수를 보고서에 표시하려면 사용자 인터페이스에 등록해야 합니다. 이 과정은 유니버설 애널리틱스에서 맞춤 측정기준을 등록하는 과정과 유사합니다(제한사항 적용됨). 내보낸 데이터만 보거나 잠재고객 활성화에만 매개변수를 사용하는 경우에는 맞춤 측정기준을 등록하지 않아도 됩니다.
- 맞춤 매개변수의 범위는 조회 범위와 비슷하게 항상 이벤트 수준에 있습니다. 또한 기존의 맞춤 측정기준 범위 설정과는 별개로, 매개변수로 자동 변환되는 맞춤 측정기준에 적용됩니다(gtag.js 'UA-XXXXXXXX' 구현의 경우).
맞춤 측정항목에도 동일한 매핑 및 고려사항이 적용됩니다. 단, 맞춤 측정항목이 보고서 용도로 등록될 때 텍스트 매개변수 한도 대신 숫자 매개변수 한도에 포함됩니다.
개념적으로 유니버설 애널리틱스 속성에서 다양한 범위의 맞춤 측정기준과 측정항목은 다음과 같이 Google 애널리틱스 4 속성에 매핑됩니다.
- 조회 범위 맞춤 측정기준: 매개변수(데이터 수집 중 이벤트당 로깅된 총 매개변수 최대 25개, 맞춤 측정기준 최대 50개/맞춤 측정항목 50개)
참고: 자동 수집 이벤트 및 매개변수에 이미 이전에 조회 범위 맞춤 측정기준이 사용된 일부 사용 사례가 포함될 수 있습니다. - 사용자 범위 맞춤 측정기준: 사용자 속성(UI를 통한 보고서 용도로 최대 25개가 등록됨). 자동 수집 사용자 측정기준은 이 한도에 포함되지 않습니다.
- 세션 범위 맞춤 측정기준: Google 애널리틱스 4 속성에서 동등하지 않으므로, 대신 맞춤 매개변수 또는 사용자 속성을 살펴보세요.
사용자 속성을 위한 권장사항
사용자 속성은 여러 플랫폼(예: 모든 데이터 스트림 유형)에서 사용자가 동일하므로 데이터를 사용자 수준에서 적용해야 하는 경우에만 이를 사용해야 합니다. 세션 수준 데이터 또는 기기 수준 데이터(예: 화면 크기)에는 사용자 속성을 사용해서는 안 됩니다.
Google 애널리틱스 4 속성 예시
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});