啟用 Open Measurement

適用於 iOS 的互動式媒體廣告 (IMA) SDK。

iOS 適用的 IMA SDK 包含Open Measurement (OM) SDK,這是互動廣告協會 (IAB) 開發的業界標準,可評估第三方可視度和驗證。使用適用於 iOS 的 IMA SDK 時,內含的 OM SDK 會自動剖析 VAST 廣告代碼中的 <AdVerifications> 標記,並透過 OMID API 將可視度資料傳送給指定的評估供應商。IMA SDK 支援 OM SDK v1.4、VAST 2 以上版本的 GAM AdVerifications 擴充功能,以及 VAST 4 以上版本的 AdVerifications 節點。如要善用開放式評估功能,請注意下列事項:

  • 如要使用 Open Measurement,您必須具備 3.9.0 以上版本的 iOS 專用 IMA SDK。

  • 如果使用 VAST 4.1 以上版本,廣告必須設定為在 VAST 中放送 <AdVerifications>,詳情請參閱 VAST 4.1 規格;否則應使用 <Extension type="AdVerifications">

  • 請勿使用任何疊加層 (透明或不透明) 遮蓋 AdDisplayContainer,否則 OM SDK 會將這些疊加層標示為障礙物,進而降低可視度。

必要條件

測試

如要使用 IMA SDK 測試公開測量功能,請使用上述任一必要版本的 SDK,以及測試廣告代碼

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

註冊影片控制項重疊障礙

暫停按鈕或進度列等影片控制項可為使用者提供重要的播放資訊和動作。在行動裝置上,使用者經常會誤觸,且對操作體驗有一定期望,因此在媒體元素上顯示大型觸控友善的控制項已成為常見做法。這些控制選項通常會在使用者輕觸時淡入和淡出,且在大部分播放時間內都不會顯示。

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

使用 IMA SDK 時,大多數發布商會透過在廣告顯示容器上方新增檢視區塊 (大部分為透明),實作這些控制項。通常,控制項是這個檢視區塊的子項元素,會完全遮蔽底層的影片播放器。這個透明的疊加層可用來擷取輕觸事件,並在使用者輕觸時向他們顯示控制項。

計算透過 Open Measurement SDK 評估的廣告可視度時,系統會將所有重疊在媒體元素上的檢視畫面視為阻礙,並降低可視度。如果透明輕觸重疊層位於整個廣告顯示容器上方,則廣告空間可能會完全無法檢視。

Open Measurement SDK 會將影片控制項視為「友善」的障礙,因為這些控制項對使用者體驗至關重要。註冊為友善控制項後,這些控制項就不會納入廣告可視度評估。

IMA SDK 支援 IAB 和 MRC,並推出 API,可向 Open Measurement SDK 註冊這些重疊畫面。這些控制項必須是完全透明的疊加層或小按鈕。與影片控制項無關的任何其他檢視畫面不得註冊。

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

下列程式碼範例示範如何在廣告顯示容器上註冊影片控制項疊加層:

UIView *myTransparentTapOverlay = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 250)];
UIButton *myPauseButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 50, 10)];
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the elements
// you want to register as video controls overlays.
// Make sure to register before ad playback starts.
IMAFriendlyObstruction *overlayObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myTransparentTapOverlay
                                           purpose:IMAFriendlyObstructionPurposeNotVisible
                                    detailedReason:@"This overlay is transparent"];
IMAFriendlyObstruction *pauseButtonObstruction =
      [[IMAFriendlyObstruction alloc] initWithView:myPauseButton
                                           purpose:IMAFriendlyObstructionPurposeMediaControls
                                    detailedReason:@"This is the video player pause button"];

[displayContainer registerFriendlyObstruction:overlayObstruction];
[displayContainer registerFriendlyObstruction:pauseButtonObstruction];

完成後,呼叫下列方法即可移除這些障礙物:

[displayContainer unregisterAllFriendlyObstructions];