事件要求 events-request

Last update: Mon Dec 02 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

Bad Request。

要求格式錯誤。

如需要求類型，請查看 JSON 驗證結構。

404

找不到。

在後端服務找不到媒體工作階段的工作階段 ID。

用戶端應用程式應使用工作階段要求 API，建立其他媒體工作階段並回報相關追蹤。

410

已過期。

在後端服務找到媒體工作階段，但用戶端無法回報相關活動。

用戶端應用程式應使用工作階段要求 API，建立其他媒體工作階段並回報相關追蹤。

500

伺服器錯誤

不適用

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb