客户端展现上报--内容定制-火山引擎

文档中心

导航

客户端展现上报

最近更新时间：2023.08.04 16:54:26首次发布时间：2021.04.09 18:31:35

该接口用于列表页图文或视频内容曝光事件上报，火山引擎支持上报单条和多条内容曝光事件。

单条曝光

请求结构	说明
请求域名	stream-api.feedcoopapi.com【建议】 mercury.snssdk.com【废弃】
请求地址	/user/action/log/show/v2/
请求协议	HTTP/HTTPS
请求方式	GET/POST
参数类型	application/x-www-form-urlencoded

请求参数

参数	描述	类型	是否必填	说明
group_id	内容id	long	是	对应“获取个性化内容”接口返回的group_id
event_time	事件发生时间	long	是	十位时间戳，单位：秒；表示点击退出详情页事件发生时的时间
req_id	请求唯一标识	String	是	唯一标识该内容源于哪次请求，比如推荐接口返回的req_id

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
msg	本次请求是否成功	String	success：成功
req_id	本次请求标识	String	惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查

请求示例

curl --location --request GET 'https://stream-api.feedcoopapi.com/user/action/log/show/v2/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a&timestamp=1656489292&nonce=894038&partner=server_sdk_demo_default_content&access_token=AEvgyaZ5cWcPS6m9jQhpXpjZ5xRued98RxaKYFX5NdjTDKXUEt8C3dGFXxmgoK9Sj5QvfXDPskhgrL87VVrmv7o6dPEsT7L&group_id=7115232373091860514&event_time=1656776132&req_id=xxx'

响应示例

{
    "data": [],
    "msg": "success",
    "req_id": "202207030046320102100881350AB63A4B",
    "ret": 0
}

多条曝光

请求结构	说明
请求域名	stream-api.feedcoopapi.com【建议】 mercury.snssdk.com【废弃】
请求地址	/user/action/log/show/v3/
请求协议	HTTP/HTTPS
请求方式	POST
参数类型	application/json

请求参数

参数	描述	类型	是否必填	说明
group_id	内容id	long	是	对应“获取个性化内容”接口返回的group_id
event_time	事件发生时间	long	是	十位时间戳，单位：秒；表示点击退出详情页事件发生时的时间
req_id	请求唯一标识	String	是	唯一标识该内容源于哪次请求，比如推荐接口返回的req_id

响应参数

参数	描述	类型	说明
ret	响应结果	long	参见“错误码”说明
msg	本次请求是否成功	String	success：成功
req_id	本次请求标识	String	惟一标识本次请求，火山引擎侧使用该字段进行具体问题追踪和排查

请求示例

curl --location --request POST 'https://stream-api.feedcoopapi.com/user/action/log/show/v3/?signature=54bf21452b8599034e6e5219864a5fd8f415a81a&timestamp=1656489292&nonce=894038&partner=server_sdk_demo_default_content&access_token=AEvgyaZ5cWcPS6m9jQhpXpjZ5xRued98RxaKYFX5NdjTDKXUEt8C3dGFXxmgoK9Sj5QvfXDPskhgrL87VVrmv7o6dPEsT7L' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "group_id": 6938426748178530823,
        "event_time": 1656776132,
        "req_id": "xxx"
    },
    {...},
    ...
]'

响应示例

{
    "data": [],
    "msg": "success",
    "req_id": "2022070300522401021219216026D10793",
    "ret": 0
}