IMA DAI SDK 中的 Open Measurement

Android 專用 IMA SDK 包含 Open Measurement (OM) SDK， 根據 互動廣告協會 (IAB)：啟用第三方 可視度和驗證評估。使用 Android 版 IMA SDK 時，內含的 OM SDK 會自動剖析 VAST 廣告代碼中的 <AdVerifications> 代碼，並透過 OMID API 將可視度資料傳送至指定的評估廠商。IMA SDK 支援 OM SDK v1.4、VAST 2 以上版本的 GAM AdVerifications 擴充功能，以及 VAST 4 以上版本的 AdVerifications 節點。如要充分運用 Open Measurement，請留意下列事項：

  • 您必須擁有版本才能使用 Open Measurement 3.11.0 或 Android 專用的 IMA SDK 不過，本指南中的範例適用於最新版的 SDK ，且包含版本 3.16.5 中導入的 API。

  • 如果使用 VAST 4.1 以上版本，則必須依據 VAST 4.1 規格設定廣告，以便在 VAST 中流量 <AdVerifications>；否則，應使用 <Extension type="AdVerifications">。

  • 請勿使用任何疊加層 (透明或不透明) 覆蓋 AdDisplayContainer，因為 OM SDK 會將這些疊加層標示為阻礙物，進而降低可見度。

必要條件

測試

如要使用 IMA SDK 測試 Open Measurement，請使用 上述 SDK，以及測試廣告代碼。

您應該會在 VAST 回應中看到傳回的 <AdVerifications>。

註冊影片控制項重疊會擋住畫面

使用暫停按鈕或進度列等影片控制項，就能提供基本播放體驗 並提供資訊與動作給使用者使用行動裝置時，不精確輕觸和使用者 因此，使用者常常需要製作方便使用者觸碰的大型圖像 控制項這些控制項通常位於 在絕大多數的播放時間中，使用者輕觸皆看不到。

以下是 YouTube 應用程式顯示的影片控制項範例：

使用 IMA SDK 時，大多數發布商會在廣告顯示容器上方加入幾乎透明的檢視畫面，藉此實作這些控制項。通常，控制項是這個檢視畫面的子元素，可完全遮蔽底層的影片播放器。這個透明疊加層用於擷取輕觸事件，然後在使用者輕觸時向使用者顯示控制項。

透過 Open Measurement SDK 計算廣告可視度時，所有觀看 覆蓋媒體元素即視為阻礙，可降低 可視率如果透明的輕觸疊加層位於整個廣告顯示容器之上，廣告空間就可能會宣告為完全無法顯示。

Open Measurement SDK 會將影片控制項視為對使用者體驗至關重要的「友善」遮蔽物。一旦註冊為友善控制項，系統就會將這些控制項排除在廣告可視度評估範圍。

支援 IAB 和 MRC 時，IMA SDK 會提供用於登錄這些 疊加在 Open Measurement SDK 上這些控制項必須是完全透明的疊加層或小按鈕。任何與影片控制項無關的檢視畫面，

DO 註冊 請勿註冊
  • 透明疊加層，用於擷取使用者輕觸動作
  • 暫時性按鈕
    • 暫停
    • 播放
    • 全螢幕
    • 投放/AirPlay
    • 收合
    • 進度/跳轉
    • 其他播放相關動作
  • 浮水印
  • 彈出式視窗
  • 對話方塊
  • 非暫時性按鈕
  • 其他遮蔽檢視畫面

以下程式碼範例示範如何註冊影片控制項疊加層 出現以下情況： 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

完成後，您可以呼叫下列方法移除這些障礙物：

displayContainer.unregisterAllFriendlyObstructions();