事件要求

上次更新： 2023-01-11
  • 建立對象：
  • User
    Admin
    Developer

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 (可選)

如需該版本的有效事件類型清單，請參閱事件類型和說明。

重要

***廣告追蹤 -*您只能追蹤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 回應代碼

HTTP 回應代碼 說明 用戶端動作項目
204 沒有內容。

心率呼叫成功。		 不適用
400 Bad Request。

要求格式錯誤。		 如需要求類型，請查看 JSON 驗證結構。
404 找不到。

在後端服務找不到媒體工作階段的工作階段 ID。		 用戶端應用程式應使用工作階段要求 API，建立其他媒體工作階段並回報相關追蹤。
410 已過期。

在後端服務找到媒體工作階段，但用戶端無法回報相關活動。		 用戶端應用程式應使用工作階段要求 API，建立其他媒體工作階段並回報相關追蹤。
500 伺服器錯誤 不適用
上一頁
Next page

此頁面上的