사용자 ID 보내기

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

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

사용자 ID를 기반으로 맞춤 측정기준을 설정하면 고유 값이 너무 많은 측정기준이 생성됩니다. 고유한 값이 너무 많으면 Google 애널리틱스 데이터와 보고 정확성에 문제가 발생합니다. 맞춤 측정기준 설정에 관한 권장사항 자세히 알아보기


시작하기 전에

사용자 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이 올바르게 관리되어 사용자의 현재 로그인 상태가 반영됩니다.