使用非 Brightcove 播放器和 SDK 實施 SSAI

在本主題中，您將了解如何將 Brightcove 的服務器端廣告插入 (SSAI) 與非 Brightcove 播放器和 SDK 一起使用。

概覽

服務器端廣告插入 (SSAI) 允許您將廣告嵌入到您的視頻中，以提供類似電視的觀看體驗，其中廣告無法被瀏覽器中的廣告攔截器攔截。對於 SSAI，您的視訊必須使用動態傳遞來擷取，這是下一代的擷取和傳遞系統，可減少儲存空間並動態封裝媒體。

SSAI 同時適用於 DRM 和非 DRM 內容。

您從 Video Cloud 擷取的任何影片，而且已透過動態傳遞內嵌的影片，都會在您的廣告設定中包含 VMAP 檔案中指定的廣告。

要使用存儲在Video Cloud中的視頻內容播放服務器端廣告，請按照以下步驟操作：

  1. 定義廣告代碼
  2. 測試您的廣告代碼
  3. 建立廣告設定
  4. 請求視頻
  5. 配置您的播放器

以下是一些額外的主題：

定義廣告代碼

廣告代碼定義要擷取和播放的廣告。您可以使用下列其中一種格式：

示例 VMAP 文件

以下是 VMAP 文件的示例：

<vmap:VMAP xmlns:vmap="http://www.iab.net/videosuite/vmap" version="1.0">
  <vmap:AdBreak timeOffset="start" breakType="linear" breakId="preroll">
    <vmap:AdSource id="preroll-ad" allowMultipleAds="false" followRedirects="true">
      <vmap:VASTAdData>
        <VAST version="3.0">
          <Ad id="1">
            <InLine>
              <AdSystem version="1.0">Test Ad Server</AdSystem>
              <AdTitle>
                <![CDATA[ Portals ]]>
              </AdTitle>
              <Description>
                <![CDATA[ Demo ad number 6 ]]>
              </Description>
              <Error>
                <![CDATA[ ]]>
              </Error>
              <Creatives>
                <Creative>
                  <Linear>
                    <Duration>00:00:05</Duration>
                    <TrackingEvents/>
                    <AdParameters>
                      <![CDATA[ <xml></xml> ]]>
                    </AdParameters>
                    <VideoClicks/>
                    <MediaFiles>
                      <MediaFile type="video/mp4" width="1280" height="720" delivery="progressive" id="2" bitrate="4316" minBitrate="320" maxBitrate="320" scalable="true" maintainAspectRatio="true">
                        <![CDATA[ https://general.support.brightcove.com/assets/ads/bc-ads/bcls-ad-6-5seconds.mp4 ]]>
                      </MediaFile>
                    </MediaFiles>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTAdData>
    </vmap:AdSource>
  </vmap:AdBreak>
  <vmap:AdBreak timeOffset="00:00:05" breakType="linear" breakId="midroll">
    <vmap:AdSource id="midroll-ad" allowMultipleAds="false" followRedirects="true">
      <vmap:VASTAdData>
        <VAST version="3.0">
          <Ad id="2">
            <InLine>
              <AdSystem version="1.0">Test Ad Server</AdSystem>
              <AdTitle>
                <![CDATA[ Marketing ]]>
              </AdTitle>
              <Description>
                <![CDATA[ Demo ad number 4 ]]>
              </Description>
              <Error>
                <![CDATA[ ]]>
              </Error>
              <Creatives>
                <Creative>
                  <Linear skipoffset="00:00:05">
                    <Duration>00:00:12</Duration>
                    <TrackingEvents/>
                    <AdParameters>
                      <![CDATA[ <xml></xml> ]]>
                    </AdParameters>
                    <VideoClicks/>
                    <MediaFiles>
                      <MediaFile type="video/mp4" width="1280" height="720" delivery="progressive" id="3" bitrate="3026" minBitrate="320" maxBitrate="320" scalable="true" maintainAspectRatio="true">
                        <![CDATA[ https://general.support.brightcove.com/assets/ads/bc-ads/bcls-ad-4-12seconds.mp4 ]]>
                      </MediaFile>
                    </MediaFiles>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTAdData>
    </vmap:AdSource>
  </vmap:AdBreak>
  <vmap:AdBreak timeOffset="end" breakType="linear" breakId="postroll">
    <vmap:AdSource id="postroll-ad" allowMultipleAds="false" followRedirects="true">
      <vmap:VASTAdData>
        <VAST version="3.0">
          <Ad id="3">
            <InLine>
              <AdSystem version="1.0">Test Ad Server</AdSystem>
              <AdTitle>
                <![CDATA[ Brand ]]>
              </AdTitle>
              <Description>
                <![CDATA[ Demo ad number 1 ]]>
              </Description>
              <Error>
                <![CDATA[ ]]>
              </Error>
              <Creatives>
                <Creative>
                  <Linear>
                    <Duration>00:00:08</Duration>
                    <TrackingEvents/>
                    <AdParameters>
                      <![CDATA[ <xml></xml> ]]>
                    </AdParameters>
                    <VideoClicks/>
                    <MediaFiles>
                      <MediaFile type="video/mp4" width="1280" height="720" delivery="progressive" id="4" bitrate="2115" minBitrate="320" maxBitrate="320" scalable="true" maintainAspectRatio="true">
                        <![CDATA[ https://general.support.brightcove.com/assets/ads/bc-ads/bcls-ad-1-8seconds.mp4 ]]>
                      </MediaFile>
                    </MediaFiles>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTAdData>
    </vmap:AdSource>
  </vmap:AdBreak>
</vmap:VMAP>

測試您的廣告代碼

最好是確認廣告代碼是否有效，並如預期般運作。這將有助於在實施過程中調試其他問題。

建立廣告設定

廣告配置定義了SSAI播放的各個方面，包括指向您的視頻多個廣告播放列表（VMAP）文件的URL，信標和其他配置。

使用視頻雲工作室

要使用 Studio 創建廣告配置，請參閱 配置服務器端廣告設置 文檔。

使用 SSAI 廣告配置 API

要使用 API 創建廣告配置，請參閱 Video Cloud SSAI Ad Config API 文檔。

請求視頻

接下來，獲取帶有服務器端廣告的視頻數據。為此，請將您的廣告配置 ID 作為 URL 參數附加到您的 Playback API 視頻請求中。

回放 API 響應示例

以下是 Playback API 響應的示例：

{
  "poster": "https://cf-images.eu-west-1.prod.boltdns.net/v1/jit/1752604059001/dca41ae8-d8f5-48a6-9853-564764d60b84/main/1280x720/12s64ms/match/image.jpg",
  "thumbnail": "https://cf-images.eu-west-1.prod.boltdns.net/v1/jit/1752604059001/dca41ae8-d8f5-48a6-9853-564764d60b84/main/160x90/12s64ms/match/image.jpg",
  "poster_sources": [{
    "src": "https://cf-images.eu-west-1.prod.boltdns.net/v1/jit/1752604059001/dca41ae8-d8f5-48a6-9853-564764d60b84/main/1280x720/12s64ms/match/image.jpg"
  }],
  "thumbnail_sources": [{
    "src": "https://cf-images.eu-west-1.prod.boltdns.net/v1/jit/1752604059001/dca41ae8-d8f5-48a6-9853-564764d60b84/main/160x90/12s64ms/match/image.jpg"
  }],
  "description": null,
  "tags": [],
  "cue_points": [],
  "custom_fields": {},
  "account_id": "1752604059001",
  "sources": [{
    "ext_x_version": "4",
    "src": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/hls/v4/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/master.m3u8?bc_token=NWZmNGQ4ZDlfZjJkMjdkY2ZlZjNhODljNzVmNzlhZTkxZTM0YTBhMmQ5NzI3ZDVmMmZmODIwYjcyMjM0NzMyZDIyZDQ3NTUwZQ%3D%3D",
    "type": "application/x-mpegURL",
    "vmap": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfOTY5ZjIzMzAzOTAxNzZhZjVlYjllOGJmMzA1YjI4MDE3OTM4NmEyZmRkYTc1OGNkZjM5NTAxMWUxYTE5ZGU5Yg%3D%3D"
  }, {
    "ext_x_version": "4",
    "src": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/hls/v4/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/master.m3u8?bc_token=NWZmNGQ4ZDlfZjJkMjdkY2ZlZjNhODljNzVmNzlhZTkxZTM0YTBhMmQ5NzI3ZDVmMmZmODIwYjcyMjM0NzMyZDIyZDQ3NTUwZQ%3D%3D",
    "type": "application/x-mpegURL",
    "vmap": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/hls/v4/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfOTY5ZjIzMzAzOTAxNzZhZjVlYjllOGJmMzA1YjI4MDE3OTM4NmEyZmRkYTc1OGNkZjM5NTAxMWUxYTE5ZGU5Yg%3D%3D"
  }, {
    "codecs": "avc1,mp4a",
    "ext_x_version": "7",
    "src": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/hls/v7/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/master.m3u8?bc_token=NWZmNGQ4ZDlfNjVhYTczMDhmZWY5OWE5Zjk3OGJmNTczYjYyYWFmMGI3OWQxZTYyODc5YTk3NzJiOWY3MDk0NmZjOTVmZjVhMA%3D%3D",
    "type": "application/x-mpegURL",
    "vmap": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/hls/v7/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfNzk5NzY0NThhOTlhZWY0OWI3NDc0MDQxMTQxNWMwZjVkYTFlYzdiZTRkMWE2ZmJjODRjODRkY2JlYjZjZWI1Mg%3D%3D"
  }, {
    "codecs": "avc1,mp4a",
    "ext_x_version": "7",
    "src": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/hls/v7/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/master.m3u8?bc_token=NWZmNGQ4ZDlfNjVhYTczMDhmZWY5OWE5Zjk3OGJmNTczYjYyYWFmMGI3OWQxZTYyODc5YTk3NzJiOWY3MDk0NmZjOTVmZjVhMA%3D%3D",
    "type": "application/x-mpegURL",
    "vmap": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/hls/v7/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfNzk5NzY0NThhOTlhZWY0OWI3NDc0MDQxMTQxNWMwZjVkYTFlYzdiZTRkMWE2ZmJjODRjODRkY2JlYjZjZWI1Mg%3D%3D"
  }, {
    "profiles": "urn:mpeg:dash:profile:isoff-live:2011",
    "src": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/dash/live-timeline/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/manifest.mpd?bc_token=NWZmNGQ4ZDlfN2Y5MzJhZmYxYjM5ZTRiZTIwNmFlNzg1NWIyOTY3NjlhMTMwZTllMGI2YzEwZmFlMTk2ZmEzODAwMDVlMWMxYw%3D%3D",
    "type": "application/dash+xml",
    "vmap": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/dash/live-timeline/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfY2JkMWY4NmY1ZDI2NDQ0NGY1YzAzYzMxNGY5NTJjY2MzYjljMTVjOGM3N2ZhZWRkNTU3YjgxYzkyMDQwOGIzYQ%3D%3D"
  }, {
    "profiles": "urn:mpeg:dash:profile:isoff-live:2011",
    "src": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/dash/live-timeline/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/manifest.mpd?bc_token=NWZmNGQ4ZDlfN2Y5MzJhZmYxYjM5ZTRiZTIwNmFlNzg1NWIyOTY3NjlhMTMwZTllMGI2YzEwZmFlMTk2ZmEzODAwMDVlMWMxYw%3D%3D",
    "type": "application/dash+xml",
    "vmap": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/dash/live-timeline/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfY2JkMWY4NmY1ZDI2NDQ0NGY1YzAzYzMxNGY5NTJjY2MzYjljMTVjOGM3N2ZhZWRkNTU3YjgxYzkyMDQwOGIzYQ%3D%3D"
  }, {
    "codecs": "avc1,mp4a",
    "profiles": "urn:mpeg:dash:profile:isoff-live:2011",
    "src": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/dash/live-timeline/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/manifest.mpd?bc_token=NWZmNGQ4ZDlfNGY5Y2NlNjUyMjNiN2RjYTUyOTYyN2EwZjMzNmNiNjA3NzY4OTFjM2MxMDVhYzkzYzY0NzE5NDc4ZTI4MDc2ZQ%3D%3D",
    "type": "application/dash+xml",
    "vmap": "http://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/dash/live-timeline/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfZWUxN2FkNjUxZTZmMTZkMzJmM2VhOTY0MTY1NTU1ZmJkNzhiMjgxMTg1ZmI1ZGY1ODcwYmVjOWUzM2E2NGVjMw%3D%3D"
  }, {
    "codecs": "avc1,mp4a",
    "profiles": "urn:mpeg:dash:profile:isoff-live:2011",
    "src": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/dash/live-timeline/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/manifest.mpd?bc_token=NWZmNGQ4ZDlfNGY5Y2NlNjUyMjNiN2RjYTUyOTYyN2EwZjMzNmNiNjA3NzY4OTFjM2MxMDVhYzkzYzY0NzE5NDc4ZTI4MDc2ZQ%3D%3D",
    "type": "application/dash+xml",
    "vmap": "https://ssaimanifest.prod.boltdns.net/playback/once/v1/vmap/dash/live-timeline/clear/codec_avc1_mp4a/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/content.vmap?bc_token=NWZmNGQ4ZDlfZWUxN2FkNjUxZTZmMTZkMzJmM2VhOTY0MTY1NTU1ZmJkNzhiMjgxMTg1ZmI1ZGY1ODcwYmVjOWUzM2E2NGVjMw%3D%3D"
  }],
  "name": "Mt Audubon",
  "reference_id": null,
  "long_description": null,
  "duration": 24128,
  "economics": "AD_SUPPORTED",
  "text_tracks": [],
  "published_at": "2020-05-14T18:51:30.532Z",
  "created_at": "2020-05-14T18:51:30.502Z",
  "updated_at": "2020-05-14T19:46:00.320Z",
  "offline_enabled": false,
  "link": null,
  "id": "6156696074001",
  "ad_keys": null
}

配置您的播放器

在播放 API 回應 (上一節) 中，找出Sources物件，複製其中一個vmap URL，然後將其貼到瀏覽器搜尋列中，以查看 VMAP 回應。

示例 VMAP 響應

以下是 vmap 響應的示例：

<vmap:VMAP xmlns:bc="bc" xmlns:vmap="http://www.iab.net/vmap-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0">
  <vmap:Extensions>
    <bc:Brightcove ttl="3600" contenturi="https://ssaimanifest.prod.boltdns.net/us-east-1/playback/once/v1/hls/v4/clear/1752604059001/d6190656-2095-4ff3-8afe-1a0b60d67ed2/dca41ae8-d8f5-48a6-9853-564764d60b84/6830b2e4-3298-439d-beef-e04abef9f23c/content.m3u8?bc_token=NWZkMTE5NTlfZWQxNDAzNDRkNTAxNDRlMWEwODU3MTI1MzY2YjAyZWQ5YzlmZTkzY2UwMjM5NTM1MmI2NGRjZDNhNjE2ZDhlOA%3D%3D"
    contentlength="24.0574" payloadlength="50.1835" contenttype="application/x-mpegURL" />
    <bc:thumbnailURL type="thumbnail" width="480" height="270" bandwidth="0">https://ssai.playback.us-east-1.prod.deploys.brightcove.com/v1/thumbnail/1752604059001/dca41ae8-d8f5-48a6-9853-564764d60b84/low-res/6830b2e4-3298-439d-beef-e04abef9f23c/thumbnail.vtt?bc_token=NWZkMTE5NTlfMmVmODIzZDJjMGZkMDBjZjY1YWIxNDQ4Y2YyZmUxYTExNzg5YmIxZDI5ZTdkMjgyODBmMDBmYTViMTE2Yzc0MQ%3D%3D</bc:thumbnailURL>
  </vmap:Extensions>
  <vmap:AdBreak breakType="linear" breakId="PreRoll_0_0" timeOffset="start">
    <vmap:AdSource allowMultipleAds="true" followRedirects="true" id="0">
      <vmap:VASTData>
        <VAST xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <Ad id="1">
            <InLine>
              <AdSystem>Test Ad Server</AdSystem>
              <AdTitle>Portals</AdTitle>
              <Description>Demo ad number 6</Description>
              <Error></Error>
              <Creatives>
                <Creative>
                  <Linear>
                    <CreativeExtensions>
                      <CreativeExtension>
                        <BrightcoveForeignKey>1</BrightcoveForeignKey>
                      </CreativeExtension>
                    </CreativeExtensions>
                    <Duration>00:00:05.9392</Duration>
                    <AdParameters>
                      <xml></xml>
                    </AdParameters>
                    <VideoClicks/>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTData>
    </vmap:AdSource>
  </vmap:AdBreak>
  <vmap:AdBreak breakType="linear" breakId="MidRoll_5_0" timeOffset="00:00:04.8381">
    <vmap:AdSource allowMultipleAds="true" followRedirects="true" id="1">
      <vmap:VASTData>
        <VAST xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <Ad id="2">
            <InLine>
              <AdSystem>Test Ad Server</AdSystem>
              <AdTitle>Marketing</AdTitle>
              <Description>Demo ad number 4</Description>
              <Error></Error>
              <Creatives>
                <Creative>
                  <Linear skipoffset="00:00:05">
                    <CreativeExtensions>
                      <CreativeExtension>
                        <BrightcoveForeignKey>2</BrightcoveForeignKey>
                      </CreativeExtension>
                    </CreativeExtensions>
                    <Duration>00:00:12.1788</Duration>
                    <AdParameters>
                      <xml></xml>
                    </AdParameters>
                    <VideoClicks/>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTData>
    </vmap:AdSource>
  </vmap:AdBreak>
  <vmap:AdBreak breakType="linear" breakId="PostRoll_24_0" timeOffset="end">
    <vmap:AdSource allowMultipleAds="true" followRedirects="true" id="2">
      <vmap:VASTData>
        <VAST xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <Ad id="3">
            <InLine>
              <AdSystem>Test Ad Server</AdSystem>
              <AdTitle>Brand</AdTitle>
              <Description>Demo ad number 1</Description>
              <Error></Error>
              <Creatives>
                <Creative>
                  <Linear>
                    <CreativeExtensions>
                      <CreativeExtension>
                        <BrightcoveForeignKey>3</BrightcoveForeignKey>
                      </CreativeExtension>
                    </CreativeExtensions>
                    <Duration>00:00:08.0080</Duration>
                    <AdParameters>
                      <xml></xml>
                    </AdParameters>
                    <VideoClicks/>
                  </Linear>
                </Creative>
              </Creatives>
              <Extensions>
                <Extension>
                  <xml>data</xml>
                </Extension>
              </Extensions>
            </InLine>
          </Ad>
        </VAST>
      </vmap:VASTData>
    </vmap:AdSource>
  </vmap:AdBreak>
</vmap:VMAP>

VMAP 擴展

在 VMAP 回應中，布萊特灣增加了一個<vmap:Extensions>區段。

下列屬性與副檔名區段中的<bc:Brightcove>標籤相關聯：

VMAP 響應字段屬性
屬性 描述
contenturi 對會話特定清單的引用 - 這是您應該加載到播放器中的內容
contentlength 內容視頻的時長
payloadlength 總拼接流的持續時間

廣告插播

以下屬性與每個廣告塊相關聯：

VMAP 響應字段
屬性 描述
timeoffset 這可以是startend、或需要計算的特定時間。如果一個廣告連播有多個廣告，它們可以有相同的偏移量，因為它們是在相同的“內容時間”插入的。

以下標籤與每個廣告塊相關聯：

VMAP 響應字段
標籤 描述
Duration 這標識要插入的廣告的持續時間。

注意事項

在製定廣告策略時，請注意以下幾點：

  • 在start偏移量時，您可能會有 3 個廣告的持續時間00:00:16.0000，導致捲動前 Pod 總長度為 48 秒。這意味著實際內容開始時間將是實際拼接清單的 48 秒標記。
  • 在各種廣告元素中，最相關的可能是ClickThrough因為它標識要啟用的 URL 鏈接。請注意，當使用者按一下連結時，應該指標任何關聯的ClickTracking元素。

廣告代碼變量

廣告代碼變量允許您定位廣告。

如果您的廣告設定有任何{{url.*}}巨集，請求 VMAP 時，應將它們作為查詢參數附加。

例如，像這樣的宏

{{url.deviceId}}

應該附加為查詢參數，例如

?deviceId=xyz

有關詳細信息，請參閱 視頻雲 SSAI Ad Config API 文檔。

服務器端信標

您可以配置信標以觸發服務器端印象和四分位數/完整信標。

  • 使用SSAI時，VAST廣告錯誤信標有助於主動發現和解決廣告工作流程中的問題。如需詳細資訊，請參閱 SSAI 的廣告錯誤信標文件。
  • 也可以使用 VAST 標准信標。有關詳細信息，請參閱 數字視頻廣告服務模板 (VAST) 文檔。