SDK对接文档

主题

简介 ​

需求来源 ​

是否是渠道必接：有内购必接，非内购项目如需买量必接，其他情况选接

AMS需求

功能简介 ​

在小游戏公共库中整合成统一风格的调用接口，和统一在小游戏配置面板上配置相关内容

各种别称 ​

对应功能截图 ​

AMS 后台

前置条件 ​

框架版本：1.2.0框架

公共库版本：微信插件模块>=9.0.1

打包渠道：微信小游戏

其他要求：需要发布在小游戏后台中添加对应地址的白名单

https://api.datanexus.qq.com

接入 ​

接入流程 ​

1. AMS配置界面 ​

IAP，内购项目 ​

sql
//角色名称（有就上报）
XYX.WXAMS.OnCreateRole("test"); 
//上报完成新手引导（有就上报）
XYX.WXAMS.OnFinishToturial();
//上报升级（有就上报）
XYX.WXAMS.UpdateLevel(100);
//上报浏览某个UI（有就上报）
XYX.WXAMS.VIEW_CONTENT();
//上报浏览商店UI（有就上报）
XYX.WXAMS.VIEW_CONTENT_Mall();
//上报浏览活动UI（有就上报）
XYX.WXAMS.VIEW_CONTENT_Activity ();

IAA项目接入 ​

下面这些属于必接，如果游戏无法接入，请给测试说一下

新手引导 ​
json
XYX.WXAMS.TutorialStart();引导开始
json
XYX.WXAMS.TutorialFinish();引导结束
关卡相关 ​

上报模块

即：如果之前接入过统计埋点中的封装关卡事件埋点，此处可以忽略，sdk会自动上报，但是如果有道具消耗等事件，需要根据枚举值额外上报一次

json
//已关卡开始上报为例
//需要补充关卡名字，关卡进度，金币数量
int level =1;
string levelName = "关卡" + level;
data.mode_level = level;
data.mode_level_name = levelName;
data.mode_level_progress = 1;//进度为1到100
data._current_gold = Gold;        
ReportManager.Instance.NewReportGameStart(data);

关卡内使用道具

java
LitJson.JsonData jsonData = new LitJson.JsonData();
jsonData["chapter_id"] = 1;//章节
jsonData["stamina_value"] = 10;//体力
jsonData["level_value"] = 100;//等级

jsonData["items"] = new LitJson.JsonData();
jsonData["items"].Add(new LitJson.JsonData("{item_type:1,item_num:1}"));
jsonData["items"].Add(new LitJson.JsonData("{item_type:2,item_num:1}"));

string jsonProperties = jsonData.ToJson();
//上报
XYX.WXAMS.SetLevelData(jsonProperties);
视频相关 ​

研发必须手动初始化

XYX.WXAMS.SetVideoMapping

一定要在SDK初始化完成后注册

Csharp
ZMYSDKManager.SDKInitOver_Event += OnSDKInitOver;

void OnSDKInitOver(object sender, System.EventArgs e){
        Debug.Log("SDK初始化完成");
        //后面执行video_name注册
}

如

激励视频广告枚举值如下

自测 ​

检查是否有对应打印 ​

微信日志中搜索WXAMS 函数调用会有对应的中文日志

如果没有AMS的初始化日志 请务必检查 是否配置正确，因为AMS是配置后才会开启的业务 ​

//下方是埋点具体的对应的打印

java
收藏游戏： 
Log("WXAMS", $"Call OnAddToFavorites 用户收藏小游戏：");

注册事件：
Log("WXAMS", $"Call checkRegAndReActive 上报注册事件");

回归事件
Log("WXAMS", $"Call onReActive 用户回归 天数：" + backday);

支付事件
Log("WXAMS", "Call 支付 金额分:" + purchaseValue);

分享事件
Log("WXAMS", "Call 调用分享 是否是朋友圈 :" + isShareToTimeLine);

创建角色:
Log("WXAMS", "Call 创建角色:" + roleName);

新手引导
Log("WXAMS", "Call 完成新手引导:");

玩家升级
Log("WXAMS", "Call 升级:" + level);

浏览商城
Log("WXAMS", "Call 浏览商城:" + "Mall");

检查是否上传成功 ​

  1. 查看微信开发者工具中的的network信息

Code 为0 代表上传成功

ams后台是否能看到上报信息，是由测试验收的，研发没有后台权限

点我快速对接
›