如果您目前希望从 1.x 版本升级至 2.x 版本，请务必联系 GrowingIO 对接人，我们需要在后台为你开启 2.x 版本所对应的功能权限。
如果直接重新集成2.x版本SDK，而后台对应功能权限未开启的话，可能会造成数据丢失问题。
1. 重新集成SDK
请参考集成SDK（2.x）
2. 迁移用户属性字段
如果您在旧版本1.x版本未做用户属性字段上传，请忽略此部分。
用户属性字段（简称CS字段）是 1.x 版本的概念，升级至 2.x 版本后：
CS1字段，会强制命名为“登陆用户ID”，并且上传接口与其他变量不同。
CS2-10字段，会迁移至“应用级变量”，应用级变量与CS字段的使用方式无任何区别。
CS11-20字段，会迁移至“用户变量“。两者的区别主要在于：用户变量支持自定义的归因方式。
2.x 版本中的上传用户变量方法有较大改动，不再将 'setCSn' 这个字段作为参数，方法中只需写入用户变量的 key - value 对。
2.x版本方法格式
1.x版本方法格式
对于 CS1 字段，也就是登陆用户ID，请使用以下方法：
// 设置登录用户IDgio('setUserId', userId);// 清除登录用户IDgio('clearUserId');对于应用级变量，也就是 1.x 版本中的 CS2 - CS10，请使用以下方法：
gio(‘app.set’, key, value) // 单个变量gio('app.set', appLevelVariables) // 多个变量，可组合为一个JSON对象appLevelVariables传入对于用户变量，也就是 1.x 版本中的 CS11 - CS20，请使用以下方法：
gio('people.set', key, value); // 单个变量gio('people.set', peopleVariables); // 多个变量，可组合为一个JSON对象peopleVariables传入_vds.push(['setCS1', 'CS1的key', 'CS1的value']);_vds.push(['setCS2', 'CS2的key', 'CS2的value']);_vds.push(['setCS3', 'CS3的key', 'CS3的value']);..._vds.push(['setCS10', 'CS10的key', 'CS10的value']);
1.x版本的用户属性字段配置是在 GrowingIO平台的 “项目配置 > CS字段配置” 页面。
2.x 版本后，取消了上述配置方式。您可以：
在“数据中心 > 数据管理 > 变量 > 事件变量”，下的应用级变量页签下配置原有应用级变量（原CS2-CS10字段）。（仅升级用户可见）
在“数据中心 > 数据管理 > 变量 > 用户变量”，下的登录用户变量页签下配置原登录用户变量（原CS11-CS20字段）。
类似于用户属性字段，在 2.x 版本中，页面属性字段被迁移到了“页面级变量”。与页面属性字段不同的是，页面级变量相当于过去的 PS 字段，不再存在过去的 PG 字段。
2.x版本方法格式
1.x版本方法格式
gio('page.set', key, value);gio('page.set', pageLevelVariables); //多个变量，可组合为一个对象传入_vds.push([’setPageGroup‘, ‘PageGroup 的名称’];_vds.push([‘setPS1’, ‘PS1 的值’]);_vds.push([‘setPS2’, ‘PS2 的值’]);_vds.push([‘setPS3’, ‘PS1 的值’]);
您需要在“数据中心 > 数据管理 > 变量 > 事件变量”，下的页面级变量页签下进行配置。
如果您在旧版本1.x版本未做自定义事件的上传，请忽略此部分。
2.x 版本的自定义事件，在概念上与 1.x 版本无任何区别，但上传接口和配置方式上有以下变更。
2.x版本方法格式
1.x版本方法格式
gio('track', eventId);gio('track', eventId, number);gio('track', eventId, eventLevelVariables);gio('track', eventId, number, eventLevelVariables);window._vds.track(event_name, properties)
您需要在“数据中心 > 数据管理 > 变量 > 事件变量”，下的事件级变量页签下配置事件变量。
在在“数据中心 > 数据管理 > 事件 > 埋点事件”，下新建自定义事件，并选择已创建好的事件级变量。
在完成了上述代码实施和配置后，我们当然需要对数据是否成功上传进行校验。校验工作分为两步完成。GrowingIO 提供了 SDK debug 模式以及 debug 工具，来帮助您完成数据的校验。
点击查看 GrowingIO Web Debugger 的安装和使用。