廣告檢查器

廣告檢查器 是應用程式內的疊加功能，可讓授權裝置直接在行動應用程式中即時分析測試廣告請求。 Google Mobile Ads SDK 7.68.0 以上版本都包含這項功能，而且啟用時完全不需要程式碼。

在 Google Mobile Ads SDK 8.5.0 以下版本中使用廣告檢查器，您可以：

  • 檢查廣告單元
  • 檢查第三方轉接程式
  • 檢查廣告是否正常供應
  • 找出錯誤並查看詳細的問題解決方法
  • 查看每項請求的各個廣告聯播網中介服務詳細資料
  • 測試個別第三方中介服務廣告來源
  • 確認已正確設定每個廣告單元，以便透過瀑布流程進行中介
  • 測試自訂事件整合

如果是 Google Mobile Ads SDK 8.5.0 以上版本，您也可以：

  • 查看每項請求的各個廣告聯播網出價詳細資料
  • 查看每個要求中每個廣告聯播網的出價和刊登序列中介服務詳細資料
  • 測試個別第三方出價或刊登序列中介服務廣告來源

  • 確認您已正確設定各個廣告單元，以便進行出價和瀑布式中介

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

必要條件

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

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

啟動廣告檢查器

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

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

使用手勢啟動

您不必變更應用程式，即可透過手勢啟動廣告檢查器；只要執行您在 AdMob 中為該測試裝置設定的手勢 (雙擊或晃動) 即可。瞭解詳情

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

以程式輔助方式啟動

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

Swift

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Objective-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

請確認傳遞至此 API 的 View Controller 已在螢幕上完整顯示 (已呼叫 viewDidAppear:)。如果傳遞的 View Controller 正在顯示中 (例如在 View Controller 的 viewDidLoad 函式中呼叫 API)，則廣告檢查器的呈現作業會失敗。

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

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

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

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

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

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

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

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

前置條件：Google Mobile Ads SDK 8.5.0 以上版本

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

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

出價結果會依序排序，讓可執行項目更靠近清單頂端：

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

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

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

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

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

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

進階廣告單元偵錯

排解廣告單元問題時，您可以深入瞭解廣告請求和回應，找出失敗的原因，或是與 Google 支援團隊分享，以利進行偵錯。輕觸瀑布流程鏈結頂端的選單圖示，然後選取「分享廣告請求和回應」，即可匯出完整的廣告請求和回應。這樣一來，您就不必在自己的應用程式上執行網路追蹤作業。

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

查看可用的轉接器

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

如果找不到轉接程式或無法初始化，請參閱使用廣告檢查器解決發現的問題，進一步瞭解相關資訊。

測試廣告單元

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

廣告測試

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

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

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

單一廣告來源測試

廣告檢查器提供一項功能，可限制應用程式中的廣告請求，只放送單一出價或刊登序列中介服務廣告來源的廣告。藉此確認已正確導入第三方轉接程式，且廣告來源已正常放送。

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

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

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

單一廣告來源測試設定會套用至您在同一個工作階段中日後提出的任何廣告請求。不過，這項設定不會套用至先前快取的廣告，如果該廣告尚未顯示，就不會套用。套用單一廣告來源測試時，建議您強制重新啟動應用程式，以便讓系統無效化任何可能會放送的快取廣告，而非您所選的廣告來源收到請求。

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

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

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

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

停止單一廣告來源測試

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

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

建議您在停止測試後強制重新啟動應用程式，以便讓系統將測試廣告來源的所有快取廣告設為無效。

偵錯隱私權設定

前置條件：Google Mobile Ads SDK 第 9.8.0 以上版本

您可以使用廣告檢查器查看發布商與歐洲 IAB 資訊公開和同意聲明架構整合的過程中，在廣告請求中傳遞的下列隱私權信號：

  • 適用 GDPR (IABTCF_gdprApplies)
  • 額外同意聲明字串 (IABTCF_AddtlConsent)
  • 資訊公開和同意聲明 (TC) 字串 (IABTCF_TCString)

在廣告檢查器中載入廣告或執行廣告測試後，輕觸「SDK 請求記錄」下方請求旁的選單圖示。接著，選取「隱私權信號」選項。

「隱私信號」畫面會顯示廣告請求中傳遞的隱私信號。

如要進一步瞭解 AC 字串，請參閱 Google 的額外同意聲明技術規格。如要查看 TC 字串中的詳細同意聲明資料，例如 CMP ID 和與 IAB 相關聯的已同意供應商 ID 清單，請按一下「解碼」，開啟 IAB GPP 編碼器 / 解碼器。

如果發生任何錯誤，請按照「瞭解隱私權問題」一文中的步驟排解問題。

複製整個偵錯輸出內容

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

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