gtag.js를 사용한 쿠키 및 사용자 식별

gtag.js는 쿠키를 사용하여 탐색 세션 전체에서 순 사용자를 식별합니다. 이 페이지에서는 쿠키 설정을 맞춤설정하는 방법을 설명합니다.

참고: gtag.js가 쿠키를 사용하는 방법에 대한 자세한 내용은 쿠키 사용 가이드를 참조하세요.

쿠키 필드 설정 구성

다음 표는 gtag.js에서 사용하는 기본 쿠키 필드 값을 보여줍니다.

필드 이름	값 유형	기본값
cookie_domain	string	auto
cookie_expires	integer	63072000(초 단위로 2년)
cookie_prefix	string	_ga
cookie_update	boolean	true
cookie_flags	string

이러한 값을 변경하려면 속성의 config를 업데이트하여 매개변수 목록에 지정합니다. 예를 들면 다음과 같습니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

쿠키 도메인 구성

기본적으로 gtag.js에는 자동 쿠키 도메인 구성이 사용 설정되어 있습니다. 이 옵션을 사용 설정하면 gtag.js가 최대한 높은 수준의 도메인에 쿠키를 설정합니다. 예를 들어 웹사이트 주소가 blog.example.com이면 gtag.js가 example.com 도메인에 쿠키를 설정합니다. 로컬에서 서버를 실행 (예: localhost)하는 것이 gtag.js에서 감지되면 cookie_domain가 자동으로 'none'으로 설정되어 gtag.js가 쿠키를 설정합니다. 문서 위치에서 전체 도메인을 사용합니다.

자동 쿠키 도메인 구성을 사용 중지하려면 속성의 config를 업데이트하여 cookie_domain 매개변수의 값을 지정합니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

참고: 자동 쿠키 도메인 구성을 사용하면 추가 구성 없이도 하위 도메인에서 활동이 측정됩니다.

주의: cookie_domain은 현재 도메인의 상위 항목이어야 하며, 그렇지 않으면 쿠키가 설정되지 않습니다. 예를 들어 도메인이 one.two.three.root.com인 경우, 쿠키를 someotherdomain.com이 아닌 root.com에 설정되도록 구성할 수 있습니다. 쿠키 도메인을 잘못 설정하면 Google 애널리틱스로 조회가 전송되지 않습니다.

쿠키 접두사

다른 쿠키와 충돌하지 않도록 gtag.js에서 설정한 쿠키 앞에 추가되는 쿠키 프리픽스를 변경해야 할 수 있습니다. 예를 들어 Google 애널리틱스에서 사용하는 ID 쿠키의 기본 이름은 _ga입니다. 이 코드는 대신 쿠키 이름을 example_ga으로 지정합니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

주의: 태그된 사이트에서 gtag.js 또는 Google 애널리틱스를 사용하고 사용자가 해당 사이트를 방문한 후 cookie_prefix가 변경된 경우, 컨텍스트가 접두사가 붙지 않은 쿠키에 저장되어 있으므로 이러한 방문자는 gtag.js 및 Google 애널리틱스의 신규 방문자로 표시됩니다. 이러한 이유로, 쿠키 접두사를 사용하려는 경우 맨 처음 사이트가 태그될 때부터 이를 사용하는 것이 좋습니다.

쿠키 만료

페이지를 로드할 때마다 쿠키 만료 시간이 현재 시간과 cookie_expires 필드 값을 더하도록 업데이트됩니다. 즉, cookie_expires이 1주일로 설정되어 있고 사용자가 5일 이내에 동일한 브라우저를 사용하여 방문하면 추가 1주일 동안 쿠키가 제공되며 Google 애널리틱스에서 동일한 방문자와 같이 표시됩니다. 같은 사용자가 원래 쿠키가 만료된 후에 방문했다면 새 쿠키가 생성되며, 이 사용자의 첫 번째 및 두 번째 방문은 보고서에서 Google 애널리틱스로 표시됩니다.

cookie_expires 값을 0 (0)초로 설정하면 쿠키가 세션 기반 쿠키로 전환되며 현재 브라우저 세션이 종료되면 만료됩니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

주의: 쿠키가 너무 빨리 만료되도록 설정하면 사용자 수가 부풀려지고 측정 품질이 저하될 수 있습니다.

쿠키 업데이트

cookie_update를 true (기본값)로 설정하면 페이지를 로드할 때마다 gtag.js가 쿠키를 업데이트합니다. 이렇게 하면 최근 사이트 방문을 기준으로 쿠키 만료가 업데이트됩니다. 예를 들어 쿠키 만료가 1주일로 설정되어 있고 사용자가 5일마다 동일한 브라우저를 사용하여 방문한다면 쿠키 만료는 각 방문마다 업데이트되므로 실제로 만료되지 않습니다.

false로 설정하면 페이지를 로드할 때마다 쿠키가 업데이트되지 않습니다. 이는 사용자가 사이트를 처음 방문한 시점을 기준으로 쿠키가 만료되는 효과가 있습니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

쿠키 플래그

설정되면 쿠키에 추가적인 플래그가 추가됩니다. 플래그는 세미콜론으로 구분해야 합니다.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

주의: samesite를 None으로 설정하고 Secure 플래그를 생략하거나 HTTP를 통해 사이트를 제공하면 측정에 부정적인 영향을 미칩니다

사용자 ID 설정

사용자 ID는 사용자를 나타내는 고유하고 영구적인 개인 식별 ID 문자열입니다. 또한 여러 기기에서 세션 그룹을 분석할 수 있습니다. User ID를 구현해야 하는 이유를 알아보려면 User ID 기능 사용의 이점을 참조하세요.

gtag.js로 사용자 ID를 구현하려면 속성의 config를 업데이트하여 사용자 ID를 설정합니다.

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

동의 여부에 따라 태그 동작 조정하기

사용자가 동의를 제공할 때까지 쿠키를 읽거나 쓰지 않도록 gtag.js를 구성할 수 있습니다. 자세한 내용은 동의 여부에 따라 태그 동작 조정하기를 참고하세요.