@adstage/web-sdk 2.6.1 → 2.6.3

package/dist/index.d.ts

@@ -21,6 +21,8 @@ interface AdStageConfig {
     timeout?: number;
     /** 플레이스홀더 스타일 모드 (기본값: 'subtle') */
     placeholderMode?: 'invisible' | 'transparent' | 'subtle' | 'minimal' | 'debug' | 'legacy';
+    /** 고객 앱 버전 (선택사항, 기본값: '1.0.0') */
+    appVersion?: string;
 }
 /**
  * 모듈 기본 인터페이스
@@ -390,8 +392,8 @@ declare class ConfigModule implements BaseModule {
 }
 
 /**
- * AdStage SDK - Events 모듈 (기본 구조)
- * 이벤트 추적 시스템 - Q1 2025 구현 예정
+ * AdStage SDK - Events 모듈
+ * 이벤트 추적 시스템
  */
 
 interface EventProperties {
@@ -419,33 +421,42 @@ declare class EventsModule implements BaseModule {
      */
     getConfig(): AdStageConfig | null;
     /**
-     * 커스텀 이벤트 추적
-     * @example AdStage.events.track('page_view', { page: '/products' })
+     * 사용자 ID 설정
      */
-    track(eventName: string, properties?: EventProperties): Promise<void>;
+    setUserId(userId: string): void;
     /**
-     * 페이지 뷰 이벤트
-     * @example AdStage.events.pageView({ page: '/home', title: 'Homepage' })
+     * 현재 사용자 ID 반환
      */
-    pageView(pageData?: PageData): Promise<void>;
+    getUserId(): string | undefined;
     /**
-     * 사용자 액션 이벤트
-     * @example AdStage.events.userAction('button_click', { button_id: 'cta' })
+     * 사용자 속성 설정
      */
-    userAction(actionType: string, metadata?: EventProperties): Promise<void>;
+    setUserProperties(properties: {
+        gender?: 'male' | 'female' | 'other' | 'unknown';
+        country?: string;
+        city?: string;
+        age?: string;
+        language?: string;
+        [key: string]: any;
+    }): void;
     /**
-     * 컨버전 이벤트
-     * @example AdStage.events.conversion({ type: 'purchase', value: 99.99 })
+     * 현재 사용자 속성 반환
      */
-    conversion(conversionData: EventProperties): Promise<void>;
-    batch: {
-        start: () => void;
-        add: (eventName: string, properties: EventProperties) => void;
-        flush: () => Promise<void>;
-    };
-    realtime: {
-        track: (eventName: string, properties: EventProperties) => Promise<void>;
-    };
+    getUserProperties(): any;
+    /**
+     * 이벤트 추적
+     * @param eventName 이벤트 이름
+     * @param properties 이벤트 속성
+     */
+    track(eventName: string, properties?: EventProperties): Promise<void>;
+    /**
+     * 페이지 뷰 이벤트 (track의 편의 메소드)
+     */
+    pageView(pageData?: PageData): Promise<void>;
+    /**
+     * 서버에 이벤트 전송
+     */
+    private sendEventToServer;
 }
 
 /**
@@ -506,6 +517,45 @@ declare class AdStage {
     };
 }
 
+/**
+ * AdStage SDK - 전역 이벤트 함수들
+ * Firebase Analytics와 유사한 간단한 API 제공
+ */
+
+/**
+ * 이벤트 추적 (메인 함수)
+ * @param eventName 이벤트 이름
+ * @param properties 이벤트 속성
+ *
+ * @example
+ * track('purchase', {
+ *   transaction_id: 'T123',
+ *   value: 99.99,
+ *   currency: 'USD'
+ * });
+ */
+declare function track(eventName: string, properties?: EventProperties): Promise<void>;
+/**
+ * 페이지 뷰 추적
+ * @param pageData 페이지 정보
+ *
+ * @example
+ * pageView({ page: '/products', title: 'Products Page' });
+ */
+declare function pageView(pageData?: PageData): Promise<void>;
+/**
+ * 사용자 ID 설정
+ * @param userId 사용자 ID
+ *
+ * @example
+ * setUserId('user123');
+ */
+declare function setUserId(userId: string): void;
+/**
+ * 현재 사용자 ID 반환
+ */
+declare function getUserId(): string | undefined;
+
 interface AdStageContextType {
     isInitialized: boolean;
     config: AdStageConfig | null;
@@ -541,4 +591,4 @@ declare function useAdStageInstance(): typeof AdStage | null;
 declare const SDK_VERSION = "2.0.0";
 declare const SUPPORTED_MODULES: readonly ["ads", "events", "config"];
 
-export { AdEventType, AdOptions, AdSlot, AdStage, AdStageConfig, AdStageProvider, AdType, Advertisement, ApiResponse, BaseModule, EventProperties, ModuleName, OrganizationInfo, PageData, SDK_VERSION, SUPPORTED_MODULES, useAdStageContext, useAdStageInstance };
+export { AdEventType, AdOptions, AdSlot, AdStage, AdStageConfig, AdStageProvider, AdType, Advertisement, ApiResponse, BaseModule, EventProperties, ModuleName, OrganizationInfo, PageData, SDK_VERSION, SUPPORTED_MODULES, getUserId, pageView, setUserId, track, useAdStageContext, useAdStageInstance };