[UA→GA4] UA용 gtag.js가 GA4에 매핑되는 방식

이 가이드는 gtag.js 라이브러리를 사용하고 있으며 유니버설 애널리틱스(UA)용 gtag.js가 Google 애널리틱스 4에 어떻게 매핑되는지 알고자 하는 웹사이트 소유자를 위한 구현 가이드입니다. 사용자가 이미 Google 애널리틱스 4 속성을 만들었다고 가정합니다. 웹사이트에 기본 측정 코드를 추가하기만 하려면 이 도움말을 참고하세요.

이 도움말에서는 다음 내용을 다룹니다.

• gtag.js 스니펫 정보
• 기본 데이터 수집
• gtag.js 구성 설정
• 이벤트
• 맞춤 측정기준 및 측정항목

gtag.js 스니펫 및 속성 ID에 대한 정보

유니버설 애널리틱스 속성의 gtag.js 스니펫과 Google 애널리틱스 4 속성의 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>

1행: gtag.js를 통해 유니버설 애널리틱스 속성을 구현한 경우 사이트에 이미 이 코드 행이 있을 수 있습니다. <Some Property ID A> 대신 'UA-' 뒤에 일련의 숫자가 표시됩니다. Google Ads 또는 다른 Google Marketing Platform 제품을 위해 gtag.js를 구현한 경우에도 웹사이트에 이 코드 행이 있을 수 있으나, <Some Property ID A>는 'AW-' 또는 'DC-'로 시작합니다.

<Some Property ID A>에서 나타내는 속성 ID(또는 Google 애널리틱스 4 속성의 경우 태그 ID)에서는 이 gtag.js 스니펫을 '관리'합니다. 이 ID가 중요한 이유는 다음과 같습니다.

1. 이 행이 이미 있으면 다시 구현할 필요가 없습니다. 'config' 행을 추가하여 태그 ID를 지정하기만 하면 됩니다.
2. 이 행의 속성 ID는 gtag.js 스니펫의 '컨트롤러'입니다. 유니버설 애널리틱스 속성 ID('UA-XXXXXXXX')에서 태그를 관리하는 경우 연결된 사이트 태그를 사용하여 측정 데이터를 Google 애널리틱스 4 속성에 보낼 수 있으며, 페이지에 새 코드를 추가하지 않아도 됩니다.

7행: gtag 'config' 지시문은 <Some Property ID A>와 연결된 속성에 대한 데이터 수집을 사용 설정합니다. 예를 들어 Google 애널리틱스 4 속성에서 이 지시문을 태그 ID와 함께 추가하면 해당 속성에 page_view 이벤트가 전송됩니다.

속성 ID는 유니버설 애널리틱스 속성('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>로 표시되는 속성에만 전송됩니다.

gtag config 명령어는 기본 측정을 사용 설정합니다.

• 유니버설 애널리틱스 속성의 경우 유니버설 애널리틱스 속성 ID가 있는 'config'에서 페이지 조회를 전송합니다.
• Google 애널리틱스 4 속성의 경우 태그 ID가 있는 'config'를 사용하면 속성이 페이지에 로드될 때 page_view 이벤트를 자동 수집 이벤트로 수집할 수 있습니다.

속성 식별자

유니버설 애널리틱스 속성 ID의 형식은 'UA-XXXXXXXX'입니다. 이 ID는 추적 ID라고도 합니다. 이 가이드에서는 이를 UA 속성 ID라고 하겠습니다.

Google 애널리틱스 4 속성 웹 데이터 스트림에서는 'G-XXXXXXXX' 형식의 태그 ID를 사용합니다.

일부 코드 예시 및 문서에서는 둘 모두를 'TAG_ID'라고 하기도 합니다.

기본 데이터 수집

Google 애널리틱스 4 속성의 기본 데이터 수집을 사용 설정하면 다음 항목을 수집할 수 있습니다.

• page_view 이벤트
• 자동으로 수집되는 이벤트
• 향상된 측정 이벤트(UI에서 사용 설정된 경우)

기존 유니버설 애널리틱스 속성에서 gtag.js 구현을 사용하는 경우 다음과 같은 방법으로 Google 애널리틱스 4 속성의 기본 데이터 수집을 사용 설정할 수 있습니다.

• 옵션 1: 관련 태그 ID와 함께 새 'config' 지시문 추가
  또는
• 옵션 2: 연결된 사이트 태그 사용 설정(기존 gtag.js 구현을 사용할 수 있는 경우)

선택한 옵션에 관계없이 기존 유니버설 애널리틱스 속성은 영향을 받지 않으며 계속해서 데이터를 수집합니다.

옵션 1: 새 'config' 지시문 추가

페이지에 기존 gtag.js 코드가 있는 경우 'config' 지시문을 관련 Google 애널리틱스 4 속성의 측정 ID와 함께 추가하면 됩니다. 아래 예시에서는 기존 gtag.js 구현에 8행이 추가되었습니다. 이 행에서는 Google 애널리틱스 4 속성의 측정 ID를 참조합니다. 이렇게 하면 해당 Google 애널리틱스 4 속성에 page_view 이벤트가 전송됩니다. 또한 자동으로 수집되는 이벤트와 향상된 측정 이벤트(향상된 측정을 사용 설정한 경우)가 자동으로 해당 Google 애널리틱스 4 속성에서 사용 설정됩니다.

1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

2: <script>

3: window.dataLayer = window.dataLayer || [];

4: function gtag(){dataLayer.push(arguments);}

5: gtag('js', new Date());

6:

7: gtag('config', '<Some Property ID A>');

8: gtag('config', 'G-XXXXXXXX');

9: </script>

옵션 2: 연결된 사이트 태그 사용 설정

다음과 같은 경우 연결된 사이트 태그를 사용할 수 있습니다.

• 사용자 상호작용을 측정하려는 페이지의 기존 gtag.js 스니펫을 유니버설 애널리틱스 속성에서 '관리'하는 경우(즉, gtag.js 스니펫의 다음과 같은 행에서 참조되는 ID가 'UA-'로 시작)

<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>

(Google 애널리틱스 4 속성에서 기존 gtag.js 스니펫을 관리하는 경우에도 연결된 사이트 태그가 작동합니다. 하지만 Google 애널리틱스 4 속성이 이미 구현된 경우에만 이러한 경우가 발생합니다.)

• 또한 스니펫에서 ID로 참조되는 유니버설 애널리틱스 속성에 대한 관리 액세스 권한이 있는 경우

페이지에 gtag.js 태그와 GTM 컨테이너가 모두 구현된 경우 연결된 사이트 태그가 작동하려면 gtag.js 태그를 GTM 컨테이너 위에 배치해야 합니다.

gtag.js 구성 설정

기본 gtag.js 스니펫을 구성하여 IP 익명처리, 쿠키 맞춤설정, Google 신호 데이터와 같은 데이터 수집 설정을 관리할 수 있습니다. gtag.js에서 'config' 또는 'set' 지시문을 사용하여 구성합니다.

유니버설 애널리틱스('UA-XXXXXXXX')와 Google 애널리틱스 4('G-XXXXXXXX') 속성 모두에서 gtag.js를 통해 이러한 구성 설정을 구현할 수 있습니다. 하지만 유니버설 애널리틱스와 Google 애널리틱스 4 속성의 설정 간에는 차이가 있습니다. 

• IP 익명처리는 'true'로 표준화되며 Google 애널리틱스 4 속성에서 설정을 변경할 수 없습니다. 따라서 IP 주소가 표준 이벤트를 통해 Google 애널리틱스 4 속성('G-XXXXXXXX')으로 자동 마스킹됩니다.

• 구성된 모든 속성에 전체 설정을 적용해야 하는 경우 연결된 사이트 태그를 통해 구현된 ID를 포함하여 모든 측정 ID 및 속성 ID에 적용하려면 'set' 명령어를 사용해야 합니다.
• 'config' 행을 사용하여 가장 일반적으로 구현되는 '광고 개인 최적화 사용 중지' 기능에 특별히 주의를 기울이세요.
• 연결된 사이트 태그를 사용하는 경우: 'config'를 사용하여 gtag.js 코드에서 설정한 모든 구성은 해당 코드 행의 측정 ID와 연결된 속성에만 적용되며, 연결된 Google 애널리틱스 4 속성으로 자동 전송되지 않습니다. 연결된 Google 애널리틱스 4 속성에 구성을 적용하려는 경우 다음을 실행합니다.
  • 별도의 'config' 지시문을 만든 후 측정 ID를 참조하여 관련 Google 애널리틱스 4 속성에 적용합니다.
    또는
  • 'set' 지시문을 사용하여 설정을 구성합니다. 이 경우 구성된 모든 속성에 해당 구성이 적용됩니다.

구성 예시

기본 데이터 수집 사용, User-ID 구성

gtag('config', 'GA_MEASUREMENT_ID', {

'user_id': 'USER_ID'

});

쿠키 설정 구성

gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {

'user_id': 'USER_ID',

'send_page_view': false

});

이벤트

이벤트 이전 가이드를 참고하세요.

맞춤 측정기준 및 측정항목

맞춤 측정기준 및 측정항목을 사용하여 정보를 확장하고 오프라인 데이터를 가져올 수 있습니다(예: CRM 시스템에서).

Google 태그(gtag.js)를 사용할 때, 연결된 사이트 태그 또는 Google 애널리틱스 4 속성(예: 'G-XXXXXXXX')이 사용되는 경우 맞춤 측정기준 및 측정항목 측정이 자동으로 매개변수로 변환됩니다.

맞춤 측정기준 및 측정항목에 대해 자세히 알아보기