@playcraft/adsdk 1.0.8 → 1.0.9

package/dist/iife/index.js

@@ -160,6 +160,14 @@
   }
 
   // src/tracking.ts
+  function getCurrentAdNetwork(adNetwork) {
+    const network = adNetwork || (typeof AD_NETWORK !== "undefined" ? AD_NETWORK : "");
+    const supportedNetworks = ["bigabid", "inmobi", "applovin"];
+    if (supportedNetworks.includes(network)) {
+      return network;
+    }
+    return null;
+  }
   function trackURL(url) {
     if (url) {
       const trackingPixel = new Image();
@@ -184,39 +192,46 @@
       window.ALPlayableAnalytics.trackEvent(event);
     }
   }
-  var totalInteractions = 0;
-  var progressMilestones = [];
-  function setTotalInteractions(total) {
-    totalInteractions = total;
-  }
-  function trackChallengeSuccess() {
-    if (AD_NETWORK === "applovin") {
-      trackApplovinEvent("CHALLENGE_SOLVED");
-    }
-    if (AD_NETWORK === "bigabid") {
-      trackBigabidComplete();
+  var bigabidCompleteTriggered = false;
+  function trackBigabidComplete() {
+    if (!bigabidCompleteTriggered) {
+      trackBigabidEvent("complete");
+      bigabidCompleteTriggered = true;
     }
-    if (AD_NETWORK === "inmobi") {
-      trackInMobiEvent("Gameplay_Complete");
+  }
+  var inmobiTimers = [];
+  function startInMobiDurationTracking() {
+    const durations = [5, 10, 15, 20, 25, 30];
+    for (const sec of durations) {
+      const timer = setTimeout(() => trackInMobiEvent(`Spent_${sec}_Seconds`), sec * 1e3);
+      inmobiTimers.push(timer);
     }
   }
-  function trackChallengeFailed() {
-    if (AD_NETWORK === "applovin") {
-      trackApplovinEvent("CHALLENGE_FAILED");
+  function clearInMobiDurationTracking() {
+    for (const timer of inmobiTimers) {
+      clearTimeout(timer);
     }
+    inmobiTimers = [];
+  }
+  var totalInteractions = 0;
+  var progressMilestones = [];
+  function setTotalInteractions(total) {
+    totalInteractions = total;
   }
-  function initProgressMilestones() {
+  function initProgressMilestones(adNetwork) {
     if (totalInteractions <= 0) return;
-    if (AD_NETWORK === "applovin") {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "applovin") {
       progressMilestones = [
         { percent: 25, triggered: false, callback: () => trackApplovinEvent("CHALLENGE_PASS_25") },
         { percent: 50, triggered: false, callback: () => trackApplovinEvent("CHALLENGE_PASS_50") },
         { percent: 75, triggered: false, callback: () => trackApplovinEvent("CHALLENGE_PASS_75") },
-        { percent: 100, triggered: false, callback: () => trackChallengeSuccess() }
+        { percent: 100, triggered: false, callback: () => _trackChallengeSuccess(adNetwork) }
       ];
-    } else if (AD_NETWORK === "bigabid") {
+    } else if (network === "bigabid") {
       progressMilestones = [
-        { percent: 100, triggered: false, callback: () => trackChallengeSuccess() }
+        { percent: 100, triggered: false, callback: () => _trackChallengeSuccess(adNetwork) }
       ];
     }
   }
@@ -230,104 +245,189 @@
       }
     }
   }
-  var bigabidCompleteTriggered = false;
-  function trackBigabidComplete() {
-    if (!bigabidCompleteTriggered) {
-      trackBigabidEvent("complete");
-      bigabidCompleteTriggered = true;
+  function _onInit(adNetwork) {
+    initProgressMilestones(adNetwork);
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "bigabid") {
+      trackBigabidEvent("mraid_viewable");
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("Ad_Load_Start");
+    }
+    if (network === "applovin") {
+      trackApplovinEvent("LOADING");
     }
   }
-  var inmobiTimers = [];
-  function startInMobiDurationTracking() {
-    const durations = [5, 10, 15, 20, 25, 30];
-    for (const sec of durations) {
-      const timer = setTimeout(() => trackInMobiEvent(`Spent_${sec}_Seconds`), sec * 1e3);
-      inmobiTimers.push(timer);
+  function _onStart(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "bigabid") {
+      trackBigabidEvent("game_viewable");
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("Ad_Viewable");
+      startInMobiDurationTracking();
+    }
+    if (network === "applovin") {
+      trackApplovinEvent("LOADED");
     }
   }
-  function clearInMobiDurationTracking() {
-    for (const timer of inmobiTimers) {
-      clearTimeout(timer);
+  function _onInteractive(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "applovin") {
+      trackApplovinEvent("DISPLAYED");
     }
-    inmobiTimers = [];
   }
+  function _onInteraction(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "bigabid") {
+      trackBigabidEvent("engagement");
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("First_Engagement");
+    }
+    if (network === "applovin") {
+      trackApplovinEvent("CHALLENGE_STARTED");
+    }
+  }
+  function _onSuccess(successCount) {
+    checkInteractionProgress(successCount);
+  }
+  function _onFinish(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "bigabid") {
+      trackBigabidComplete();
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("Gameplay_Complete");
+      clearInMobiDurationTracking();
+    }
+    if (network === "applovin") {
+      trackApplovinEvent("ENDCARD_SHOWN");
+    }
+  }
+  function _onInstall(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "bigabid") {
+      trackBigabidEvent("click");
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("DSP_Click");
+      clearInMobiDurationTracking();
+    }
+    if (network === "applovin") {
+      trackApplovinEvent("CTA_CLICKED");
+    }
+  }
+  function _onRetry(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "applovin") {
+      trackApplovinEvent("CHALLENGE_RETRY");
+    }
+  }
+  function _trackChallengeSuccess(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "applovin") {
+      trackApplovinEvent("CHALLENGE_SOLVED");
+    }
+    if (network === "bigabid") {
+      trackBigabidComplete();
+    }
+    if (network === "inmobi") {
+      trackInMobiEvent("Gameplay_Complete");
+    }
+  }
+  function _trackChallengeFailed(adNetwork) {
+    const network = getCurrentAdNetwork(adNetwork);
+    if (!network) return;
+    if (network === "applovin") {
+      trackApplovinEvent("CHALLENGE_FAILED");
+    }
+  }
+  var tracking = {
+    /**
+     * SDK 初始化开始
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInit: _onInit,
+    /**
+     * 游戏资源加载完成
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onStart: _onStart,
+    /**
+     * 主场景就绪，用户可交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteractive: _onInteractive,
+    /**
+     * 首次交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteraction: _onInteraction,
+    /**
+     * 成功计数（用于进度百分比追踪）
+     * @param successCount - 当前成功次数
+     */
+    onSuccess: _onSuccess,
+    /**
+     * 游戏结束
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onFinish: _onFinish,
+    /**
+     * 点击安装
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInstall: _onInstall,
+    /**
+     * 重试游戏
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onRetry: _onRetry,
+    /**
+     * 设置交互总数（用于进度百分比计算）
+     * @param total - 交互总数
+     */
+    setTotalInteractions,
+    /**
+     * 检查交互进度
+     * @param currentInteractions - 当前交互次数
+     */
+    checkInteractionProgress,
+    /**
+     * 触发游戏成功事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeSuccess: _trackChallengeSuccess,
+    /**
+     * 触发游戏失败事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeFailed: _trackChallengeFailed
+  };
+
+  // src/tracking-init.ts
   function initTrackingProtocols() {
     const supportedNetworks = ["bigabid", "inmobi", "applovin"];
     if (!supportedNetworks.includes(AD_NETWORK)) {
       return;
     }
-    initProgressMilestones();
-    sdk.once("init", () => {
-      if (AD_NETWORK === "bigabid") {
-        trackBigabidEvent("mraid_viewable");
-      }
-      if (AD_NETWORK === "inmobi") {
-        trackInMobiEvent("Ad_Load_Start");
-      }
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("LOADING");
-      }
-    });
-    sdk.once("start", () => {
-      if (AD_NETWORK === "bigabid") {
-        trackBigabidEvent("game_viewable");
-      }
-      if (AD_NETWORK === "inmobi") {
-        trackInMobiEvent("Ad_Viewable");
-        startInMobiDurationTracking();
-      }
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("LOADED");
-      }
-    });
-    sdk.once("interactive", () => {
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("DISPLAYED");
-      }
-    });
-    sdk.once("interaction", () => {
-      if (AD_NETWORK === "bigabid") {
-        trackBigabidEvent("engagement");
-      }
-      if (AD_NETWORK === "inmobi") {
-        trackInMobiEvent("First_Engagement");
-      }
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("CHALLENGE_STARTED");
-      }
-    });
-    sdk.on("success", (successCount) => {
-      checkInteractionProgress(successCount);
-    });
-    sdk.once("finish", () => {
-      if (AD_NETWORK === "bigabid") {
-        trackBigabidComplete();
-      }
-      if (AD_NETWORK === "inmobi") {
-        trackInMobiEvent("Gameplay_Complete");
-        clearInMobiDurationTracking();
-      }
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("ENDCARD_SHOWN");
-      }
-    });
-    sdk.on("install", () => {
-      if (AD_NETWORK === "bigabid") {
-        trackBigabidEvent("click");
-      }
-      if (AD_NETWORK === "inmobi") {
-        trackInMobiEvent("DSP_Click");
-        clearInMobiDurationTracking();
-      }
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("CTA_CLICKED");
-      }
-    });
-    sdk.once("retry", () => {
-      if (AD_NETWORK === "applovin") {
-        trackApplovinEvent("CHALLENGE_RETRY");
-      }
-    });
+    sdk.once("init", tracking.onInit);
+    sdk.once("start", tracking.onStart);
+    sdk.once("interactive", tracking.onInteractive);
+    sdk.once("interaction", tracking.onInteraction);
+    sdk.on("success", tracking.onSuccess);
+    sdk.once("finish", tracking.onFinish);
+    sdk.on("install", tracking.onInstall);
+    sdk.once("retry", tracking.onRetry);
   }
 
   // src/assets/images.ts
@@ -957,7 +1057,7 @@
       if (isSDKInitialized) return;
       if (callback) initCallback = callback;
       if ((options == null ? void 0 : options.totalSuccessCount) && options.totalSuccessCount > 0) {
-        setTotalInteractions(options.totalSuccessCount);
+        tracking.setTotalInteractions(options.totalSuccessCount);
       }
       initTrackingProtocols();
       document.readyState === "loading" ? window.addEventListener("DOMContentLoaded", initSDK) : initSDK();
@@ -1226,7 +1326,7 @@
      * }
      */
     static recordSuccess() {
-      trackChallengeSuccess();
+      tracking.trackChallengeSuccess();
     }
     /**
      * Records a game failure event.
@@ -1240,7 +1340,7 @@
      * }
      */
     static recordFailed() {
-      trackChallengeFailed();
+      tracking.trackChallengeFailed();
     }
     /**
      * Forces the playable ad into a paused state.

package/dist/index.d.mts

@@ -279,4 +279,138 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-export { sdk as default, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+/**
+ * 设置交互总数
+ */
+declare function setTotalInteractions(total: number): void;
+/**
+ * 检查交互进度，触发对应里程碑
+ */
+declare function checkInteractionProgress(currentInteractions: number): void;
+/**
+ * init 事件：SDK 初始化开始
+ * 渠道埋点: Bigabid:mraid_viewable | InMobi:Ad_Load_Start | AppLovin:LOADING
+ * 同时初始化进度里程碑
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInit(adNetwork?: string): void;
+/**
+ * start 事件：游戏资源加载完成
+ * 渠道埋点: Bigabid:game_viewable | InMobi:Ad_Viewable | AppLovin:LOADED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onStart(adNetwork?: string): void;
+/**
+ * interactive 事件：主场景就绪，用户可交互
+ * 渠道埋点: AppLovin:DISPLAYED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInteractive(adNetwork?: string): void;
+/**
+ * interaction 事件：首次交互
+ * 渠道埋点: Bigabid:engagement | InMobi:First_Engagement | AppLovin:CHALLENGE_STARTED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInteraction(adNetwork?: string): void;
+/**
+ * success 事件：成功计数（用于进度百分比追踪）
+ */
+declare function _onSuccess(successCount: number): void;
+/**
+ * finish 事件：游戏结束
+ * 渠道埋点: Bigabid:complete | InMobi:Gameplay_Complete | AppLovin:ENDCARD_SHOWN
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onFinish(adNetwork?: string): void;
+/**
+ * install 事件：点击安装
+ * 渠道埋点: Bigabid:click | InMobi:DSP_Click | AppLovin:CTA_CLICKED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInstall(adNetwork?: string): void;
+/**
+ * retry 事件：重试游戏
+ * 渠道埋点: AppLovin:CHALLENGE_RETRY
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onRetry(adNetwork?: string): void;
+/**
+ * 触发游戏成功事件
+ * 不同渠道发送对应的成功埋点
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _trackChallengeSuccess(adNetwork?: string): void;
+/**
+ * 触发游戏失败事件
+ * 不同渠道发送对应的失败埋点
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _trackChallengeFailed(adNetwork?: string): void;
+/**
+ * 统一的埋点追踪对象
+ * 包含所有 SDK 事件的埋点方法
+ */
+declare const tracking: {
+    /**
+     * SDK 初始化开始
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInit: typeof _onInit;
+    /**
+     * 游戏资源加载完成
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onStart: typeof _onStart;
+    /**
+     * 主场景就绪，用户可交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteractive: typeof _onInteractive;
+    /**
+     * 首次交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteraction: typeof _onInteraction;
+    /**
+     * 成功计数（用于进度百分比追踪）
+     * @param successCount - 当前成功次数
+     */
+    onSuccess: typeof _onSuccess;
+    /**
+     * 游戏结束
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onFinish: typeof _onFinish;
+    /**
+     * 点击安装
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInstall: typeof _onInstall;
+    /**
+     * 重试游戏
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onRetry: typeof _onRetry;
+    /**
+     * 设置交互总数（用于进度百分比计算）
+     * @param total - 交互总数
+     */
+    setTotalInteractions: typeof setTotalInteractions;
+    /**
+     * 检查交互进度
+     * @param currentInteractions - 当前交互次数
+     */
+    checkInteractionProgress: typeof checkInteractionProgress;
+    /**
+     * 触发游戏成功事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeSuccess: typeof _trackChallengeSuccess;
+    /**
+     * 触发游戏失败事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeFailed: typeof _trackChallengeFailed;
+};
+
+export { sdk as default, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide, tracking };

package/dist/index.d.ts

@@ -279,4 +279,138 @@ declare function hideWechatGuide(): void;
  */
 declare function removeWechatGuide(): void;
 
-export { sdk as default, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide };
+/**
+ * 设置交互总数
+ */
+declare function setTotalInteractions(total: number): void;
+/**
+ * 检查交互进度，触发对应里程碑
+ */
+declare function checkInteractionProgress(currentInteractions: number): void;
+/**
+ * init 事件：SDK 初始化开始
+ * 渠道埋点: Bigabid:mraid_viewable | InMobi:Ad_Load_Start | AppLovin:LOADING
+ * 同时初始化进度里程碑
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInit(adNetwork?: string): void;
+/**
+ * start 事件：游戏资源加载完成
+ * 渠道埋点: Bigabid:game_viewable | InMobi:Ad_Viewable | AppLovin:LOADED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onStart(adNetwork?: string): void;
+/**
+ * interactive 事件：主场景就绪，用户可交互
+ * 渠道埋点: AppLovin:DISPLAYED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInteractive(adNetwork?: string): void;
+/**
+ * interaction 事件：首次交互
+ * 渠道埋点: Bigabid:engagement | InMobi:First_Engagement | AppLovin:CHALLENGE_STARTED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInteraction(adNetwork?: string): void;
+/**
+ * success 事件：成功计数（用于进度百分比追踪）
+ */
+declare function _onSuccess(successCount: number): void;
+/**
+ * finish 事件：游戏结束
+ * 渠道埋点: Bigabid:complete | InMobi:Gameplay_Complete | AppLovin:ENDCARD_SHOWN
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onFinish(adNetwork?: string): void;
+/**
+ * install 事件：点击安装
+ * 渠道埋点: Bigabid:click | InMobi:DSP_Click | AppLovin:CTA_CLICKED
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onInstall(adNetwork?: string): void;
+/**
+ * retry 事件：重试游戏
+ * 渠道埋点: AppLovin:CHALLENGE_RETRY
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _onRetry(adNetwork?: string): void;
+/**
+ * 触发游戏成功事件
+ * 不同渠道发送对应的成功埋点
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _trackChallengeSuccess(adNetwork?: string): void;
+/**
+ * 触发游戏失败事件
+ * 不同渠道发送对应的失败埋点
+ * @param adNetwork - 可选的广告渠道名称，不传则使用全局 AD_NETWORK
+ */
+declare function _trackChallengeFailed(adNetwork?: string): void;
+/**
+ * 统一的埋点追踪对象
+ * 包含所有 SDK 事件的埋点方法
+ */
+declare const tracking: {
+    /**
+     * SDK 初始化开始
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInit: typeof _onInit;
+    /**
+     * 游戏资源加载完成
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onStart: typeof _onStart;
+    /**
+     * 主场景就绪，用户可交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteractive: typeof _onInteractive;
+    /**
+     * 首次交互
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInteraction: typeof _onInteraction;
+    /**
+     * 成功计数（用于进度百分比追踪）
+     * @param successCount - 当前成功次数
+     */
+    onSuccess: typeof _onSuccess;
+    /**
+     * 游戏结束
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onFinish: typeof _onFinish;
+    /**
+     * 点击安装
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onInstall: typeof _onInstall;
+    /**
+     * 重试游戏
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    onRetry: typeof _onRetry;
+    /**
+     * 设置交互总数（用于进度百分比计算）
+     * @param total - 交互总数
+     */
+    setTotalInteractions: typeof setTotalInteractions;
+    /**
+     * 检查交互进度
+     * @param currentInteractions - 当前交互次数
+     */
+    checkInteractionProgress: typeof checkInteractionProgress;
+    /**
+     * 触发游戏成功事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeSuccess: typeof _trackChallengeSuccess;
+    /**
+     * 触发游戏失败事件
+     * @param adNetwork - 可选的广告渠道名称
+     */
+    trackChallengeFailed: typeof _trackChallengeFailed;
+};
+
+export { sdk as default, hideWechatGuide, removeWechatGuide, sdk, showWechatGuide, tracking };