埋点数据上传API
url
请求类型
POST
参数说明与示例
请参考 body 示例。注意：事件数据需放在数组中。
请求参数
body示例
路径参数
类型
是否必传
说明
ai
string
是
项目ID。
sendingTime
string
是
发送时间时间戳（毫秒）
body参数
类型
是否必传
说明
cs1
string
是
用户登录ID。
tm
double
是
事件发生时间时间戳（毫秒）。
n
string
是
事件标识。
var
map{key:value}
否
所有的自定义事件变量。
t
string
是
事件类型，此处固定为cstm。
单条事件发送
[
{
"cs1":"9128391",
"tm":1434556935000,
"t":"cstm",
"n":"BuyProduct",
"var":{
"product_name":"苹果",
"product_classify":"水果",
"product_price":14
}
}
]
多条事件发送
[
{
"cs1":"9128391",
"tm":1434556935000,
"t":"cstm",
"n":"BuyProduct",
"var":{
"product_name":"苹果",
"product_classify":"水果",
"product_price":14
}
},
{
"cs1":"9128391",
"tm":1434556935000,
"t":"cstm",
"n":"BuyProduct",
"var":{
"product_name":"苹果",
"product_classify":"水果",
"product_price":14
}
},
{
"cs1":"9128391",
"tm":1434556935000,
"t":"cstm",
"n":"BuyProduct",
"var":{
"product_name":"苹果",
"product_classify":"水果",
"product_price":14
}
}
]
程序调试
GrowingIO建议您按照如下步骤进行埋点数据的开发联调
- 1.在GrowingIO的网站中创建自定义事件以及对应的自定义事件变量。
- 2.参考接口文档，编写一段程序上传一个事件，确保收到了200的HTTP状态
- 3.在GrowingIO产品中使用您创建的埋点数据创建一个实时的图表
- 4.如果可以在实时产品中看到您的埋点数据统计，则代表您的埋点创建成功
自动关联访问用户ID
自2020年4月22日起，所有通过服务端上传的埋点事件，GrowingIO将自动关联对应的访问用户ID。
关联规则如下：
- 服务端上传的埋点事件，会从该登录用户ID过去4个小时内的页面浏览事件中搜索对应的访问用户ID并与之关联。
- 如果过去4个小时内没有页面浏览事件，GrowingIO无法关联访问用户ID，从而该事件无法使用相关的维度进行分析（包括：位置维度、设备维度、访问用户变量等）
带来的好处：
- 服务端埋点事件可以用更多的维度进行分析
- 服务端埋点事件可以与其他事件一起出现在用户细查中（该功能目前还在测试，稍晚推出）
- 服务端埋点事件可以使用转化变量进行分析
常见问题
1. 程序调试时，为什么在实时图表中无法看到我上报的数据？
答：检查实时图表的目标分群是否为"访问用户"，因为在调试阶段，服务器端埋点事件可能未自动关联访问用户，需要将目标用户修改为“全部登录用户“才能看到数据。
2. 为什么使用访问用户分析服务端埋点事件比登录用户少？
答: 如果服务端埋点事件发生前4个小时内该登录用户没有页面浏览事件，GrowingIO无法关联访问用户ID，从而无法使用访问用户去分析。出现这种现象的可能原因：
- 全部或部分服务端埋点事件是线下行为触发的
- 全部或部分服务端埋点事件上传时间距离客户行为超过了4个小时
最近更新 5mo ago
此页面是否有帮助？
大纲
url
请求类型
参数说明与示例
程序调试
自动关联访问用户ID
常见问题