@adstage/web-sdk 3.0.10 → 3.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "3.0.10",
+  "version": "3.0.11",
   "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/core/adstage.ts

@@ -78,9 +78,41 @@ export class AdStage {
         console.log('📊 Tracking parameters captured:', trackingParams);
       }
 
-      // � 서버에 Attribution 자동 등록 (클릭 ID가 있는 경우)
-      if (trackingParams && TrackingParamsModule.hasClickId()) {
-        setTimeout(async () => {
+      // 🔎 리다이렉트 단계에서 전달된 attributionId(attribution_id) 우선 사용
+      const aidFromUrl = (() => {
+        try {
+          const search = new URLSearchParams(window.location.search);
+          const hash = new URLSearchParams((window.location.hash || '').replace(/^#/, ''));
+          return search.get('attribution_id') || hash.get('attribution_id');
+        } catch {
+          return null;
+        }
+      })();
+
+      if (aidFromUrl) {
+        try {
+          localStorage.setItem('adstage_attribution_id', aidFromUrl);
+          if (config.debug) {
+            console.log('🔗 Using attributionId from URL (attribution_id):', aidFromUrl);
+          }
+        } catch (_) {
+          // no-op: storage might be unavailable in some contexts
+        }
+      }
+
+      // 🎯 Click 이벤트 자동 전송 (새로운 클릭 ID 발견 시)
+      const shouldSend = TrackingParamsModule.shouldSendClickEvent();
+      if (config.debug) {
+        console.log('🔍 Should send click event:', shouldSend);
+        if (!shouldSend) {
+          console.log('⏭️ Skipping click event (duplicate or no click ID)');
+        }
+      }
+
+      // � 서버에 Attribution 자동 등록 (클릭 ID가 있는 경우, 단 URL로 이미 전달된 경우는 생략)
+      if (!aidFromUrl && trackingParams && TrackingParamsModule.hasClickId()) {
+        // Attribution 등록을 Promise로 처리
+        const attributionPromise = (async () => {
           try {
             // Device ID 생성 (브라우저 fingerprint 또는 랜덤)
             const deviceId = instance.generateDeviceId();
@@ -95,29 +127,62 @@ export class AdStage {
                 expiresAt: attribution.expiresAt,
               });
             }
+
+            return attribution;
           } catch (err) {
             console.error('❌ Failed to register attribution:', err);
+            return null;
           }
-        }, 100);
-      }
-
-      // �🎯 Click 이벤트 자동 전송 (새로운 클릭 ID 발견 시)
-      const shouldSend = TrackingParamsModule.shouldSendClickEvent();
-      if (config.debug) {
-        console.log('🔍 Should send click event:', shouldSend);
-        if (!shouldSend) {
-          console.log('⏭️ Skipping click event (duplicate or no click ID)');
+        })();
+
+        // Click 이벤트는 Attribution 등록이 완료된 후에만 전송
+        if (shouldSend) {
+          attributionPromise.then((attribution) => {
+            try {
+              const trackingParams = TrackingParamsModule.get();
+              const attributionObj = TrackingParamsModule.toAttributionObject();
+
+              if (config.debug) {
+                console.log('🎯 Sending click event after attribution registration', {
+                  attributionId: attribution?.attributionId,
+                  hasAttribution: !!attribution,
+                });
+              }
+
+              // Click 이벤트 전송 (추적 파라미터는 EventsModule에서 자동 주입)
+              instance.events
+                .track('click', {
+                  _autoGenerated: true,
+                  _source: 'tracking_params',
+                  _timestamp: new Date().toISOString(),
+                  _platform: 'web',
+                })
+                .then(() => {
+                  TrackingParamsModule.markClickEventSent();
+
+                  if (config.debug) {
+                    console.log('✅ Auto-tracked click event with tracking params:', {
+                      attribution: attributionObj,
+                      trackingParams,
+                    });
+                  }
+                })
+                .catch((err) => {
+                  console.error('❌ Failed to auto-track click event:', err);
+                });
+            } catch (err) {
+              console.error('❌ Error in click event auto-tracking:', err);
+            }
+          });
         }
-      }
-
-      if (shouldSend) {
-        // EventsModule 초기화 완료 대기
+      } else if (shouldSend) {
+        // Attribution 등록이 필요없는 경우 (aidFromUrl이 있거나 클릭 ID가 없음)
+        // 기존 방식대로 Click 이벤트만 전송
         setTimeout(() => {
           try {
             const trackingParams = TrackingParamsModule.get();
             const attribution = TrackingParamsModule.toAttributionObject();
 
-            // Click 이벤트 전송 (추적 파라미터는 EventsModule에서 자동 주입)
             instance.events
               .track('click', {
                 _autoGenerated: true,
@@ -141,7 +206,7 @@ export class AdStage {
           } catch (err) {
             console.error('❌ Error in click event auto-tracking:', err);
           }
-        }, 200); // Attribution 등록 후 실행
+        }, 100);
       }
     }
 

package/src/modules/events/events-module.ts

@@ -251,9 +251,10 @@ export class EventsModule implements BaseModule {
         console.log('✅ Attribution registered:', response);
       }
 
-      // Attribution ID를 sessionStorage에 저장
+      // Attribution ID를 localStorage + sessionStorage에 저장 (세션 종료 후에도 유지)
       if (response.attributionId) {
-        sessionStorage.setItem('adstage_attribution_id', response.attributionId);
+        try { localStorage.setItem('adstage_attribution_id', response.attributionId); } catch (_) {}
+        try { sessionStorage.setItem('adstage_attribution_id', response.attributionId); } catch (_) {}
       }
 
       return response;
@@ -265,13 +266,23 @@ export class EventsModule implements BaseModule {
 
   /**
    * 저장된 Attribution ID 반환
+   * 우선순위: sessionStorage (현재 세션) > localStorage (영속 저장)
    */
   getAttributionId(): string | null {
-    if (typeof window === 'undefined' || !window.sessionStorage) {
+    if (typeof window === 'undefined') {
       return null;
     }
 
-    return sessionStorage.getItem('adstage_attribution_id');
+    try {
+      const fromSession = sessionStorage.getItem('adstage_attribution_id');
+      if (fromSession) return fromSession;
+    } catch (_) {}
+
+    try {
+      return localStorage.getItem('adstage_attribution_id');
+    } catch (_) {}
+
+    return null;
   }
 
   /**

package/src/modules/tracking/tracking-params.ts

@@ -140,11 +140,11 @@ export class TrackingParamsModule {
   }
 
   /**
-   * 추적 파라미터를 sessionStorage에 저장
-   * (SPA 페이지 전환 시에도 유지)
+   * 추적 파라미터를 sessionStorage + localStorage에 저장
+   * (SPA 페이지 전환 + 브라우저 재시작 시에도 유지)
    */
   public static store(params: TrackingParams): void {
-    if (typeof window === 'undefined' || !window.sessionStorage) {
+    if (typeof window === 'undefined') {
       return;
     }
 
@@ -152,8 +152,10 @@ export class TrackingParamsModule {
       // 기존 파라미터와 병합 (새 파라미터 우선)
       const existing = TrackingParamsModule.get();
       const merged = { ...existing, ...params };
+      const json = JSON.stringify(merged);
 
-      sessionStorage.setItem(TrackingParamsModule.STORAGE_KEY, JSON.stringify(merged));
+      try { sessionStorage.setItem(TrackingParamsModule.STORAGE_KEY, json); } catch (_) {}
+      try { localStorage.setItem(TrackingParamsModule.STORAGE_KEY, json); } catch (_) {}
     } catch (error) {
       console.warn('Failed to store tracking params:', error);
     }
@@ -161,21 +163,23 @@ export class TrackingParamsModule {
 
   /**
    * 저장된 추적 파라미터 반환
+   * 우선순위: sessionStorage (현재 세션) > localStorage (영속 저장)
    * EventsModule에서 track() 호출 시 사용됨
    */
   public static get(): TrackingParams | null {
-    if (typeof window === 'undefined' || !window.sessionStorage) {
+    if (typeof window === 'undefined') {
       return null;
     }
 
     try {
-      const stored = sessionStorage.getItem(TrackingParamsModule.STORAGE_KEY);
-      if (stored) {
-        return JSON.parse(stored) as TrackingParams;
-      }
-    } catch (error) {
-      console.warn('Failed to retrieve tracking params:', error);
-    }
+      const fromSession = sessionStorage?.getItem(TrackingParamsModule.STORAGE_KEY);
+      if (fromSession) return JSON.parse(fromSession) as TrackingParams;
+    } catch (_) {}
+
+    try {
+      const fromLocal = localStorage?.getItem(TrackingParamsModule.STORAGE_KEY);
+      if (fromLocal) return JSON.parse(fromLocal) as TrackingParams;
+    } catch (_) {}
 
     return null;
   }
@@ -184,15 +188,12 @@ export class TrackingParamsModule {
    * 저장된 추적 파라미터 삭제
    */
   public static clear(): void {
-    if (typeof window === 'undefined' || !window.sessionStorage) {
+    if (typeof window === 'undefined') {
       return;
     }
 
-    try {
-      sessionStorage.removeItem(TrackingParamsModule.STORAGE_KEY);
-    } catch (error) {
-      console.warn('Failed to clear tracking params:', error);
-    }
+    try { sessionStorage?.removeItem(TrackingParamsModule.STORAGE_KEY); } catch (_) {}
+    try { localStorage?.removeItem(TrackingParamsModule.STORAGE_KEY); } catch (_) {}
   }
 
   /**