사용자 ID 보내기

사용자 ID는 개별 사용자에게 할당하는 고유 식별자입니다. 이 가이드에서는 Google 애널리틱스로 사용자 ID를 전송하여 여러 세션, 기기, 플랫폼에서 사용자 행동을 연결하는 방법을 설명합니다.

User-ID 기능을 자세히 알아보려면 활동 플랫폼 간 측정하기를 참고하세요. 앱의 사용자 ID를 설정하는 방법을 알아보려면 사용자 ID 설정을 참고하세요.

user_id 매개변수는 맞춤 사용자 속성 또는 표준 이벤트 매개변수가 아닌 구성 매개변수입니다. 대신 user_id는 기기 및 세션 전반에서 인증된 사용자를 식별하는 데 특별히 사용되는 예약된 시스템 매개변수입니다. 맞춤 사용자 속성으로 설정하지 말고 (예: gtag.js의 user_properties 객체 또는 Google 태그 관리자 태그의 사용자 속성 섹션) 애널리틱스 UI에서 맞춤 측정기준으로 등록하지 마세요. 마찬가지로 개별 이벤트에서 이벤트 수준 매개변수로 전달하지 마세요. 대신 다음 방법을 사용하여 user_id를 구성 매개변수로만 설정하세요.


시작하기 전에

사용자 ID를 전송하려면 먼저 다음 작업을 완료해야 합니다.

사용자 ID 보내기

user_id에 전송하는 값은 사용자의 상태에 따라 다릅니다.

  • 사용자가 로그인한 적이 없음: user_id 매개변수를 전송하지 마세요.
  • 사용자가 로그인함: 사용자 ID를 전송합니다.
  • 사용자가 로그인했다가 로그아웃함: null을 전송합니다.

애널리틱스로 사용자 ID를 전송하려면 웹사이트의 각 페이지에 있는 config 명령어에 user_id 매개변수를 추가합니다.

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. TAG_ID을(를) 태그 ID로 바꿉니다.
  2. 사용자가 로그인했는지, 사용자가 로그인했다가 로그아웃했는지 확인하는 검사로 주석을 바꿉니다.
  3. 사용자가 로그인한 경우 USER_ID를 사용자 ID로 바꿉니다.
  4. 사용자가 로그아웃하면 user_id를 null로 설정합니다. 빈 문자열 (""), 공백 문자열 (" "), 따옴표로 묶인 단어 "null" 또는 "NULL"을 전송하지 마세요.

초기화 후 사용자 ID 설정

대부분의 경우 Google 태그가 처음 초기화될 때 user_id를 알 수 없습니다. 예를 들어 사용자가 사이트를 방문하고 나중에 로그인할 수 있습니다.

초기 페이지 로드 후 user_id를 설정하거나 업데이트하려면 gtag('set') 명령어를 사용합니다. 이 명령어는 페이지의 모든 후속 이벤트에 대해 user_id를 설정하며 이 시나리오에서 gtag('config') 대신 권장되는 접근 방식입니다.

로그인 시 사용자 ID 설정

사용자가 로그인에 성공하면 gtag('set')을 호출하여 ID를 향후 이벤트와 연결합니다.

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

로그아웃 시 사용자 ID 지우기

사용자가 로그아웃하면 값을 null로 설정하여 user_id를 지워야 합니다.

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

gtag('set')을 사용하면 사용자 세션 전반에서 user_id이 올바르게 관리되어 페이지가 로드된 후 변경되더라도 사용자의 현재 로그인 상태를 반영합니다.

Google 애널리틱스에서 User-ID가 사용되는 방식

Google 애널리틱스로 user_id 값을 전송하면 다음과 같은 용도로 사용됩니다.

  • 사용자 여정 통합: 로그인한 사용자의 여러 세션, 기기, 플랫폼에서 사용자 활동을 연결합니다.
  • 사용자 수 개선: 중복이 삭제된 사용자 측정항목을 더 정확하게 제공합니다.
  • 분석 사용 설정:
    • 로그인 상태를 기반으로 활동 분석: '사용자 ID로 로그인함'과 같은 측정기준을 사용하여 표준 보고서에서 비교를 만들거나 탐색 분석에서 세그먼트를 만듭니다.
    • 사용자 탐색 분석 탐색 분석 기법을 지원하여 개별 사용자의 활동 타임라인으로 드릴 다운할 수 있습니다.

중요 고려사항

  • 사용자 ID에 대한 맞춤 측정기준을 만들지 마세요. user_id를 사용자 범위 맞춤 측정기준으로 등록해서는 안 됩니다. 이는 핵심 권장사항입니다. 이렇게 하면 불필요하게 카디널리티가 높은 측정기준이 생성되어 보고서 실적에 심각한 영향을 미치고 데이터가 '(기타)' 행으로 그룹화되며 맞춤 측정기준 할당량이 소진될 수 있습니다. 기본 제공 User-ID 기능은 사용자 스티칭을 처리합니다. User-ID 권장사항에서 자세히 알아보세요.

  • user_id를 사용자 속성 또는 이벤트 매개변수가 아닌 구성 설정으로 설정하세요. user_id는 예약된 시스템 매개변수이므로 구성 또는 설정 매개변수 (gtag() config 또는 set 명령어 또는 Google 태그 관리자의 Google 태그 구성 설정 사용)로만 적용해야 합니다. 맞춤 사용자 속성으로 구성하거나 user_properties 설정 객체 내에서 전달하거나 개별 이벤트에서 이벤트 수준 매개변수로 전송하지 마세요.

  • 표준 보고서와 탐색 분석의 직접 ID 공개 상태: 개인 정보 보호 및 카디널리티 관리를 위해 원시 user_id 값은 표준 보고서 또는 대부분의 탐색 분석 (예: 자유 형식)에서 표준 측정기준으로 사용할 수 없습니다. 하지만 로그인한 사용자의 경우 사용자 탐색 분석 템플릿의 유효 사용자 ID 라벨이 지정된 열에서 원시 user_id를 볼 수 있습니다.

  • 원시 사용자 ID 액세스: 원시 user_id 값을 사용하여 분석을 실행해야 하는 경우 GA4 BigQuery Export를 사용하는 것이 좋습니다. 내보낸 데이터에서 user_id 필드를 사용할 수 있습니다.

User-ID 데이터가 사용자 탐색 분석에서 사용되고 표시되도록 하려면 속성의 보고서 ID가 혼합 또는 관찰됨으로 설정되어 있는지 확인하세요.