2） 向game.js文件添加代码

打开与miniwx-cn-sesdk-umd.js同级目录下的game.js文件，添加两句代码

需要先接入微信团队开源的 Unity 转微信小游戏的插件 才会有这个文件

访客 ID 即 _visitor_id，是用户在设备上安装了应用之后，登录状态之前该用户的唯一标识。

我们提供访客 ID 自定义设置的接口，如果您有自己的访客管理体系需要替换访客 ID，应在 SDK 初始化之前进行设置。

数据上报时仅以最后一次传入的访客 ID 为准，应避免多次调用造成多个非正常访客 ID 先后上报数据的情况。

string visitorId = "your_visitor_id";
SESDKBridge.Instance.setVisitorId(visitorId);

如果您需要获取当前访客 ID，可以调用 getVisitorId 获取：

指用户在应用中登录之后，登录账号在应用中的唯一标识。登录之前将以访客 ID 作为用户标识。

在账户 ID 设置完成后，在调用 logout 清除账号 ID之前，设置的账号 ID 将一直保留，并作为用户身份识别 ID。清除账号 ID 的操作请在有真实退出登录状态行为时进行，关闭 App、退至后台运行时无需调用。

数据上报时仅以最后一次传入的账号 ID 为准，应避免多次调用造成多个非正常账号 ID 先后上报数据的情况。

3.3、账号 ID

3.3.1、设置账号 ID

调用 login 来设置用户的账号 ID：

string accountId = "your_account_id";
SESDKBridge.Instance.login(accountId);

注：

该调用仅为向 SDK 传入账号 ID，不会上报用户登录事件。

开发者设置的账号 ID 长度不能超过 128 个字符，否则会设置失败。

开发者设置后会存储在本地存储中。

注：支付失败原因 failReason 参数仅在 payStatus 参数为 fail 支付失败时才会传入，其他状态传""即可。

调用示例：

IAPData iapData = new IAPData
{
    reportingToTencentSdk=1,
    orderId = "12345678",
    payAmount = 1234.555577777,
    currencyType = "test",
    payType = "alipay",
    productID = "12345678aaaaa",
    productName = "this is product name",
    productCount = 10,
    payStatus = 1,
    failReason = "this is fail reason",
    customProperties = new Dictionary<string, object> { { "one", "1" } }
};

SESDKBridge.Instance.trackIAP(iapData);

4.2.4、增加归因安装事件

支持统计归因数据，满足客户使用三方归因或者自归因之后的结果数据回传到自定义分析，上报时机支持开发者自定义触发。

自归因事件的 _event_name 为 _mpAttr。

 public void trackAppAttr(MpAttrData data)

MpAttrData参数说明：

4.2.6、注册事件

用户注册时，报送该事件，用于进行用户注册数据分析。

public void trackRegister(RegisterData data)

RegisterData参数说明：

调用示例：

RegisterData registrationData = new RegisterData
{
reportingToTencentSdk=1,
    regType = "WeChat",
    registerStatus = "success",
    customProperties = new Dictionary<string, object> { { "one", "1" } }
};
SESDKBridge.Instance.trackRegister(registrationData);

用户登录时，报送该事件，用于进行用户登录数据分析。

 public void trackLogin(LoginData data)

LoginData参数说明：

调用示例：

LoginData loginData = new LoginData
{
    loginType = "WeChat",
    loginStatus = "Success",
    //customProperties = new Dictionary<string, object> { { "one", "1" } }
};
SESDKBridge.Instance.trackLogin(loginData);

4.2.8沉默唤起

已经注册的小游戏用户变为沉默用户后，再次进入小游戏，定义为沉默唤起行为，建议的沉默唤起周期为 7、14、30 天，如果业务目前使用其他回流周期也支持传任意 N 值（数字，单位天）。

public void trackReActive(ReActiveData data)

ReActiveData参数说明：

调用示例：

 ReActiveData registerData = new ReActiveData
    {
        reportingToTencentSdk=3,
        backFlowDay=1,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackReActive(registerData);


4.2.9收藏小游戏

在用户收藏小游戏的时候上报，包括收藏、添加到我的小程序、添加到桌面以及小游戏自己定义的收藏逻辑。

  public void trackAddToWishlist(AddToWishlistData data)

AddToWishlistData参数说明：

调用示例：

   AddToWishlistData addToWishlistData = new AddToWishlistData
    {
        reportingToTencentSdk=1,
        addToWishlistType = SESDKBridge.WishlistType_DESKTOP,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackAddToWishlist(addToWishlistData);

4.2.10分享小游戏

在用户分享小游戏的时候上报，需区分是【转发给朋友】还是【分享到朋友圈】。

 public void trackShare(ShareData data)

ShareData参数说明：

调用示例：

  ShareData shareData = new ShareData
    {
        reportingToTencentSdk=1,
        mpShareTarget = SESDKBridge.ShareTarget_APP_MESSAGE,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackShare(shareData);

4.2.11创建角色

用户在小游戏内创建角色成功后上报 CREATE_ROLE 行为，可添加创建角色相关的自定义参数，如角色名等。

 public void trackCreateRole(CreateRoleData data)

CreateRoleData参数说明：

调用示例：

  CreateRoleData createRoleData = new CreateRoleData
    {
        reportingToTencentSdk=1,
        mpRoleName = "role_name",
    };
    SESDKBridge.Instance.trackCreateRole(createRoleData);

4.2.12完成新手指引

在用户完成游戏新手指引教程或者完成教程关卡后上报 TUTORIAL_FINISH 行为。

 public void trackTutorialFinish(TutorialFinishData data)

data 为object类型，参数说明：

调用示例：

  TutorialFinishData tutorialFinishData = new TutorialFinishData
    {
        reportingToTencentSdk=1,
    };
    SESDKBridge.Instance.trackTutorialFinish(tutorialFinishData);

4.2.13游戏等级提升

用户在小游戏内的完成游戏等级提升时上报 UPDATE_LEVEL 行为，可添加自定义参数，如当前游戏等级、游戏能量等。

public void trackUpdateLevel(UpdateLevelData data)

UpdateLevelData参数说明：

调用示例：

  UpdateLevelData updateLevelData = new UpdateLevelData
    {
        reportingToTencentSdk=1,
        beforeUpgrade = 10,
        afterUpgrade = 20,
        
        
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackUpdateLevel(updateLevelData);

4.2.14 浏览商城页面

用户在小游戏内浏览商城页面时上报。

 public void trackViewContentMall(ViewContentMallData data)

ViewContentMallData参数说明：

调用示例：

  ViewContentMallData viewContentMallData = new ViewContentMallData
    {
        reportingToTencentSdk=1,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackViewContentMall(viewContentMallData);

4.2.15浏览游戏活动

用户在小游戏内浏览商城页面时上报。

 public void trackViewContentActivity(ViewContentActivitData data)

ViewContentActivitData参数说明：

调用示例：

  ViewContentActivitData viewContentActivityData = new ViewContentActivitData
    {
        reportingToTencentSdk=1,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };
    SESDKBridge.Instance.trackViewContentActivity(viewContentActivityData);

4.3、自定义事件

除了以上已经列出的有明确定义的事件外，开发者可以根据自己的分析需求，进行自定义事件的上报

自定义事件，即事件的 _event_name 由开发者自定义。

您可以调用 track(eventName, data) 来上报事件，建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件。

事件名称要求：

• string 类型
• 只能以字母开头，其余字符可包含数字、小写字母和下划线"_"
• 长度最大为 40 个字符
• 仅支持小写字母

调用示例：

string eventName = "test";
Dictionary<string, object> properties = new Dictionary<string, object>
{
    { "one", "1" },
    { "two", 2 }
};

SESDKBridge.Instance.track(eventName, properties);

4.4、自定义属性要求

事件的属性是一个 object 对象，其中每个元素代表一个属性。

4.4.1、key 为该属性的名称

• string 类型
• 只能以字母开头，其余字符可包含数字、小写字母和下划线"_"
• 长度最大为 40 个字符
• 仅支持小写字母

4.4.2、value 为该属性的值

• 支持 string、double、boolean和 array
• 对于 array 的元素，只支持字符串类型
• 对于其他类型都将强制转为字符串存储

4.4.3、自定义属性的属性类型

一个自定义属性的存储数据类型，会以第一次上报数据的格式自动由系统进行识别，一旦确定无法修改。相同产品的属性类型在第一次上报时进行确定。后续不同SDK、不同事件上报的同名属性只有类型与第一次一致才会入库。

注：属性的存储数据类型，决定了在分析模型中可以选择的分析逻辑，比如数值型可以进行最大值、最小值、求和等计算，布尔型可以进行为真数、为假数的计算，所以报送数据的格式，需要考虑分析场景和业务需求，制定完整的埋点方案，并按埋点方案进行格式确定。

4.5、时长事件

如果您需要记录某个事件的持续时长，可以调用 eventStart(eventName) 来开始计时，配置您想要计时的事件名称，当您结束该事件时，需要调用 eventFinish(eventName, data)，它将会自动在您的事件属性中加入 _duration 这一属性来表示记录的时长，单位为毫秒。需要注意的是，同一个事件名只能有一个在计时的任务。

string eventName = "testEvent";
SESDKBridge.Instance.eventFinish(eventName,new Dictionary<string, object> { { "one", "1" } });

注：在上报预置事件 _appEnd 时，会默认上报由上一次 _appStart 开始计时的时长，即退出事件的时长无需配置开始计时，会默认赋值。

5、用户属性设置

在热力引擎中，专门提供了针对用户属性设置数据的上报方法，针对用户的属性的添加或变更，您可以通过该方法进行上报。

建议您将与用户相关的不变的、或变化频率比较低、或保存价值比较高的属性，比如年龄、创建角色时间、等级、所在地、首次付费时间、总付费金额等属性设置为用户属性，其它变化频率比较高的属性通过事件进行上报和记录。

用户属性设置分为以下几种方式：userUpdate、userInit、userAdd、userUnset、userAppend、userDelete，由开发者调用，对用户属性进行设置。

注：用户属性格式要求与事件属性保持一致。

5.1、userInit

如果您要上传一批用户属性，其中已经存在的用户属性不去更新属性值、对不存在的属性进行创建并保存属性值，则可以调用 userInit 来进行设置。

调用示例：

Dictionary<string, object> properties = new Dictionary<string, object>
{
    { "regtime", "2021-03-01 12:34:56.789" },
    { "rolename", "engineer" },
    {"age",29}
}; 
SESDKBridge.Instance.userInit(properties);

5.2、userUpdate

对于一般的用户属性，您可以调用 userUpdate 来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致。

调用示例:

Dictionary<string, object> properties = new Dictionary<string, object>
{
 
    { "rolename", "leader" }
 
}; 
SESDKBridge.Instance.userUpdate(properties);

当您要上传数值型的属性时，您可以调用 userAdd 来对该属性进行累加操作，如果该属性还未被设置，则会赋值 0 后再进行计算，可传入负值，等同于相减操作。

调用示例：

Dictionary<string, object> properties = new Dictionary<string, object>
{
 
    { "age", 1 }
 
}; 
SESDKBridge.Instance.userAdd(properties);

userAdd 设置的属性类型以及 Key 值的限制与 userUpdate 一致，但 Value 只允许 int 类型。

5.4、userUnset

当您要清空用户的属性值时，您可以调用 userUnset 来对指定属性（字符串列表）进行清空操作，如果该属性还未在集群中被创建，则 不会 创建该属性。

调用示例：

 List<string> str = new List<string>();
         str.Add("age");
SESDKBridge.Instance.userUnset(str);

userUnset 传入的参数是用户属性的属性名，类型是字符串列表。

5.5、userAppend

您可以调用 userAppend 对数组类型的用户属性进行追加操作。如果该属性不存在，则会新建该属性。

调用示例：

Dictionary<string, object> properties = new Dictionary<string, object>
{
 
    { "location",new object[] { "BeiJing" } }
 
}; 
SESDKBridge.Instance.userAppend(properties);

5.6、userDelete

如果您要删除某个用户，可以调用 userDelete 将这名用户删除。用户删除后，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到。

调用示例：

SESDKBridge.Instance.userDelete(UserDeleteType.userDeleteByAccountId);

———————————— 

SDK 更新记录

2024-12-31 1.0.7

       • 内部初始化逻辑优化

2024-12-05  1.0.6

      • 修复除webgl以外的其他平台部分方法编译报错

2024-12-02  1.0.5

      • 新增支持腾讯广告小游戏（需要原生JS SDK版本是1.2.3及以上）

• 原生JS插件：下载地址  【详见2.3获取SDK】

2024-07-26  1.0.4

• 去掉_pl定义抖音/微信

2024-07-16  1.0.3

• 去掉中文字符

2024-07-02  1.0.2

• 适配低版本unity

2024-03-15  1.0.1

• 修复内部日志上报问题

2024-03-06 

• 1.0.0版本上线