廣告檢查器 (Beta 版)

廣告檢查器 是應用程式內的疊加功能，可讓授權裝置即時執行 直接在行動應用程式中分析測試廣告請求 包含在 Google Mobile Ads SDK 版本中 20.2.0 以上版本，不需編寫程式碼即可啟用 這通常代表交易 不會十分要求關聯語意

使用廣告檢查器可以：

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

本指南說明如何啟動及使用廣告中的各種功能 檢查工具

必要條件

如要使用廣告檢查器，您必須：

  • 請使用 Google Mobile Ads SDK 20.2.0 或更高版本。

啟動廣告檢查器

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

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

透過偵錯選單啟動

應用程式不需變更，即可透過偵錯功能啟動廣告檢查器 ；只需尋找您 Ad Manager 聯播網放送的廣告，並按住 以兩指開啟廣告 偵錯選單然後選取「開啟廣告檢查器」。

如果您沒有連結自己的 Merchant Center 帳戶 裝置，系統可能會請你 登入 Ad Manager 帳戶

您還可以選取偵錯設定中的「廣告檢查器設定」，然後 選擇日後能自動開啟廣告檢查器的手勢 透過偵錯選單

以程式輔助方式啟動

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

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

這個 API 適用於測試裝置 已註冊 編寫程式

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

廣告檢查器啟動後，就會出現主要的廣告檢查器畫面，其中列出所有廣告 單位 因為在此期間啟用廣告檢查器，裝置已向 提出廣告請求 應用程式工作階段。這份清單中也包含已啟用公開出價、並已排序的廣告單元 按時間排序，先列出最近完成的要求，以及要求頻率最高的要求 沒有已完成的廣告請求 (已停用)：

建議您初始化 Google 行動廣告 SDK 再使用廣告檢查器

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

輕觸廣告單元，即可查看 SDK 請求記錄，瞭解 中介服務刊登序列至廣告供應期間 (或刊登序列) 沒有供應就結束的情況下)。

您可使用揭露指標展開每項要求，並顯示結果 中介服務刊登序列的對應序列，以及所有的錯誤和延遲情形 適用於該要求的所有屬性

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

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

如果您不熟悉公開出價，請參閱公開出價簡介 出價：

在 SDK 請求記錄中，您可以查看 Open Bidding 廣告來源 之間所呼叫的鍵/值輕觸 SDK 請求記錄中的廣告單元即可查看內容 競價中每個廣告來源的 Open Bidding 詳細資料。

Open Bidding 結果經過排序，方便您找出 更靠近清單頂端的可操作項目：

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

  • 接著是發生問題的廣告聯播網您可以按照 問題的疑難排解步驟 請參閱「 Open Bidding 常見問題」專區

  • 然後，有些廣告聯播網沒有傳回任何廣告，或是沒有出價。這個 可能代表廣告來源的許多不同問題 可能因為設定或決策而無法出價。您可以參考廣告 來源設定指南，或 公開出價常見問題瞭解詳情 聯絡。

  • 最後，清單底部會列出失去了 Open Bidding 競價。

中介服務刊登序列可以把贏得 Open Bidding 根據有效千次曝光出價決定競價

中介服務刊登序列是多個收益群組參與競價的結果 相同的廣告空間您最多可以在一個單一區域中新增 10 個第三方收益夥伴 收益群組，包括公開出價收益夥伴和行動裝置中介服務 應用程式收益夥伴

進階廣告單元偵錯

排解廣告單元問題時，建議您深入瞭解廣告請求 並協助您找出問題所在，或是向 Google 告知 支援偵錯功能。輕觸瀑布頂端的選單圖示 鏈結並選取「共用廣告請求和回應」，匯出完整的廣告請求 和回應這樣一來，就不必在 自己的應用程式

此外，你也可以輕觸 與請求位於相同選單的第三方出價參數選項 字串。這會詳細說明哪些第三方出價參數 協助您對應用程式進行偵錯或驗證聯播網 成功收集信號

查看可用的轉接器

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

找不到轉接程式或無法初始化時，請參閱 檢查行動應用程式廣告放送情形 瞭解詳情

測試您的廣告單元

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

廣告測試

本節介紹的廣告檢查器廣告測試是很實用的工具 驗證您的基礎廣告體驗並驗證中介服務 前提是要搭配單一廣告來源測試使用

準備好測試廣告單元時，請輕觸 [請求測試廣告] 按鈕 觸發廣告檢查器廣告測試。測試 結果會出現在 SDK 請求記錄的 Requested 來自廣告檢查器

瞭解如何在 應用程式

單一廣告來源測試

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

如要啟用這項功能，請將「單一廣告來源測試」切換鈕設為 。系統隨即會顯示下列廣告來源選取對話方塊：

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

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

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

重新啟動應用程式後，所有廣告單元刊登位置會嘗試顯示 僅所選網路。單一廣告來源測試出現時，啟動廣告檢查器 「有效」會顯示有效的測試廣告來源：

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

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

您在中介服務中加入了多個所選廣告來源例項 瀑布圖中，您會看到每個對廣告來源的呼叫 刊登序列，直到廣告已供應廣告，或刊登序列沒有廣告供應為止。

停止單一廣告來源測試

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

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

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

複製整個偵錯輸出內容

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

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