유니버설 애널리틱스(UA)는 2023년 7월 1일부터 지원이 중단되어 더 이상 데이터를 처리하지 않습니다. 2023년 10월 1일부터 애널리틱스 360 속성이 더 이상 작동하지 않습니다. Google 애널리틱스 4로 이전

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'
});

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

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

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

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

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

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

false로 설정하면 페이지를 로드할 때마다 쿠키가 업데이트되지 않습니다. 이렇게 하면 사용자가 사이트를 처음 방문했을 때를 기준으로 쿠키 만료 효과가 발생합니다.

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

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

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

사용자 ID 설정

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

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

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

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