時間軸 2 - 使用者放棄工作階段

VOD、前段廣告、中段廣告、使用者提早放棄內容

下列圖表說明播放點時間軸和使用者動作的對應時間軸。以下呈現每個動作的詳細資料及其隨附要求。

動作詳細資料

動作 1 - 開始工作階段

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
按下「自動播放」或「播放」按鈕 0 0 /api/v1/sessions

實作詳細資料

這個呼叫代表​使用者有意願播放​影片。它會傳回工作階段 ID ({sid}),給予用來識別工作階段中所有後續追蹤呼叫的用戶端。播放器狀態尚未進入「正在播放」,而是「正在開始」。要求內容的 params 對映必須包含強制工作階段參數。在後端,這個呼叫會產生 Adobe Analytics 起始呼叫。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:sessionStart, params: {
        "media.playerName": "sample-html5-api-player",
        "analytics.trackingServer": "[ _YOUR-TS_ ]",
        "analytics.reportSuite": "[ _YOUR-RSID_ ]",
        "analytics.visitorId": "[ _YOUR-VISITOR-ID_ ]",
        "media.contentType": "VOD",
        "media.length": 60.3333333333333,
        "media.id": "VA API Sample Player",
        "visitor.marketingCloudOrgId": "[YOUR-MCID]",
        "media.name": "ClickMe",
        "media.channel": "sample-channel",
        "media.sdkVersion": "va-api-0.0.0",
        "analytics.enableSSL": false
    }
}

動作 2 - 啟動 Ping 計時器

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式啟動 Ping 事件計時器 0 0

實作詳細資料

啟動應用程式的 Ping 計時器。如果有前段廣告,第一個 Ping 事件則應在 1 秒引發;如果沒有,則為 10 秒。

動作 3 - 廣告插播開始

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤前段廣告插播開始 0 0 /api/v1/sessions/{sid}/events

實作詳細資料

必須追蹤前段廣告。廣告追蹤只能在廣告插播中進行。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.podIndex": 0,
        "media.ad.podSecond": 0
    }
}

動作 4 - 廣告開始

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤前段廣告 #1 開始 0 0 /api/v1/sessions/{sid}/events

實作詳細資料

12 秒的廣告開始。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 1",
        "media.ad.id": "002",
        "media.ad.length": 7,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "1",
        "media.ad.creativeId": "42",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz-creative.com",
        "media.ad.placementId": "sample-placement2"
    },
}

動作 5 - 廣告 Ping

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式傳送 Ping 事件 1 0 /api/v1/sessions/{sid}/events

實作詳細資料

每隔 1 秒 Ping 後端一次。(為了簡單起見,將不會顯示後續廣告 Ping。)

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

動作 6 - 廣告完成

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤前段廣告 #1 完成 12 0 /api/v1/sessions/{sid}/events

實作詳細資料

第一個前段廣告結束。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

動作 7 - 廣告插播完成

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤前段廣告插播完成 12 0 /api/v1/sessions/{sid}/events

實作詳細資料

廣告插播結束。整個廣告插播期間,播放器一直保持「正在播放」狀態。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

動作 8 - 播放內容

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤播放事件 12 0 /api/v1/sessions/{sid}/events

實作詳細資料

將播放器改變為「正在播放」狀態;開始追蹤內容播放的開始。

範例要求內文

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:play,
    qoeData: { bitrate: 10000 }
}

動作 9 - Ping

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式傳送 Ping 事件 20 8 /api/v1/sessions/{sid}/events

實作詳細資料

每隔 10 秒 Ping 後端一次。

範例要求內文

{
    playerTime: {
        playhead: 8ß,
        ts: <timestamp>
    },
    eventType:ping
}

動作 10 - Ping

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式傳送 Ping 事件 30 18 /api/v1/sessions/{sid}/events

實作詳細資料

每隔 10 秒 Ping 後端一次。

範例要求內文

{
    playerTime: {
        playhead: 18,
        ts: <timestamp>
    },
    eventType:ping
}

動作 11 - 錯誤

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
發生錯誤,應用程式傳送錯誤資訊。 32 20 /api/v1/sessions/{sid}/events

實作詳細資料

範例要求內文

{
    playerTime: {
        playhead: 20,
        ts: <timestamp>
    },
    eventType:error
}

動作 12 - 播放內容

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式從錯誤中復原,使用者按下「播放」 37 20 /api/v1/sessions/{sid}/events

實作詳細資料

範例要求內文

{
    playerTime: {
        playhead: 18,
        ts: <timestamp>
    },
    eventType:play, qoeData: { bitrate: 10000 }
}

動作 13 - Ping

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
應用程式傳送 Ping 事件 40 28 /api/v1/sessions/{sid}/events

實作詳細資料

每隔 10 秒 Ping 後端一次。

範例要求內文

{
    playerTime: {
        playhead: 28,
        ts: <timestamp>
    },
    eventType:ping
}

動作 14 - 廣告插播開始

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤中段廣告插播開始 45 33 /api/v1/sessions/{sid}/events

實作詳細資料

持續 8 秒的中段廣告:傳送 adBreakStart

範例要求內文

{
    playerTime: {
        playhead: 33,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod2",
        "media.ad.podIndex": 1,
        "media.ad.podSecond": 33
    }
}

動作 15 - 廣告開始

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
追蹤中段廣告 #1 開始 45 33 /api/v1/sessions/{sid}/events

實作詳細資料

追蹤中段廣告。

範例要求內文

{
    playerTime: { playhead: 33, ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 1",
        "media.ad.id": "002",
        "media.ad.length": 8,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "7",
        "media.ad.creativeId": "40",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

動作 16 - 關閉應用程式

動作 動作時間軸 (秒) 播放點位置 (秒) 用戶端要求
使用者關閉應用程式。應用程式判斷使用者已放棄觀看,且不會回到此工作階段。 48 33 /api/v1/sessions/{sid}/events

實作詳細資料

傳送 sessionEnd 給 VA 後端,指出應立即關閉工作階段,而且不需要進一步處理。

範例要求內文

{
    playerTime: {
        playhead: 33,
        ts: <timestamp>
    },
    eventType:sessionEnd
}

本頁內容

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