Google의 새로운 태그 플랫폼 문서를 미리 확인해 주셔서 감사합니다. 이 사이트는 공개 베타 버전입니다 (의견 보내기).

제품 구성 및 데이터 전송

전체 스니펫 모든 페이지에서 gtag() 명령어를 호출할 수 있습니다. gtag() 내에 사용 가능한 명령어는 세 가지로, configset는 일반 속성을 설정하는 데 사용되고, event는 데이터를 전송하는 데 사용됩니다.

config를 사용한 제품 초기화

config 명령어를 사용하여 특정 제품 계정의 설정을 초기화하고 구성할 수 있습니다. config 명령어는 다음과 같은 형식을 취합니다.

gtag('config', '<TARGET_ID>', {<additional_config_info>});

여기서 <TARGET_ID> 는 데이터를 전송할 제품 계정의 ID이고, <additional_config_info>는 추가 구성 옵션을 지정하는 데 사용되는 선택적 객체입니다.

config 명령어를 사용하면 gtag.js를 처리해야 하는 제품 및 계정을 지정하고 연결될 구성을 지정할 수 있습니다. target_ID에 지정된 제품에 따라 config 명령어가 해당 제품의 특정 동작을 시작할 수도 있습니다. 예를 들어 페이지 조회를 시작하도록config 명령어가 gtag.js에 지시하는 경우도 있습니다. 개별 제품과 관련하여 config 명령어가 작동하는 방식에 대해 자세히 알아보려면 제품별 문서를 참고하세요.

가장 기본적인 예시는 config 명령어와 target_ID로 구성됩니다.

gtag('config', 'G-XXXXXX');

선택사항인 <additional_config_info> 객체에 매개변수를 지정하여 config 명령어를 조정하고 확장할 수 있습니다. 예를 들어 다음 매개변수를 추가하면 Google 애널리틱스 페이지 조회가 자동으로 전송되지 않습니다.

gtag('config', 'G-XXXXXX', {'send_page_view': false});

event를 사용한 데이터 전송

event 명령어는 이벤트 데이터를 전송하는 방법입니다. 예를 들어 event 명령어를 사용하여 method 값이 'Google'인 login 이벤트를 전송할 수 있습니다.

gtag('event', 'login', {
  'method': 'Google'
});

특정 컨텍스트에서 유용한 권장 매개변수와 함께 일련의 추천 이벤트가 있습니다. 추천 이벤트 목록에 포함되지 않은 맞춤 이벤트를 전송할 수도 있습니다.

set를 사용하여 모든 이벤트에 관한 데이터 전송

set 명령어를 사용하면 페이지의 모든 후속 이벤트와 연결되는 매개변수를 설정할 수 있습니다. 예를 들어 사이트에서 발생하는 모든 거래가 동일한 통화를 사용하는 경우 set 명령어를 사용하여 currency 필드를 지정할 수 있습니다.

gtag('set', {'currency': 'USD'});

단일 set 명령어를 통해 여러 속성을 설정할 수 있습니다.

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});