使用原生 SDK 實作用戶端廣告

概覽

客戶端廣告涉及從客戶端設備向廣告服務器提出請求。擷取廣告影片時，這可能會造成一些緩衝時間。要獲得更像電視的體驗，可以使用服務器端廣告插入。

使用用戶端廣告時，內容影片會播放，直到偵測到廣告提示點，或是從 VMAP 回應達到廣告時間為止。系統會向已設定的廣告伺服器提出要求，該伺服器會回應廣告詳細資料。播放器接著會開始播放要求的廣告。

布萊特灣原生 SDK 提供下列技術的外掛程式：

• Google的互動媒體廣告（IMA）
• 飛輪

原生 SDK 支持使用谷歌的廣告管理器和雙點擊發布商（DFP），谷歌 AdSense 網絡生成的 VMAP。

廣告類型

您可以搭配影片使用三種主要的廣告類型：

線性廣告 -暫停主要內容視頻並在播放器全幀中顯示的廣告

非線性廣告 -覆蓋在主要內容視頻上顯示的廣告。這些可以是文本，圖形圖像，甚至視頻覆蓋。

隨播廣告 -在視頻播放器之外顯示的廣告

廣告標準

標準 XML 檔案可用來告訴播放器何時播放您的廣告，以及要播放哪些廣告。的互動廣告局（IAB）在視頻播放器和廣告單元之間提供了以下通用接口：

視頻廣告投放模板（VAST） -用於向數字視頻播放器投放廣告的通用XML模式。此檔案指定要顯示哪些廣告。

視頻多個廣告播放列表（VMAP） -該文件描述了VAST廣告的播放列表，包括前插，中插，後插和非線性廣告。您可以在此指定廣告突發時間，以及每次休息時會播放哪些廣告。

視頻播放器廣告服務界面定義（VPAID） -建立用於提供互動廣告體驗的通用界面。

如果您不熟悉廣告條款，請先查看視頻廣告學習指南。

從您的應用程式播放廣告

若要播放用戶端廣告，請依照下列步驟執行：

1. 定義廣告代碼
2. 驗證廣告代碼
3. 創建提示點

4. 建置您的應用程式

   • Android實施
   • iOS實施

定義廣告代碼

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

• VAST-有關XML模式的詳細信息，請參見IAB VAST規範。
• VMAP-有關XML模板的詳細信息，請參見IAB VMAP規範。

驗證廣告代碼

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

Google提供了視頻套件檢查器供您檢查廣告代碼。

FreeWheel提供了廣告預覽器檢查廣告服務器的響應。

創建提示點

如果您使用的是 VMAP 廣告代碼，可以略過此步驟。VMAP 會為您的廣告定義播放清單，並指定播放時間。注意Google的IMA廣告規則使用VMAP。

如果您使用的是 VAST 廣告代碼，則需要建立提示點，告訴播放器何時要插入廣告。您必須在您的應用程序中創建這些內容。以下是一些如何做到這一點的例子：

Android

• IMA VAST基本樣本

iOS

• IMA基本樣本

安卓實作

Android 版原生 SDK 支援 VMAP、VAST、伺服器端廣告規則和隨附廣告，並採用下列技術：

谷歌伊馬

請依照下列步驟使用 Google IMA 廣告規則：

1. 找到並查看廣告規則IMA示例應用程序。
2. 開啟 MainActivity.java 檔案。

3. 使用您的值自訂專案。您需要下列值，才能從您的視訊雲端媒體櫃擷取內容：

   • 播放 API 原則金鑰
   • 帳戶 ID
   • 視訊 ID

4. 包含存取 IMA 廣告的值：

   • 廣告規則網址
5. 的setupGoogleIMA()方法與Brightcove IMA插件建立連接。
6. 聽著GoogleIMAEventType.ADS_REQUEST_FOR_VIDEO事件。在這裡，您將建立廣告請求物件，並指向您的廣告代碼網址。在這種情況下，它是一個廣告規則 VMAP 文件。
7. 的setupAdMarkers()方法是可選的。這個方法會呼叫 IMA AdManager，並在搜尋列上建立廣告標記，讓使用者可以直觀地看到廣告的播放時間。

搜尋沒有廣告

如果您想要在使用者透過影片搜尋時停用廣告播放功能，請參閱 Seek (不含廣告程式碼片段)。

代碼樣本

以下是完整的代碼示例：

• 基本的IMA Vast播放器：要使用VAST代碼，您的應用應從以下位置創建一組提示點：Video從Playback API調用返回的對像元數據。中繼資料將包含您在 Video Cloud Studio 中建立的廣告提示點。

• IMA廣告規則IMA播放器：或者，您的應用可以在播放器中創建一組提示點對象Activity類。

• 廣告規則IMA Widevine模塊化：將用戶端廣告與內容保護結合在一起。

飛輪

這些廣告需要您購買 Freewheel AdManager 程式庫。

請依照下列步驟使用 Freewheel 廣告：

1. 聯繫飛輪購買其AdManager.aar庫歸檔文件並將其安裝到您的libs /目錄中，該目錄通常位於/ home /目錄的根目錄下。適用於 Android 的原生 SDK 和飛輪範例應用程式需要 Freewheel AdManager 程式庫版本 6.28.0。
2. 找到並查看飛輪示例應用程序。
3. 開啟 MainActivity.java 檔案。
4. 使用您的值自訂專案。此範例使用遠端視訊資產。

5. 包含存取 Freewheel 廣告的數值：

   • 廣告網址
   • 廣告聯播網識別碼
   • 廣告設定檔
6. 的setupFreeWheel()方法與Brightcove FreeWheel插件建立連接。
7. 配置FreeWheel控制器以指向您的廣告URL。freeWheelController.setAdURL("http://demo.v.fwmrm.net/");
8. 稍後將使用它實例化FreeWheel AdRequestConfiguration類。
9. 聽著FreeWheelEventType.WILL_SUBMIT_AD_REQUEST事件。在這裡，您將獲得 Freewheel 控制器，並設置預捲，中卷，後期和重疊廣告版位。

搜尋沒有廣告

如果您想要在使用者透過影片搜尋時停用廣告播放功能，請參閱 Seek (不含廣告程式碼片段)。

代碼樣本

以下是完整的代碼示例：

• 基本的FreeWheel播放器

• FreeWheel Widevine模塊化播放器：將用戶端廣告與內容保護結合在一起。

iOS 實作

iOS 版原生 SDK 支援 VMAP、VAST、伺服器端廣告規則和隨附廣告，並採用下列技術：

谷歌伊馬

有關安裝，快速啟動和使用的詳細信息，請參見適用於iOS的IMA Plugin for Brightcove Player SDK參考。

如要使用 Google IMA 廣告，請按照下列步驟操作：

1. 找到並查看基本的IMA播放器示例應用程序。
2. 打開視圖控制器文件。

3. 使用您的值自訂專案。您需要下列值，才能從您的視訊雲端媒體櫃擷取內容：

   • 播放 API 原則金鑰
   • 帳戶 ID
   • 視訊 ID

4. 包含存取 IMA 廣告的值：

   • 發行者 ID
   • 語言
   • 廣告代碼網址
5. 創建playbackController使用適當的IMA設置，包括廣告請求策略（VAST，VMAP或服務器端廣告規則）。
6. BCOVIMA 外掛程式會透過生命週期事件發出廣告事件。這些事件在BCOVIMAComponent.h文件。
7. 範例應用程式包含可在廣告播放時隱藏播放器控制項的功能，並在廣告完成時顯示這些控制項。

搜尋沒有廣告

如果您想在用戶搜索視頻時禁用廣告播放，請參閱尋求無廣告插件參考部分。

代碼樣本

以下是完整的代碼示例：

• 基本的IMA播放器

• 帶有FairPlay的基本IMA播放器：將用戶端廣告與內容保護結合在一起。

飛輪

無法安裝自由輪 AD管理程式 SDK。相反，您必須手動將其添加到項目的應用程序目標中。

請依照下列步驟使用 Freewheel 廣告：

1. 手動將自由輪驅動器 SDK 添加到您的項目中。有關詳細步驟，請參見基本Freewheel Player的自述文件文件。
2. 找到並查看基本的FreeWheel播放器示例應用程序。
3. 打開視圖控制器文件。

4. 使用您的值自訂專案。您需要下列值，才能從您的視訊雲端媒體櫃擷取內容：

   • 播放 API 原則金鑰
   • 帳戶 ID
   • 視訊 ID
5. 建立自由輪管理員。這將負責所有的廣告內容。
6. 使用廣告內容政策建立工作階段提供者和播放控制器。
7. 使用您自己的 Freewheel 組態值自訂專案。參考FreeWheel文檔或聯繫您的FreeWheel客戶經理。
8. 設定廣告檢視、廣告控制和隨附位置。

搜尋沒有廣告

如果您想在用戶搜索視頻時禁用廣告播放，請參閱尋求無廣告插件參考部分。

程式碼範例

這是一個完整的代碼示例：

• 基本的飛輪手