访问用户变量
Last updated
Last updated
访问用户变量用来保存用户在非登录情况下跟用户本身相关的信息，例如用户的性别、A/B 测试分组等等。不建议在访问用户变量中保存跟交互行为相关的信息，例如当前正在浏览的商品，当前正在查看的某一个 SaaS 项目。这些随着用户的交互行为会发生变化的信息 GrowingIO 建议使用页面变量和转化变量来保存。
不同于登录用户变量，访问用户变量适用于在对非登录状态下的访问用户进行标记，便于后续做用户信息的相关分析。在添加所需要设置的访问用户变量的代码之前，需要在 GrowingIO 产品的自定义事件和变量管理页面配置访问用户级变量。
当前 GrowingIO 访问用户变量支持 Web、APP、微信小程序等平台；
JS SDK：v2.1.17 及以上版本（web debugger 需要升级到 v1.1.1）
Android Native SDK：v2.4.0 及以上版本
iOS Native SDK：v2.4.0 及以上版本
小程序 SDK：始终支持
访问用户是 GrowingIO 对访问您的应用（包括网页、App、微信小程序等，下同）的用户的一种识别机制。每一个访问您的应用的用户都会在对应的设备中生成并记录一个唯一的 ID，我们称之为访问用户 ID。
对于不同平台类型的应用，GrowingIO 提供了多种识别方案，从而尽可能的实现对用户的唯一标识。访问用户在不同平台的标识请参考。
梳理业务需求，确认需要上传的访问用户变量,请勿直接开始代码的部署,需要先到 GrowingIO 后台找到 【数据管理】-【事件和变量】- 【访问用户变量】功能，在其中完成对应的配置。
在具体的将自定义变量添加到网站或者移动应用上之前，GrowingIO 要求先在打点管理的界面上进行变量的声明操作，然后再开展具体的添加自定义变量的操作。在自定义变量的声明界面上需要输入下列对所有变量来说通用的信息：
标识符是代表某一个具体变量的一种具有唯一性要求的符号，标识符用来唯一的代表一个打点事件或者变量，即整个打点系统内部标识符在所有的变量和打点指标之间是唯一的。在新创建任何一种类型的变量的时候，这个新的变量的标识符不能跟任何一个已有变量和打点事件的标识符重复。在一个变量的标识符确定之后，在代码中就可以使用这个标识符来唯一代表该变量，请仔细检查确保声明的标识符和代码中使用标识符一致。如果出现了不一致的情况，GrowingIO 将视为没有收到声明了的变量的数据，而那个在代码中发送的跟声明中标识符不一样的变量的数据会被 GrowingIO 认为没有声明而丢弃。GrowingIO 虽然支持标识符的修改，但是不建议频繁修改，因为每一次标识符的修改都需要在声明界面和代码上同时作出修改，以保证标识符的一致性。
标识符的设置细节规则如下
自定义事件和所有自定义变量类型的标识符整体范围内不允许重名；
标识符仅允许大小写英文、数字、下划线、以及英文冒号，并且不能以数字和冒号开头；
标识符的长度限制在 50 个英文字符之内；
名称是变量具体在使用的时候显示在报表上的一种变量的称呼。客户给变量一个名称，这个名称会出现在报表界面上用以指代当前所设置的变量对应的维度。名称允许客户经常改动，需要注意的是，名称修改以后，对应的报表界面上的维度名称也会跟着修改。
名称的设置细节：名称允许重名，可以使用大小写英文、中文以及各种符号，长度限制在 30 个字符之内。
可以使用较长的一段文字来描述某一个变量设置的目的，意义。
描述的设置细节规则：描述允许重复，可以使用大小写英文、中文以及各种符号，长度限制在 150 个字符之内。
完成了配置后，即可在代码中完成以上设计的 “自定义事件和变量” 的部署。具体的说，就是调用 GrowingIO 提供的 API 接口，上传数据。
API中给出了访问用户变量的上传方式
在完成了【数据管理】-【事件与变量】-【访问用户变量】的配置，以及代码实施后，我们接下来需要对数据是否成功上传进行校验。校验工作分为两步完成。
在 GrowingIO 分析后台，找到 “分析” - “新建事件分析”，选择一个事件后，在 "维度" 中查看设置的访问用户变量是否有数据。当然，您需要首先确已经完成了访问用户变量的数据上传。
至此，您已经完成了 “自定义变量” 的上传，如您在配置或添加代码中有任何疑问，请联系您的客户成功经理咨询，或在工单系统中反馈问题。谢谢。
访问用户变量持久性范围是 4 小时。所有的都统计都是基于最近 4 小时的数据，如果同一个维度值设置多次，取最后一次。建议用户每次访问时重新设置。
GrowingIO 提供了 SDK debug 模式以及 debug 工具，来帮助您完成数据的校验。具体请参考 。