구성

이 문서에는 GA4에 대한 모든 구성 필드가 나와 있습니다.

allow_google_signals

모든 광고 기능을 사용 중지하려면 allow_google_signalsfalse로 설정하세요.

필드 이름 유형 기본값
allow_google_signals boolean

전역으로 설정

gtag('set', 'allow_google_signals', true);

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

광고 개인 최적화 기능을 사용 중지하려면 false로 설정하세요.

필드 이름 유형 기본값
allow_ad_personalization_signals boolean

전역으로 설정

gtag('set', 'allow_ad_personalization_signals', true);

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

A/B 테스트 및 콘텐츠 타겟팅 광고에 사용됩니다. campaign_content을 사용하여 동일한 URL을 가리키는 광고 또는 링크를 구분할 수 있습니다.

필드 이름 유형 기본값
campaign_content string undefined

전역으로 설정

gtag('set', 'campaign_content', 'logolink');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

이 추천에서 참조하는 캠페인을 식별하는 데 사용됩니다. campaign_id를 사용하여 특정 캠페인을 식별합니다.

필드 이름 유형 기본값
campaign_id string undefined

전역으로 설정

gtag('set', 'campaign_id', 'abc.123');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

campaign_medium를 사용하여 이메일 또는 클릭당비용과 같은 매체를 식별합니다.

필드 이름 유형 기본값
campaign_medium string undefined

전역으로 설정

gtag('set', 'campaign_medium', 'cpc');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

키워드 분석에 사용됩니다. campaign_name를 사용하여 특정 제품 프로모션 또는 전략적 캠페인을 식별합니다.

필드 이름 유형 기본값
campaign_name string undefined

전역으로 설정

gtag('set', 'campaign_name', 'spring_sale');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

campaign_source를 사용하여 검색엔진, 뉴스레터 이름 또는 기타 소스를 식별합니다.

필드 이름 유형 기본값
campaign_source string undefined

전역으로 설정

gtag('set', 'campaign_source', 'google');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

유료 검색에 사용됩니다. 이 광고의 키워드를 보려면 campaign_term를 사용하세요.

필드 이름 유형 기본값
campaign_term string undefined

전역으로 설정

gtag('set', 'campaign_term', 'running+shoes');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

캠페인

설정할 수 있는 모든 캠페인 값이 포함된 객체입니다.

campaign 객체는 기존 구현을 지원하기 위해 제공되며 대부분의 경우 권장되지 않습니다. 대신 각 필드의 campaign 프리픽스 버전을 사용해야 합니다.

필드 이름 유형 기본값
campaign object undefined

전역으로 설정

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

브라우저 인스턴스를 익명화합니다. 기본적으로 이 값은 2년 만료 후 제1사 애널리틱스 쿠키의 일부로 저장됩니다.

필드 이름 유형 기본값
client_id string 각 사용자에 대해 무작위로 생성된 값입니다.

전역으로 설정

gtag('set', 'client_id', 'aaa.bbb');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

필드 이름 유형 기본값
content_group string

전역으로 설정

gtag('set', 'content_group', '/news/sports');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

애널리틱스 쿠키를 저장하는 데 사용하는 도메인을 지정합니다.

도메인을 지정하지 않고 쿠키를 설정하려면 'none'로 설정합니다.

'auto'로 설정 (기본값)하여 최상위 도메인과 하나의 하위 도메인 (eTLD +1)으로 쿠키를 설정합니다. 예를 들어 cookie_domain'auto'로 설정된 경우 https://example.com은 도메인에 example.com을 사용하고 https://subdomain.example.com는 도메인에 example.com도 사용합니다.

필드 이름 유형 기본값
cookie_domain string 'auto'

전역으로 설정

gtag('set', 'cookie_domain', 'example.com');

단일 스트림에 설정

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

조회가 Google 애널리틱스로 전송될 때마다 쿠키 만료 시간이 현재 시간 + cookie_expires 필드 값으로 업데이트됩니다. 즉, 기본값 시간 (2년, 6,307,2000 초)을 사용하는 경우 사용자가 매월 사이트에 방문하더라도 쿠키는 만료되지 않습니다.

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

필드 이름 유형 기본값
cookie_expires number 63072000

전역으로 설정

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

설정되면 쿠키에 추가 플래그가 추가됩니다. 플래그는 세미콜론으로 구분해야 합니다. 설정할 플래그의 예는 새 쿠키 작성을 참조하세요.

필드 이름 유형 기본값
cookie_flags string

전역으로 설정

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

단일 스트림에 설정

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

분석 쿠키를 저장하는 데 사용되는 하위 경로를 지정합니다.

필드 이름 유형 기본값
cookie_path string '/'

전역으로 설정

gtag('set', 'cookie_path', '/example_path');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

애널리틱스 쿠키 이름 앞에 추가할 프리픽스를 지정합니다.

필드 이름 유형 기본값
cookie_prefix string

전역으로 설정

gtag('set', 'cookie_prefix', 'prefix');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

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

false(으)로 설정할 경우 페이지 로드 시 쿠키가 업데이트되지 않습니다. 이는 사용자가 사이트를 처음 방문했을 때의 시점을 기준으로 쿠키가 만료되는 것과 같은 효과를 갖습니다.

필드 이름 유형 기본값
cookie_update boolean true

전역으로 설정

gtag('set', 'cookie_update', true);

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

언어

사용자의 언어 환경설정을 지정합니다. 기본값은 사용자의 navigator.language 값입니다.

필드 이름 유형 기본값
language string 기본값은 navigator.language입니다.

전역으로 설정

gtag('set', 'language', 'en-us');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

페이지의 전체 URL을 지정합니다. 기본값은 사용자의 document.location 값입니다.

필드 이름 유형 기본값
page_location string 기본값은 document.location입니다.

전역으로 설정

gtag('set', 'page_location', 'https://example.com/page1');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

페이지로 트래픽을 유도한 추천 소스를 지정합니다. 이 값은 트래픽 소스를 계산하는 데도 사용됩니다. 이 값의 형식은 URL입니다. 기본값은 사용자의 document.referrer 값입니다.

필드 이름 유형 기본값
page_referrer string 기본값은 document.referrer입니다.

전역으로 설정

gtag('set', 'page_referrer', 'https://example.com');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

페이지 또는 문서 제목입니다. 기본값은 사용자의 document.title 값입니다.

필드 이름 유형 기본값
page_title string 기본값은 document.title입니다.

전역으로 설정

gtag('set', 'page_title', 'Settings');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

false로 설정하면 기본 스니펫에서 page_view를 전송하지 않습니다.

필드 이름 유형 기본값
send_page_view boolean

전역으로 설정

gtag('set', 'send_page_view', false);

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

화면의 해상도를 지정합니다. x으로 구분된 양의 정수여야 합니다. 예를 들어 800x600픽셀 화면은 800x600입니다. 사용자의 window.screen 값에서 계산됩니다.

필드 이름 유형 기본값
screen_resolution string 기본값은 window.screen부터 계산됩니다.

전역으로 설정

gtag('set', 'screen_resolution', '800x600');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

사이트 소유자/라이브러리 사용자가 제공한 사용자의 알려진 식별자를 지정합니다. 그 자체가 PII (개인 식별 정보)여서는 안 됩니다. 이 값은 Google 애널리틱스 쿠키 또는 애널리틱스에서 제공하는 다른 스토리지에 유지하면 안 됩니다.

필드 이름 유형 기본값
user_id string

전역으로 설정

gtag('set', 'user_id', 'id');

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

사용자 속성은 언어 환경설정, 지리적 위치와 같은 사용자층을 나눈 세그먼트를 기술하는 데 사용할 수 있는 속성입니다. 프로젝트당 최대 25개의 추가 사용자 속성을 설정할 수 있습니다.

필드 이름 유형 기본값
user_properties object

전역으로 설정

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});