Outline

Beacon is a mobile APP operation platform which centers on quality control and user analysis. MSDK integrates beacon SDK components inside it. Through our encapsulated interfaces, you can report your custom event data.

Through statistics on the massive reporting data, Beacon mainly focuses on the following aspects to help improve the quality of APP:

1) Custom events Flexibly customize events and analyze the quality performance of product features in the actual user environment

2) Terminal information Completely grasp users' hardware distribution, geographical and network information distribution

3) User behavior Offer multidimensional, massive user analysis, helping you better understand users from a variety of perspectives

4) User portrait Accurately draw the user portrait in combination with years of accumulation of wireless data.

For detailed description, please refer to Beacon's official website http://beacon.tencent.com/ (Access through the Intranet, and the Tencent operation interface administrator may assist you in your search)

Access Guide

Starting from MSDK 3.3.25, Beacon and Qimei SDK are provided in the form of plug-ins and support flexible replacement; when using them, you need to add other frameworks in the MSDKBeacon/Beacon directory in addition to adding MSDKBeacon/MSSDKBeacon.framework.

1 Preconditions

1) You have registered games on Tencent open platform and passed the audit, or your staff in contact with Tencent have helped you register games through internal channels.

2) You have completed access configuration by fthe instructions for accessing the configuration module.

3) Your game has the privilege of accessing the lighthouse. When applying for the lighthouse access privilege, corresponding Tencent operation interface administrator shall get in touch with the corporate WeChat account of Lighthouse Assistant.

2 Refer to demos

As for user-defined data report examples, refer to MSDKDemo/OtherViewController.mm source code's onClickCustomEventUpload method.

User-defined data reporting

1 Summary

You can report custom event data through the interfaces provided by MSDK. The reported data can be viewed through Beacon's official websitehttp://beacon.tencent.com/ (access through the Intranet, and the Tencent operation interface administrator may assist you in your search). The data can be queried 5 minutes later after being reported.

Registration callback

None

Call interfaces

1)Interface declaration

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

2)Parameter description

3)Return value

None

4)Demo code

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)Special description

None

6)Term interpretation

None

iOS Beacon Transparent Transmission Field Interface

Function description

Beacon iOS 4.2.76.20 no longer collects idfa, wifiName and wifimac, so MSDK provides a privacy setting interface to transmit fields such as idfa and then fill them in Beacon.This interface has been added since version 3.3.28.

Interface example

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

Warning

• It is needed to add system dependency library Network.framework and set it to optional
• Beacon iOS currently supports WiFiMacAddress, WiFiName, and Idfa fields. For specific usage, please refer to “Information field setting interface” inhttps://wiki.ssl.msdk.qq.com/Unity/config.html#Unity_DataCompliance

FAQ