사용자 ID 보내기

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

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

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


시작하기 전에

사용자 ID를 전송하기 전에 다음을 완료해야 합니다.

사용자 ID 보내기

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

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

1단계: 데이터 영역 업데이트

사용자 ID를 애널리틱스로 전송하기 전에 웹사이트의 데이터 영역에서 user_id를 사용할 수 있도록 설정합니다.

초기 페이지 로드 중에 또는 페이지가 로드된 후에(예: 사용자가 로그인할 때) 데이터 영역을 업데이트할 수 있습니다. dataLayer.push를 호출할 때마다 연결된 태그 관리자 태그가 업데이트된 user_id를 수신합니다.

핵심 사항: user_id가 초기 페이지 조회 이벤트 및 모든 후속 이벤트와 연결되도록 하려면 데이터 영역을 선언하고 페이지의 Google 태그 관리자 컨테이너 스니펫 위(앞)에 user_id를 푸시해야 합니다. user_id가 GTM 스니펫 이후에 푸시되면 컨테이너 로드 이벤트에서 태그가 실행될 때 사용할 수 없습니다.

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

2단계: 데이터 영역 변수 만들기

  1. Google 태그 관리자에서 변수를 클릭합니다.
  2. 사용자 정의 변수 섹션에서 새로 만들기를 클릭합니다.
  3. 변수 구성 > 데이터 영역 변수를 클릭합니다.
  4. 상단에 변수 이름을 입력합니다.
  5. 데이터 영역 변수 이름 필드에 사용자 ID 변수의 이름(예: 'user_id')을 입력합니다.
  6. 저장을 클릭합니다.

3단계: Google 태그 수정

마지막으로, 태그와 연결된 모든 이벤트가 데이터 영역 변수를 사용하도록 구성 태그를 수정합니다.

  1. 태그 관리자에서 태그 메뉴 항목 태그를 클릭합니다.
  2. Google 태그를 선택합니다.
  3. 구성 설정 섹션에서 다음 매개변수가 있는 새 행을 추가합니다.
    • 매개변수: user_id
    • 값: 생성한 데이터 영역 변수를 선택합니다.
  4. 저장을 클릭합니다.
  5. 제출을 클릭하여 변경사항을 게시합니다.

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

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

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

중요 고려사항

  • 사용자 ID에 대한 맞춤 측정기준을 만들지 마세요. user_id를 사용자 범위 맞춤 측정기준으로 등록하면 안 됩니다. 이는 핵심 권장사항입니다. 이렇게 하면 불필요하게 카디널리티가 높은 측정기준이 생성되어 보고서 성능에 심각한 영향을 미치고, 데이터가 '(other)' 행으로 그룹화되며, 맞춤 측정기준 할당량이 소모될 수 있습니다. 기본 제공되는 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가 혼합 또는 관찰됨으로 설정되어 있는지 확인하세요.