이 페이지는 Cloud Translation API를 통해 번역되었습니다.

구성

이 문서에는 Google 애널리틱스의 모든 구성 필드가 나와 있습니다.

allow_google_signals

서드 파티 광고 식별자 기반 광고 기능을 사용 중지하려면 allow_google_signals를 false로 설정하세요.

필드 이름	유형	기본값
`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_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

필드 이름	유형	기본값
`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'
});

cookie_domain

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

도메인을 지정하지 않고 쿠키를 설정하려면 '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'
});

cookie_expires

조회가 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

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

필드 이름	유형	기본값
`cookie_flags`	`string`

예

전역으로 설정

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

단일 스트림에 설정

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

cookie_path

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

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

예

전역으로 설정

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

단일 스트림에 설정

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

cookie_prefix

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

필드 이름	유형	기본값
`cookie_prefix`	`string`

예

전역으로 설정

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

단일 스트림에 설정

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

cookie_update

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

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

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

예

전역으로 설정

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

단일 스트림에 설정

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

ignore_referrer

애널리틱스에서 리퍼러를 트래픽 소스로 표시해서는 안 된다는 것을 인식하도록 하려면 true로 설정합니다. 이 필드를 사용해야 하는 경우 알아보기

필드 이름	유형	기본값
`ignore_referrer`	`boolean`	false

예

전역으로 설정

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

단일 스트림에 설정

gtag('config', 'STREAM_ID', {
  'ignore_referrer': 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`입니다.	1000

예

전역으로 설정

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`입니다.	420

예

전역으로 설정

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`입니다.	300

예

전역으로 설정

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`		256

예

전역으로 설정

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

단일 스트림에 설정

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

user_properties

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

필드 이름	유형	기본값	글자 수 제한
`user_properties`	`object`		속성 이름=24 속성 값=36

예

전역으로 설정

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

단일 스트림에 설정

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