@adstage/web-sdk 3.0.12 → 3.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adstage/web-sdk",
-  "version": "3.0.12",
+  "version": "3.0.14",
   "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

@@ -109,8 +109,11 @@ export class AdStage {
         }
       }
 
-      // � 서버에 Attribution 자동 등록 (클릭 ID가 있는 경우, 단 URL로 이미 전달된 경우는 생략)
-      if (!aidFromUrl && trackingParams && TrackingParamsModule.hasClickId()) {
+      // 🎯 서버에 Attribution 자동 등록 (클릭 ID 또는 channel이 있는 경우, 단 URL로 이미 전달된 경우는 생략)
+      const hasClickId = TrackingParamsModule.hasClickId();
+      const hasChannel = !!(trackingParams && trackingParams.channel);
+
+      if (!aidFromUrl && trackingParams && (hasClickId || hasChannel)) {
         // Attribution 등록을 Promise로 처리
         const attributionPromise = (async () => {
           try {

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

@@ -51,7 +51,7 @@ export class TrackingParamsModule {
   // 추출할 파라미터 키 정의
   private static readonly CLICK_ID_KEYS = ['gclid', 'fbclid', 'ttclid', 'nclid', 'liclid', 'msclkid', 'twclid'];
 
-  private static readonly CAMPAIGN_KEYS = ['campaign', 'campaign_id', 'ad_group', 'ad_group_id', 'ad_creative', 'creative_id', 'term'];
+  private static readonly CAMPAIGN_KEYS = ['channel', 'campaign', 'campaign_id', 'ad_group', 'ad_group_id', 'ad_creative', 'creative_id', 'term'];
 
   private static readonly UTM_KEYS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_content', 'utm_term'];
 
@@ -217,7 +217,7 @@ export class TrackingParamsModule {
 
   /**
    * Click 이벤트 자동 전송 여부 확인
-   * 새로운 클릭 ID가 발견되면 true 반환
+   * 새로운 클릭 ID 또는 channel 파라미터가 발견되면 true 반환
    */
   public static shouldSendClickEvent(): boolean {
     if (typeof window === 'undefined') {
@@ -225,24 +225,33 @@ export class TrackingParamsModule {
     }
 
     const params = TrackingParamsModule.get();
-    if (!params || !TrackingParamsModule.hasClickId()) {
+    if (!params) {
       return false;
     }
 
-    // 현재 클릭 ID 추출
-    const currentClickId =
-      params.gclid || params.fbclid || params.ttclid || params.nclid || params.liclid || params.msclkid || params.twclid;
+    // 클릭 ID 또는 channel 파라미터가 있어야 함
+    const hasClickId = TrackingParamsModule.hasClickId();
+    const hasChannel = !!params.channel;
 
-    if (!currentClickId) {
+    if (!hasClickId && !hasChannel) {
       return false;
     }
 
-    // 이미 처리된 클릭 ID인지 확인 (중복 방지)
+    // 현재 식별자 추출 (clickId 우선, 없으면 channel+term 조합)
+    const currentIdentifier = hasClickId
+      ? (params.gclid || params.fbclid || params.ttclid || params.nclid || params.liclid || params.msclkid || params.twclid)
+      : `${params.channel || ''}:${params.term || ''}`;
+
+    if (!currentIdentifier) {
+      return false;
+    }
+
+    // 이미 처리된 식별자인지 확인 (중복 방지)
     const lastClickId = sessionStorage.getItem('adstage_last_click_id');
 
-    // 새로운 클릭 ID면 전송 필요
-    if (currentClickId !== lastClickId) {
-      sessionStorage.setItem('adstage_last_click_id', currentClickId);
+    // 새로운 식별자면 전송 필요
+    if (currentIdentifier !== lastClickId) {
+      sessionStorage.setItem('adstage_last_click_id', currentIdentifier);
       return true;
     }