十分钟带你零基础Unity接入友盟+统计SDK 【文末源码】

一，获取AppKey，下载SDK

官网地址

进入广告注册/登录账号，在后台创建App
【进入工作台】 —> 右上角【产品】—> 选择【移动统计 U-App】
进入打如下界面，然后按步骤添加App信息，注册完成即可获得AppKey。（例如：59892f08310c9307b60023d0）

下载SDK 官网地址

点击上面传输蒙 或者 通过网站首页 — 开发者中心 — SDK下载 进入；
选择Unity3D 勾选游戏统计SDK 点击下面下载。

将下载的SDK zip包解压缩，目录如下图：
- 基础服务包： Common.unitypackage
- 统计包： UmengGameAnalytics_v3.2.unitypackage

---

二，导入unitypackage，查看目录内容

将两个unitypackage导入Unity工程中，目录如下：

• UmengAllinOneDemo：测试其他SDK的，直接删除
• UmengExample：统计Demo打开场景 并 添加到Build Setting

导入后打包配置脚本 BuildPostProcessor.cs
报错如下：

由于API过时导致，删除34行，35行修改为：

---

三，查看SDK代码逻辑

对示例项目中调用代码添加一些注释，在自己的项目中调用需要修改的方法就可以了。

using UnityEngine;
using Umeng; // 引入友盟命名空间
using System.Collections.Generic;

public class UmengGameExample : MonoBehaviour
{
     
    void Start()
    {
     
        // 开始友盟初始化 【注意要换成自己申请的AppKey】
        // 参数:友盟appKey, 渠道名称
        GA.StartWithAppKeyAndChannelId("59892f08310c9307b60023d0", "umeng");
        // 设置是否打印sdk的信息 【正式包关闭】
        GA.SetLogEnabled(Debug.isDebugBuild);
    }


    void OnGUI()
    {
     
        int x = 150;
        int y = 50;
        int w = 500;
        int h = 100;
        int d = 150;

        // 进入游戏关卡
        if (GUI.Button(new Rect(x, y, w, h), "StartLevel1"))
        {
     
            GA.StartLevel("level1");
        }

        y += d;
        // 完成游戏关卡
        if (GUI.Button(new Rect(x, y, w, h), "FinishLevel"))
        {
     
            GA.FinishLevel("level1");
        }
        // 对应的还有一个 未完成游戏关卡
        // GA.FailLevel("level1");
        
        y += d;
        // 玩家获得奖励统计
        if (GUI.Button(new Rect(x, y, w, h), "Bonus"))
        {
     
            GA.Bonus(10, GA.BonusSource.Source10);
        }

        y += d;
        // 玩家支付统计
        if (GUI.Button(new Rect(x, y, w, h), "Pay"))
        {
     
            GA.Pay(19, GA.PaySource.Source10, 10);
        }

        y += d;
        // 基础事件
        if (GUI.Button(new Rect(x, y, w, h), "Event"))
        {
     
            GA.Event("EventTest");
        }

        y += d;
        // 不同的标签会分别进行统计，方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签.
        if (GUI.Button(new Rect(x, y, w, h), "EventLabel"))
        {
     
            GA.Event("event1", "label");
        }

        y += d;
        // 属性事件
        if (GUI.Button(new Rect(x, y, w, h), "EventDict"))
        {
     
            var dict = new Dictionary<string, string>();
            dict.Add("Level1", "1");

            GA.Event("EventDict", dict);
        }
    }
}

自定义事件需要在后台添加相应的事件ID ，未添加时间ID的会在未注册事件标签页中显示:

使用前，请先到友盟App管理后台的 设置 -> 编辑 自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID
eventId、attributes中key和value都不能使用空格和特殊字符，且长度不能超过255个字符（否则将截取前255个字符）
id， ts， du是保留字段，不能作为eventId及key的名称

---

四，导出Xcode 打包测试

将UmengExample添加到Build Setting，并进行报名和版号设置，准备打包Xcode;

官方文档说需要导出后,在xcode里手动添加依赖库：（实际上不需要）

• TARGETS—>Build Phases—>Link Binary With Libraries—> + —>libz.tdb
• TARGETS—>Build Phases—>Link Binary With Libraries—> + —>libsqlite3.tbd

通过打包编辑 BuildPostProcessor.cs （上面报错那个脚本）自动添加：

因此在Xcode中只需修改Team 就可以直接打包测试了。

---

到此为止，集成全部完成，小结：

1. 申请AppKey，下载SDK
2. 创建项目导入unitypackage
3. 查看代码修改报错
4. 打包测试

---

五，后台查看数据

实时数据页:
游戏运行后，到后台看有新用户增加的话，证明已经介入成功。

统计页自定义事件 （第一次5分钟左右刷新没有，过了10分钟左右刷新有结果 ）

---

上面示例：源码链接

官方文档链接：

• Unity集成文档
• 常见问题汇总