@adstage/web-sdk 3.0.14 → 3.0.16

package/dist/index.d.ts

@@ -21,6 +21,12 @@ interface AdStageConfig {
     timeout?: number;
     /** 플레이스홀더 스타일 모드 (기본값: 'subtle') */
     placeholderMode?: 'invisible' | 'transparent' | 'subtle' | 'minimal' | 'debug' | 'legacy';
+    /**
+     * 아웃바운드 트래킹 링크 데코레이션 대상 도메인 (기본값: ['adg.im'])
+     * 이 도메인으로 향하는 <a> 클릭 시 방문자 신원(클릭 ID + attribution_id)을 자동 부착해
+     * web→app 어트리뷰션이 끊기지 않게 한다.
+     */
+    trackingLinkDomains?: string[];
 }
 /**
  * 모듈 기본 인터페이스
@@ -546,6 +552,12 @@ declare class AdStage {
      * 현재 설정 반환
      */
     static getConfig(): AdStageConfig | null;
+    /**
+     * 트래킹 링크(adg.im 등)에 현재 방문자 신원(클릭 ID + attribution_id)을 부착해 반환.
+     * <a> 클릭은 자동 데코레이션되지만, window.open() 등 프로그램적 이동에는 이 헬퍼를 직접 사용한다.
+     * 트래킹 도메인이 아니면 원본 URL 을 그대로 반환한다.
+     */
+    static decorateUrl(url: string): string;
     /**
      * SDK 인스턴스 반환 (공개 메소드로 변경)
      */
@@ -657,12 +669,21 @@ declare function useAdStageInstance(): typeof AdStage | null;
  */
 interface TrackingParams {
     gclid?: string;
+    gbraid?: string;
+    wbraid?: string;
     fbclid?: string;
     ttclid?: string;
     nclid?: string;
+    naverclk?: string;
     liclid?: string;
+    li_fat_id?: string;
     msclkid?: string;
     twclid?: string;
+    sccid?: string;
+    ScCid?: string;
+    yclid?: string;
+    pnclid?: string;
+    kakaoclk?: string;
     channel?: string;
     campaign?: string;
     campaign_id?: string;
@@ -671,6 +692,12 @@ interface TrackingParams {
     ad_creative?: string;
     creative_id?: string;
     term?: string;
+    k_campaign?: string;
+    k_adgroup?: string;
+    k_keyword?: string;
+    k_keyword_id?: string;
+    k_creative?: string;
+    k_rank?: string;
     utm_source?: string;
     utm_medium?: string;
     utm_campaign?: string;