廣告檢查器

廣告檢查器 這是應用程式內的重疊元素,可讓已授權的裝置直接在行動應用程式中即時測試測試廣告請求。 這是 Google Mobile Ads SDK 版本 20.0.0 及更高版本, 無需程式碼即可啟用。

在低於20.2.0的 Mobile Ads SDK 版本中使用廣告檢查器,您可以:

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

如果是 Mobile Ads SDK 20.2.0 以上版本,您還可以:

  • 查看每個請求的廣告聯播網出價詳細資料
  • 分別查看每個廣告聯播網的出價和刊登序列中介服務詳細資料
  • 測試個別第三方出價或刊登序列中介服務廣告來源
  • 確認您已正確設定每個廣告單元的出價和刊登序列中介服務

本指南說明如何在廣告檢查器中啟動並使用各種功能。

事前準備

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

  • 完整閱讀入門指南

  • 請使用 Google Mobile Ads SDK 20.0.0 以上版本。

啟動廣告檢查器

您可以從應用程式的任何位置啟動廣告檢查器。您可以透過下列三種方式啟動廣告檢查器。

  1. 註冊測試裝置時,請使用 AdMob 使用者介面中選取的手勢。

  2. 透過程式使用提供的 API

  3. 使用偵錯選單中的啟動按鈕。

使用手勢啟動

您完全不需要做任何調整,就能讓應用程式透過手勢啟動廣告檢查器。只要執行您在 AdMob 中為該測試裝置設定的手勢 (快轉或搖晃)。瞭解詳情

在 AdMob 使用者介面中完成手勢 (並等候 15 分鐘,經過該動作之後),應用程式就必須對 Google Mobile Ads SDK 發出廣告請求,以瞭解您的手勢設定。如果您指定的手勢無法運作,請嘗試載入廣告並重新啟動應用程式,然後再次測試手勢。

透過程式啟動

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

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

這個 API 可在透過程式註冊 或在 AdMob 使用者介面中測試的測試裝置使用。

按廣告單元查看最近的廣告請求結果

此應用程式工作階段自啟用廣告檢查器後,裝置就發出廣告請求。

系統會按時間先後順序排序廣告單元,以及最近完成的要求。如上所示,沒有完成請求的已知廣告單元會變暗。

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

查看可用的轉接器

前往「轉接程式」分頁,您可以在「出價」或「中介服務設定」中,查看與廣告來源相關聯的所有第三方轉接程式清單,以及這些交易的初始化狀態。如果找不到轉接程式或無法初始化轉接,請參閱說明中心文章來排解問題。

除了支援的第三方轉接程式之外,您也可以查看自訂事件轉接程式;自訂事件可讓發布商使用 AdMob 不支援的廣告聯播網。自訂事件可以和標準第三方調整器一起根據類別名稱辨識在事件清單中,如下所示:

除了提供類別名稱和狀態資訊之外,廣告檢查器也會在 AdMob 使用者介面中提供指派給該類別的標籤。

查看 bidding 廣告單元詳情

必要條件:Google Mobile Ads SDK 20.2.0 或更高版本

如果您是第一次使用出價,請參閱出價總覽

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

輕觸 [查看所有出價方] 連結,查看為廣告單元設定的 bidding 所有廣告聯播網。系統會排序bidding 結果,以便將可排序的項目移到清單頂端:

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

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

  • 有些廣告聯播網沒有傳回任何廣告,或是沒有出價。這是廣告來源的許多不同問題,可能原因在於廣告來源設定或決策可能沒有出價。請參閱廣告來源的設定指南,或 直接與廣告來源聯絡以取得支援

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

中介服務刊登序列可根據哪個有效千次曝光出價,將勝出的廣告來源設為bidding

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

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

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

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

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

執行單一廣告來源測試

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

如要啟用這項功能,請切換畫面底部的 [單一廣告來源測試] 切換按鈕。這樣就會看到下列廣告來源選取對話方塊:

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

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

單一廣告來源測試設定會套用到您在相同工作階段日後發出的任何廣告請求。但不會套用到該工作階段先前未顯示的任何快取廣告。套用單一廣告來源測試時,建議您強制重新啟動應用程式,以便撤銷可能會放送的任何快取廣告,而不是選擇接收請求的廣告來源。

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

在單一廣告來源測試模式中,無論廣告請求是針對所請求的廣告單元設定出價或中介服務,所有廣告請求都會嘗試透過所選廣告來源供應廣告。也就是說,如果重新測試的廣告來源不在廣告單元的中介服務刊登序列中,您就會看見「未供應廣告」錯誤訊息。

在單一廣告來源測試中,您可以輕觸廣告單元來查看 SDK 請求記錄。 並瞭解在啟用單一廣告來源測試後,廣告來源是否履行廣告請求。如果廣告來源無法載入廣告,就會顯示錯誤訊息來說明錯誤。

如果您已在中介服務刊登序列中加入了所選廣告來源的多個例項,系統就會在刊登序列期間顯示該廣告來源的所有呼叫例項,直到廣告供應完畢或刊登序列未有供應就結束為止。

單一廣告來源測試不支援自訂事件。

停止單一廣告來源測試

如要停止測試,請關閉開關:

之後,下列重新啟動畫面上就會顯示確認訊息:

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