@adstage/web-sdk 2.4.5 → 2.4.7

package/dist/index.cjs.js

@@ -47,11 +47,15 @@ class ViewableEventTracker {
     static isDuplicateViewable(adId, slotId, debug = false) {
         const key = `${adId}_${slotId}`;
         const now = Date.now();
+        // 디버그 모드에 따른 쿨다운 시간 결정
+        const cooldownTime = debug ?
+            ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG :
+            ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION;
         // 메모리 기반 중복 확인 (새로고침 시 초기화됨)
         const lastViewable = ViewableEventTracker.viewableTracker.get(key);
-        if (lastViewable && (now - lastViewable) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+        if (lastViewable && (now - lastViewable) < cooldownTime) {
             if (debug) {
-                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - lastViewable)) / 1000)}s remaining`);
+                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - lastViewable)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
             }
             return true;
         }
@@ -60,9 +64,9 @@ class ViewableEventTracker {
         const sessionViewable = sessionStorage.getItem(sessionKey);
         if (sessionViewable) {
             const sessionTime = parseInt(sessionViewable, 10);
-            if (!isNaN(sessionTime) && (now - sessionTime) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+            if (!isNaN(sessionTime) && (now - sessionTime) < cooldownTime) {
                 if (debug) {
-                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - sessionTime)) / 1000)}s remaining`);
+                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - sessionTime)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
                 }
                 // 메모리에도 기록하여 이후 요청 최적화
                 ViewableEventTracker.viewableTracker.set(key, sessionTime);
@@ -74,6 +78,9 @@ class ViewableEventTracker {
         sessionStorage.setItem(sessionKey, now.toString());
         // 오래된 세션 스토리지 데이터 정리 (선택적)
         ViewableEventTracker.cleanupOldViewables();
+        if (debug) {
+            console.log(`✅ New viewable recorded for ad ${adId} in slot ${slotId} (${debug ? 'debug' : 'production'} mode)`);
+        }
         return false;
     }
     /**
@@ -81,7 +88,8 @@ class ViewableEventTracker {
      */
     static cleanupOldViewables() {
         const now = Date.now();
-        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN * 2; // 쿨다운의 2배 시간이 지난 데이터 정리
+        // 프로덕션 쿨다운의 2배 시간이 지난 데이터 정리
+        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION * 2;
         // 세션 스토리지 정리
         for (let i = 0; i < sessionStorage.length; i++) {
             const key = sessionStorage.key(i);
@@ -104,14 +112,33 @@ class ViewableEventTracker {
         }
     }
     /**
-     * 모든 추적 데이터 정리
+     * 모든 추적 데이터 정리 (디버그용)
      */
     static clear() {
         ViewableEventTracker.viewableTracker.clear();
+        // 세션 스토리지에서도 adstage_viewable_ 키들 제거
+        const keysToRemove = [];
+        for (let i = 0; i < sessionStorage.length; i++) {
+            const key = sessionStorage.key(i);
+            if (key && key.startsWith('adstage_viewable_')) {
+                keysToRemove.push(key);
+            }
+        }
+        keysToRemove.forEach(key => sessionStorage.removeItem(key));
+    }
+    /**
+     * 특정 광고의 viewable 추적 초기화 (디버그용)
+     */
+    static clearAdViewable(adId, slotId) {
+        const key = `${adId}_${slotId}`;
+        ViewableEventTracker.viewableTracker.delete(key);
+        const sessionKey = `adstage_viewable_${key}`;
+        sessionStorage.removeItem(sessionKey);
     }
 }
 ViewableEventTracker.viewableTracker = new Map();
-ViewableEventTracker.VIEWABLE_COOLDOWN = 300000; // 5분 쿨다운
+ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION = 300000; // 5분 쿨다운 (프로덕션)
+ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG = 30000; // 30초 쿨다운 (디버그)
 
 /**
  * SSR 안전한 DOM API 래퍼 클래스
@@ -2229,6 +2256,9 @@ class AdRenderer {
             }
             if (this.advertisementEventTracker) {
                 try {
+                    if (this.debug) {
+                        console.log(`🔄 Starting advertisement event tracking: ${eventType} for ad ${adId} in slot ${slotId}`);
+                    }
                     await this.advertisementEventTracker.trackAdvertisementEvent(adId, slotId, eventType, {});
                     if (this.debug) {
                         console.log(`📊 Advertisement event tracked: ${eventType} for ad ${adId} in slot ${slotId}`);
@@ -2240,6 +2270,11 @@ class AdRenderer {
                     }
                 }
             }
+            else {
+                if (this.debug) {
+                    console.warn(`⚠️ AdvertisementEventTracker not available for ${eventType} event`);
+                }
+            }
         };
         let sliderElement;
         const optimizedSliderOptions = {

package/dist/index.esm.js

@@ -45,11 +45,15 @@ class ViewableEventTracker {
     static isDuplicateViewable(adId, slotId, debug = false) {
         const key = `${adId}_${slotId}`;
         const now = Date.now();
+        // 디버그 모드에 따른 쿨다운 시간 결정
+        const cooldownTime = debug ?
+            ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG :
+            ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION;
         // 메모리 기반 중복 확인 (새로고침 시 초기화됨)
         const lastViewable = ViewableEventTracker.viewableTracker.get(key);
-        if (lastViewable && (now - lastViewable) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+        if (lastViewable && (now - lastViewable) < cooldownTime) {
             if (debug) {
-                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - lastViewable)) / 1000)}s remaining`);
+                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - lastViewable)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
             }
             return true;
         }
@@ -58,9 +62,9 @@ class ViewableEventTracker {
         const sessionViewable = sessionStorage.getItem(sessionKey);
         if (sessionViewable) {
             const sessionTime = parseInt(sessionViewable, 10);
-            if (!isNaN(sessionTime) && (now - sessionTime) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+            if (!isNaN(sessionTime) && (now - sessionTime) < cooldownTime) {
                 if (debug) {
-                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - sessionTime)) / 1000)}s remaining`);
+                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - sessionTime)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
                 }
                 // 메모리에도 기록하여 이후 요청 최적화
                 ViewableEventTracker.viewableTracker.set(key, sessionTime);
@@ -72,6 +76,9 @@ class ViewableEventTracker {
         sessionStorage.setItem(sessionKey, now.toString());
         // 오래된 세션 스토리지 데이터 정리 (선택적)
         ViewableEventTracker.cleanupOldViewables();
+        if (debug) {
+            console.log(`✅ New viewable recorded for ad ${adId} in slot ${slotId} (${debug ? 'debug' : 'production'} mode)`);
+        }
         return false;
     }
     /**
@@ -79,7 +86,8 @@ class ViewableEventTracker {
      */
     static cleanupOldViewables() {
         const now = Date.now();
-        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN * 2; // 쿨다운의 2배 시간이 지난 데이터 정리
+        // 프로덕션 쿨다운의 2배 시간이 지난 데이터 정리
+        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION * 2;
         // 세션 스토리지 정리
         for (let i = 0; i < sessionStorage.length; i++) {
             const key = sessionStorage.key(i);
@@ -102,14 +110,33 @@ class ViewableEventTracker {
         }
     }
     /**
-     * 모든 추적 데이터 정리
+     * 모든 추적 데이터 정리 (디버그용)
      */
     static clear() {
         ViewableEventTracker.viewableTracker.clear();
+        // 세션 스토리지에서도 adstage_viewable_ 키들 제거
+        const keysToRemove = [];
+        for (let i = 0; i < sessionStorage.length; i++) {
+            const key = sessionStorage.key(i);
+            if (key && key.startsWith('adstage_viewable_')) {
+                keysToRemove.push(key);
+            }
+        }
+        keysToRemove.forEach(key => sessionStorage.removeItem(key));
+    }
+    /**
+     * 특정 광고의 viewable 추적 초기화 (디버그용)
+     */
+    static clearAdViewable(adId, slotId) {
+        const key = `${adId}_${slotId}`;
+        ViewableEventTracker.viewableTracker.delete(key);
+        const sessionKey = `adstage_viewable_${key}`;
+        sessionStorage.removeItem(sessionKey);
     }
 }
 ViewableEventTracker.viewableTracker = new Map();
-ViewableEventTracker.VIEWABLE_COOLDOWN = 300000; // 5분 쿨다운
+ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION = 300000; // 5분 쿨다운 (프로덕션)
+ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG = 30000; // 30초 쿨다운 (디버그)
 
 /**
  * SSR 안전한 DOM API 래퍼 클래스
@@ -2227,6 +2254,9 @@ class AdRenderer {
             }
             if (this.advertisementEventTracker) {
                 try {
+                    if (this.debug) {
+                        console.log(`🔄 Starting advertisement event tracking: ${eventType} for ad ${adId} in slot ${slotId}`);
+                    }
                     await this.advertisementEventTracker.trackAdvertisementEvent(adId, slotId, eventType, {});
                     if (this.debug) {
                         console.log(`📊 Advertisement event tracked: ${eventType} for ad ${adId} in slot ${slotId}`);
@@ -2238,6 +2268,11 @@ class AdRenderer {
                     }
                 }
             }
+            else {
+                if (this.debug) {
+                    console.warn(`⚠️ AdvertisementEventTracker not available for ${eventType} event`);
+                }
+            }
         };
         let sliderElement;
         const optimizedSliderOptions = {

package/dist/index.standalone.js

@@ -42,11 +42,15 @@ class ViewableEventTracker {
     static isDuplicateViewable(adId, slotId, debug = false) {
         const key = `${adId}_${slotId}`;
         const now = Date.now();
+        // 디버그 모드에 따른 쿨다운 시간 결정
+        const cooldownTime = debug ?
+            ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG :
+            ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION;
         // 메모리 기반 중복 확인 (새로고침 시 초기화됨)
         const lastViewable = ViewableEventTracker.viewableTracker.get(key);
-        if (lastViewable && (now - lastViewable) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+        if (lastViewable && (now - lastViewable) < cooldownTime) {
             if (debug) {
-                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - lastViewable)) / 1000)}s remaining`);
+                console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - lastViewable)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
             }
             return true;
         }
@@ -55,9 +59,9 @@ class ViewableEventTracker {
         const sessionViewable = sessionStorage.getItem(sessionKey);
         if (sessionViewable) {
             const sessionTime = parseInt(sessionViewable, 10);
-            if (!isNaN(sessionTime) && (now - sessionTime) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+            if (!isNaN(sessionTime) && (now - sessionTime) < cooldownTime) {
                 if (debug) {
-                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - sessionTime)) / 1000)}s remaining`);
+                    console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - sessionTime)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
                 }
                 // 메모리에도 기록하여 이후 요청 최적화
                 ViewableEventTracker.viewableTracker.set(key, sessionTime);
@@ -69,6 +73,9 @@ class ViewableEventTracker {
         sessionStorage.setItem(sessionKey, now.toString());
         // 오래된 세션 스토리지 데이터 정리 (선택적)
         ViewableEventTracker.cleanupOldViewables();
+        if (debug) {
+            console.log(`✅ New viewable recorded for ad ${adId} in slot ${slotId} (${debug ? 'debug' : 'production'} mode)`);
+        }
         return false;
     }
     /**
@@ -76,7 +83,8 @@ class ViewableEventTracker {
      */
     static cleanupOldViewables() {
         const now = Date.now();
-        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN * 2; // 쿨다운의 2배 시간이 지난 데이터 정리
+        // 프로덕션 쿨다운의 2배 시간이 지난 데이터 정리
+        const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION * 2;
         // 세션 스토리지 정리
         for (let i = 0; i < sessionStorage.length; i++) {
             const key = sessionStorage.key(i);
@@ -99,14 +107,33 @@ class ViewableEventTracker {
         }
     }
     /**
-     * 모든 추적 데이터 정리
+     * 모든 추적 데이터 정리 (디버그용)
      */
     static clear() {
         ViewableEventTracker.viewableTracker.clear();
+        // 세션 스토리지에서도 adstage_viewable_ 키들 제거
+        const keysToRemove = [];
+        for (let i = 0; i < sessionStorage.length; i++) {
+            const key = sessionStorage.key(i);
+            if (key && key.startsWith('adstage_viewable_')) {
+                keysToRemove.push(key);
+            }
+        }
+        keysToRemove.forEach(key => sessionStorage.removeItem(key));
+    }
+    /**
+     * 특정 광고의 viewable 추적 초기화 (디버그용)
+     */
+    static clearAdViewable(adId, slotId) {
+        const key = `${adId}_${slotId}`;
+        ViewableEventTracker.viewableTracker.delete(key);
+        const sessionKey = `adstage_viewable_${key}`;
+        sessionStorage.removeItem(sessionKey);
     }
 }
 ViewableEventTracker.viewableTracker = new Map();
-ViewableEventTracker.VIEWABLE_COOLDOWN = 300000; // 5분 쿨다운
+ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION = 300000; // 5분 쿨다운 (프로덕션)
+ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG = 30000; // 30초 쿨다운 (디버그)
 
 /**
  * SSR 안전한 DOM API 래퍼 클래스
@@ -2224,6 +2251,9 @@ class AdRenderer {
             }
             if (this.advertisementEventTracker) {
                 try {
+                    if (this.debug) {
+                        console.log(`🔄 Starting advertisement event tracking: ${eventType} for ad ${adId} in slot ${slotId}`);
+                    }
                     await this.advertisementEventTracker.trackAdvertisementEvent(adId, slotId, eventType, {});
                     if (this.debug) {
                         console.log(`📊 Advertisement event tracked: ${eventType} for ad ${adId} in slot ${slotId}`);
@@ -2235,6 +2265,11 @@ class AdRenderer {
                     }
                 }
             }
+            else {
+                if (this.debug) {
+                    console.warn(`⚠️ AdvertisementEventTracker not available for ${eventType} event`);
+                }
+            }
         };
         let sliderElement;
         const optimizedSliderOptions = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "AdStage Web SDK - Production-ready marketing platform SDK with React Provider support for seamless integration",
   "type": "module",
   "main": "dist/index.cjs.js",

package/src/managers/ads/viewable-event-tracker.ts

@@ -7,7 +7,8 @@
  */
 export class ViewableEventTracker {
   private static viewableTracker = new Map<string, number>();
-  private static readonly VIEWABLE_COOLDOWN = 300000; // 5분 쿨다운
+  private static readonly VIEWABLE_COOLDOWN_PRODUCTION = 300000; // 5분 쿨다운 (프로덕션)
+  private static readonly VIEWABLE_COOLDOWN_DEBUG = 30000; // 30초 쿨다운 (디버그)
 
   /**
    * 중복 viewable 이벤트 여부 확인
@@ -16,11 +17,16 @@ export class ViewableEventTracker {
     const key = `${adId}_${slotId}`;
     const now = Date.now();
     
+    // 디버그 모드에 따른 쿨다운 시간 결정
+    const cooldownTime = debug ? 
+      ViewableEventTracker.VIEWABLE_COOLDOWN_DEBUG : 
+      ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION;
+    
     // 메모리 기반 중복 확인 (새로고침 시 초기화됨)
     const lastViewable = ViewableEventTracker.viewableTracker.get(key);
-    if (lastViewable && (now - lastViewable) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+    if (lastViewable && (now - lastViewable) < cooldownTime) {
       if (debug) {
-        console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - lastViewable)) / 1000)}s remaining`);
+        console.log(`Duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - lastViewable)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
       }
       return true;
     }
@@ -30,9 +36,9 @@ export class ViewableEventTracker {
     const sessionViewable = sessionStorage.getItem(sessionKey);
     if (sessionViewable) {
       const sessionTime = parseInt(sessionViewable, 10);
-      if (!isNaN(sessionTime) && (now - sessionTime) < ViewableEventTracker.VIEWABLE_COOLDOWN) {
+      if (!isNaN(sessionTime) && (now - sessionTime) < cooldownTime) {
         if (debug) {
-          console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((ViewableEventTracker.VIEWABLE_COOLDOWN - (now - sessionTime)) / 1000)}s remaining`);
+          console.log(`Session-based duplicate viewable blocked for ad ${adId} in slot ${slotId}. Cooldown: ${Math.round((cooldownTime - (now - sessionTime)) / 1000)}s remaining (${debug ? 'debug' : 'production'} mode)`);
         }
         // 메모리에도 기록하여 이후 요청 최적화
         ViewableEventTracker.viewableTracker.set(key, sessionTime);
@@ -47,6 +53,10 @@ export class ViewableEventTracker {
     // 오래된 세션 스토리지 데이터 정리 (선택적)
     ViewableEventTracker.cleanupOldViewables();
     
+    if (debug) {
+      console.log(`✅ New viewable recorded for ad ${adId} in slot ${slotId} (${debug ? 'debug' : 'production'} mode)`);
+    }
+    
     return false;
   }
 
@@ -55,7 +65,8 @@ export class ViewableEventTracker {
    */
   private static cleanupOldViewables(): void {
     const now = Date.now();
-    const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN * 2; // 쿨다운의 2배 시간이 지난 데이터 정리
+    // 프로덕션 쿨다운의 2배 시간이 지난 데이터 정리
+    const cleanupThreshold = ViewableEventTracker.VIEWABLE_COOLDOWN_PRODUCTION * 2;
     
     // 세션 스토리지 정리
     for (let i = 0; i < sessionStorage.length; i++) {
@@ -81,9 +92,28 @@ export class ViewableEventTracker {
   }
 
   /**
-   * 모든 추적 데이터 정리
+   * 모든 추적 데이터 정리 (디버그용)
    */
   static clear(): void {
     ViewableEventTracker.viewableTracker.clear();
+    // 세션 스토리지에서도 adstage_viewable_ 키들 제거
+    const keysToRemove: string[] = [];
+    for (let i = 0; i < sessionStorage.length; i++) {
+      const key = sessionStorage.key(i);
+      if (key && key.startsWith('adstage_viewable_')) {
+        keysToRemove.push(key);
+      }
+    }
+    keysToRemove.forEach(key => sessionStorage.removeItem(key));
+  }
+
+  /**
+   * 특정 광고의 viewable 추적 초기화 (디버그용)
+   */
+  static clearAdViewable(adId: string, slotId: string): void {
+    const key = `${adId}_${slotId}`;
+    ViewableEventTracker.viewableTracker.delete(key);
+    const sessionKey = `adstage_viewable_${key}`;
+    sessionStorage.removeItem(sessionKey);
   }
 }

package/src/modules/ads/AdRenderer.ts

@@ -250,6 +250,9 @@ export class AdRenderer {
 
       if (this.advertisementEventTracker) {
         try {
+          if (this.debug) {
+            console.log(`🔄 Starting advertisement event tracking: ${eventType} for ad ${adId} in slot ${slotId}`);
+          }
           await this.advertisementEventTracker.trackAdvertisementEvent(adId, slotId, eventType, {});
           if (this.debug) {
             console.log(`📊 Advertisement event tracked: ${eventType} for ad ${adId} in slot ${slotId}`);
@@ -259,6 +262,10 @@ export class AdRenderer {
             console.error(`❌ Failed to track ${eventType} event for ad ${adId}:`, error);
           }
         }
+      } else {
+        if (this.debug) {
+          console.warn(`⚠️ AdvertisementEventTracker not available for ${eventType} event`);
+        }
       }
     };