最近更新时间:2023.02.28 17:57:49
首次发布时间:2021.10.18 11:12:18
该接口用于点击进入图文、短视频详情页的事件上报。
请求方法
GET/POST(Content-Type: application/x-www-form-urlencoded)
请求url
https://mercury.volcengineapi.com/?Action=ClickLog&Version=2021-01-01
请求header
ServiceName:content
参数 | 描述 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
Partner | 渠道号 | String | 是 | |
AccessToken | 用户唯一标识 | String | 是 | |
GroupId | 内容id | String | 是 | 对应“获取个性化内容”接口返回的GroupId |
Category | 频道ID | String | 是 | 对应“获取个性化内容”接口传入的Category值,在相关推荐场景Category固定传related |
EventTime | 事件发生时间 | String | 是 | 十位时间戳,单位:秒;表示点击事件发生时的时间 |
Dt | 设备型号 | String | 否 | 如iphone5s、Galaxy。主要用于推荐分析,提升推荐效果 |
DeviceBrand | 设备厂商 | String | 否 | 如Apple、Samsung。主要用于推荐分析,提升推荐效果 |
Os | 操作系统 | String | 否 | 如 Android、IOS。主要用于推荐分析,提升推荐效果。 |
OsVersion | 操作系统版本 | String | 否 | 如4.0.4。主要用于推荐分析,提升推荐效果。 |
ClientVersion | 应用的版本号 | String | 否 | 比如1.0.1。主要用于数据排查,提升业务指标 |
FromGid | 相关推荐来源内容id | String | 否 | 相关推荐场景特有,表示从哪条内容点进来的,如在内容A的详情页-->相关推荐曝光的内容有B,C,D,这个时候B,C,D的FromGid均为A |
ReqId | 请求唯一标识 | String | 是 | 表示该内容具体是从哪一次请求返回的,便于数据分析。 该值对应公共响应参数中的RequestId |
参数 | 描述 | 类型 | 说明 |
---|---|---|---|
Result | 上报结果 | String | success:成功 |
public static void main(String[] args) { //初始化一个service LogService logService = LogServiceImpl.getInstance(); //设置ak,sk 此为请求的凭证 logService.setAccessKey("xxx"); logService.setSecretKey("xxx"); //初始化一个request ClickLogRequest req = new ClickLogRequest(); req.setPartner("xxx"); req.setAccessToken("xxx"); req.setGroupId("6938426748178530823"); req.setCategory("xxx"); req.setEventTime("1626861782"); req.setDt("iphone6s"); req.setOs("iOS"); req.setOsVersion("12"); req.setClientVersion("7.3.25"); req.setDeviceBrand("Apple"); try { LogResponse response = logService.clickLog(req); System.out.println(JSON.toJSONString(response)); } catch (Exception e) { e.printStackTrace(); } }
{ "ResponseMetadata": { "Action": "ClickLog", "Region": "cn-north-1", "RequestId": "20220721103117010210043037253714CD", "Service": "content", "Version": "2021-01-01" }, "Result": "success" }