（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）

對於任何流媒體服務來說，觀看時間都是一個至關重要的指標。它衡量觀眾在特定日期範圍內觀看內容的總時長。這包括 VOD、直播活動和相關的直播到 VOD 回放。瞭解觀看時間可以幫助您評估觀眾的參與度，並就內容策略做出明智的決策。

關於觀看時間報告

觀看時間報告提供以下詳細信息：

• 內容資訊： 這包括內容標題、內容 ID、流媒體類型和內容創建時間。
• 客戶 ID： 這些是自定義的用戶 ID，可幫助您識別用戶的播放。
• 觀看時間（秒）： 這是按不同內容、類型和客戶 ID 細分的觀眾觀看內容的時間數據。

以下示例是 2023 年 7 月 3 日從 00:00:00 到 23:59:59 的 VOD 觀看歷史記錄的觀看時間報告 (20230703.csv) ：

生成觀看時間報告

要生成觀看時間報告，可以使用以下 API：

GET /bv/analytics/v1/reports/watch-time

此 API 接受兩個查詢參數：

• streaming_type: 指定要生成報告的內容類型。 它可以指定成用於直播活動和相關的直播到點播的 REPORT_STREAMING_TYPE_LIVE ，或是用於 VOD 的 REPORT_STREAMING_TYPE_VOD 。
• time: 使用 ISO 8601 格式指定報告日期 (YYYY-MM-DDTHH:MM:SSZ). 報告將包括從指定日期的 00:00:00 至 23:59:59 期間啓動的所有查看的總觀看時間。

以下是一個 cURL 請求的示例：

curl --request GET \
  --url 'https://api.one-qa.kkstream.io/bv/analytics/v1/reports/watch-time?time=2023-07-03T00%3A00%3A00&streaming_type=REPORT_STREAMING_TYPE_VOD' \
  --header 'Accept: application/json' \
  --header 'authorization: Bearer <your-api-token>' \
  --header 'x-bv-org-id: <your-organization-id>'

成功的回應將包含觀看時間報告的 URL：

{
  "url": "string"
}

現在，您可以通過導航到此 URL 訪問您的報告。

註記：

1. 如果報告不可用（1-2 天）或指定日期沒有查看歷史記錄，API 將回應 404 錯誤。
2. URL 將在一小時後過期。如果過期，請再次使用此 API 獲取新的 URL。