MSDK WIKI

概述

灯塔是以质量监控、用户分析为核心的移动APP运营平台，MSDK内部集成了灯塔SDK组件，通过我们封装的接口，您可以上报自定义事件数据。

接入向导

MSDK 3.3.25 版本开始，灯塔、Qimei SDK 以插件化形式提供，支持灵活替换；使用时除添加 MSDKBeacon/MSDKBeacon.framework 外还需添加 MSDKBeacon/Beacon 目录下其他 framework。Beaconld.framework 是灯塔 4.2 版本以下的依赖库，4.2 版本以上的灯塔已经变更为依赖 QimeiSDK.framework。

1 前置条件

1) 您已经在腾讯开放平台上注册游戏并通过审核，或您的腾讯接口人已经通过内部渠道帮您注册游戏。

2) 您已经按接入配置模块说明完成接入配置。

3) 您的游戏已经具备接入灯塔的权限，灯塔接入权限申请需要由对应腾讯运营接口人联系企业微信号灯塔小秘。

2 参考Demo示例

自定义数据上报示例参考 MSDKDemo/OtherViewController.mm 源码的 onClickCustomEventUpload 方法。

3 Qimei36 说明

Qimei36 上报功能，iOS 3.3.17 版本开始支持。默认为空，需要业务联系灯塔开通，开通指引参考：https://iwiki.woa.com/pages/viewpage.action?pageId=417707553

对于 appKey，Android 端一般为 QQ 号，iOS 端为 i+QQ 号,可参考飞鹰系统---SDK 参数---灯塔 Key 字段或咨询 “灯塔小秘”。
Qimei36 每隔 24 小时刷新一次。

自定义数据上报

1 概述

您可以通过MSDK提供接口上报自定义事件数据，上报的数据可以通过灯塔官网进行查看http://beacon.tencent.com/ （内网访问，可由对应腾讯运营接口人协助查询），上报后5分钟可以查到。

注册回调

无

调用接口

1)接口声明

void WGReportEvent(unsigned char* name, std::vector<KVPair>& eventList, bool isRealTime)

2)参数说明

参数名称	类型	说明
name	unsigned char* name	事件名称，最大长度128
eventList	std::vector<KVPair>	事件内容, 一个key-vector key最大长度64，value最大长度1024，key个数最大50， key建议使用"B1","B2"规则命名，以减少流量消耗
isRealTime	bool	是否实时上报，非实时上报会缓存本地，批量上报

3)返回值

无

4)示例代码

std::vector<KVPair>eveList;
KVPair item;
item.key = "evtBody";
item.value = std::string("wegame_evt_body");
eveList.push_back(item);
WGPlatform::GetInstance()->WGReportEvent((unsigned char*)"wegame_evt", eveList, true);

5)特殊说明

无

6)名词解释

无

iOS 灯塔透传字段接口

功能描述

灯塔 iOS 4.2.76.20，对 idfa、wifiName 和 wifimac 不再采集，故 MSDK 提供设置接口透传 idfa 等字段，填充到灯塔。3.3.28 版本开始新增该接口。

接口示例

WGPlatform::GetInstance()->WGSetSensitiveInfo("{\"WiFiMacAddress\":\"xxx\", \"WiFiName\":\"xxx\", \"Idfa\":\"xxx\"}");

注意事项

需添加系统依赖库 Network.framework，且设置为 optional
灯塔 iOS 目前支持 WiFiMacAddress、WiFiName、Idfa 字段，具体使用可参照https://wiki.ssl.msdk.qq.com/Unity/config.html#Unity_DataCompliance中设置信息字段接口。

概述