Unity 埋点 SDK
Unity 全版本支持
App适配最低系统版本:iOS 8及以上、Android 4.2-10
Android
iOS
- 1.将最新的Unity埋点SDK
vds-android-agent-game-track.jar
导入 Unity 项目目录Assets/Plugins/Android/
- 2.
public class GameApp extends Application {
@Override
public void onCreate() {
super.onCreate();
GrowingIO.startWithConfiguration(this, new Configuration()
.setProjectId("xxxxx")
.setURLScheme("growing.xxxxx")
.setDebugMode(true));
);
}
}
3. 在
LAUNCHER Activity
的onNewIntent
方法中调用public GrowingIO onNewIntent(Activity activity, Intent intent)
API。如果使用的是Unity默认的UnityPlayerActivity
为LAUNCHER Activity
,请自定义一个LAUNCHER Activity
。4. 添加
AndroidManifest.xml
文件到 Unity 项目目录Assets/Plugins/Android/
,并注意修改AndroidManifest.xml
中${您的APP包名}
等关键字- 1.
- 2.将
BuildPostProcessor
脚本文件导入 Unity 项目目录Assets/Editor
中 - 3.配置 URLScheme:将在GrowingIO官网申请到的应用的
URL Scheme
填入到BuildPostProcessor
中的AddInfoPlist(path, "XXXXX");
XXXXX 处并保存 - 4.
- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
{
[Growing startWithAccountId:@"xxxxx"];
return YES;
}
5. Unity 工程中可以通过
GrowingIOGame.cs
脚本调用指定的埋点方法public static void Track(string eventId)
public static void Track(string eventId, double number)
public static void Track(string eventId, Dictionary<string, object> variable)
public static void Track(string eventId, double number, Dictionary<string, object> variable)
采集自定义事件
eventId
,该事件的属性信息属于事件级变量。在添加所需要发送的事件代码之前,需要在打点管理用户界面配置事件以及事件级变量
eventLevelVariable
。参数说明:
参数名称 | 参数类型 | 必填 | 说明 |
eventId | String | 是 | 事件标识符 |
eventLevelVariable | Dictionary | 否 | 事件发生时所伴随的维度信息 |
参数限制条件:
参数违反以下条件将不发送数据,调用后请验证数据是否发送,事件类型
t
为cstm
。参数名称 | 限制条件 |
eventId | 非空,长度限制小于等于50; |
eventLevelVariable | 非空,长度限制小于等于100( eventLevelVariable.length()<=100 );eventLevelVariable 内部不允许嵌套 Dictionary;eventLevelVariable Dictionary 中的 key 长度限制小于等于50,value 长度限制小等于1000。 |
//Track 设置自定义事件
GrowingIOGame.Track("StringTrack");
GrowingIOGame.Track("NumberTrack", 10);
//Track 设置自定义事件,传递字典参数
Dictionary<string, object> dictionary = new Dictionary<string, object> {{"key1", "value1"}, {"key2", 111}, {"key3", false}};
GrowingIOGame.Track("DictionaryTrack", dictionary);
Dictionary<string, object> dictionary = new Dictionary<string, object> {{"key1", "value1"}, {"key2", 111.11}};
GrowingIOGame.Track("NumberDictionaryTrack", 66.66, dictionary
public static void SetEvar(string key, string value)
public static void SetEvar(string key, double number)
public static void SetEvar(Dictionary<string, object> variable)
发送一个转化信息用于高级归因分析,在添加代码之前必须在打点管理界面上声明转化变量。
转化变量是一种非常强大的变量类型,主要是为了归因而用,比如访问渠道、站外搜索关键词、站内搜索关键词等等。在 GrowingIO 里面可以定制变量的归因方式和持久性范围。
参数说明:
参数名 | 类型 | 是否必填 | 描述 |
conversionVariables | Dictionary | 是 | 转化级属性 |
参数限制条件:
参数名称 | 限制条件 |
conversionVariables | 非空,键值对个数小于等于100; conversionVariables 内部不允许含有Dictionary 嵌套;conversionVariables Dictionary中的 key 长度限制小于等于50,value 长度限制小等于1000。 |
//SetEvar 设置转化变量
GrowingIOGame.SetEvar("EvarStringKey", "EvarString");
GrowingIOGame.SetEvar("EvarNumberKey", "100");
//SetEvar 设置转化变量,传递字典参数
Dictionary<string, object> dictionary = new Dictionary<string, object> {{"EvarKey1", "EvarValue1"}, {"EvarKey2", true}};
GrowingIOGame.SetEvar(dictionary);
public static void SetPeopleVariable(string key, string value)
public static void SetPeopleVariable(string key, double number)
public static void SetPeopleVariable(Dictionary<string, object> variable)
设置用户自身属性相关的属性信息,比如用户姓名、邮件地址、信用等级等。
在添加代码之前必须在打点管理界面上声明用户变量。
参数说明
参数名 | 类型 | 是否必填 | 描述 |
peopleVariables | Dictionary | 是 | 用户属性 |
参数限制条件:
参数名称 | 限制条件 |
peopleVariables | 非空,长度限制小于等于100( peopleVariables.length()<=100 );peopleVariables 内部不允许含有Dictionary 或者;peopleVariables Dictionary中的 key 度限制小于等于50,value 长度限制小等于1000。 |
//SetPeopleVariable 设置用户变量
GrowingIOGame.SetPeopleVariable("PeopleStringKey", "PeopleString");
GrowingIOGame.SetPeopleVariable("PeopleNumberKey", "PeopleNumber");
//SetPeopleVariable 设置用户变量,传递字典参数
Dictionary<string, object> dictionary = new Dictionary<string, object> {{"PeopleKey1", "PeopleValue1"}, {"PeopleKey2", 6.66}};
GrowingIOGame.SetPeopleVariable(dictionary);
public static void SetUserId(string userId)
把 GrowingIO 识别的访问用户跟应用自身的注册用户做关联,用以登录用户行为分析。
参数说明:
参数名称 | 参数类型 | 必填 | 说明 |
userId | String | 是 | 登录用户Id,长度限制小于等于1000; 如果值为空则清空了登录用户变量,不建议这么用, 请使用 clearUserId 清除登录用户变量。 |
GrowingIOGame.SetUserId("张三");
注:您的 App 每次用户升级版本时无需重新登录的话,建议在用户每次升级App 版本后初次访问时重新调用上述 setUserId 方法。
public static void ClearUserId()
当访问用户跟注册用户关联后,之后触发的行为会绑定到该注册用户上。如果有需要解除绑定,比如用户退出登录后,可以通过该函数解决绑定。
示例
GrowingIOGame.ClearUserId();
当用户未登录时,定义用户属性变量,也可用于A/B测试上传标签。
public static void SetVisitor(Dictionary<string, object> variable)
参数说明:
参数名称 | 参数类型 | 必填 | 说明 |
visitorVar | Dictionary | 是 | 不可使用嵌套的 Dictionary 对象,即为Dictionary中不可以放入Dictionary ;key 长度限制小于等于50,value长度限制小等于1000,值不能为空串,也就是""。 |
//SetVisitor 设置访问用户变量,传递字典参数
Dictionary<string, object> dictionary = new Dictionary<string, object> {{"VisitorKey1", "VisitorValue1"}, {"VisitorKey2", false}};
GrowingIOGame.SetVisitor(dictionary);
添加代码之后,请先Clean项目,然后再进行编译,并在您的 App 安装了 SDK 后重新启动几次 App,保证行为采集数据自动发送给 GrowingIO,以便顺利完成检测。
在GrowingIO平台的应用创建页面继续完成应用创建的数据检测,检测成功后应用创建成功。
GrowingIO为您提供多种验证SDK是否正常采集数据的方式:
方式二:在SDK中设置了Debug模式后,在IDE编译器控制台查看数据采集日志。
最近更新 10mo ago