API 2.x
API概览
接口定义
1. 初始化
初始化 init
API ,用来设置项目ID和一些常用的配置项。
参数名称
类型
是否必须
说明
projectId
string
是
项目ID
options
JSON Object
否
系统变量配置
代码示例:
2. 设置登录用户ID
当用户登录之后调用 setUserId
API,设置登录用户 ID,用于标记登录用户。
90% 以上的用户都会上传登录用户 ID,以便分析登录用户的数据情况。
参数名称
类型
是否必须
说明
userId
string
是
用户的登录用户ID
代码示例:
3. 清除登录用户ID
当用户退出登录之后调用 clearUserId
API,清除已经设置的登录用户 ID。
代码示例:
4. 设置登录用户变量
当需要上报登录用户变量时,调用 people.set
API。
发送登录用户信息用于登录用户信息相关分析,在添加代码之前必须在打点管理界面上创建登录用户变量。
参数名称
类型
是否必须
说明
key
tring
否
登录用户变量的标识符
value
tring
否
登录用户变量的值
customerVariables
JSON Object
否
包含登录用户变量的JSON对象
代码示例:
5. 设置访问用户变量
当需要上报访问用户变量时,调用 visitor.set
API。
发送访问用户信息用于访问用户信息相关分析,在添加代码之前必须在打点管理界面上创建访问用户变量。
参数名称
类型
是否必须
说明
key
string
否
访问用户变量的标识符
value
string
否
访问用户变量的值
visitorVariables
JSON Object
否
包含访问用户变量的JSON对象
代码示例:
6. 设置页面级变量
当需要上报页面级变量时,调用 page.set
API。
发送页面级别的维度信息,用于标记当前页面,在添加代码之前必须在打点管理界面上创建页面级变量。
参数名称
类型
是否必须
说明
key
string
否
页面级变量的标识符
value
string
否
页面级变量的值
pageLevelVariables
JSON Object
否
包含页面级变量的JSON对象,即页面级别的信息
代码示例:
7. 设置转化变量
当需要上报转化变量时,调用 evar.set
API。
发送一个转化信息用于高级归因分析,在添加代码之前必须在打点管理界面上创建转化变量。
参数名称
类型
是否必须
说明
key
String
否
转化变量的标识符
value
Strng
否
转化变量的值
conversionVariables
JSON Object
否
包含转化变量的JSON对象
代码示例:
8. 设置埋点事件和事件级变量
当需要上报埋点事件和事件级变量时,调用 track
API。
发送一个埋点事件,在添加所需要发送的事件代码之前,需要在打点管理用户界面创建埋点事件以及事件级变量,并完成埋点事件和事件级变量的绑定。
参数名称
类型
是否必须
说明
eventId
tring
是
事件标识符
eventLevelVariables
JSON Object
否
包含事件级变量的JSON对象,即事件发生时所伴随的维度信息。限制:eventLevelVariable内部不允许含有JSONObject或者JSONArray; key长度限制小<=50,value长度限制<=1000,值不能为空字符串,也就是“ ”
代码示例:
9. 手动发送页面浏览事件
sendPage
在默认情况下,由于用户浏览网站的交互行为导致当前页面的 URL 产生变化时,GrowingIO 的 Web JS SDK 会发送一个 page 类型的请求。
在一些特殊的情况下,例如用户在访问单页应用(Single Page Application)类型的网站时,用户的操作会导致业务上面理解的页面产生了变化,但是当前的 URL 可能并没有改变。这时,可以调用GrowingIO提供的 sendPage
接口手动发送页面浏览事件。
调用将会发送出一条 page 类型的数据,GIO 服务器在收到 page 类型的数据之后,页面浏览量这个预定义指标会加 1。
代码示例:
10. GDPR数据采集开关
全局配置, 可以放到 send
调用之后。设置禁止或开启数据采集
SDK 版本2.2.7开始,推荐使用 enableDataCollect
11. 获取访问用户ID
getVisitUserId
调用该方法,可以获取 SDK 自动生成用于标记访问用户的访问用户ID
最后更新于