事件请求 events-request

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

用户
管理员
开发人员

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（可选）

有关此版本的有效事件类型列表，请参阅事件类型和描述。

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

c8eee520-cef5-4f8c-a38a-d4952cfae4eb