事件要求

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 (選用;只能連同 adStartchapterStart 事件類型一起傳送)
  • qoeData (可選)

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

重要

***廣告追蹤 -**您只能追蹤adBreak*內的廣告。

如果廣告周圍缺少 adBreakStartadBreakComplete「書擋」,系統將會忽略 adStartadComplete 事件,並將對應的廣告持續時間視為主要內容持續時間來追蹤。這可能會對 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 伺服器錯誤 不適用

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now