이벤트

이 도움말에서는 유니버설 애널리틱스(UA) 이벤트를 Google 애널리틱스 4(GA4) 이벤트로 이전하는 방법을 안내해드립니다.

UA와 GA4의 측정 모델은 서로 다르기 때문에 기존의 UA 이벤트 구조를 GA4로 이전하기보다는 GA4 모델의 관점에서 데이터를 다시 수집하는 것이 좋습니다.

GA4 이벤트에 관해 자세히 알아보려면 이벤트에 관해를 읽어보세요.

UA 및 GA4 이벤트의 비교

유니버설 애널리틱스

유니버설 애널리틱스 (UA)의 경우 조회수를 전송하여 측정이 이루어집니다. 대부분의 조회수 유형은 특정 상호작용(예: pageview)을 측정하는 데 사용되지만 event 조회수 유형은 맞춤/일반 측정에 사용할 수 있습니다. event 조회수와 함께 전송되는 데이터에는 카테고리, 작업, 라벨이 포함됩니다.

다음은 analytics.jsgtag.js 라이브러리의 유니버설 애널리틱스 이벤트 예입니다.

analytics.js(UA)

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js(UA)

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google 애널리틱스 4

Google 애널리틱스 4 (GA4)의 경우 이벤트를 전송하여 측정이 이루어집니다. 자동으로 수집되는 이벤트, 사전 정의되고 적절한 경우 전송하도록 추천되는 이벤트, 자동 이벤트 또는 추천 이벤트가 사용 사례를 충족하지 못하는 경우 전송할 수 있는 맞춤 이벤트가 있습니다.

다음은 GA4의 맞춤 이벤트 예입니다.

gtag.js(GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

UA 이벤트를 GA4에 매핑

UA 이벤트를 GA4로 이전하려면 동등한 GA4 이벤트가 있는지 확인해야 합니다. UA 이벤트를 GA4에 매핑하려면 다음과 같은 단계별 접근 방식을 사용하세요.

  1. 자동 수집 이벤트 목록을 검토합니다. GA4 자동 수집 이벤트가 UA 이벤트와 거의 일치하는 경우 UA 이벤트를 삭제하고 자동 수집 이벤트를 사용합니다.

  2. 이전 단계에서 일치하는 이벤트를 찾지 못한 경우 향상된 측정을 통해 수집된 이벤트를 검토합니다. GA4 향상된 측정 이벤트가 UA 이벤트의 목적과 거의 일치하는 경우 UA 이벤트를 이전하지 말고 대신 향상된 측정을 사용하여 이벤트를 전송합니다. 향상된 측정이 GA4 속성에서 이벤트를 수집할 수 있도록 올바르게 구성되어 있는지 확인해야 합니다.

  3. 이전 단계에서 일치하는 이벤트를 찾지 못한 경우 추천 이벤트 목록을 검토합니다. GA4 추천 이벤트가 UA 이벤트의 목적과 거의 일치하는 경우 추천 이벤트를 사용하고 이벤트를 전송할 때 관련된 이벤트 매개변수를 모두 설정합니다.

  4. 이전 단계에서 일치하는 이벤트를 찾지 못한 경우 맞춤 이벤트를 전송합니다.

이전 시나리오 및 예

자동 수집 이벤트

자동 수집 이벤트는 항상 전송되며 일반적으로 향상된 측정을 통해 구성할 수 없으면 사용 중지할 수 없습니다. 일반적으로 충분히 동등한 자동 수집 이벤트가 없는 UA 이벤트는 이전해서는 안 됩니다.

예를 들어 파일 다운로드 상호작용을 측정하기 위해 전송된 UA 이벤트는 GA4의 file_download 이벤트가 자동으로 수집되므로 GA4로 이전할 필요가 없습니다.

향상된 측정

일반적으로 향상된 측정을 통해 충분히 동등한 GA4 이벤트가 수집되는 경우 UA 이벤트를 GA4로 이전할 필요가 없습니다. 예를 들어 다음 UA 이벤트는 향상된 측정을 통해 GA4에서 이미 측정되었으므로 GA4로 이전할 필요가 없습니다.

향상된 측정 재정의

향상된 측정 이벤트가 목적상 UA 이벤트와 동등하지만 필요한 모든 데이터를 캡처하지 못하는 경우 추가 맞춤 매개변수와 함께 이벤트를 직접 전송할 수 있습니다. 이를 위해서는 해당 이벤트에 대한 향상된 측정을 구성/사용 중지하고 직접 GA4 이벤트를 전송해야 합니다.

예를 들어 향상된 측정을 통해 수집되는 file_download 이벤트는 UA 이벤트와 거의 일치하지만 파일 크기에 대한 정보가 포함되지 않습니다. 향상된 측정 이벤트를 재정의하고 파일 크기 정보를 포함하려면 다음 단계를 따르세요.

  1. 향상된 측정에서 파일 다운로드를 사용 중지합니다.
  2. 필요한 경우 맞춤 매개변수와 함께 file_download 이벤트를 직접 전송하세요.
    • 자동 수집 이벤트는 향상된 측정을 통해 사용 중지되므로 일반적으로 이벤트와 함께 수집되는 매개변수(예: file_extension, file_name)를 수동으로 설정해야 합니다.
  3. 맞춤 측정기준/측정항목을 만들어 보고서에서 맞춤 매개변수 값을 확인합니다.

다음 gtag.js 예에서는 file_size 맞춤 매개변수와 함께 GA4 file_download 이벤트를 전송합니다.

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

UA 이벤트와 충분히 동등한 GA4 추천 이벤트가 있는 경우 UA 이벤트를 추천 이벤트로 이전하세요.

다음 예는 로그인을 측정하기 위한 analytics.js UA 이벤트입니다.

ga('send', 'event', 'login', 'google-sso');

GA4 login 이벤트를 사용하여 UA 이벤트를 GA4로 이전할 수 있습니다. 동등한 GA4 gtag.js 이벤트는 다음과 같습니다.

gtag('event', 'login', {
  method: 'google-sso'
});

맞춤 이벤트

UA 이벤트에 해당하는 자동 수집 이벤트, 향상된 측정 또는 추천 이벤트가 없는 경우 UA 이벤트를 이전하고 필요에 따라 맞춤 측정기준 및 측정항목을 만듭니다.

다음 예에서는 UI 방향 옵션의 변경사항을 측정하는 analytics.js UA 이벤트를 보여줍니다.

ga('send', 'event', 'orientation', 'layout', 'wide');

위의 UA 이벤트를 측정하기 위한 사전 정의된 GA4 이벤트는 없습니다. 대신 다음 gtag.js 예에서는 맞춤 이벤트를 사용하여 GA4에서 동일한 상호작용을 측정하는 방법을 보여줍니다.

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

보고서에 ui_elementconfiguration을 포함하려면 이러한 이벤트 매개변수에서 해당하는 측정기준을 만들어야 합니다. 자세한 내용은 맞춤 측정기준 및 측정항목을 참고하세요.