@adstage/web-sdk 2.4.12 → 2.5.1

package/src/modules/ads/AdsModule.ts

@@ -8,9 +8,7 @@ import { AdType, AdEventType } from '../../types/advertisement';
 import type { AdSlot, Advertisement } from '../../types/advertisement';
 // 렌더링 관련 매니저/뷰 트래커는 AdRenderer로 이전됨
 import { AdvertisementEventTracker } from '../../managers/ads/advertisement-event-tracker';
-import { ViewabilityTracker, VIEWABILITY_STANDARDS } from '../../managers/ads/viewability-tracker';
-import { BasicFraudDetector } from '../../managers/ads/basic-fraud-detector';
-import type { ViewabilityMetrics } from '../../managers/ads/viewability-tracker';
+import { SimpleViewabilityTracker } from '../../managers/ads/viewability-tracker';
 import { endpoints } from '../../constants/endpoints';
 import { ApiHeaders } from '../../utils/api-headers';
 // 새로 분리된 클래스들
@@ -190,16 +188,11 @@ export class AdsModule implements BaseModule {
       throw new Error(`Ad slot not found: ${slotId}`);
     }
 
-    // ViewabilityTracker 정리
+    // SimpleViewabilityTracker 정리
     if ((slot as any).viewabilityTracker) {
       (slot as any).viewabilityTracker.destroy();
     }
 
-    // BasicFraudDetector 정리
-    if ((slot as any).fraudDetector) {
-      (slot as any).fraudDetector.destroy();
-    }
-
     // DOM에서 제거
     const container = document.getElementById(slot.containerId);
     if (container) {
@@ -283,23 +276,6 @@ export class AdsModule implements BaseModule {
     return slotId;
   }
 
-  // createAdSlot 제거: AdRenderer.createPlaceholder 사용
-
-  /**
-   * 여러 광고의 최적 컨테이너 크기 계산 (동적 크기 조정)
-   */
-  // calculateOptimalContainerSize 제거: AdRenderer.calculateOptimalContainerSize 사용
-
-  /**
-   * 최적 크기 조정 전략 선택
-   */
-  // selectOptimalSizeStrategy 제거: AdRenderer 내부 구현 사용
-
-  /**
-   * 전략에 따른 최적 높이 계산
-   */
-  // calculateOptimalHeight 제거: AdRenderer 내부 구현 사용
-
   /**
    * 백그라운드에서 광고 콘텐츠 로드
    */
@@ -322,11 +298,9 @@ export class AdsModule implements BaseModule {
       if (adstageData.length > 1 || (slot.config as any)?.autoSlide) {
         await this.adRenderer?.renderAdSlider(slot, adstageData);
         
-        // 🔧 슬라이더의 첫 번째 광고도 자동 viewability 추적 시작
-        if (adstageData.length > 0) {
-          setTimeout(() => {
-            this.startBasicViewabilityTracking(slot, adstageData[0]);
-          }, 100); // 슬라이더 렌더링 완료 후 추적 시작
+        // 🔧 슬라이더는 CarouselSliderManager에서 자체적으로 모든 광고의 VIEWABLE 이벤트를 처리
+        if (this._config?.debug) {
+          console.log(`🎠 Slider will handle VIEWABLE events for ${adstageData.length} ads automatically`);
         }
       } else {
         // 광고가 1개면 일반 렌더링
@@ -334,7 +308,7 @@ export class AdsModule implements BaseModule {
   await this.adRenderer?.renderAdElement(slot, adstageData[0]);
         
         // ✅ 신규: Viewable impression 추적 시작 (기존 즉시 추적 대신)
-        this.startBasicViewabilityTracking(slot, adstageData[0]);
+        this.startSimpleViewabilityTracking(slot, adstageData[0]);
       }
       
       slot.isLoaded = true;
@@ -354,9 +328,9 @@ export class AdsModule implements BaseModule {
   // optimizeContainerForBannerAds 제거: AdRenderer.optimizeContainerForBannerAds 사용
 
   /**
-   * 기본 viewability 추적 시작 (재시도 로직 포함)
+   * 단순한 노출 추적 시작 (재시도 로직 포함)
    */
-  private startBasicViewabilityTracking(slot: AdSlot, ad: Advertisement): void {
+  private startSimpleViewabilityTracking(slot: AdSlot, ad: Advertisement): void {
     const tryStartTracking = (retryCount = 0) => {
       const element = document.getElementById(slot.id);
       
@@ -373,20 +347,16 @@ export class AdsModule implements BaseModule {
         return;
       }
       
-      // 기본 fraud 검사
-      const fraudDetector = new BasicFraudDetector();
-      
-      // viewability 추적
-      const tracker = new ViewabilityTracker(element, slot.adType, async (metrics) => {
-        await this.handleViewableEvent(ad, slot, metrics, fraudDetector);
+      // 단순한 노출 추적
+      const tracker = new SimpleViewabilityTracker(element, async () => {
+        await this.handleViewableEvent(ad, slot);
       });
       
       // 정리를 위해 저장
       (slot as any).viewabilityTracker = tracker;
-      (slot as any).fraudDetector = fraudDetector;
 
       if (this._config?.debug) {
-        console.log(`🎯 Viewability tracking started for slot: ${slot.id} (element found)`);
+        console.log(`🎯 Simple viewability tracking started for slot: ${slot.id} (element found)`);
       }
     };
 
@@ -394,41 +364,23 @@ export class AdsModule implements BaseModule {
   }
 
   /**
-   * Viewable 이벤트 처리
+   * Viewable 이벤트 처리 (단순화됨)
    */
   private async handleViewableEvent(
     ad: Advertisement, 
-    slot: AdSlot, 
-    metrics: ViewabilityMetrics,
-    fraudDetector: BasicFraudDetector
+    slot: AdSlot
   ): Promise<void> {
     try {
-      const fraudScore = fraudDetector.calculateFraudScore();
-      
-      // 높은 위험도면 차단
-      if (fraudScore.riskLevel === 'CRITICAL') {
-        if (this._config?.debug) {
-          console.warn(`🚫 Viewable blocked due to fraud risk: ${fraudScore.score}`, fraudScore.reasons);
-        }
-        return;
-      }
-      
       // VIEWABLE 이벤트 전송
       if (this.advertisementEventTracker) {
         await this.advertisementEventTracker.trackAdvertisementEvent(
           ad._id,
           slot.id,
-          AdEventType.VIEWABLE,
-          {
-            viewabilityMetrics: metrics,
-            fraudScore: fraudScore.score,
-            fraudReasons: fraudScore.reasons,
-            riskLevel: fraudScore.riskLevel
-          }
+          AdEventType.VIEWABLE
         );
         
         if (this._config?.debug) {
-          console.log(`✅ Viewable impression tracked for ad ${ad._id} (fraud score: ${fraudScore.score})`);
+          console.log(`✅ Simple viewable impression tracked for ad ${ad._id}`);
         }
       }
       
@@ -437,16 +389,6 @@ export class AdsModule implements BaseModule {
     }
   }
 
-  /**
-   * Fallback 광고 렌더링 - AdStage 확실한 컨테이너 우선 탐지
-   */
-  // renderFallback 제거: AdRenderer.renderFallback 사용
-
-  /**
-   * 빈 컨테이너 생성 (컨테이너를 찾지 못한 경우)
-   */
-  // createEmptyContainer 제거: AdRenderer 내부 구현 사용
-
   /**
    * 광고 데이터 가져오기
    */
@@ -523,21 +465,6 @@ export class AdsModule implements BaseModule {
     return advertisements;
   }
 
-  /**
-   * 광고 슬라이더 렌더링 (여러 광고 또는 autoSlide 옵션)
-   */
-  // renderAdSlider 제거: AdRenderer.renderAdSlider 사용
-
-  /**
-   * 광고 렌더링 (단일 광고용)
-   */
-  // renderAd 제거: AdRenderer.renderAd 사용
-
-  /**
-   * 광고 요소 렌더링 (기본 구현)
-   */
-  // renderAdElement 제거: AdRenderer.renderAdElement 사용
-
   /**
    * 광고 슬롯 새로고침
    */

package/src/utils/version.ts

@@ -0,0 +1,23 @@
+/**
+ * AdStage SDK - 버전 정보 유틸리티
+ */
+
+// package.json에서 버전 정보 가져오기 (빌드 시 자동으로 교체됨)
+export const SDK_VERSION = '__SDK_VERSION__';
+
+/**
+ * SDK 버전 정보 반환
+ */
+export function getSDKVersion(): string {
+  return SDK_VERSION;
+}
+
+/**
+ * 버전 정보가 포함된 User-Agent 문자열 생성
+ */
+export function getSDKUserAgent(): string {
+  if (typeof navigator !== 'undefined') {
+    return `${navigator.userAgent} AdStageSDK/${SDK_VERSION}`;
+  }
+  return `AdStageSDK/${SDK_VERSION}`;
+}

package/src/managers/ads/basic-fraud-detector.ts

@@ -1,191 +0,0 @@
-/**
- * BasicFraudDetector - 현실적 구현 버전
- * 기본적인 봇 탐지 및 간단한 행동 패턴 분석
- */
-
-export interface FraudScore {
-  score: number;           // 0-100
-  riskLevel: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
-  reasons: string[];
-}
-
-export interface BasicBrowserInfo {
-  userAgent: string;
-  language: string;
-  platform: string;
-  cookieEnabled: boolean;
-  doNotTrack: string | null;
-  timezone: string;
-  screenResolution: string;
-  viewportSize: string;
-}
-
-export class BasicFraudDetector {
-  private startTime: number;
-  private mouseEvents: number = 0;
-  private keyboardEvents: number = 0;
-  private scrollEvents: number = 0;
-  
-  constructor() {
-    this.startTime = Date.now();
-    this.initBasicTracking();
-  }
-  
-  private initBasicTracking(): void {
-    // 기본적인 사용자 상호작용 추적
-    document.addEventListener('mousemove', () => this.mouseEvents++, { passive: true });
-    document.addEventListener('keydown', () => this.keyboardEvents++, { passive: true });
-    document.addEventListener('scroll', () => this.scrollEvents++, { passive: true });
-  }
-  
-  public calculateFraudScore(): FraudScore {
-    let score = 0;
-    const reasons: string[] = [];
-    
-    // 1. 웹드라이버 탐지 (기본)
-    if (this.detectWebDriver()) {
-      score += 50;
-      reasons.push('WebDriver detected');
-    }
-    
-    // 2. 헤드리스 브라우저 기본 탐지
-    if (this.detectBasicHeadless()) {
-      score += 40;
-      reasons.push('Headless browser signatures');
-    }
-    
-    // 3. 사용자 상호작용 부족
-    const sessionTime = Date.now() - this.startTime;
-    if (sessionTime > 5000) { // 5초 이상 경과
-      if (this.mouseEvents === 0) {
-        score += 20;
-        reasons.push('No mouse interaction');
-      }
-      
-      if (this.scrollEvents === 0 && sessionTime > 10000) {
-        score += 15;
-        reasons.push('No scroll activity');
-      }
-    }
-    
-    // 4. 브라우저 환경 이상 징후
-    const browserCheck = this.checkBrowserEnvironment();
-    score += browserCheck.score;
-    reasons.push(...browserCheck.reasons);
-    
-    // 5. 시간 패턴 이상 (너무 빠른 페이지 로드 후 즉시 클릭)
-    if (sessionTime < 1000) {
-      score += 25;
-      reasons.push('Suspiciously fast interaction');
-    }
-    
-    const finalScore = Math.min(score, 100);
-    
-    return {
-      score: finalScore,
-      riskLevel: this.getRiskLevel(finalScore),
-      reasons: reasons
-    };
-  }
-  
-  private detectWebDriver(): boolean {
-    // 기본적인 웹드라이버 탐지
-    return !!(
-      (window as any).webdriver ||
-      (navigator as any).webdriver ||
-      (window as any).__webdriver_evaluate ||
-      (window as any).__selenium_evaluate ||
-      (window as any).__webdriver_script_function ||
-      (window as any).__webdriver_script_func ||
-      (window as any).__webdriver_script_fn ||
-      (window as any).__fxdriver_evaluate ||
-      (window as any).__driver_unwrapped ||
-      (window as any).__webdriver_unwrapped ||
-      (window as any).__driver_evaluate ||
-      (window as any).__selenium_unwrapped ||
-      (window as any).__fxdriver_unwrapped
-    );
-  }
-  
-  private detectBasicHeadless(): boolean {
-    const signatures: string[] = [];
-    
-    // PhantomJS 탐지
-    if ((window as any)._phantom || (window as any).phantom) {
-      signatures.push('PhantomJS');
-    }
-    
-    // Chrome headless 기본 탐지
-    if (navigator.userAgent.includes('HeadlessChrome')) {
-      signatures.push('Chrome Headless');
-    }
-    
-    // 플러그인 없음 (일반적이지 않음)
-    if (navigator.plugins.length === 0) {
-      signatures.push('No plugins');
-    }
-    
-    return signatures.length > 0;
-  }
-  
-  private checkBrowserEnvironment(): { score: number; reasons: string[] } {
-    let score = 0;
-    const reasons: string[] = [];
-    
-    // 언어 설정 이상
-    if (!navigator.language || navigator.language === 'C') {
-      score += 10;
-      reasons.push('Unusual language setting');
-    }
-    
-    // 쿠키 비활성화
-    if (!navigator.cookieEnabled) {
-      score += 15;
-      reasons.push('Cookies disabled');
-    }
-    
-    // 화면 해상도 이상
-    if (screen.width === 0 || screen.height === 0) {
-      score += 20;
-      reasons.push('Invalid screen resolution');
-    }
-    
-    // 시간대 정보 없음
-    try {
-      const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-      if (!timezone || timezone === 'UTC') {
-        score += 5;
-        reasons.push('No timezone info');
-      }
-    } catch (e) {
-      score += 10;
-      reasons.push('Timezone detection failed');
-    }
-    
-    return { score, reasons };
-  }
-  
-  private getRiskLevel(score: number): 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' {
-    if (score >= 70) return 'CRITICAL';
-    if (score >= 50) return 'HIGH';
-    if (score >= 30) return 'MEDIUM';
-    return 'LOW';
-  }
-  
-  public getBrowserInfo(): BasicBrowserInfo {
-    return {
-      userAgent: navigator.userAgent,
-      language: navigator.language,
-      platform: navigator.platform,
-      cookieEnabled: navigator.cookieEnabled,
-      doNotTrack: navigator.doNotTrack,
-      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-      screenResolution: `${screen.width}x${screen.height}`,
-      viewportSize: `${window.innerWidth}x${window.innerHeight}`
-    };
-  }
-  
-  public destroy(): void {
-    // 이벤트 리스너 정리는 생략 (메모리 누수 방지를 위해 필요시 구현)
-  }
-}