이벤트 매개변수 설정

이 가이드에서는 이벤트에서 더 많은 정보를 수집할 수 있도록 웹사이트에서 추천 이벤트맞춤 이벤트의 매개변수를 설정하는 방법을 설명합니다. 상품 범위 매개변수를 추가하는 방법에 대한 자세한 내용은 전자상거래 측정을 참고하세요.

대상

이미 설정한 이벤트를 통해 사용자 활동에 대한 자세한 정보를 수집하려면 다음을 따르세요.

웹사이트에서 Google 태그(gtag.js) 또는 Google 태그 관리자를 사용합니다. 모바일 앱의 이벤트 매개변수를 설정하려면 이벤트 로깅을 참고하세요.


시작하기 전에

이 가이드에서는 다음 작업을 완료했다고 가정합니다.

또한 다음 권한이 있다고 가정합니다.

  • 웹사이트 소스 코드에 대한 액세스 권한
  • Google 애널리틱스 계정에 대한 편집자 이상의 역할

이 가이드를 읽기 전에 이벤트 설정도 읽어보시기 바랍니다.

이벤트 매개변수 이해

매개변수는 사용자가 웹사이트와 상호작용하는 방식에 대한 추가 정보를 제공합니다. 예를 들어 판매 중인 제품을 사용자가 조회할 때 사용자가 조회한 제품을 설명하는 매개변수(예: 이름, 카테고리, 가격)를 포함할 수 있습니다.

자동으로 수집되는 이벤트와 향상된 측정 이벤트에는 기본적으로 매개변수가 포함됩니다. Google에서는 각 추천 이벤트에 포함할 수 있는 일련의 필수 및 선택 매개변수도 제공합니다. 또한 필요에 따라 이벤트 매개변수를 추가할 수도 있습니다.

이벤트 매개변수 설정

이벤트의 구조는 다음과 같습니다. 여기서 <event_parameters>는 이벤트 매개변수이며 키-값 쌍으로 작성됩니다.

gtag('event', '<event_name>', {
  <event_parameters>
});

다음 예를 참고하세요.

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

이 예는 다음과 같습니다.

  • app_namescreen_name은 이벤트 매개변수 이름입니다.
  • myAppNameHome은 이벤트 매개변수 값입니다.

모든 이벤트에 매개변수 설정

이전 섹션의 예에서는 gtag() 함수의 event 명령어를 사용하여 한 이벤트의 매개변수를 전송합니다. <head> HTML 태그의 Google 태그 스니펫에 있는 config 명령어를 업데이트하여 페이지의 모든 이벤트와 함께 매개변수를 전송할 수도 있습니다.

다음 코드는 페이지 제목을 설정한 후 페이지의 모든 이벤트와 함께 매개변수를 전송합니다.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
</script>

페이지에 태그 ID를 두 개 이상 추가하는 경우 config 명령어를 업데이트하는 대신 set 명령어를 추가하세요. 그러면 모든 ID가 설정된 매개변수를 상속합니다. set 명령어를 config 명령어 에 삽입하세요.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

애널리틱스에서 이벤트 보기

실시간DebugView 보고서를 사용하여 이벤트와 매개변수를 볼 수 있습니다. 보고서를 사용하려면 DebugView 보고서에 추가 구성이 필요합니다. 이 두 보고서에서는 이벤트가 트리거될 때 사용자가 웹사이트에서 트리거한 이벤트를 보여줍니다.

일부 매개변수는 Google 애널리틱스에서 사전 빌드된 측정기준 및 측정항목을 자동으로 채웁니다. 예를 들어 자동으로 수집되는 이벤트 및 향상된 측정 이벤트의 매개변수와, 추천 이벤트와 함께 전송되는 필수 및 선택 매개변수를 통해 사전 빌드된 측정기준과 측정항목이 채워집니다.

다른 매개변수의 경우, Google 애널리틱스에서 매개변수 값을 보려면 맞춤 측정기준 및 측정항목을 만들어야 합니다. 맞춤 매개변수를 만들 때마다 이에 상응하는 맞춤 측정기준 또는 측정항목을 만들어야 해당 데이터를 볼 수 있습니다.

다음 단계

맞춤 이벤트 매개변수의 맞춤 측정기준 및 측정항목을 만듭니다.