主题
Skip to content
上报流程
由于上报比较独立和赋值，所有接口位于ReportManager中
但是有三个属性值，上报频率较高，不需要每次都手动传入
LangType 和 GameName 默认根据 \Assets\Resources\XYXGlobalConfig.json 中的配置来上报
mode_name 通过 ReportManager.I.StartGameModel(ModeName); 传入，在模式开始时调用一次即可
mode_level 通过 ReportManager.I.NewReportGameStart(game_start); 中game_start的参数传入
参考
c#
void Start()
{
ZMYSDKManager.I.XYXHandler.InputFieldAdapter(m_input.gameObject);
//启动游戏应该先上报玩法开始
ReportManager.I.StartMineGame();
}
//再正式进入游戏核心玩法前，应该选择不同的玩法。也就是不同的模式，同一时间只存在一种模式
#region 模式上报
/// <summary>
/// 开始关卡模式
/// </summary>
public void mode_level(){ReportManager.I.StartGameModel("Level"); }
public void mode_PVP() { ReportManager.I.StartGameModel("PVP"); }//开始一个模式，会自动停掉上一个模式
public void mode_Customize() { ReportManager.I.StartGameModel("Customize"); }
public void mode_quit() { ReportManager.I.StartGameModel("None"); }//特殊标记为None，表示退出当前模式
#endregion
/*有关卡概念的游戏，应该进行关卡相关上报。
关卡上报分为：开始----过程中----结束。过程中的上报必须在关卡开始和结束期间进行上报。
否则会触发上报不合规，无法正常上报
关卡复活上报只能在关卡失败上报后进行上报
关卡退出上报不是关卡结束上报，关卡退出表示关卡流程被挂起，用户会再次进入挂起的关卡，并触发关卡继续上报。
*/
#region 关卡上报
/// <summary>
/// 关卡开始上报--单个关卡上报前 最开始的上报
/// </summary>
public void lv_GameStart()
{
game_start data= ReportManager.I.GetNewReportJsonData<game_start>();
int lv = 1;
int.TryParse(m_input.text, out lv);
data.mode_level = lv;
ReportManager.I.NewReportGameStart(data);
}WARNING
💡 激励视频上报里面的 mode_level,SDK 会默认自动获取 game_start 关卡开始上报中的 mode_level 属性值，如果想改变激励视频上报中的 mode_level 值，可以调用 ReportManager.mode_Level 来修改
SDK 封装了如下上报
| 上报模块 | 上报说明 | 上报条目 | 说明 |
|---|---|---|---|
| 玩法类上报 | 玩法首次开始 | start_first | StartMineGame 接口控制 |
| 玩法开始 | start | ||
| 玩法进行中 | gaming | ||
| 模式上报 | 模式开始 | mode_start | StartGameModel 接口控制 |
| 模式进行中 | mode_gaming | ||
| 关卡类上报 | 关卡开始 | game_start | NewReportGameStart 接口控制 |
| 关卡时长 | level_gaming | SDK 自动处理 | |
| 关卡离开 | game_quit | NewReportGameQuit 接口控制 | |
| 关卡进度变化 | game_progress | NewReportGameProgress 接口控制 | |
| 关卡犯规 | game_foul | NewReportGameFoul 接口控制 | |
| 关卡复活 | game_revive | NewReportGameRevive 接口控制 | |
| 关卡失败 | game_fail | NewReportGameFail 接口控制 | |
| 关卡过关 | game_complete | NewReportGameComplete 接口控制 | |
| 关卡平局 | game_draw | NewReportGameDraw 接口控制 | |
| 关卡跳过 | game_skip | NewReportGameSkip 接口控制 | |
| 激励视频上报 | 视频按钮不可用 | video_unable | 以下埋点由 VideoButton 组件自动上报 |
| 视频按钮无广告 | video_noAds | ||
| 视频按钮曝光 | video_show | ||
| 视频点击 | video_click | ||
| 视频播放完毕 | video_success | ||
| 视频播放退出 | video_fail | ||
| 视频播放开始 | video_play |
- 通过接口获取对应的上报数据类：
GetNewReportJsonData
c#
game_start data= ReportManager.I.GetNewReportJsonData<game_start>();- 赋值上报类里面对应的值
c#
data.mode_level = 12;- 调用对应上报类的接口
c#
//上报类对应的上报接口，都是固定写法NewReport_上报数据类 具体可以参考NewReportManagerByTools脚本
ReportManager.I.NewReport_game_start(game_Start);这样就会把game\_start 上报到事件后台。
- 校验上报
每条上报都会触发相关打印：
key：上报数据类的类名
JsonProperties：上报赋值的数据组成的 json 字符串
玩法上报
start\_first、start上报只需要调用ReportManager.StartMineGame()方法。
c#
ReportManager.I.StartMineGame();此接口会自动触发start\_first和start，并在后台开启计算器，定时上报gaming
模式上报
c#
ReportManager.I.StartGameModel(“模式名称”);WARNING
💡 调用了模式上报后，游戏会进入传入的相应游戏模式状态，后续所有涉及到 mode_name 属性都会变成模式上报时设置的值。如果相关的上报涉及到上报游戏模式，必须要设置好相应的模式之后，在进行上报。
调用StartGameModel()SDK 会自动处理mode\_gaming的上报
StartGameModel()参数传入一个非 None 的模式时，SDK 自动开始模式上报；当传入 None 的时候，如果上一个模式非 None，那么会停止上一个非 None 模式的时长上报，所以StartGameModel(None)也叫做模式结束。
关卡上报
WARNING
💡 关卡上报时，mode_name 和_duration SDK 会自动赋值。游戏研发可以忽略这 2 个字段
game_start 开始游戏
c#
ReportManager.I.NewReportGameStart();game_quit 离开游戏
NewGameQuit 用于处理中途离开游戏的情况
表示放弃游戏。比如点击暂停，然后点击暂停页面的返回主页
SDK 接口实现：
上报离开游戏
game_progress 游戏进度发生变化
上报游戏进度：
c#
game_progress data = ReportManager.I.GetNewReportJsonData<game_progress>();
data._current_gold++;
ReportManager.I.NewReportGameProgress(data);game_foul 游戏犯规
c#
game_foul data = ReportManager.I.GetNewReportJsonData<game_foul>();
data.activity_name = "游戏犯规1";
ReportManager.I.NewReportGameFoul(data);game_revive 游戏复活
c#
game_revive data = ReportManager.I.GetNewReportJsonData<game_revive>();
ReportManager.I.NewReportGameRevive(data);game_fail 游戏失败
c#
game_fail data = ReportManager.I.GetNewReportJsonData<game_fail>();
ReportManager.I.NewReportGameFail(data);game_complete 游戏成功
c#
game_complete data = ReportManager.I.GetNewReportJsonData<game_complete>();
ReportManager.I.NewReportGameComplete(data);game_pause 游戏暂停
c#
game_pause data = ReportManager.I.GetNewReportJsonData<game_pause>();
ReportManager.I.NewReportGamePause(data);game_continue 游戏继续
只能在关卡暂停和关卡离开后上报，有内部控制
c#
game_continue data = ReportManager.I.GetNewReportJsonData<game_continue>();
ReportManager.I.NewReportGameContinue(data);其他封装的上报
在ReportDefineByTools脚本中，SDK 预置了很多业务相关上报数据类，在NewReportManagerByTools脚本中预制了对应的上报接口。
对于 SDK 未封装的上报，参考上面的上报流程进行上报即可。
示例:
c#
//上报道具获得
item_get data = ReportManager.I.GetNewReportJsonData<item_get>();
data.item_id = 1001;
data.item_count = 50;
ReportManager.I.NewReport_item_get(data);全部封装上报接口
| 方法名 | 方法属性 | 方法描述 |
|---|---|---|
NewReport_game_share | game_share | 上报游戏分享 |
NewReport_game_evaluate | game_evaluate | 上报游戏评价 |
NewReport_game_ui_sort | game_ui_sort | 上报玩法多玩法排序 |
NewReport_game_stuck | game_stuck | 上报关卡卡点 |
NewReport_game_unlock | game_unlock | 上报关卡解锁 |
NewReport_game_loadstart | game_loadstart | 上报关卡资源加载开始 |
NewReport_game_loadover | game_loadover | 上报关卡资源加载完成 |
NewReport_game_loadfail | game_loadfail | 上报关卡资源加载失败 |
NewReport_game_click | game_click | 上报关卡动作 |
NewReport_game_round_start | game_round_start | 上报关卡回合开始 |
NewReport_game_round_complete | game_round_complete | 上报关卡回合结束 |
NewReport_game_behavior | game_behavior | 上报关卡行为 |
NewReport_game_difficulty_adjust | game_difficulty_adjust | 上报关卡难度调整 |
NewReport_dealing_card | dealing_card | 上报发牌 |
NewReport_item_get | item_get | 上报物品获得 |
NewReport_item_cost | item_cost | 上报物品消耗 |
NewReport_item_use | item_use | 上报物品使用 |
NewReport_tools_unlock | tools_unlock | 上报道具解锁 |
NewReport_tools_fail | tools_fail | 上报道具使用失败 |
NewReport_tools_use | tools_use | 上报道具使用成功 |
NewReport_activity_warmup | activity_warmup | 上报活动预热 |
NewReport_activity_unlock | activity_unlock | 上报活动解锁 |
NewReport_activity_enter | activity_enter | 上报活动界面进入 |
NewReport_activity_start | activity_start | 上报活动开始挑战 |
NewReport_activity_fail | activity_fail | 上报活动进度变化失败 |
NewReport_activity_success | activity_success | 上报活动进度变化成功 |
NewReport_activity_reward | activity_reward | 上报活动领奖 |
NewReport_activity_reset | activity_reset | 上报活动重置 |
NewReport_activity_giveup | activity_giveup | 上报活动放弃 |
NewReport_activity_complete | activity_complete | 上报活动完成 |
NewReport_activity_register | activity_register | 上报活动报名 |
NewReport_live_activity_start | live_activity_start | 上报活动创建 |
NewReport_live_activity_click | live_activity_click | 上报活动点击 |
NewReport_live_activity_update | live_activity_update | 上报活动更新 |
NewReport_live_activity_complete | live_activity_complete | 上报活动结束 |
NewReport_develop_trail | develop_trail | 上报养成点试用 |
NewReport_develop_unlock | develop_unlock | 上报养成点解锁 |
NewReport_develop_use | develop_use | 上报养成点使用 |
NewReport_develop_levelup | develop_levelup | 上报养成点升级 |
NewReport_element_show | element_show | 上报界面元素展示 |
NewReport_element_use | element_use | 上报界面元素使用 |
NewReport_element_result | element_result | 上报界面元素结果 |
NewReport_popup_show | popup_show | 上报弹窗展示 |
NewReport_popup_redirect | popup_redirect | 上报弹窗跳转 |
NewReport_res_downloadstart | res_downloadstart | 上报资源下载开始 |
NewReport_res_downloadover | res_downloadover | 上报资源下载成功 |
NewReport_res_downloadfail | res_downloadfail | 上报资源下载失败 |
NewReport_res_read_fail | res_read_fail | 上报资源读取失败 |
NewReport_mail_check | mail_check | 上报邮件查看 |
NewReport_mail_delete | mail_delete | 上报邮件删除 |
NewReport_mail_receive | mail_receive | 上报邮件接收 |
NewReport_insert_all | insert_all | 上报插屏All(游戏) |
NewReport_insert_nonet | insert_nonet | 上报插屏无网(游戏) |
NewReport_insert_select | insert_select | 上报插屏select(游戏) |
NewReport_insert_show | insert_show | 上报插屏show(游戏) |
NewReport_inters_click | inters_click | 上报插屏click(游戏) |
NewReport_insert_close | insert_close | 上报插屏close(游戏) |
NewReport_insert_show_level | insert_show_level | 上报insert_show_level |
NewReport_tcp_delay | tcp_delay | 上报服务器延迟 |
NewReport_login_register | login_register | 上报服务器创建账号 |
NewReport_login_b bind | login_bind | 上报绑定第三方账号 |
NewReport_login_request | login_request | 上报发起登录请求 |
NewReport_login_success | login_success | 上报登录成功 |
NewReport_login_fail | login_fail | 上报登录失败 |
NewReport_login_enterfsm | login_enterfsm | 上报进入某个登录状态 |
NewReport_login_leavefsm | login_leavefsm | 上报离开某个登录状态 |
NewReport_login_sdk | login_sdk | 上报登录SDK |
NewReport_login_startserver | login_startserver | 上报开始登录服务器 |
NewReport_login_server | login_server | 上报服务器登录回执 |
NewReport_login_startsyndata | login_startsyndata | 上报开始数据同步 |
NewReport_login_SynDatachangeuser | login_SynDatachangeuser | 上报和上一次登录的用户ID不一样 |
NewReport_login_focusupdate | login_focusupdate | 上报强制下载数据 |
NewReport_login_focusupload | login_focusupload | 上报强制上传数据 |
NewReport_login_synData_needUpdateData | login_synData_needUpdateData | 上报需要下载的数据Key |
NewReport_login_syndata_needuploaddata | login_syndata_needuploaddata | 上报需要上传的数据Key |
NewReport_login_syndata_actionsuccess | login_syndata_actionsuccess | 上报登录成功时数据同步动作完成 |
NewReport_login_syndata_fsmsuccess | login_syndata_fsmsuccess | 上报登录成功时数据同步状态成功 |
NewReport_login_nethttperror | login_nethttperror | 上报与服务器交互发生错误 |
NewReport_login_download_request | login_download_request | 上报账号数据下载发起 |
NewReport_login_download_success | login_download_success | 上报账号数据下载成功 |
NewReport_login_download_fail | login_download_fail | 上报账号数据下载失败 |
NewReport_login_upload_request | login_upload_request | 上报账号数据上传发起 |
NewReport_login_upload_success | login_upload_success | 上报账号数据上传成功 |
NewReport_login_upload_fail | login_upload_fail | 上报账号数据上传失败 |
NewReport_user_level_update | user_level_update | 上报用户等级更新 |
NewReport_pay_success_custom | pay_success_custom | 上报支付成功(自定义) |
NewReport_game_pay_event | game_pay_event | 上报支付事件(游戏) |
NewReport_unity_online_config_params | unity_online_config_params | 上报unity在线参数 |
NewReport_video_lock_park | video_lock_p park | 上报看视频解车位 |
NewReport_use_prop_refresh | use_prop_refresh | 上报使用道具排序车的颜色 |
NewReport_use_prop_sort | use_prop_sort | 上报使用道具排序人的颜色 |
NewReport_use_prop_remove | use_prop_remove | 上报使用道具移除一辆车 |
NewReport_ttfeed_entry | ttfeed_entry | 上报直玩进入 |
NewReport_ttfeed_subscribe | ttfeed_subscribe | 上报直玩订阅 |
NewReport_ttfeed_game_ready | ttfeed_game_ready | 上报游戏准备就绪 |
NewReport_ttfeed_reportev | ttfeed_reportev | 上报抖音Feed事件 |
NewReport_resume_request | resume_request | 上报发起恢复购买 |
NewReport_resume_success | resume_success | 上报恢复购买成功 |
自定义上报
也可以使用OnNewEvent接口进行自定义事件上报
c#
// 自定义上报
ZMYSDKManager.I.SDK.OnNewEvent(key， JsonString);点我快速对接
›