Google 互動式媒體廣告 SDK 常見問題


為什麼我無法取回所有格式的廣告?
測試廣告代碼的設定是一律針對有效請求傳回廣告。這麼做是為了方便整合,並讓您更輕鬆測試玩家如何要求及顯示廣告。不過,廣告不一定適用於網站、帳戶或廣告單元的所有格式。如果整合作業適用於測試代碼,但不適用於您自己的代碼,原因可能是下列任一項:
  • 您在環境中放送的影片格式不受支援。例如,您只向 iOS 或 Android 放送 HTML5 廣告。
  • 如果您使用 Ad Manager,您的發布商 ID 目前可能沒有任何指定廣告。此外,請確認您已在 Ad Manager 中核准相關廣告和廣告素材。
  • 如果您使用 AdSense,網站或測試網頁的指定條件可能沒有任何有效的廣告。最常見的原因是 私人且未檢索的網站。
  • 如果您使用 Ad Exchange 聯播網夥伴管理功能,但未設定 descriptionURL,或該網域不在自有或經營的網域管理清單中,系統就不會放送廣告。
  • 查看 Ad Exchange 影片廣告中定義的「最低千次曝光出價」門檻。minCPM千次曝光出價偏高可能導致供應率偏低。如要修正這個問題,請嘗試從廣告請求 (即 slotname) 中移除 minCPM 或廣告單元參數,以驗證這是否會影響供應率。
理想的 descriptionUrl 長什麼樣?
為達到最佳成效,descriptionUrl 所指向的網頁內容不應是字詞或詞組的集合,而應是 1 到 3 段實際描述內容,以及您在提供內容時所扮演的角色。我們過去已將其成功 根據預先定義區塊動態建立「descriptionUrl」網頁內容。 例如,這是幾個用來描述內容的句子、幾個用來說明 而是一些預先定義的摘要 AdSense 頻道 (例如「娛樂」或「運動」)。因此,每部內容都會與一組相當獨特的 descriptionUrl 相關聯,提供一般資訊 (例如類型描述符) 和特定資訊 (直接關於內容的內容)。

這個中繼資料 HTML 應該要很簡潔,例如:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
  
為什麼我會收到「廣告回應不含有效的廣告類型」錯誤訊息?
這個錯誤通常出現,因為您並未將任何廣告指定至 特定 publisherId (在指定時間範圍內)。這項條件可能會在一天或數天內因廣告活動的開始和結束而變動。請檢查要指定的廣告尚未過期 廣告指定條件正確無誤。 只要廣告能正確使用測試 publisherId 進行要求、接收及算繪,您就可以確保在廣告可用時,系統會使用您的實際 publisherId 正確處理這些廣告。
您是否有 Ad Manager 影片廣告代碼,可供我用於測試?
您可以在「範例代碼」頁面中找到範例代碼。
我應該將 adSlotWidthadSlotHeight 設為相同的值 做為 Ad Manager 廣告代碼中的 sz 嗎?
不一定。adSlotWidthadSlotHeight 必須設為播放器的寬度/高度,或您希望廣告填入的區域。AdSense 會使用這些資訊,判斷哪些廣告可放入該空間。Ad Manager 廣告代碼中的 sz 鍵/值組合為 指定目標參數,不一定會影響放送的廣告素材 (詳情請見下文)。
示範的廣告代碼看起來很棒,但是當我切換成我的廣告代碼時,卻沒有出現廣告。
檢查以確定有廣告投放至您的廣告代碼 資源。最簡單的方法就是觀察 HTTP 流量。如果 HTML 錨點區塊中傳回 1x1 像素灰色.gif 圖片,您就需要在 Ad Manager 中檢查指定目標。
我想多次使用相同代碼來請求廣告,但只產生第一個廣告 請求。該如何解決這個問題?
多次請求廣告時,請務必讓廣告伺服器知道 這些是合法要求,並非意外重複。SDK 會透過兩個快速的 API 呼叫為您完成這項操作:
  1. AdsManager 例項上呼叫 destroy()。這樣當您以下列呼叫 contentComplete()。您可獲得新的 AdsManager 有助於您提出下一個要求
  2. AdsLoader 例項上呼叫 contentComplete()。這會重設 SDK,讓新的廣告請求不會看起來像是先前的廣告請求的複本。
在發出上述兩個呼叫後,您可以在 AdsLoader 例項上呼叫 requestAds(),取得另一組廣告,以便在新的影片中播放。
如何使用 IMA SDK 要求疊加和全版 AdSense 廣告?

如要使用 SDK 請求 AdSense 廣告,您必須先取得 AdSense 廣告代碼。詳細資訊請見 AdSense 。取得代碼後,您必須採取下列步驟,才能提出疊加或全版廣告版位廣告請求:

重疊廣告
  1. AdsRequest 中,將 ViewMode 設為 NORMAL
  2. 在廣告代碼中,新增參數 overlay=1
全版位廣告
  1. AdsRequest 中,將 ViewMode 設為 FULLSCREEN
  2. 在廣告代碼中,新增參數 overlay=0
點選廣告時,我收到「到達網址無效」錯誤訊息。可能的原因為何?
這個錯誤最常見的原因是點擊率網址未正確逸出。如果您看到這則錯誤訊息,請確認點閱網址在 VAST 回應中是否已正確逸出。
在 Android 和 iOS SDK 中,有辦法將整個影片廣告設為可點擊嗎?
就整部影片的點擊追蹤而言,行動裝置影片的標準觀眾體驗是輕觸影片後,影片會暫停或顯示播放器控制項。為避免使用者在想使用播放器控制項時,不小心點按廣告,IMA 會使用「Learn more」按鈕,讓使用者點按廣告,進一步瞭解廣告產品。
為什麼我會看到「VAST Document Empty」錯誤?
如果廣告代碼傳回空白的 VAST 文件,就會發生這個錯誤。 廣告無法正常放送請與客戶經理或廣告伺服器代表聯絡,瞭解廣告代碼無法運作的原因。
我可以變更「略過廣告」方塊或其他 UI 元素的大小/文字嗎?
IMA SDK 不支援變更 UI 元素的版面配置、大小或內容。 如要進一步瞭解 UI 元素,請參閱 AdsManager.uiElements
為什麼我無法在 iOS 上調整廣告的音量?
iOS 不允許您以程式輔助方式設定音量。如果您使用 HTML5 SDK,adsManager.setVolume() 就不會生效。因此,iOS SDK 不會在 IMAAdsManager 上提供音量設定器。
我可以使用多個執行緒來初始化及操作 UI 嗎?
所有 UI 初始化作業都必須在主執行緒上完成。初始化後,您可以選擇實作背景廣告播放