keytops-game-framework 2.0.0 → 2.1.1

package/dist/index.js

@@ -1416,7 +1416,10 @@ class EmptyAnalyticsSender {
         }
         return true;
     }
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return { eventName, data: Object.assign({}, eventData) };
+    }
+    send(eventName, eventData, userProperties) {
         return __awaiter(this, void 0, void 0, function* () {
         });
     }
@@ -1452,44 +1455,14 @@ class AnalyticsAble {
         for (let i = 0; i < senders.length; i++) {
             const sender = senders[i];
             this._senderList.push(sender);
-            this._syncSenderUserState(sender);
-        }
-    }
-    _usesSenderUserProperties(sender) {
-        if (sender.userPropertyMode !== "sender") {
-            return false;
-        }
-        if (typeof sender.setUserProperty === "function") {
-            return true;
+            if (this._hasSetUserId && typeof sender.setUserId === "function") {
+                sender.setUserId(this._userId);
+            }
         }
-        this._debugMode && console.error("[Analytics] userPropertyMode=sender 的 Sender 必须实现 setUserProperty，已回退为 event 模式。");
-        return false;
     }
     _getUserProperties() {
         return Object.assign({}, this._userOnceProperties || {}, this._userAddProperties || {}, this._userProperties || {});
     }
-    _syncSenderUserState(sender) {
-        if (this._hasSetUserId && typeof sender.setUserId === "function") {
-            sender.setUserId(this._userId);
-        }
-        if (!this._usesSenderUserProperties(sender)) {
-            return;
-        }
-        const properties = this._getUserProperties();
-        for (const key in properties) {
-            if (Object.prototype.hasOwnProperty.call(properties, key)) {
-                sender.setUserProperty(key, properties[key]);
-            }
-        }
-    }
-    _notifyUserProperty(key, value) {
-        for (let i = 0; i < this._senderList.length; i++) {
-            const sender = this._senderList[i];
-            if (this._usesSenderUserProperties(sender)) {
-                sender.setUserProperty(key, value);
-            }
-        }
-    }
     /**
      * 设置排除
      * @param excludeEvents 排除事件名称或者名称列表。
@@ -1509,11 +1482,11 @@ class AnalyticsAble {
         }
     }
     _onAppShow() {
-        this.time("app_hide");
-        this.report("app_show", publisher.publisher.enterOptions.getAllOption());
+        this.time("app.hide");
+        this.report("app.show", publisher.publisher.enterOptions.getAllOption());
     }
     _onAppHide() {
-        this.report("app_hide");
+        this.report("app.hide");
     }
     /**
      * 设置所有上报事件的基础属性
@@ -1632,7 +1605,6 @@ class AnalyticsAble {
             console.warn(`用户属性中已经存在${key}:${this._userProperties[key]}, 将替换为${value}`);
         }
         this._userProperties[key] = value;
-        this._notifyUserProperty(key, value);
     }
     /**
      * 如果您要上传的用户属性只要设置一次，则可以调用 userSetOnce 来进行设置。
@@ -1662,12 +1634,10 @@ class AnalyticsAble {
         if (storageValue != null && storageValue != "") {
             this._debugMode && console.info(`用户属性中已经存在once属性${key}:${storageValue}`);
             this._userOnceProperties[key] = typeof value === "number" ? Number(storageValue) : storageValue;
-            this._notifyUserProperty(key, this._userOnceProperties[key]);
             return;
         }
         storage.setUValue(`analytics_user_once_${key}`, value);
         this._userOnceProperties[key] = value;
-        this._notifyUserProperty(key, value);
     }
     /**
      *设置用户累积属性，当您要上传数值型的属性时，您可以调用 userAdd 来对该属性进行累加操作，
@@ -1690,7 +1660,6 @@ class AnalyticsAble {
         let total = Number(this._userAddProperties[key] || storage.getUValue(`analytics_user_add_${key}`, 0) || 0);
         this._userAddProperties[key] = total + value;
         storage.setUValue(`analytics_user_add_${key}`, total + value);
-        this._notifyUserProperty(key, total + value);
     }
     /**
      * 移除用户属性。当您要清空用户的用户属性值时，您可以调用 userUnset 来对指定属性进行清空操作，如果该属性还未在集群中被创建，则 user_unset 不会创建该属性
@@ -1702,14 +1671,13 @@ class AnalyticsAble {
         this._userAddProperties && delete this._userAddProperties[key];
         storage.removeUValue(`analytics_user_once_${key}`);
         storage.removeUValue(`analytics_user_add_${key}`);
-        this._notifyUserProperty(key, null);
     }
     /**
      * 上报错误
      * @param error 错误信息
      */
     error(error) {
-        this.report("app_error", { error: error });
+        this.report("app.error", { error: error });
     }
     /**
      * 开始事件计时
@@ -1794,16 +1762,170 @@ class AnalyticsAble {
             return Promise.all(this._senderList
                 .filter((sender) => sender.sendAble(eventName))
                 .map((sender) => {
-                const senderData = Object.assign({}, data);
-                if (!this._usesSenderUserProperties(sender)) {
-                    this._copyToData(eventName, senderData, userProperties);
+                const mapped = sender.mapEvent(eventName, Object.assign({}, data));
+                if (!sender.sendAble(mapped.eventName)) {
+                    return Promise.resolve();
                 }
-                return sender.send(eventName, senderData);
+                return sender.send(mapped.eventName, Object.assign({}, mapped.data), Object.assign({}, userProperties));
             })).then();
         });
     }
 }
 
+/**
+ * 框架内部统一使用的业务语义事件名。
+ * Sender 负责将它们转换成统计平台实际接收的事件名和参数。
+ */
+var AnalyticsBehavior;
+(function (AnalyticsBehavior) {
+    AnalyticsBehavior["APP_LAUNCH"] = "app.launch";
+    AnalyticsBehavior["APP_SHOW"] = "app.show";
+    AnalyticsBehavior["APP_HIDE"] = "app.hide";
+    AnalyticsBehavior["APP_ERROR"] = "app.error";
+    AnalyticsBehavior["SESSION_LOGIN"] = "session.login";
+    AnalyticsBehavior["LEVEL_START"] = "level.start";
+    AnalyticsBehavior["LEVEL_END"] = "level.end";
+    AnalyticsBehavior["LEVEL_PAUSE"] = "level.pause";
+    AnalyticsBehavior["LEVEL_TIMEOUT"] = "level.timeout";
+    AnalyticsBehavior["LEVEL_ITEM_USE"] = "level.item_use";
+    AnalyticsBehavior["AD_LIFECYCLE"] = "ad.lifecycle";
+    AnalyticsBehavior["AD_IMPRESSION"] = "ad.impression";
+    AnalyticsBehavior["SOCIAL_SHARE"] = "social.share";
+    AnalyticsBehavior["SOCIAL_SUBSCRIBE_SHOW"] = "social.subscribe_show";
+    AnalyticsBehavior["SOCIAL_SUBSCRIBE"] = "social.subscribe";
+    AnalyticsBehavior["TUTORIAL_BEGIN"] = "tutorial.begin";
+    AnalyticsBehavior["TUTORIAL_COMPLETE"] = "tutorial.complete";
+    AnalyticsBehavior["TUTORIAL_SKIP"] = "tutorial.skip";
+    AnalyticsBehavior["PAY_BEGIN"] = "pay.begin";
+    AnalyticsBehavior["PAY_PURCHASE"] = "pay.purchase";
+    AnalyticsBehavior["PAY_PENDING"] = "pay.pending";
+    AnalyticsBehavior["PAY_CANCEL"] = "pay.cancel";
+    AnalyticsBehavior["PAY_FAIL"] = "pay.fail";
+})(AnalyticsBehavior || (AnalyticsBehavior = {}));
+const LEVEL_RESULT_EVENT = {
+    success: "lv_success",
+    fail: "lv_fail",
+    leave: "lv_leave",
+    skip: "lv_skip",
+    revive: "lv_revive",
+    break: "lv_break",
+    retry: "lv_retry",
+};
+const SHARE_PHASE_MESSAGE = {
+    begin: "发起",
+    success: "成功",
+    fail: "失败",
+};
+function move(data, source, target) {
+    if (data[source] !== undefined) {
+        data[target] = data[source];
+        delete data[source];
+    }
+}
+/**
+ * Keytops/Ali 当前服务端仍使用的物理协议。
+ * 兼容逻辑集中在 Sender 边界，业务层无需继续依赖旧事件字符串。
+ */
+function mapCanonicalEventToLegacy(eventName, eventData) {
+    const data = Object.assign({}, eventData);
+    let mappedName = eventName;
+    switch (eventName) {
+        case AnalyticsBehavior.APP_LAUNCH:
+        case AnalyticsBehavior.APP_SHOW:
+        case AnalyticsBehavior.APP_HIDE:
+        case AnalyticsBehavior.APP_ERROR:
+        case AnalyticsBehavior.SESSION_LOGIN:
+            mappedName = eventName.replace(".", "_");
+            if (eventName === AnalyticsBehavior.SESSION_LOGIN) {
+                mappedName = "login";
+                move(data, "options", "msg");
+            }
+            break;
+        case AnalyticsBehavior.LEVEL_START:
+            mappedName = "lv_enter";
+            break;
+        case AnalyticsBehavior.LEVEL_END:
+            mappedName = LEVEL_RESULT_EVENT[String(data.result || "")] || "lv_leave";
+            delete data.result;
+            break;
+        case AnalyticsBehavior.LEVEL_PAUSE:
+            mappedName = "lv_leave";
+            break;
+        case AnalyticsBehavior.LEVEL_TIMEOUT:
+            mappedName = "lv_timeout";
+            break;
+        case AnalyticsBehavior.LEVEL_ITEM_USE:
+            mappedName = "lv_item";
+            break;
+        case AnalyticsBehavior.AD_LIFECYCLE:
+        case AnalyticsBehavior.AD_IMPRESSION:
+            mappedName = "ad";
+            move(data, "adType", "_adtype");
+            move(data, "lifecycle", "_adevent");
+            move(data, "message", "msg");
+            delete data.group;
+            break;
+        case AnalyticsBehavior.SOCIAL_SHARE:
+            mappedName = "share";
+            if (data.itemId !== undefined && data.name === undefined) {
+                data.name = data.itemId;
+            }
+            if (data.phase !== undefined) {
+                data.msg = SHARE_PHASE_MESSAGE[String(data.phase)] || String(data.phase);
+            }
+            break;
+        case AnalyticsBehavior.SOCIAL_SUBSCRIBE_SHOW:
+            mappedName = "subscribe_show";
+            break;
+        case AnalyticsBehavior.SOCIAL_SUBSCRIBE:
+            mappedName = "subscribe";
+            break;
+        case AnalyticsBehavior.TUTORIAL_BEGIN:
+        case AnalyticsBehavior.TUTORIAL_COMPLETE:
+        case AnalyticsBehavior.TUTORIAL_SKIP:
+        case AnalyticsBehavior.PAY_BEGIN:
+        case AnalyticsBehavior.PAY_PURCHASE:
+        case AnalyticsBehavior.PAY_PENDING:
+        case AnalyticsBehavior.PAY_CANCEL:
+        case AnalyticsBehavior.PAY_FAIL:
+            mappedName = eventName.replace(".", "_");
+            break;
+    }
+    if (eventName === AnalyticsBehavior.LEVEL_START ||
+        eventName === AnalyticsBehavior.LEVEL_END ||
+        eventName === AnalyticsBehavior.LEVEL_PAUSE ||
+        eventName === AnalyticsBehavior.LEVEL_TIMEOUT ||
+        eventName === AnalyticsBehavior.LEVEL_ITEM_USE) {
+        move(data, "levelId", "id");
+        move(data, "levelIndex", "index");
+        move(data, "gameId", "type");
+        move(data, "repeatCount", "code");
+        move(data, "averageThinkTimeMs", "time");
+        move(data, "itemName", "name");
+        if (eventName === AnalyticsBehavior.LEVEL_TIMEOUT) {
+            data.name = "超时";
+            delete data.reason;
+        }
+        else if (eventName === AnalyticsBehavior.LEVEL_PAUSE) {
+            data.name = "切出游戏";
+            delete data.reason;
+        }
+        else {
+            move(data, "reason", "name");
+        }
+    }
+    return { eventName: mappedName, data };
+}
+/**
+ * 小游戏平台通常不接受点号事件名，统一转换为下划线。
+ */
+function mapCanonicalEventToFlatName(eventName, eventData) {
+    return {
+        eventName: eventName.replace(/\./g, "_"),
+        data: Object.assign({}, eventData),
+    };
+}
+
 const ALI_ANALYTICS_EVENT_CACHE = "ALI_ANALYTICS_EVENT_CACHE";
 /**
  * 内部阿里云日志事件上报器
@@ -1898,10 +2020,13 @@ class ALiAnalyticsSender extends EmptyAnalyticsSender {
             return false;
         }
     }
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToLegacy(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         return __awaiter(this, void 0, void 0, function* () {
-            const payload = data && typeof data === "object" && !Array.isArray(data)
-                ? Object.assign({}, data) : { value: data };
+            const payload = eventData && typeof eventData === "object" && !Array.isArray(eventData)
+                ? Object.assign(Object.assign({}, userProperties), eventData) : Object.assign({}, userProperties);
             payload['_event'] = eventName;
             let msg_data = {
                 appid: publisher.appId,
@@ -2235,7 +2360,7 @@ class ADBehaviorReporter {
      * @param from 广告来源
      */
     onShowComplete(type, from) {
-        this.report(type, ADEvent.SHOW_COMPLETE, from);
+        this.report(type, ADEvent.SHOW_COMPLETE, from, undefined, true);
     }
     /**
      * 广告显示失败
@@ -2261,20 +2386,20 @@ class ADBehaviorReporter {
      * @param from 广告来源
      * @param msg 广告失败原因
      */
-    report(type, event, from, msg) {
-        from = from || {};
-        const group = from.group || "game";
-        from.group && delete from.group;
-        from._adtype = type;
-        from._adevent = event;
+    report(type, event, from, msg, impression = false) {
+        const source = Object.assign({}, (from || {}));
+        const group = source.group || "game";
+        delete source.group;
         if (!this._groupCount[group]) {
             this._groupCount[group] = 0;
         }
-        from.count = event == ADEvent.SHOW_COMPLETE ? ++this._groupCount[group] : this._groupCount[group];
+        const data = Object.assign(Object.assign({}, source), { group, adType: type, lifecycle: event, count: event == ADEvent.SHOW_COMPLETE
+                ? ++this._groupCount[group]
+                : this._groupCount[group] });
         if (msg) {
-            from.msg = msg;
+            data.message = msg;
         }
-        this.baseAble.report("ad", from);
+        this.baseAble.report(impression ? AnalyticsBehavior.AD_IMPRESSION : AnalyticsBehavior.AD_LIFECYCLE, data);
     }
 }
 
@@ -2942,13 +3067,13 @@ LevelOnlineConfig = __decorate([
 
 var GameLeaveType;
 (function (GameLeaveType) {
-    GameLeaveType["success"] = "lv_success";
-    GameLeaveType["fail"] = "lv_fail";
-    GameLeaveType["leave"] = "lv_leave";
-    GameLeaveType["skip"] = "lv_skip";
-    GameLeaveType["revive"] = "lv_revive";
-    GameLeaveType["break"] = "lv_break";
-    GameLeaveType["retry"] = "lv_retry";
+    GameLeaveType["success"] = "success";
+    GameLeaveType["fail"] = "fail";
+    GameLeaveType["leave"] = "leave";
+    GameLeaveType["skip"] = "skip";
+    GameLeaveType["revive"] = "revive";
+    GameLeaveType["break"] = "break";
+    GameLeaveType["retry"] = "retry";
 })(GameLeaveType || (GameLeaveType = {}));
 /**
  * 关卡行为自动上报器
@@ -2967,7 +3092,7 @@ class LevelBehaviorReporter {
         this.reset();
         this._setTimers();
         App.onHide(this._leaveApp, this);
-        this.baseAble.report("lv_enter", context);
+        this.baseAble.report(AnalyticsBehavior.LEVEL_START, context);
     }
     end(type, data) {
         const context = this._getContext();
@@ -2978,7 +3103,7 @@ class LevelBehaviorReporter {
         const levelsession = this._game.getCurrentLevelSession();
         // 有效操作的平均思考时间
         const time = levelsession.stepsUsed > 0 ? Math.floor(levelsession.thinkTimeTotal / levelsession.stepsUsed) : 0;
-        this.baseAble.report(type, Object.assign(Object.assign(Object.assign({}, context), data), { time }));
+        this.baseAble.report(AnalyticsBehavior.LEVEL_END, Object.assign(Object.assign(Object.assign({}, context), data), { result: type, averageThinkTimeMs: time }));
         this.reset();
     }
     reportLeave(data) {
@@ -2986,47 +3111,39 @@ class LevelBehaviorReporter {
         if (!context) {
             return;
         }
-        this.baseAble.report(GameLeaveType.leave, Object.assign(Object.assign(Object.assign({}, context), { name: "切出游戏" }), data));
+        this.baseAble.report(AnalyticsBehavior.LEVEL_PAUSE, Object.assign(Object.assign(Object.assign({}, context), { reason: "app_hide" }), data));
     }
     reportTimeout(data) {
         const context = this._getContext();
         if (!context) {
             return;
         }
-        this.baseAble.report("lv_timeout", Object.assign(Object.assign(Object.assign({}, context), { name: "超时" }), data));
+        this.baseAble.report(AnalyticsBehavior.LEVEL_TIMEOUT, Object.assign(Object.assign(Object.assign({}, context), { reason: "timeout" }), data));
     }
     reportItem(name, data) {
         const context = this._getContext();
         if (!context) {
             return;
         }
-        this.baseAble.report("lv_item", Object.assign(Object.assign(Object.assign({}, context), { name: name.toLocaleLowerCase() }), data));
+        this.baseAble.report(AnalyticsBehavior.LEVEL_ITEM_USE, Object.assign(Object.assign(Object.assign({}, context), { itemName: name.toLocaleLowerCase() }), data));
     }
     reset() {
-        this.baseAble.cancelTime(GameLeaveType.success);
-        this.baseAble.cancelTime(GameLeaveType.leave);
-        this.baseAble.cancelTime(GameLeaveType.fail);
-        this.baseAble.cancelTime(GameLeaveType.skip);
-        this.baseAble.cancelTime(GameLeaveType.revive);
-        this.baseAble.cancelTime(GameLeaveType.break);
-        this.baseAble.cancelTime(GameLeaveType.retry);
-        this.baseAble.cancelTime("lv_timeout");
-        this.baseAble.cancelTime("ad");
+        this.baseAble.cancelTime(AnalyticsBehavior.LEVEL_END);
+        this.baseAble.cancelTime(AnalyticsBehavior.LEVEL_PAUSE);
+        this.baseAble.cancelTime(AnalyticsBehavior.LEVEL_TIMEOUT);
+        this.baseAble.cancelTime(AnalyticsBehavior.AD_LIFECYCLE);
+        this.baseAble.cancelTime(AnalyticsBehavior.AD_IMPRESSION);
         App.offHide(this._leaveApp, this);
     }
     _leaveApp() {
         this.reportLeave();
     }
     _setTimers() {
-        this.baseAble.time(GameLeaveType.success, false);
-        this.baseAble.time(GameLeaveType.leave, false);
-        this.baseAble.time(GameLeaveType.fail, false);
-        this.baseAble.time(GameLeaveType.skip, false);
-        this.baseAble.time(GameLeaveType.revive, false);
-        this.baseAble.time(GameLeaveType.break, false);
-        this.baseAble.time(GameLeaveType.retry, false);
-        this.baseAble.time("lv_timeout", false);
-        this.baseAble.time("ad", false);
+        this.baseAble.time(AnalyticsBehavior.LEVEL_END, false);
+        this.baseAble.time(AnalyticsBehavior.LEVEL_PAUSE, false);
+        this.baseAble.time(AnalyticsBehavior.LEVEL_TIMEOUT, false);
+        this.baseAble.time(AnalyticsBehavior.AD_LIFECYCLE, false);
+        this.baseAble.time(AnalyticsBehavior.AD_IMPRESSION, false);
     }
     _getContext() {
         return this._game.getCurrentBehaviorContext();
@@ -3810,7 +3927,7 @@ class GameDimension extends BaseDimension {
         if (!this._currentLevelSession) {
             return null;
         }
-        return Object.assign({ id: this._currentLevelSession.levelId.toString(), index: this._currentLevelSession.levelIndex, type: this._gameFlag, progress: this._currentLevelSession.progress, code: Number((_b = (_a = this._currentEnterParams) === null || _a === void 0 ? void 0 : _a.repeat) !== null && _b !== void 0 ? _b : 0) }, this._currentEnterParams);
+        return Object.assign(Object.assign({}, this._currentEnterParams), { levelId: this._currentLevelSession.levelId.toString(), levelIndex: this._currentLevelSession.levelIndex, gameId: this._gameFlag, progress: this._currentLevelSession.progress, repeatCount: Number((_b = (_a = this._currentEnterParams) === null || _a === void 0 ? void 0 : _a.repeat) !== null && _b !== void 0 ? _b : 0) });
     }
     onLevelStart(id, index, data) {
         this._currentEnterParams = data;
@@ -4109,7 +4226,7 @@ class LaunchAnalyticsAble {
      * 标记应用准备就绪，开始统计启动时间
      */
     ready() {
-        this._baseAble.time("app_launch");
+        this._baseAble.time(AnalyticsBehavior.APP_LAUNCH);
     }
     /**
      * 上报启动事件
@@ -4118,7 +4235,7 @@ class LaunchAnalyticsAble {
      */
     report(name, data) {
         const payload = Object.assign(Object.assign({}, (data || {})), { name });
-        this._baseAble.report("app_launch", payload);
+        this._baseAble.report(AnalyticsBehavior.APP_LAUNCH, payload);
     }
 }
 
@@ -4336,7 +4453,9 @@ class SessionAnalyticsAble {
         this._dimension = new SessionDimension();
     }
     recordLogin() {
-        this._baseAble.report("login", { msg: JSON.stringify(publisher.publisher.enterOptions.getAllOption()) });
+        this._baseAble.report(AnalyticsBehavior.SESSION_LOGIN, {
+            options: JSON.stringify(publisher.publisher.enterOptions.getAllOption()),
+        });
         this._dimension.recordLogin();
     }
     updateSessionDuration() {
@@ -4418,9 +4537,15 @@ class SocialAnalyticsAble {
         this._baseAble = baseAble;
         this._socialDimension = new SocialDimension();
     }
+    share(data) {
+        this._baseAble.report(AnalyticsBehavior.SOCIAL_SHARE, data);
+        data.phase === "success" && this._socialDimension.recordShare();
+    }
+    /**
+     * @deprecated 请改用 share，并明确传入分享阶段。
+     */
     recordShare(data) {
-        this._baseAble.report("share", data);
-        this._socialDimension.recordShare();
+        this.share(Object.assign(Object.assign({}, data), { phase: "success" }));
     }
     recordInvite(success = false) {
         this._socialDimension.recordInvite(success);
@@ -4432,16 +4557,104 @@ class SocialAnalyticsAble {
         this._socialDimension.recordInteraction();
     }
     recordSubscribeShow(name) {
-        this._baseAble.report("subscribe_show", { name });
+        this._baseAble.report(AnalyticsBehavior.SOCIAL_SUBSCRIBE_SHOW, { name });
     }
     recordSubscribe(name, code) {
-        this._baseAble.report("subscribe", { name, code });
+        this._baseAble.report(AnalyticsBehavior.SOCIAL_SUBSCRIBE, { name, code });
     }
     getMetrics() {
         return this._socialDimension.getMetrics();
     }
 }
 
+/**
+ * 新手引导统计能力。只提供稳定的业务动作，不维护引导流程状态。
+ */
+class TutorialAnalyticsAble {
+    constructor(_baseAble) {
+        this._baseAble = _baseAble;
+    }
+    begin(data) {
+        this._baseAble.report(AnalyticsBehavior.TUTORIAL_BEGIN, data);
+    }
+    complete(data) {
+        this._baseAble.report(AnalyticsBehavior.TUTORIAL_COMPLETE, data);
+    }
+    skip(data) {
+        this._baseAble.report(AnalyticsBehavior.TUTORIAL_SKIP, data);
+    }
+}
+
+/**
+ * 支付漏斗统计能力。价格由业务提供，value 由框架按商品明细统一计算。
+ */
+class PayAnalyticsAble {
+    constructor(_baseAble) {
+        this._baseAble = _baseAble;
+    }
+    begin(data) {
+        this.report(AnalyticsBehavior.PAY_BEGIN, data);
+    }
+    purchase(data) {
+        this.report(AnalyticsBehavior.PAY_PURCHASE, data);
+    }
+    pending(data) {
+        this.report(AnalyticsBehavior.PAY_PENDING, data);
+    }
+    cancel(data) {
+        this.report(AnalyticsBehavior.PAY_CANCEL, data);
+    }
+    fail(data) {
+        this.report(AnalyticsBehavior.PAY_FAIL, data);
+    }
+    report(eventName, data) {
+        const normalized = this.normalize(data);
+        if (!normalized) {
+            return;
+        }
+        this._baseAble.report(eventName, normalized);
+    }
+    normalize(data) {
+        const transactionId = String(data && data.transactionId || "").trim();
+        const currency = String(data && data.currency || "").trim().toUpperCase();
+        const items = data && data.items;
+        if (!transactionId) {
+            return this.invalid("transactionId 不能为空");
+        }
+        if (!/^[A-Z]{3}$/.test(currency)) {
+            return this.invalid(`currency 必须是三位大写货币代码: ${currency}`);
+        }
+        if (!Array.isArray(items) || items.length === 0) {
+            return this.invalid("items 不能为空");
+        }
+        const normalizedItems = [];
+        let value = 0;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const itemId = String(item && item.itemId || "").trim();
+            const price = Number(item && item.price);
+            const quantity = item && item.quantity === undefined
+                ? 1
+                : Number(item.quantity);
+            if (!itemId || !Number.isFinite(price) || price < 0) {
+                return this.invalid(`items[${i}] 的 itemId/price 无效`);
+            }
+            if (!Number.isInteger(quantity) || quantity <= 0) {
+                return this.invalid(`items[${i}] 的 quantity 必须是正整数`);
+            }
+            const normalizedItem = Object.assign(Object.assign({}, item), { itemId, price, quantity });
+            normalizedItems.push(normalizedItem);
+            value += price * quantity;
+        }
+        return Object.assign(Object.assign({}, data), { transactionId,
+            currency, items: normalizedItems, value: Math.round(value * 1000000) / 1000000 });
+    }
+    invalid(message) {
+        console.warn(`[Analytics.pay] ${message}，本次事件已忽略。`);
+        return null;
+    }
+}
+
 /**
  * 请求进度改变时调度。
  * @eventType Event.PROGRESS
@@ -6214,10 +6427,13 @@ class KeytopsAnalyticsSender extends EmptyAnalyticsSender {
             }
         });
     }
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToLegacy(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         return __awaiter(this, void 0, void 0, function* () {
-            const payload = data && typeof data === "object" && !Array.isArray(data)
-                ? Object.assign({}, data) : { value: data };
+            const payload = eventData && typeof eventData === "object" && !Array.isArray(eventData)
+                ? Object.assign(Object.assign({}, userProperties), eventData) : Object.assign({}, userProperties);
             let msg_data = {
                 appid: publisher.appId,
                 openid: String(storage.userId || publisher.login.openID || ""),
@@ -6238,6 +6454,276 @@ class KeytopsAnalyticsSender extends EmptyAnalyticsSender {
     }
 }
 
+/*
+@name: NativeHelper
+@desc: 原生函数调用代理
+@author: timoo
+@date: 2022/11/26
+*/
+class NativeHelper {
+    static call(className, methodName, ...args) {
+        NativeHelper.impl.call(className, methodName, ...args);
+    }
+    static callWithReturnType(className, methodName, returnType, ...args) {
+        return NativeHelper.impl.callWithReturnType(className, methodName, returnType, ...args);
+    }
+    static registerCallback(caller, method, times, ...args) {
+        return NativeHelper.impl.registerCallback(caller, method, times, ...args);
+    }
+    static registerCallbackOnce(caller, method, ...args) {
+        return NativeHelper.impl.registerCallback(caller, method, 1, ...args);
+    }
+    static get impl() {
+        if (this._impl == null) {
+            this._impl = Injector.getInject(NativeHelper.KEY);
+        }
+        if (this._impl == null) {
+            throw new Error(NativeHelper.KEY + " 未注入!");
+        }
+        return this._impl;
+    }
+}
+NativeHelper.KEY = "NativeHelper";
+
+const DEFAULT_IGNORED_PARAMETERS = [
+    "device_system",
+    "device_platform",
+    "device_brand",
+    "device_model",
+    "app_version",
+];
+const RESERVED_PREFIXES = ["firebase_", "google_", "ga_"];
+const RESERVED_USER_PROPERTIES = new Set([
+    "first_open_time",
+    "first_visit_time",
+    "last_deep_link_referrer",
+    "user_id",
+    "first_open_after_install",
+]);
+const FIREBASE_EVENT_NAMES = {
+    [AnalyticsBehavior.SESSION_LOGIN]: "login",
+    [AnalyticsBehavior.LEVEL_START]: "level_start",
+    [AnalyticsBehavior.LEVEL_END]: "level_end",
+    [AnalyticsBehavior.AD_IMPRESSION]: "ad_impression",
+    [AnalyticsBehavior.TUTORIAL_BEGIN]: "tutorial_begin",
+    [AnalyticsBehavior.TUTORIAL_COMPLETE]: "tutorial_complete",
+    [AnalyticsBehavior.TUTORIAL_SKIP]: "tutorial_skip",
+    [AnalyticsBehavior.PAY_BEGIN]: "begin_checkout",
+    [AnalyticsBehavior.PAY_PURCHASE]: "purchase",
+    [AnalyticsBehavior.PAY_PENDING]: "purchase_pending",
+    [AnalyticsBehavior.PAY_CANCEL]: "purchase_cancel",
+    [AnalyticsBehavior.PAY_FAIL]: "purchase_fail",
+};
+/**
+ * Firebase Android Analytics 上报器。
+ *
+ * TS 端属于框架，Java Bridge 仍由具体游戏工程提供。非原生环境会安全忽略调用。
+ */
+class FirebaseAnalyticsSender extends EmptyAnalyticsSender {
+    constructor(config, exclude) {
+        super(exclude);
+        this._lastUserProperties = {};
+        if (!config || !String(config.bridgeClassName || "").trim()) {
+            throw new Error("FirebaseAnalyticsSender.bridgeClassName 不能为空");
+        }
+        this._config = {
+            bridgeClassName: String(config.bridgeClassName).trim(),
+            collectionEnabled: config.collectionEnabled !== false,
+            ignoredParameters: config.ignoredParameters || DEFAULT_IGNORED_PARAMETERS,
+            maxParameters: Math.min(Math.max(config.maxParameters || 25, 1), 25),
+            supportsStructuredItems: !!config.supportsStructuredItems,
+            debug: !!config.debug,
+        };
+        this._ignoredParameters = new Set(this._config.ignoredParameters);
+        if (this.canSend) {
+            NativeHelper.call(this._config.bridgeClassName, "setCollectionEnabled", this._config.collectionEnabled);
+        }
+    }
+    get canSend() {
+        var _a;
+        const target = globalThis;
+        const sys = target.cc && target.cc.sys;
+        if (sys) {
+            return !!(sys.isNative &&
+                sys.os === ((_a = sys.OS) === null || _a === void 0 ? void 0 : _a.ANDROID) &&
+                (target.jsb || target.native));
+        }
+        return !!(target.jsb || target.native);
+    }
+    setUserId(userId) {
+        const normalized = userId == null ? null : String(userId).trim();
+        const nextUserId = normalized ? this.truncate(normalized, 256) : null;
+        if (this._lastUserId === nextUserId) {
+            return;
+        }
+        this._lastUserId = nextUserId;
+        if (!this.canSend) {
+            return;
+        }
+        NativeHelper.call(this._config.bridgeClassName, nextUserId ? "setUserId" : "clearUserId", ...(nextUserId ? [nextUserId] : []));
+    }
+    mapEvent(eventName, eventData) {
+        const data = this.mapParameters(eventName, eventData);
+        let mappedName = FIREBASE_EVENT_NAMES[eventName] || eventName.replace(/\./g, "_");
+        if (eventName === AnalyticsBehavior.SOCIAL_SHARE) {
+            const phase = String(data.phase || "");
+            mappedName = phase === "success" ? "share" : `share_${phase || "unknown"}`;
+        }
+        else if (eventName === AnalyticsBehavior.AD_LIFECYCLE) {
+            mappedName = "ad_lifecycle";
+        }
+        return { eventName: mappedName, data };
+    }
+    send(eventName, eventData, userProperties) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.canSend || !this._config.collectionEnabled) {
+                return;
+            }
+            if (!this.isValidName(eventName, 40)) {
+                this.warn(`忽略无效 Firebase 事件名: ${eventName}`);
+                return;
+            }
+            if ((eventName === "purchase" || eventName === "begin_checkout") &&
+                Array.isArray(eventData.items) &&
+                !this._config.supportsStructuredItems) {
+                this.syncUserProperties(userProperties);
+                this.warn("当前 Java Bridge 不支持 Bundle[] items，支付事件已忽略。");
+                return;
+            }
+            this.syncUserProperties(userProperties);
+            const parameters = this.normalizeParameters(eventData);
+            NativeHelper.call(this._config.bridgeClassName, "logEvent", eventName, JSON.stringify(parameters));
+        });
+    }
+    mapParameters(eventName, eventData) {
+        const data = Object.assign({}, eventData);
+        if (eventName === AnalyticsBehavior.LEVEL_START ||
+            eventName === AnalyticsBehavior.LEVEL_END) {
+            if (data.levelId !== undefined) {
+                data.level_name = data.levelId;
+                delete data.levelId;
+            }
+        }
+        if (eventName === AnalyticsBehavior.SOCIAL_SHARE) {
+            if (data.contentType !== undefined) {
+                data.content_type = data.contentType;
+                delete data.contentType;
+            }
+            if (data.itemId !== undefined) {
+                data.item_id = data.itemId;
+                delete data.itemId;
+            }
+        }
+        if (eventName === AnalyticsBehavior.PAY_BEGIN ||
+            eventName === AnalyticsBehavior.PAY_PURCHASE) {
+            if (data.transactionId !== undefined) {
+                data.transaction_id = data.transactionId;
+                delete data.transactionId;
+            }
+            if (Array.isArray(data.items)) {
+                data.items = data.items.map((item) => {
+                    if (item.itemId === undefined) {
+                        return Object.assign({}, item);
+                    }
+                    const mapped = Object.assign(Object.assign({}, item), { item_id: item.itemId });
+                    delete mapped.itemId;
+                    if (item.itemName !== undefined) {
+                        mapped.item_name = item.itemName;
+                        delete mapped.itemName;
+                    }
+                    if (item.itemCategory !== undefined) {
+                        mapped.item_category = item.itemCategory;
+                        delete mapped.itemCategory;
+                    }
+                    return mapped;
+                });
+            }
+        }
+        return data;
+    }
+    syncUserProperties(properties) {
+        const previous = this._lastUserProperties;
+        Object.keys(previous).forEach((key) => {
+            if (!Object.prototype.hasOwnProperty.call(properties, key)) {
+                this.setUserProperty(key, null);
+            }
+        });
+        Object.keys(properties).forEach((key) => {
+            if (previous[key] !== properties[key]) {
+                this.setUserProperty(key, properties[key]);
+            }
+        });
+        this._lastUserProperties = Object.assign({}, properties);
+    }
+    setUserProperty(key, value) {
+        if (!this.isValidName(key, 24) || RESERVED_USER_PROPERTIES.has(key)) {
+            this.warn(`忽略无效 Firebase 用户属性: ${key}`);
+            return;
+        }
+        if (value == null) {
+            NativeHelper.call(this._config.bridgeClassName, "clearUserProperty", key);
+            return;
+        }
+        const normalized = typeof value === "boolean"
+            ? (value ? "1" : "0")
+            : String(value);
+        NativeHelper.call(this._config.bridgeClassName, "setUserProperty", key, this.truncate(normalized, 36));
+    }
+    normalizeParameters(data) {
+        const result = {};
+        const keys = Object.keys(data || {});
+        for (let i = 0; i < keys.length; i++) {
+            if (Object.keys(result).length >= this._config.maxParameters) {
+                this.warn(`Firebase 事件参数超过 ${this._config.maxParameters} 个，后续参数已忽略。`);
+                break;
+            }
+            const key = keys[i];
+            if (this._ignoredParameters.has(key) || !this.isValidName(key, 40)) {
+                continue;
+            }
+            const value = data[key];
+            if (key === "items" && Array.isArray(value)) {
+                if (this._config.supportsStructuredItems) {
+                    result[key] = value.map((item) => (Object.assign({}, item)));
+                }
+                continue;
+            }
+            const normalized = this.normalizeValue(value);
+            if (normalized !== undefined) {
+                result[key] = normalized;
+            }
+        }
+        return result;
+    }
+    normalizeValue(value) {
+        if (value == null) {
+            return undefined;
+        }
+        if (typeof value === "boolean") {
+            return value ? 1 : 0;
+        }
+        if (typeof value === "number") {
+            return Number.isFinite(value) ? value : undefined;
+        }
+        if (typeof value === "string") {
+            return this.truncate(value, 100);
+        }
+        return undefined;
+    }
+    isValidName(name, maxLength) {
+        if (!name || name.length > maxLength || !/^[A-Za-z][A-Za-z0-9_]*$/.test(name)) {
+            return false;
+        }
+        return !RESERVED_PREFIXES.some((prefix) => name.startsWith(prefix));
+    }
+    truncate(value, maxLength) {
+        return value.length > maxLength ? value.slice(0, maxLength) : value;
+    }
+    warn(message) {
+        this._config.debug && console.warn(`[FirebaseAnalyticsSender] ${message}`);
+    }
+}
+
 class AnalyticsManager {
     constructor() {
         this._base = null;
@@ -6246,6 +6732,9 @@ class AnalyticsManager {
         this._session = null;
         this._launch = null;
         this._social = null;
+        this._tutorial = null;
+        this._pay = null;
+        this._abilityMap = new Map();
         this._assignmentSender = null;
     }
     hasRelayUrl(config) {
@@ -6333,6 +6822,46 @@ class AnalyticsManager {
         }
         return this._social;
     }
+    /**
+     * 新手引导统计能力
+     */
+    get tutorial() {
+        if (!this.base.inited) {
+            throw new Error("请先通过enable初始化基础统计能力");
+        }
+        if (!this._tutorial) {
+            this._tutorial = new TutorialAnalyticsAble(this.base);
+        }
+        return this._tutorial;
+    }
+    /**
+     * 支付漏斗统计能力
+     */
+    get pay() {
+        if (!this.base.inited) {
+            throw new Error("请先通过enable初始化基础统计能力");
+        }
+        if (!this._pay) {
+            this._pay = new PayAnalyticsAble(this.base);
+        }
+        return this._pay;
+    }
+    /**
+     * 获取由 AnalyticsManager 代管的自定义统计能力。
+     *
+     * 同一个构造器只会创建一个实例；自定义能力应通过构造参数接收基础统计能力。
+     */
+    getAbility(abilityClass) {
+        if (!this.base.inited) {
+            throw new Error("请先通过enable初始化基础统计能力");
+        }
+        let instance = this._abilityMap.get(abilityClass);
+        if (!instance) {
+            instance = new abilityClass(this.base);
+            this._abilityMap.set(abilityClass, instance);
+        }
+        return instance;
+    }
     /**
      * 启用统计（基础统计能力）
      * @param debugMode 调试模式，是否打印日志信息，默认为false
@@ -6398,7 +6927,7 @@ class AnalyticsManager {
             if (levelid !== undefined) {
                 payload.level_id = levelid;
             }
-            this.assignmentSender.send(eventName, payload);
+            this.assignmentSender.send(eventName, payload, {});
         });
     }
 }
@@ -6716,37 +7245,6 @@ Application.KEY = "Application";
  */
 const App = new Application();
 
-/*
-@name: NativeHelper
-@desc: 原生函数调用代理
-@author: timoo
-@date: 2022/11/26
-*/
-class NativeHelper {
-    static call(className, methodName, ...args) {
-        NativeHelper.impl.call(className, methodName, ...args);
-    }
-    static callWithReturnType(className, methodName, returnType, ...args) {
-        return NativeHelper.impl.callWithReturnType(className, methodName, returnType, ...args);
-    }
-    static registerCallback(caller, method, times, ...args) {
-        return NativeHelper.impl.registerCallback(caller, method, times, ...args);
-    }
-    static registerCallbackOnce(caller, method, ...args) {
-        return NativeHelper.impl.registerCallback(caller, method, 1, ...args);
-    }
-    static get impl() {
-        if (this._impl == null) {
-            this._impl = Injector.getInject(NativeHelper.KEY);
-        }
-        if (this._impl == null) {
-            throw new Error(NativeHelper.KEY + " 未注入!");
-        }
-        return this._impl;
-    }
-}
-NativeHelper.KEY = "NativeHelper";
-
 /*
 @name: BusinessCenter
 @desc: 事务中心,管理事务
@@ -9872,15 +10370,18 @@ class IShareAble {
         let internalQuery = dataArr.join("&");
         return query ? query + "&" + internalQuery : internalQuery;
     }
-    _report(analyticsName, msg) {
-        let data = { msg };
+    _report(analyticsName, phase, method = "text_or_image") {
+        let data = { phase, method };
         if (typeof analyticsName === "string") {
-            data.name = analyticsName;
+            data.itemId = analyticsName;
         }
         else if (typeof analyticsName == "object") {
             Object.assign(data, analyticsName);
+            if (data.itemId === undefined && data.name !== undefined) {
+                data.itemId = data.name;
+            }
         }
-        analytics.social.recordShare(data);
+        analytics.social.share(data);
     }
     /**
      * 分享图片或者文字
@@ -10619,9 +11120,12 @@ class NativeAnalyticsSender extends EmptyAnalyticsSender {
         this._className = "sdk.Share";
         this._className = className;
     }
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToFlatName(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         return new Promise((success) => {
-            NativeHelper.call(this._className, "report", eventName, JSON.stringify(data));
+            NativeHelper.call(this._className, "report", eventName, JSON.stringify(Object.assign(Object.assign({}, userProperties), eventData)));
             success();
         });
     }
@@ -10892,14 +11396,14 @@ class NativeShare extends IShareAble {
     shareTextOrImage(analyticsName, data) {
         return __awaiter(this, void 0, void 0, function* () {
             console.log("发起分享：", analyticsName, data);
-            this._report(analyticsName, "发起");
+            this._report(analyticsName, "begin");
             return this._share("textOrImage", analyticsName, data);
         });
     }
     shareVideo(analyticsName, data) {
         return __awaiter(this, void 0, void 0, function* () {
             console.log("发起视频分享：", analyticsName, data);
-            this._report(analyticsName, "发起");
+            this._report(analyticsName, "begin", "video");
             return this._share("video", analyticsName, data);
         });
     }
@@ -10908,12 +11412,12 @@ class NativeShare extends IShareAble {
             let callbacks = [];
             callbacks.push(NativeHelper.registerCallbackOnce(this, () => {
                 console.log("分享完成，分享是否成功：", true);
-                this._report(analyticsName, "成功");
+                this._report(analyticsName, "success", action === "video" ? "video" : "text_or_image");
                 resolve(true);
             }));
             callbacks.push(NativeHelper.registerCallbackOnce(this, () => {
                 console.log("分享完成，分享是否成功：", false);
-                this._report(analyticsName, "失败");
+                this._report(analyticsName, "fail", action === "video" ? "video" : "text_or_image");
                 resolve(false);
             }));
             if (typeof data == "string") {
@@ -11358,10 +11862,13 @@ class TKAd extends IADAble {
  * TK事件上报器(window['tt'].reportAnalytics)
  */
 class TKAnalyticsSender extends EmptyAnalyticsSender {
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToFlatName(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            (_b = (_a = window['TTMinis']) === null || _a === void 0 ? void 0 : _a.game) === null || _b === void 0 ? void 0 : _b.reportEvent(eventName, data);
+            (_b = (_a = window['TTMinis']) === null || _a === void 0 ? void 0 : _a.game) === null || _b === void 0 ? void 0 : _b.reportEvent(eventName, Object.assign(Object.assign({}, userProperties), eventData));
         });
     }
 }
@@ -11383,9 +11890,12 @@ class WXPay extends IPayAble {
  * 微信事件上报器(window['wx'].reportEvent)
  */
 class WXAnalyticsSender extends EmptyAnalyticsSender {
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToFlatName(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         return __awaiter(this, void 0, void 0, function* () {
-            window['wx'].reportEvent(eventName, data);
+            window['wx'].reportEvent(eventName, Object.assign(Object.assign({}, userProperties), eventData));
         });
     }
 }
@@ -11446,7 +11956,7 @@ class WXShare extends IShareAble {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve) => {
                 console.log("发起分享：", analyticsName, data);
-                this._report(analyticsName, "发起");
+                this._report(analyticsName, "begin");
                 if (!this._wx) {
                     console.error("wx接口不存在!");
                     resolve(false);
@@ -11462,14 +11972,14 @@ class WXShare extends IShareAble {
                         let duration = Math.floor((Date.now() - shareTime) / 1000);
                         let shareResult = duration <= tempData.durationMax && duration >= tempData.durationMin;
                         console.log("分享完成，分享是否成功：", shareResult);
-                        this._report(analyticsName, "成功");
+                        this._report(analyticsName, shareResult ? "success" : "fail");
                         resolve(shareResult);
                     };
                     App.onShow(onShareBack);
                 }
                 else {
                     console.log("分享完成，分享是否成功：", false);
-                    this._report(analyticsName, "失败");
+                    this._report(analyticsName, "fail");
                     resolve(true);
                 }
             });
@@ -12203,7 +12713,7 @@ class KSShare extends IShareAble {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve) => {
                 console.log("发起分享：", data);
-                this._report(analyticsName, "发起");
+                this._report(analyticsName, "begin");
                 if (!this._ks) {
                     console.error("快手接口不存在!");
                     resolve(false);
@@ -12212,12 +12722,12 @@ class KSShare extends IShareAble {
                 params.query = this._getShareQuery(analyticsName, params.query);
                 params.success = () => {
                     console.log("分享完成，分享是否成功：", true);
-                    this._report(analyticsName, "成功");
+                    this._report(analyticsName, "success");
                     resolve(true);
                 };
                 params.fail = (e) => {
                     console.log("分享完成，分享是否成功：", false, e);
-                    this._report(analyticsName, "失败");
+                    this._report(analyticsName, "fail");
                     resolve(false);
                 };
                 this._ks.shareAppMessage(params);
@@ -12226,8 +12736,10 @@ class KSShare extends IShareAble {
     }
     shareVideo(analyticsName, data) {
         return __awaiter(this, void 0, void 0, function* () {
-            publisher.recordT().publicVideo(this._getShareQuery(analyticsName, data.query), data.mouldId);
-            return true;
+            this._report(analyticsName, "begin", "video");
+            const success = yield publisher.recordT().publicVideo(this._getShareQuery(analyticsName, data.query), data.mouldId);
+            this._report(analyticsName, success ? "success" : "fail", "video");
+            return success;
         });
     }
 }
@@ -12348,7 +12860,7 @@ class TTShare extends IShareAble {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve) => {
                 console.log("发起分享：", data);
-                this._report(analyticsName, "发起");
+                this._report(analyticsName, "begin");
                 if (!this._tt) {
                     console.error("tt接口不存在!");
                     resolve(false);
@@ -12357,12 +12869,12 @@ class TTShare extends IShareAble {
                 params.query = this._getShareQuery(analyticsName, params.query);
                 params.success = () => {
                     console.log("分享完成，分享是否成功：", true);
-                    this._report(analyticsName, "成功");
+                    this._report(analyticsName, "success");
                     resolve(true);
                 };
                 params.fail = (e) => {
                     console.log("分享完成，分享是否成功：", false, e);
-                    this._report(analyticsName, "失败");
+                    this._report(analyticsName, "fail");
                     resolve(false);
                 };
                 this._tt.shareAppMessage(params);
@@ -12373,7 +12885,7 @@ class TTShare extends IShareAble {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve) => {
                 console.log("发起视频分享：", data);
-                this._report(analyticsName, "发起");
+                this._report(analyticsName, "begin", "video");
                 if (!this._tt) {
                     console.error("tt接口不存在!");
                     resolve(false);
@@ -12390,12 +12902,12 @@ class TTShare extends IShareAble {
                     },
                     success: (res) => {
                         console.log("分享完成，分享是否成功：", true);
-                        this._report(analyticsName, "成功");
+                        this._report(analyticsName, "success", "video");
                         resolve(true);
                     },
                     fail: (e) => {
                         console.log("分享完成，分享是否成功：", false, e);
-                        this._report(analyticsName, "失败");
+                        this._report(analyticsName, "fail", "video");
                         resolve(false);
                     },
                 });
@@ -12761,9 +13273,12 @@ class TTAd extends IADAble {
  * 字节事件上报器(window['tt'].reportAnalytics)
  */
 class TTAnalyticsSender extends EmptyAnalyticsSender {
-    send(eventName, data) {
+    mapEvent(eventName, eventData) {
+        return mapCanonicalEventToFlatName(eventName, eventData);
+    }
+    send(eventName, eventData, userProperties) {
         return __awaiter(this, void 0, void 0, function* () {
-            window['tt'].reportAnalytics(eventName, data);
+            window['tt'].reportAnalytics(eventName, Object.assign(Object.assign({}, userProperties), eventData));
         });
     }
 }
@@ -15222,4 +15737,4 @@ TipsView = __decorate([
     menu("基础视图/TipsView")
 ], TipsView);
 
-export { ADAnalyticsAble, ADBehaviorReporter, ADEvent, ADType, AD_METRIC_ORDER_V1, ALiAnalyticsSender, AdDimension, AnalyticsAble, App, Application, Async, AudioBusiness, BaseDimension, BaseOnlineConfig, BaseProtocolHelper, BusinessCenter, ByteView, CCPViewLoader, CCSceneLoader, CocosNativeHelper, CocosStorageUtils, CocosViewManager, Component, ConfigHelper, DEFAULT_GAME_FLAG, Dictionary, DimensionType, ECS, EffectAudioSourceProxy, EmptyAnalyticsSender, EmptyLink, EnterOptionParser, Event$2 as Event, EventDispatcher, Fsm, FsmBase, GameDimension, GameLeaveType, GeometryUtils, Handler, HttpNode, HttpRequest, IADAble, IDevice, IGameUpdateAble, ILoginAble, INTERNAL_METHODS, INativeHelper, IPayAble, IPublisher, IPublisherManager, IRecordAble, IShareAble, IViewLoader, Injector, Json, KKTServer, KSAd, KSDevice, KSLogin, KSPublisher, KSRecorder, KSShare, KeytopsAnalyticsSender, LEVEL_STATS_METRIC_ORDER_V1, LaunchAnalyticsAble, LevelAnalyticsAble, LevelBehaviorReporter, LevelOnlineConfig, LevelStatsDimension, Link, List, LogType, Logger, MYAd, MYDevice, MYLogin, MYPublisher, Mask, MathUtils, MemeryStorage, NativeAd, NativeAnalyticsSender, NativeDevice, NativeHelper, NativeLogin, NativePay, NativePublisher, NativeRecorder, NativeShare, NativeUtils, NetManager, NoRequestServer, PLAYER_ABILITY_METRIC_ORDER_V1, PlayerAbilityDimension, Pool, PromiseUtils, PropSupport, PublisherManager, RemoteConfigService, RemoteConfigStore, ResourceManager, RewardVideoMaskBusiness, RuntimeApplicationImpl, Scene, Server, SessionAnalyticsAble, SessionDimension, SocialAnalyticsAble, SocialDimension, Socket, SocketLogType, SocketNode, Storage, StorageImpl, StringUtils, System, SystemOnlineConfig, TKAd, TKAnalyticsSender, TKDevice, TKLogin, TKPublisher, TTAd, TTAnalyticsSender, TTDevice, TTGameUpdater, TTLogin, TTPay, TTPublisher, TTRecorder, TTShare, Task, TaskQueue, TaskSequence, Timer, TimerImpl, TipsType, TipsView, View, ViewControl, ViewLevel, ViewManager, WXAd, WXAnalyticsSender, WXDevice, WXGameUpdater, WXLogin, WXPay, WXPublisher, WXShare, ab, analytics, audio, bidding, businessCenter, cmd, component, eventCenter, fsmManager, manager, maskView, md5, net, publisher, remoteConfig, remoteConfigService, res, server, storage, system, timer, version, viewAnalytics, viewClass, viewManager };
+export { ADAnalyticsAble, ADBehaviorReporter, ADEvent, ADType, AD_METRIC_ORDER_V1, ALiAnalyticsSender, AdDimension, AnalyticsAble, AnalyticsBehavior, App, Application, Async, AudioBusiness, BaseDimension, BaseOnlineConfig, BaseProtocolHelper, BusinessCenter, ByteView, CCPViewLoader, CCSceneLoader, CocosNativeHelper, CocosStorageUtils, CocosViewManager, Component, ConfigHelper, DEFAULT_GAME_FLAG, Dictionary, DimensionType, ECS, EffectAudioSourceProxy, EmptyAnalyticsSender, EmptyLink, EnterOptionParser, Event$2 as Event, EventDispatcher, FirebaseAnalyticsSender, Fsm, FsmBase, GameDimension, GameLeaveType, GeometryUtils, Handler, HttpNode, HttpRequest, IADAble, IDevice, IGameUpdateAble, ILoginAble, INTERNAL_METHODS, INativeHelper, IPayAble, IPublisher, IPublisherManager, IRecordAble, IShareAble, IViewLoader, Injector, Json, KKTServer, KSAd, KSDevice, KSLogin, KSPublisher, KSRecorder, KSShare, KeytopsAnalyticsSender, LEVEL_STATS_METRIC_ORDER_V1, LaunchAnalyticsAble, LevelAnalyticsAble, LevelBehaviorReporter, LevelOnlineConfig, LevelStatsDimension, Link, List, LogType, Logger, MYAd, MYDevice, MYLogin, MYPublisher, Mask, MathUtils, MemeryStorage, NativeAd, NativeAnalyticsSender, NativeDevice, NativeHelper, NativeLogin, NativePay, NativePublisher, NativeRecorder, NativeShare, NativeUtils, NetManager, NoRequestServer, PLAYER_ABILITY_METRIC_ORDER_V1, PayAnalyticsAble, PlayerAbilityDimension, Pool, PromiseUtils, PropSupport, PublisherManager, RemoteConfigService, RemoteConfigStore, ResourceManager, RewardVideoMaskBusiness, RuntimeApplicationImpl, Scene, Server, SessionAnalyticsAble, SessionDimension, SocialAnalyticsAble, SocialDimension, Socket, SocketLogType, SocketNode, Storage, StorageImpl, StringUtils, System, SystemOnlineConfig, TKAd, TKAnalyticsSender, TKDevice, TKLogin, TKPublisher, TTAd, TTAnalyticsSender, TTDevice, TTGameUpdater, TTLogin, TTPay, TTPublisher, TTRecorder, TTShare, Task, TaskQueue, TaskSequence, Timer, TimerImpl, TipsType, TipsView, TutorialAnalyticsAble, View, ViewControl, ViewLevel, ViewManager, WXAd, WXAnalyticsSender, WXDevice, WXGameUpdater, WXLogin, WXPay, WXPublisher, WXShare, ab, analytics, audio, bidding, businessCenter, cmd, component, eventCenter, fsmManager, manager, mapCanonicalEventToFlatName, mapCanonicalEventToLegacy, maskView, md5, net, publisher, remoteConfig, remoteConfigService, res, server, storage, system, timer, version, viewAnalytics, viewClass, viewManager };