您可以透過廣告檢查器執行以下操作：
- 檢查廣告單元
- 檢查廣告是否正常供應
- 找出錯誤並查看詳細的問題解決方法
- 查看每個請求的每個出價廣告聯播網詳細資料
- 查看每項請求的各個廣告聯播網中介服務詳細資料
- 測試個別第三方出價或刊登序列中介服務廣告來源
- 確認您已正確設定各個廣告單元的出價和瀑布式中介服務
本指南將說明如何啟動及使用廣告檢查器中的不同功能。
必要條件
如要使用廣告檢查器，您必須：
- 完整閱讀入門指南
- 使用 Mobile Ads Flutter 外掛程式 1.3.0 以上版本。
- 啟用測試模式或將裝置連結至 Ad Manager。廣告檢查器只會在測試裝置或已連結的裝置上啟動。
啟動廣告檢查器
您可以透過以下方式，從應用程式的任意位置啟動廣告檢查器：
- 從偵錯選單中點選啟動按鈕
- 使用在廣告檢查器設定中選取的手勢。
- 透過程式使用提供的 API。
使用偵錯選單啟動
您不需要對應用程式進行任何變更，即可透過偵錯選單啟動廣告檢查器；只要找出 Ad Manager 聯播網放送的廣告，然後用兩指按住廣告，即可開啟偵錯選單。接著選取「開啟廣告檢查器」。
如果您尚未連結裝置，系統可能會要求登入 Ad Manager 帳戶。
您也可以從偵錯設定中選取「廣告檢查器設定」，並選擇手勢，以便日後不必透過偵錯選單，就能開啟廣告檢查器。
以程式輔助方式啟動
您也可以透過程式輔助方式啟動廣告檢查器：
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
這個 API 適用於透過程式輔助方式註冊的測試裝置。
查看廣告單元並排解相關問題
啟動後，畫面上會出現主要的廣告檢查器畫面，其中包含裝置在此應用程式工作階段啟用後，裝置曾發出廣告請求的所有廣告單元清單。清單中也會列出已啟用出價的廣告單元，並依時間順序排序，最近完成的請求會排在最前面，而未完成的廣告請求則會顯示為灰色：
建議您在使用廣告檢查器前，先初始化 Google Mobile Ads SDK。
查看廣告單元的中介服務刊登序列詳細資料
輕觸廣告單元即可查看 SDK 請求記錄，該記錄會詳細列出中介服務刊登序列，直到為最新的廣告請求供應廣告為止 (或刊登序列未有供應就結束)。
您可以使用揭露指標展開每個要求，查看該要求的中介服務刊登序列結果，以及該要求適用的任何錯誤和延遲時間。
如果是第三方廣告來源，系統會直接從廣告來源傳送錯誤訊息。如需詳細資訊，請洽詢第三方廣告來源。
查看廣告單元的出價詳細資料
如果您不熟悉出價，請參閱公開出價簡介。
您可以在 SDK 請求記錄中，查看在廣告請求中呼叫的出價廣告來源。輕觸 SDK 請求記錄中的廣告單元，即可查看出價競價中每個廣告來源的詳細資料。
出價結果會依序排序，讓可執行項目更靠近清單頂端：
頂端是贏得競價的廣告聯播網。
接下來是發生問題的廣告聯播網。您可以按照出價常見問題的最後疑難排解步驟排解問題。
接著，我們會看到沒有傳回廣告或未出價的廣告聯播網。這可能代表廣告來源的許多不同問題，因為廣告來源可能會因設定或決策而缺乏出價。如需更多支援資訊，請參閱廣告來源的設定指南或公開出價常見問題。
最後，清單底部會顯示輸掉出價競價的廣告聯播網。
中介服務刊登序列可根據有效千次曝光出價，將勝出出價競價的廣告來源排入刊登序列。
中介服務瀑布是多個收益群組爭取相同廣告空間的結果。您最多可以在單一收益群組中加入十個第三方收益夥伴，包括出價收益夥伴和行動應用程式收益夥伴的中介服務。
進階廣告單元偵錯
排解廣告單元問題時，您可以深入瞭解廣告請求和回應，找出失敗的原因，或是與 Google 支援團隊分享，以利進行偵錯。輕觸瀑布流程鏈結頂端的選單圖示，然後選取「分享廣告請求和回應」，即可匯出完整的廣告請求和回應。這樣一來，您就不必在自己的應用程式上執行網路追蹤作業。
此外，您也可以輕觸與請求字串相同選單中的「第三方出價參數」選項，查看已解碼的第三方出價參數。這項資訊會詳細說明哪些第三方出價參數可能有問題，協助您對應用程式進行偵錯，或驗證聯播網是否已成功收集信號。
|
|
查看可用的轉接程式
按一下「轉接程式」分頁，即可查看應用程式中出價或中介服務設定中與廣告來源相關聯的所有第三方轉接程式清單。接著，展開資訊卡，即可查看其初始化狀態和 SDK 版本。除了支援的第三方轉接程式，您也可以查看自訂事件轉接程式。自訂事件可讓發布商使用 Ad Manager 不支援的廣告聯播網。自訂事件與轉接程式清單中的標準第三方轉接程式不同，是其專屬的類別名稱。除了提供類別名稱和狀態資訊，廣告檢查器也會在 Ad Manager 網頁介面中顯示指派給這些自訂事件的標籤。
如果系統找不到轉接程式或無法初始化，請參閱「檢查行動應用程式廣告放送」一文瞭解詳情。
|
|
測試您的廣告單元
如果您想測試廣告單元，但不必在應用程式 UI 中前往該單元，廣告檢查器可直接在廣告單元詳細資料畫面中支援這項功能。此外，您還可以一次測試多個廣告單元、以非同步方式載入並查看測試廣告請求，甚至執行單一廣告來源測試。
廣告測試
本節所述的廣告檢查器廣告測試非常適合用來驗證基礎廣告體驗，以及在使用單一廣告來源測試時驗證中介服務設定。
準備好測試廣告單元時，請輕觸廣告檢查器畫面頂端的「請求測試廣告」按鈕，觸發廣告檢查器廣告測試。接著，測試結果會顯示在 SDK 請求記錄中，位於「Requested from Ad Inspector」標頭下方。
單一廣告來源測試
廣告檢查器可用來限制應用程式中的廣告請求，只能放送單一出價或刊登序列中介服務廣告來源的廣告。這可讓您確認是否已正確導入第三方轉接程式，以及廣告來源是否正常放送。
如要啟用這項功能，請切換畫面底部的「單一廣告來源測試」切換鈕。系統會顯示下列廣告來源選取對話方塊：
您必須先初始化 Google Mobile Ads SDK，才能使用單一廣告來源測試。
然後選取一個要測試的廣告來源。選取廣告來源後，畫面上會顯示下列畫面：
單一廣告來源測試設定會套用至日後在相同工作階段提出的所有廣告請求。不過，這項設定不會套用至先前快取的廣告，如果該廣告尚未顯示，就不會套用。套用單一廣告來源測試時，建議您強制重新啟動應用程式，以便讓系統無效化任何可能會放送的快取廣告，而非您所選的廣告來源收到請求。
重新啟動應用程式後，所有廣告單元刊登位置都會嘗試僅顯示所選聯播網的廣告。在單一廣告來源測試處於啟用狀態時啟動廣告檢查器，即可查看目前測試的廣告來源：
在單一廣告來源測試模式中，無論所選廣告來源是否已針對要求的廣告單元進行出價或中介服務設定，所有廣告請求都會嘗試透過該廣告來源進行供應。如果測試的廣告來源不在廣告單元的中介服務刊登序列中，您會收到「未供應」的錯誤訊息。
在單一廣告來源測試中，您可以輕觸廣告單元來查看 SDK 請求記錄。此圖表可讓您瞭解在啟用單一廣告來源測試後，廣告來源是否供應廣告請求。如果廣告來源無法載入廣告，系統會顯示錯誤訊息，說明錯誤原因。
如果您在中介服務刊登序列中加入了所選廣告來源的多個例項，那麼在廣告供應完畢或刊登序列未有供應的情況下結束為止，您就會看到刊登序列中廣告來源的每個呼叫例項。
停止單一廣告來源測試
如要停止測試，請將切換鈕設為關閉：
系統會在下列重新啟動畫面上方顯示確認訊息：
建議您在停止測試後強制重新啟動應用程式，以便讓系統將測試廣告來源的所有快取廣告設為無效。
複製整個偵錯輸出內容
廣告檢查器支援複製含有工具中整個偵錯輸出內容的 JSON 字串，包括 Ad Manager 應用程式的詳細資料、轉接程式初始化狀態，以及所有廣告單元的測試結果。
方法是輕觸應用程式圖示七次，直到畫面上顯示「已將廣告檢查器 JSON 複製到剪貼簿」訊息為止。