事件请求 events-request

最近更新： 2026年5月19日

主题：
{"id":"fd307ce7-56f5-4ee3-af68-a7833ff6e85e"}

创建对象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

POST https://{uri}/api/v1/sessions/{sid}/events

URI 参数

sid：从会话请求返回的会话 ID。

请求正文

请求正文必须是 JSON，且还必须具有与此示例请求正文相同的结构：

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}

playerTime（必需）
- playhead - 必须以秒为单位，但它可以是一个浮点数。
- ts - 时间戳，必须以毫秒为单位。
eventType（必需）
params（可选）
customMetadata（可选，只通过 adStart 和 chapterStart 事件类型发送）
qoeData（可选）

有关有效事件类型和每个SDK实现示例的列表，请参阅事件概述。

IMPORTANT

广告跟踪 -您只能跟踪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

服务器错误

不适用

recommendation-more-help

media-analytics-help