微信小游戏支持腾讯回传事件

调用示例：

AddToWishlistAttributes addToWishlistData = new AddToWishlistAttributes
{
    reportingToTencentSdk=1,
    addToWishlistType = SolarEngine.Analytics.WishlistType_MY,
    customProperties = new Dictionary<string, object> { { "one", "1" } }
};
SolarEngine.Analytics.trackAddToWishlist(addToWishlistData);

4.5 分享小游戏

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

public static void trackShare(ShareAttributes attributes)

ShareAttributes参数说明

调用示例：

  // 1、转发给朋友 
        WX.OnShareAppMessage(() =>
        {
            ShareAttributes shareData = new ShareAttributes
            {
                reportingToTencentSdk = 1,
                mpShareTarget = SolarEngine.Analytics.ShareTarget_APP_MESSAGE,
                customProperties = new Dictionary<string, object> { { "one", "1" } }
            };
            SolarEngine.Analytics.trackShare(shareData);
        });

// 2、分享到朋友圈
        WX.OnShareTimeline((x) =>
        {
            ShareAttributes shareData = new ShareAttributes
            {
                reportingToTencentSdk = 1,
                mpShareTarget = SolarEngine.Analytics.ShareTarget_TIME_LINE,
                customProperties = new Dictionary<string, object> { { "one", "1" } }
            };
            SolarEngine.Analytics.trackShare(shareData);
            
        });
    


// 3、主动拉起转发时上报一条分享行为（先执行上报后呼起分享上报成功率更高）

    ShareAttributes shareData = new ShareAttributes
    {
        reportingToTencentSdk = 1,
        mpShareTarget = SolarEngine.Analytics.ShareTarget_APP_MESSAGE,
        customProperties = new Dictionary<string, object> { { "one", "1" } }
    };

    SolarEngine.Analytics.trackShare(shareData);


    WX.OnShareAppMessage();

4.6 创建角色

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

public static void trackCreateRole(CreateRoleAttributes attributes)

CreateRoleAttributes参数说明：

参数名称	参数含义	参数类型	是否必传
reportingToTencentSdk	上报事件给腾讯。如果初始化时，设置初始化腾讯广告SDK, 则此参数必填。 1：全量上报给腾讯 2：非全量上报给腾讯 3：不上报给腾讯	int	是
mpRoleName	角色名称	string	是

调用示例：

CreateRoleAttributes createRoleData = new CreateRoleAttributes
{
    reportingToTencentSdk=1,
    mpRoleName = "role_name",
};
SolarEngine.Analytics.trackCreateRole(createRoleData);

 

4.7 完成新手指引 

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

public static void trackTutorialFinish(TutorialFinishAttributes attributes)

TutorialFinishAttributes参数说明：

参数名称	参数含义	参数类型	是否必传
reportingToTencentSdk	上报事件给腾讯。如果初始化时，设置初始化腾讯广告SDK, 则此参数必填。 1：全量上报给腾讯 2：非全量上报给腾讯 3：不上报给腾讯	int	是

调用示例：

TutorialFinishAttributes tutorialFinishData = new TutorialFinishAttributes
{
    reportingToTencentSdk=1,
};
SolarEngine.Analytics.trackTutorialFinish(tutorialFinishData);

4.8 游戏等级提升

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

public static void trackUpdateLevel( UpdateLevelAttributes attributes){

UpdateLevelAttributes参数说明：

参数名称	参数含义	参数类型	是否必传
reportingToTencentSdk	上报事件给腾讯。如果初始化时，设置初始化腾讯广告SDK, 则此参数必填。 1：全量上报给腾讯 2：非全量上报给腾讯 3：不上报给腾讯	int
beforeUpgrade	提升前等级	int	是
afterUpgrade	提升后等级	int	是
customProperties	自定义参数	Dictionary<string, object>	否

调用示例：

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

4.9  浏览商城页面

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

public static void trackViewContentMall(ViewContentMallAttributes attributes)

ViewContentMallAttributes参数说明：

参数名称	参数含义	参数类型	是否必传
reportingToTencentSdk	上报事件给腾讯。如果初始化时，设置初始化腾讯广告SDK, 则此参数必填。 1：全量上报给腾讯 2：非全量上报给腾讯 3：不上报给腾讯	int	是
customProperties	自定义参数	Dictionary	否

调用示例：

ViewContentMallAttributes viewContentMallData = new ViewContentMallAttributes
{
    reportingToTencentSdk=1,
    customProperties = new Dictionary<string, object> { { "one", "1" } }
};
SolarEngine.Analytics.trackViewContentMall(viewContentMallData);

4.10 浏览游戏活动

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

public  static void trackViewContentActivity(ViewContentActivitAttributes attributes)

ViewContentActivitAttributes参数说明

参数名称	参数含义	参数类型	是否必传
reportingToTencentSdk	上报事件给腾讯。如果初始化时，设置初始化腾讯广告SDK, 则此参数必填。 1：全量上报给腾讯 2：非全量上报给腾讯 3：不上报给腾讯	int	是
customProperties	自定义参数	Dictionary	否

调用示例：

ViewContentActivitAttributes viewContentActivityData = new ViewContentActivitAttributes
{
    reportingToTencentSdk=1,
    customProperties = new Dictionary<string, object> { { "one", "1" } }
};
SolarEngine.Analytics.trackViewContentActivity(viewContentActivityData);

 

您可以为「启动事件」和「每个预定义事件」单独设置配置字段“reportingToTencentSdk”。以下是目前支持的预定义事件列表（详情请参考本文）：

▪4.1 付费

▪4.2 注册

▪4.3 沉默唤起

▪4.4 收藏小游戏

▪4.5 分享小游戏

▪4.6 创建角色

▪4.7 完成新手教程

▪4.8 游戏等级提升

▪4.9 浏览商城页面

▪4.10 浏览游戏活动

 

▪注：以上事件建议主动上报。

 

◦对于这些事件，您可以根据需要为每个事件单独配置“reportingToTencentSdk”字段，以实现更精细的控制和数据回传。

 

◦reportingToTencentSdk字段说明：

▪方案一（推荐）：由腾讯广告负责归因匹配，将所有用户的事件信息回传至腾讯广告平台。请配置字段“reportingToTencentSdk”为1。

▪方案二：由热力引擎负责归因匹配，将归因至腾讯广告用户的信息回传至腾讯广告平台。请配置字段“reportingToTencentSdk”为2。注：腾讯广告 API 归因下线后，将无法通过热力引擎归因，请使用方案一。

▪方案三（不推荐）：由热力引擎负责归因匹配，不将用户的信息回传至腾讯广告平台。请配置字段“reportingToTencentSdk”为3。

▪注：非腾讯广告的渠道仍然由热力引擎归因匹配，并通过API事件回传，您无需在SDK中进行额外的配置。

•QA：

◦如何判断是否成功给腾讯报送事件，可查看接口 https://api.datanexus.qq.com/data-nexus-cgi/miniprogram 的返回值，当code=0则成功。