追蹤下載內容

概述

「下載內容」功能可供使用者在離線時追蹤媒體用量。例如,使用者可在行動裝置上下載及安裝應用程式,接著使用應用程式將內容下載至裝置上的本機儲存空間。 Adobe 特地開發「下載內容」功能,以便使用者追蹤其下載的資料。透過此功能,使用者從裝置的儲存空間播放內容時,無論裝置是否連線,追蹤資料都會儲存在裝置上。使用者完成播放工作階段,且裝置恢復成上線狀態時,儲存的追蹤資訊會隨即傳送至單一裝載中的 Media Collection API 後端。之後,儲存的追蹤資訊會照常在 Media Collection API 中處理及製成報告。

對比下列兩種方法:

  • 線上

    透過這種即時處理法,媒體播放器會傳送每個播放器事件的追蹤資料,且每十秒傳送一次網路 Ping (廣告則是每秒傳送),將資料依序傳送至後端。

  • 離線 (「下載內容」功能)

    透過這種批次處理法,系統需產生相同的工作階段事件,不過會暫時將其儲存在裝置上,直到資料以單一工作階段形式傳送到後端為止 (請參閱下方範例)。

兩種方法各有優缺點:

  • 線上情況有利於即時追蹤,但需在每個網路呼叫前檢查連線。
  • 離線情況 (「下載內容」功能) 僅需檢查一次網路連線,但會佔用裝置上更大的記憶體空間。

實作

支援平台

iOS 和 Android 行動裝置均支援內容追蹤功能。

事件結構

「下載內容」功能是離線版本的 (標準) 線上 Media Collection API,因此播放器批次處理及傳送到後端的事件資料,必須使用與線上呼叫時相同的事件結構。如需這些結構的詳細資訊,請參閱:

事件順序

  • 根據 Media Collection API 通常的情況,批次裝載中的第一個事件必須為 sessionStart
  • 在 **事件上,media.downloaded: true**您必須將params包含在標準中繼資料參數 (sessionStart索引鍵) 中,以表示您要將下載內容傳送到哪個後端。若此參數不存在或設為 false,在傳送下載資料時,API 會傳回 400 回應代碼 (Bad Request)。此參數會區分傳送到後端的下載內容與即時內容。若media.downloaded: true設在即時工作階段上,同樣會導致 API 傳回 400 回應代碼。
  • 實作時應負責依照其外觀的順序,正確地儲存播放器事件。

回應代碼

  • 201 - Created:成功的要求;資料有效,工作階段已建立且將進行處理。
  • 400 - Bad Request;結構驗證失敗,已捨棄所有資料,不會處理任何工作階段資料。

與 Adobe Analytics 整合

計算下載內容情況的 Analytics 開啟/關閉呼叫時,後端會設定一個稱為 ts. 的額外 Analytics 欄位。這些是第一個和最後一個收到事件的時間戳記 (開始和完成)。此機制可將完成的媒體工作階段放置在正確的時間點 (換句話說,即使使用者數天未重新上線,媒體工作階段也會依照實際檢視內容的時間,回報媒體工作階段)。您必須透過建立​可選時間戳記報表套裝,以在 Adobe Analytics 端啟用此機制。​若要啟用可選時間戳記報表套裝,請參閱可選時間戳記

範例工作階段比較

[url]/api/v1/sessions

線上內容

{
  eventType: "sessionStart",
  playerTime: {
    playhead: 0,  
    ts: 1529997923478},  
  params: { /* Standard metadata parameters as documented */ },  
  customMetadata: { /* Custom metadata parameters as documented */ },  
  qoeData: { /* QoE parameters as documented */ }
}

下載內容

[{
    eventType: "sessionStart",
    playerTime:{
      playhead: 0,
      ts: 1529997923478},  
    params:{
        "media.downloaded": true
        ...
    },
    customMetadata:{},  
    qoeData:{}
},
    {eventType: "play", playerTime:
        {playhead: 0,  ts: 1529997928174}},
    {eventType: "ping", playerTime:
        {playhead: 10, ts: 1529997937503}},
    {eventType: "ping", playerTime:
        {playhead: 20, ts: 1529997947533}},
    {eventType: "ping", playerTime:
        {playhead: 30, ts: 1529997957545},},
    {eventType: "sessionComplete", playerTime:
        {playhead: 35, ts: 1529997960559}
}]

媒體追蹤器 API 參考

如需如何設定下載內容的詳細資訊,請參閱媒體追蹤器 API 參考

本頁內容

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