廣告檢查器

廣告檢查器 是應用程式內的疊加功能,可讓授權裝置直接在行動應用程式中即時分析測試廣告請求。 您可以啟用這項功能,無須編寫程式碼。

行動廣告 Unity 7.0.0 以上版本,你可以:

  • 檢查廣告單元
  • 檢查第三方轉接程式
  • 檢查廣告是否正常供應
  • 找出錯誤並查看詳細的問題解決方法
  • 查看每個要求中每個廣告聯播網的出價和刊登序列中介服務詳細資料
  • 測試個別第三方出價和中介服務廣告來源
  • 確認每個廣告單元已正確設定出價和 刊登序列中介服務

  • 測試自訂事件整合

本指南將說明如何啟動及使用廣告檢查器中的不同功能。

必要條件

如要使用廣告檢查器,您必須:

  • 使用行動廣告 Unity 外掛程式版本 7.0.0 以上版本。

啟動廣告檢查器

您可以透過以下方式,從應用程式的任意位置啟動廣告檢查器:

  1. 註冊測試裝置時,請使用 AdMob 使用者介面中選取的手勢。
  2. 透過程式使用提供的 API
  3. 從偵錯選單中點選啟動按鈕

使用手勢啟動

您不需要對應用程式做出任何變更,就能以手勢啟動廣告檢查器。只要 執行您在 AdMob 中設定 測試裝置的 Cookie。瞭解詳情

在 AdMob UI 中設定手勢 (並等待 15 分鐘讓設定生效) 後,應用程式需要向 Google Mobile Ads SDK 發出廣告請求,才能瞭解手勢設定。如果指定的手勢無法運作,請嘗試載入廣告、重新啟動應用程式,然後再次測試手勢。

以程式輔助方式啟動

您也可以透過程式輔助方式啟動廣告檢查器:

public void OnButtonClick() {
  MobileAds.OpenAdInspector((AdInspectorError error) =>
  {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

這個 API 適用於測試裝置 已註冊

查看廣告單元並排解相關問題

啟動後,畫面上會顯示主要廣告檢查器畫面,其中列出 AdMob UI 中與 AdMob 應用程式 ID 相關聯的所有廣告單元,這些廣告單元具有出價或中介服務設定:

建議您在使用廣告檢查器前,先初始化 Google Mobile Ads SDK

查看廣告單元的中介服務刊登序列詳細資料

輕觸廣告單元即可查看 SDK 請求記錄,該記錄會詳細列出中介服務刊登序列,直到最新廣告請求供應廣告為止 (或刊登序列未有供應就結束)。

您可以使用揭露指標展開每個要求,查看該要求的中介服務刊登序列結果,以及該要求適用的任何錯誤和延遲時間。

如果是第三方廣告來源,系統會直接從廣告來源傳送錯誤訊息。如需詳細資訊,請洽詢第三方廣告來源。

查看廣告單元的出價詳細資料

如果您不熟悉出價,請參閱總覽

在 SDK 請求記錄中,您可以查看 廣告請求來源。輕觸 SDK 請求記錄中的廣告單元,即可查看出價競價中每個廣告來源的詳細資料。

系統會排序出價結果,讓可執行的項目更靠近清單頂端:

  • 頂端是贏得競價的廣告聯播網。

  • 接下來是發生問題的廣告聯播網。您可以按照 問題的疑難排解步驟

  • 接著,我們會看到沒有傳回廣告或未出價的廣告聯播網。這可能表示廣告來源有許多問題,因為廣告來源可能因設定或決策而無法出價。您可以參閱廣告來源的設定指南,也可以直接與廣告來源聯絡尋求支援

  • 最後,清單底部會顯示輸掉出價競價的廣告聯播網。

中介服務刊登序列可根據有效千次曝光出價,將勝出出價競價的廣告來源排入刊登序列。

中介服務刊登序列呼叫廣告來源後,就能放送廣告。 如要進一步瞭解出價與中介服務刊登序列的運作方式,請參閱範例 2範例 3,瞭解中介服務群組中的出價和刊登序列廣告來源。

進階廣告單元偵錯

排解廣告單元問題時,建議您深入瞭解廣告請求 並協助您找出問題所在,或是向 Google 告知 支援偵錯功能。輕觸瀑布流程鏈結頂端的選單圖示,然後選取「分享廣告請求和回應」,即可匯出完整的廣告請求和回應。這樣一來,您就不必在自己的應用程式上執行網路追蹤作業。

此外,您也可以輕觸與要求字串相同的選單中的「第三方出價參數」選項,查看已解碼的第三方出價參數。這會詳細說明哪些第三方出價參數 協助您對應用程式進行偵錯或驗證聯播網 成功收集信號

Android
iOS

查看可用的轉接程式

按一下「轉接程式」分頁,即可查看應用程式中出價或中介服務設定中與廣告來源相關聯的所有第三方轉接程式清單。接著,展開資訊卡,即可查看其初始化狀態和 SDK 版本。除了支援的第三方轉接程式,您也可以查看自訂事件轉接程式。自訂事件可讓發布商使用 AdMob不支援的廣告聯播網。自訂事件與標準第三方有區別 轉接器清單中的轉接器 (依其專屬的類別名稱) 排序。除了 提供類別名稱和狀態資訊,廣告檢查器也會顯示 指派給這些自訂事件的標籤 AdMob 網頁介面上。

找不到轉接程式或無法初始化時,請參閱 使用廣告檢查器解決發現的問題 瞭解詳情

Android
iOS

測試廣告單元

如果您想測試廣告單元,但不必在應用程式的 UI 中前往,廣告檢查器可直接在廣告單元詳細資料畫面中支援這項功能。此外,您還可以同時測試多個廣告單元、非同步載入及查看測試廣告請求,甚至執行單一廣告來源測試。

廣告測試

本節所述的廣告檢查器廣告測試,是驗證基礎廣告體驗的絕佳工具,可與單一廣告來源測試搭配使用,驗證中介服務設定。

準備好測試廣告單元時,請輕觸 [請求測試廣告] 按鈕 觸發廣告檢查器廣告測試。接著,測試結果會顯示在 SDK 請求記錄中,位於「Requested from Ad Inspector」標頭下方。

瞭解如何在應用程式中使用廣告檢查器

單一廣告來源測試

廣告檢查器一項功能,可限制應用程式中廣告請求只能放送 來自單一出價或刊登序列中介服務廣告來源的廣告。這之後 已正確導入第三方轉接程式,且廣告來源已正確導入 是否正常放送

如要啟用這項功能,請切換畫面底部的「單一廣告來源測試」切換鈕。系統會顯示下列廣告來源選取對話方塊:

Android
iOS

您必須初始化 Google 行動廣告 SDK ,才能使用單一廣告來源測試

接著,您可以選取單一廣告來源進行測試。選取廣告來源後,畫面上會顯示下列畫面:

單一廣告來源測試設定會套用至日後提出的所有廣告請求 在同一個工作階段不過,系統不會將之前快取過的廣告 表示每個工作階段都尚未顯示建議您強制重新啟動應用程式 來執行單一廣告來源測試,以撤銷 ,而不是您選擇的廣告來源接收請求。

重新啟動應用程式後,所有廣告單元刊登位置都會嘗試僅顯示所選聯播網的廣告。在單一廣告來源測試處於啟用狀態時啟動廣告檢查器,即可查看目前測試中的廣告來源:

在單一廣告來源測試模式中,無論所選廣告來源是否已針對所要求廣告單元的出價或中介服務進行設定,所有廣告請求都會嘗試透過該廣告來源進行供應。如果您要測試的廣告來源不在 如果某個廣告單元的中介服務刊登序列 會顯示「未供應廣告」錯誤訊息。

在單一廣告來源測試中,只要輕觸廣告單元,即可查看 SDK 請求記錄。 瞭解廣告來源能否為之後提出的廣告請求供應廣告 已啟用單一廣告來源測試。如果廣告來源無法載入廣告,系統會顯示錯誤訊息,說明錯誤原因。

如果您已在某個中介服務刊登序列中加入了所選廣告來源的多個例項,那麼在廣告供應前或刊登序列未有供應就結束時,刊登序列會顯示該廣告來源的各個呼叫例項。

停止單一廣告來源測試

如要停止測試,請將切換鈕設為關閉:

系統會在下列重新啟動畫面上方顯示確認訊息:

建議您在停止測試後強制重新啟動應用程式,以便 使受測廣告來源的任何快取廣告失效。

複製整個偵錯輸出內容

廣告檢查器支援複製 JSON 字串,其中包含工具的完整偵錯輸出內容,包括AdMob 應用程式的詳細資料、轉接器初始化狀態,以及所有廣告單元的測試結果。

方法是輕觸應用程式圖示七次,直到畫面上顯示「已將廣告檢查器 JSON 複製到剪貼簿」訊息為止。