廣告追蹤活動時間

使用用戶端報告時，玩家必須以一定的精確度發出追蹤事件 (信標)。使用用 MediaTailor 戶端追蹤結構描述，您可以確保每項可用性都能存在廣告、伴隨、覆蓋和追蹤事件、時間和持續時間資訊，以及以不同的形式呈現。

使用下列 MediaTailor 索引鍵/值配對，讓播放器準確地協調廣告事件活動 (例如追蹤事件) 與播放位置：

• startTime

• startTimeInSeconds

• adProgramDateTime

• adID/eventId

HLS 和 DASH 實現的價值startTime和startTimeInSeconds不同的價值：

• HLS-這些startTime值相對於播放工作階段的開始。播放工作階段的開始定義為時間零。廣告startTime是導致有效期間的所有EXT-INF區段持續時間累計值的總和。廣告或追蹤事件所在區段的媒體序號也對應於adId或用戶端追蹤回應eventId中。

• DASH：

  • 活動/動態清單-這些startTime值相對於 DASH 清單MPD@availabilityStartTime的值。這MPD@avaibilityStartTime是所有使用串流的 MediaTailor 工作階段的計時錨點。

  • VOD/靜態清單-這些startTime值相對於播放工作階段的開始。播放工作階段的開始定義為時間零。avail 中的每個廣告都包含在其自己的Period元素中。Period元素的@start屬性值與用戶端追蹤承載中的startTime值相同。PeriodId也對應於用戶端追蹤回應eventId中的adId或。

範例 HLS：

在下列範例中， MediaTailor 工作階段已啟動，而下列資訊清單是第一個提供給用戶端的資訊清單：

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:4603263
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:23.295678Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_34.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:27.306345Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_35.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:31.317012Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_36.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:35.327679Z
#EXTINF:4.010667,
https://123.cloudfront.net/out/v1/index_1_37.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:39.338346Z
#EXTINF:2.538667,
https://123.cloudfront.net/out/v1/index_1_38.ts
#EXT-X-DISCONTINUITY
#EXT-X-KEY:METHOD=NONE
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:41.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00001.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:43.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00002.ts
#EXT-X-PROGRAM-DATE-TIME:2023-05-03T21:24:45.453Z
#EXTINF:2.0,
https://123.cloudfront.net/tm/asset_1080_4_8_00003.ts

在用戶端追蹤 JSON 承載中，下列值適用：

• startTime: "PT18.581355S"

• startTimeInSeconds: 18.581

• availProgramDateTime: "2023-05-03T21:24:41.453Z"

• adId: 4603269

範例 DASH：

在下面的例子中，會 MediaTailor 話獲取清單中的 midroll。請注意，第二個週期的@start屬性值 (即廣告期間) 具有與該值相關的MPD@availabilityStartTime值。此值是針對所有工作階段 MediaTailor 寫入用戶端追蹤回應startTime欄位的值。

<?xml version="1.0" encoding="UTF-8"?>
<MPD availabilityStartTime="2022-10-05T19:38:39.263Z" minBufferTime="PT10S" minimumUpdatePeriod="PT2S" profiles="urn:mpeg:dash:profile:isoff-live:2011" publishTime="2023-05-03T22:06:48.411Z" suggestedPresentationDelay="PT10S" timeShiftBufferDepth="PT1M30S" type="dynamic" xmlns="urn:mpeg:dash:schema:mpd:2011" xmlns:scte35="urn:scte:scte35:2013:xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:mpeg:dash:schema:mpd:2011 http://standards.iso.org/ittf/PubliclyAvailableStandards/MPEG-DASH_schema_files/DASH-MPD.xsd">
    <BaseURL>https://123.channel-assembly.mediatailor.us-west-2.amazonaws.com/v1/channel/my-channel/</BaseURL>
    <Location>https://123.cloudfront.net/v1/dash/94063eadf7d8c56e9e2edd84fdf897826a70d0df/MediaTailor-Live-HLS-DASH/channel/channel1/dash.mpd?aws.sessionId=794a15e0-2a7f-4941-a537-9d71627984e5</Location>
    <Period id="1683151479166_1" start="PT5042H25M59.903S" xmlns="urn:mpeg:dash:schema:mpd:2011">
        <BaseURL>https://123.cloudfront.net/out/v1/f1a946be8efa45b0931ea35c9055fb74/ddb73bf548a44551a0059c346226445a/eaa5485198bf497284559efb8172425e/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
    <Period id="1683151599194_1_1" start="PT5042H27M59.931S">
        <BaseURL>https://123.cloudfront.net/tm/94063eadf7d8c56e9e2edd84fdf897826a70d0df/fpc5omz5wzd2rdepgieibp23ybyqyrme/</BaseURL>
        <AdaptationSet ...>
            ...
        </AdaptationSet>
    </Period>
</MPD>

在用戶端追蹤 JSON 承載中，下列值適用：

• startTime: "PT5042H27M59.931S"

• startTimeInSeconds: 18152879.931

• availProgramDateTime：空

• adId: 1683151599194_1_1