POST https://{uri}/api/v1/sessions/{sid}/events
sid
:从会话请求返回的会话 ID。
请求正文必须是 JSON,且还必须具有与此示例请求正文相同的结构:
{
"playerTime": {
"playhead": 0,
"ts": 1509045324153
},
"eventType": "{event-type}",
"params": {},
"qoeData": {},
"customMetadata": {}
}
playerTime
(必需)
playhead
- 必须以秒为单位,但它可以是一个浮点数。ts
- 时间戳,必须以毫秒为单位。eventType
(必需)params
(可选)customMetadata
(可选,只通过 adStart
和 chapterStart
事件类型发送)qoeData
(可选)有关此版本的有效事件类型列表,请参阅事件类型和描述。
***广告跟踪 -*您只能跟踪adBreak
内的广告。
在广告头尾没有 adBreakStart
和 adBreakComplete
“书挡”的情况下,adStart
和 adComplete
事件将被忽略,并且会将相应的广告持续时间作为主内容持续时间进行跟踪。这可能会对 Adobe Analytics 中可用的聚合数据产生重大影响。
HTTP/1.1 204 No Content
Server nginx/1.13.5
Date Thu, 26 Oct 2017 19:15:24 GMT
Connection keep-alive
Access-Control-Allow-Origin *
Access-Control-Allow-Methods OPTIONS,POST,PUT
Access-Control-Allow-Headers Content-Type
Access-Control-Expose-Headers Location
HTTP 响应代码 | 描述 | 客户端操作项 |
---|---|---|
204 | 无内容。 心跳调用成功。 |
不适用 |
400 | 错误请求。 请求格式不正确。 |
检查 JSON 验证架构以了解请求类型。 |
404 | 未找到。 在后端服务中找不到媒体会话的会话 ID。 |
客户端应用程序应使用会话请求 API 创建另一个媒体会话并报告对它的跟踪。 |
410 | 不存在。 在后端服务中找到媒体会话,但客户端无法再对该会话报告活动。 |
客户端应用程序应使用会话请求 API 创建另一个媒体会话并报告对它的跟踪。 |
500 | 服务器错误 | 不适用 |