Managing User Properties

By tracking user characteristics and behavior patterns, you can implement personalized services and targeted marketing.

🔍 User Identification

Identifying Users by Properties

The AdStage Web SDK does not provide a separate user ID setting API. Instead, it records user characteristics through user properties (setUserProperties) for use in segment and funnel analysis:

// 로그인 시 사용자 속성 설정
AdStage.events.setUserProperties({
  gender: 'male',      // 'male' | 'female' | 'other' | 'unknown'
  country: 'KR',       // ISO 국가 코드
  city: 'Seoul',       // 도시명
  age: '25-34',        // 연령대
  language: 'ko-KR'    // 언어 코드
});
 
// 현재 설정된 사용자 속성 확인
const userProperties = AdStage.events.getUserProperties();
console.log('현재 사용자 속성:', userProperties);

Anonymous User Tracking

Users who are not logged in are also automatically tracked on a session basis:

// 익명 사용자 추적은 SDK에서 자동으로 관리됩니다
// 별도 설정이나 조회 API는 제공되지 않습니다
// 세션 기반으로 자동으로 추적됩니다

👤 Setting User Properties

Supported Standard Properties

These are the standard user properties supported by the SDK:

// 여러 속성 한번에 설정 (권장 방법)
AdStage.events.setUserProperties({
  age: '25',           // 연령 (문자열)
  gender: 'female',    // 'male' | 'female' | 'other' | 'unknown'
  country: 'KR',       // ISO 국가 코드 (ISO 3166-1 alpha-2)
  city: 'Seoul',       // 도시명
  language: 'ko-KR'    // 언어 코드 (BCP 47)
});
 
// 개별 속성 설정 API는 현재 제공되지 않습니다
// 모든 속성은 setUserProperties()를 통해 설정하세요

Automatically Collected Properties

Information the SDK automatically collects from the browser:

// 브라우저 언어 설정에서 자동 추출
// navigator.language → language, country 자동 설정
// 예: 'ko-KR' → language: 'ko-KR', country: 'KR'
 
// 자동 수집된 사용자 정보 확인
const userInfo = AdStage.events.getUserInfo();
console.log(userInfo);
// { language: 'ko-KR', country: 'KR' }
 
// 타임존 기반 지역 추정은 내부적으로 수행되며
// 별도 API로 노출되지 않습니다

Property Limitations

Currently, the AdStage Web SDK supports standard properties only:

// ✅ 지원되는 표준 속성
AdStage.events.setUserProperties({
  gender: 'female',      // 'male' | 'female' | 'other' | 'unknown'
  country: 'KR',         // ISO 국가 코드
  city: 'Seoul',         // 도시명
  age: '25',             // 연령 (문자열)
  language: 'ko-KR'      // 언어 코드
});
 
// ❌ 커스텀 속성은 지원하지 않음
// 대신 이벤트 파라미터를 사용하세요
AdStage.events.track('user_profile_updated', {
  subscription_tier: 'premium',    // 이벤트 파라미터로 전송
  account_type: 'business',
  last_login: '2024-01-15'
});

📊 Managing User Properties

Querying and Managing Properties

// 현재 설정된 사용자 속성 조회
const currentProperties = AdStage.events.getUserProperties();
console.log('현재 사용자 속성:', currentProperties);
 
// 개별 속성 조회 및 속성 초기화 API는 현재 제공되지 않습니다
// 모든 속성은 getUserProperties()를 통해 일괄 조회하세요
 
// 속성을 초기화하려면 빈 객체로 설정
AdStage.events.setUserProperties({});

Leveraging Location Information

// 브라우저 기반 자동 수집 정보 확인
const userInfo = AdStage.events.getUserInfo();
console.log('자동 수집된 사용자 정보:', userInfo);
// { language: 'ko-KR', country: 'KR' }
 
// 지역 정보는 내부적으로 자동 추정되어 설정됩니다
// 수동으로 더 정확한 정보가 있다면 덮어쓸 수 있습니다
AdStage.events.setUserProperties({
  country: 'KR',
  city: 'Seoul',
  language: 'ko-KR'
});

🎯 Leveraging Personalization

Personalization Based on User Properties

// 사용자 속성 기반 콘텐츠 추천
function personalizeContent() {
  const userProperties = AdStage.events.getUserProperties();
  
  // 연령대별 콘텐츠
  if (userProperties.age && parseInt(userProperties.age) < 30) {
    showYoungAdultContent();
  }
  
  // 지역별 콘텐츠
  if (userProperties.country === 'KR') {
    showKoreanContent();
  }
  
  // 언어별 콘텐츠
  if (userProperties.language?.startsWith('ko')) {
    setKoreanLanguage();
  }
}
 
// 속성 변경 시 개인화 업데이트
AdStage.events.setUserProperties({
  country: 'KR',
  language: 'ko-KR',
  age: '28'
});
personalizeContent();

Using Properties with Events

// 사용자 속성은 모든 이벤트에 자동으로 포함됩니다
AdStage.events.track('page_view', {
  page: 'product_detail',
  product_id: 'prod_123'
});
// 서버에서 받는 데이터에는 설정된 사용자 속성이 포함됩니다:
// {
//   eventName: 'page_view',
//   user: {
//     gender: 'female',
//     country: 'KR',
//     city: 'Seoul',
//     age: '28',
//     language: 'ko-KR'
//   },
//   params: { page: 'product_detail', product_id: 'prod_123' }
// }

Managing User Properties

Table of Contents