廣告檢查器

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

使用廣告檢查器可以:

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

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

先備知識

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

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

啟動廣告檢查器

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

  1. 從偵錯選單中點選啟動按鈕
  2. 使用您在廣告檢查器設定中選取的手勢。
  3. 使用提供的 API,透過程式輔助方式建立。

透過偵錯選單啟動

您不需要對應用程式進行任何變更,即可透過偵錯選單啟動廣告檢查器;只要找出 Ad Manager 聯播網放送的廣告,然後用兩指按住廣告,即可開啟偵錯選單。然後選取「開啟廣告檢查器」

您也可以從偵錯設定中選取「廣告檢查器設定」,然後選擇可讓日後開啟廣告檢查器的手勢,而不必瀏覽偵錯選單。

以程式輔助方式啟動

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

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

此 API 適用於透過程式輔助方式或 AdMob UI 註冊

查看及解決廣告單元相關問題

廣告檢查器啟動後,主要畫面會列出 AdMob UI 中,與 AdMob 應用程式 ID 相關聯,且具有出價或中介服務設定的所有廣告單元 因為在此應用程式工作階段期間啟用廣告檢查器,裝置已發出廣告請求。清單中也包含已啟用公開出價的廣告單元、先按照最近完成的請求時間排序,以及沒有已完成廣告請求 (調暗) 的廣告單元:

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

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

輕觸廣告單元,即可查看 SDK 請求記錄,其中會針對最新廣告請求提供廣告填入 (或結束未供應廣告的刊登序列) 為止的中介服務刊登序列詳細資料。

每項要求都可以使用揭露指標展開,顯示該請求的中介服務刊登序列結果,以及適用於該請求的任何錯誤和延遲時間。

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

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

如果您是公開出價的新手,請參閱公開出價簡介

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

系統會排序 bidding 結果,讓可操作項目更靠近清單頂端:

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

  • 接著是發生問題的廣告聯播網您可以按照 bidding 常見問題結尾的問題疑難排解步驟

  • 然後,有些廣告聯播網沒有傳回任何廣告,或是沒有出價。這可能代表廣告來源的許多不同問題,因為廣告來源可能會因設定或決策而缺乏出價。請參閱廣告來源的設定指南,或 公開出價常見問題,取得進一步支援。

  • 最後,清單底部會列出失去bidding 競價的廣告聯播網。

中介服務刊登序列可根據有效千次曝光出價,決定贏得競價的廣告來源bidding 。

中介服務刊登序列是多個收益群組競爭相同廣告空間的結果。您最多可以在單一收益群組中加入十個第三方收益夥伴,包括公開出價收益夥伴和行動應用程式收益夥伴的中介服務。

進階廣告單元偵錯

排解廣告單元問題時,建議您深入瞭解廣告請求和回應,找出發生問題的原因,或與 Google 支援團隊聯絡來協助偵錯。輕觸刊登序列鏈頂端的選單圖示,然後選取「分享廣告請求和回應」,匯出完整的廣告請求和回應。如此一來,您就不必在自己的應用程式上執行網路追蹤。

此外,您也可以查看經過解碼的第三方出價參數,方法是在要求字串相同的選單中輕觸「第三方出價參數」選項。這會提供詳細資料,指出哪些第三方出價參數可能有問題,協助您對應用程式進行偵錯,或驗證聯播網是否已成功收集信號。

Android
iOS

查看可用的轉接器

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

如果系統找不到轉接程式或無法初始化,請參閱: 檢查行動應用程式廣告放送情形 瞭解詳情。

Android
iOS

測試您的廣告單元

如果您希望在不前往應用程式使用者介面的情況下測試廣告單元,廣告檢查器可直接在廣告單元詳細資料畫面上支援這項功能。此外,您還可以一次測試多個廣告單元、以非同步方式載入並查看測試廣告請求,甚至執行單一廣告來源測試。

廣告測試

本節所述的廣告檢查器廣告測試非常適合用來驗證基礎廣告體驗,以及在使用單一廣告來源測試時驗證中介服務設定。

準備好測試廣告單元時,請輕觸廣告檢查器畫面頂端的「請求測試廣告」按鈕,觸發廣告檢查器廣告測試。測試結果會顯示在 SDK 要求記錄中,位於 Requested from ad Inspector 標頭下方的。

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

單一廣告來源測試

廣告檢查器可用來限制應用程式中的廣告請求,只放送單一 bidding 或刊登序列中介服務廣告來源的廣告。這可讓您確認是否已正確導入第三方轉接程式,以及廣告來源是否正常放送。

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

您必須先初始化 Google Mobile Ads SDK,才能使用單一廣告來源測試。

然後選取一個要測試的廣告來源。選取廣告來源後,畫面會出現以下畫面:

單一廣告來源測試設定會套用至日後在相同工作階段提出的所有廣告請求。不過,這項設定不會套用至該工作階段中先前尚未顯示的任何快取廣告。套用單一廣告來源測試時,建議強制重新啟動應用程式,藉此使任何可能放送的快取廣告失效,而非由您選擇的廣告來源接收請求。

重新啟動應用程式後,所有廣告單元刊登位置都會嘗試只顯示所選聯播網的廣告。在單一廣告來源測試有效時顯示有效測試廣告來源時,啟動廣告檢查器:

在單一廣告來源測試模式中,不論廣告來源是否已為要求的廣告單元設定出價或中介服務,所有廣告請求都會嘗試以選定的廣告來源供應廣告。如果測試的廣告來源不在廣告單元的中介服務刊登序列中,您會收到「未供應」的錯誤訊息。

在單一廣告來源測試中,您可以輕觸廣告單元來查看 SDK 請求記錄。此圖表可讓您瞭解在啟用單一廣告來源測試後,廣告來源是否供應廣告請求。如果廣告來源無法載入廣告,系統會顯示錯誤訊息說明錯誤。

如果您在中介服務刊登序列中加入了所選廣告來源的多個例項,那麼在廣告供應完畢或刊登序列未有供應的情況下結束為止,您就會看到刊登序列中廣告來源的每個呼叫例項。

停止單一廣告來源測試

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

接著進入以下重新啟動畫面,畫面上會顯示確認訊息:

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

複製整個偵錯輸出內容

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

如要這麼做,請輕觸應用程式圖示七次,直到看見「已將廣告檢查器 JSON 複製到剪貼簿」訊息為止。