사용자 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"를 보내지 마세요.