官方文档

MSDK 数据上报（iOS）：灯塔与 Qimei SDK 接入说明原文标题：MSDK WIKI

发表时间：（页面未标注）采集时间：2026-10-09 10:34:43来源：wiki.ssl.msdk.qq.com原文语言：zh状态：完整

原始链接：https://wiki.ssl.msdk.qq.com/IOS/stat.html

内容概要总结

腾讯 MSDK 官方 Wiki 的 iOS 数据上报文档。灯塔（Beacon）是 MSDK 集成的移动 APP 运营平台组件，用于质量监控与用户分析，支持上报自定义事件数据。

接入方面：MSDK 3.3.25 起灯塔/Qimei SDK 插件化提供，除 MSDKBeacon.framework 外还需添加 MSDKBeacon/Beacon 目录下其他 framework；Beaconld.framework 是灯塔 4.2 以下依赖，4.2 以上改为依赖 QimeiSDK.framework。Qimei36 上报自 iOS 3.3.17 起支持，默认关闭需联系开通。文档给出 WGReportEvent 接口声明、参数表与示例代码。

合规要点：灯塔 iOS 4.2.76.20 起不再采集 idfa、wifiName、wifimac，MSDK 3.3.28 起新增 WGSetSensitiveInfo 接口透传这些字段，并需添加 Network.framework（optional）。

原文内容（原文即中文）

数据上报

概述

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

灯塔通过对海量的上报数据进行统计，以如下几个方面为主要着力点，帮助APP提升质量：

自定义事件灵活定制，分析产品功能在实际用户环境下的质量表现

终端信息完整掌握用户的硬件分布、地域及网络信息分布

用户行为多维海量用户分析，从各种视角帮助您更了解用户

用户画像结合多年无线数据积累，精准判断用户画像

详细说明请参考灯塔官网http://beacon.tencent.com/（内网访问，可由对应腾讯运营接口人协助查询）。

接入向导

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

1 前置条件

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

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

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 字段或咨询 “灯塔小秘”。

自定义数据上报

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中设置信息字段接口。

MSDK 数据上报（iOS）：灯塔与 Qimei SDK 接入说明 原文标题：MSDK WIKI