本指南將示範如何啟動及使用廣告檢查工具中的不同功能。
必要條件
如要使用廣告檢查器,請務必按照下列步驟操作:
- 完整閱讀入門指南
- 使用 Google Mobile Ads SDK 9.1.0 以上版本。
- 將裝置新增為測試裝置。 廣告檢查器只會在測試裝置上啟動。
啟動廣告檢查器
您可以透過下列方式,從應用程式的任何位置啟動廣告檢查器:
利用手勢啟動
如要透過手勢啟動廣告檢查器,不必變更應用程式,只要對測試裝置做出您在 AdMob 中設定的手勢 (轉動手腕兩次或晃動),瞭解詳情
在 AdMob 使用者介面中設定手勢後,請稍待 15 分鐘讓設定生效。接著,應用程式必須提出廣告請求,Google Mobile Ads SDK 才能瞭解手勢設定。如果指定手勢無法運作,請嘗試載入廣告、重新啟動應用程式,然後再次測試手勢。
以程式輔助方式啟動
您也可以透過程式輔助方式啟動廣告檢查器:
這項 API 適用於以程式輔助方式或在 AdMob 使用者介面中註冊的測試裝置。
查看及排解廣告單元問題
啟動後,系統會顯示廣告檢查器主畫面,其中列出 AdMob 應用程式 ID 相關聯的 AdMob UI 中,所有具備出價或中介服務設定的廣告單元:

建議您在使用廣告檢查器前,先初始化 Google Mobile Ads SDK。
查看廣告單元的中介服務刊登序列詳細資料
輕觸廣告單元即可查看 SDK 請求記錄,其中詳細列出針對最新廣告請求供應廣告前 (或刊登序列未有供應就結束時) 的中介服務刊登序列。
使用揭露指標展開每項要求,即可查看該要求的刊登序列中介服務結果,以及適用於該要求的任何錯誤和延遲時間。
如果是第三方廣告來源,系統會直接從廣告來源傳送錯誤訊息。如需詳細資訊,請洽詢第三方廣告來源。
查看廣告單元的出價詳細資料
如果您不熟悉出價,請參閱總覽。
在 SDK 請求記錄中,您可以查看廣告請求中呼叫的出價廣告來源。在 SDK 請求記錄中輕觸廣告單元,即可查看出價競價中每個廣告來源的詳細資料。
出價結果的排序方式如下,方便您在清單頂端附近找到可採取行動的項目:
頂端是贏得競價的廣告聯播網。
接下來是有問題的廣告聯播網。請按照問題的疑難排解步驟操作。
接著是未傳回廣告或未出價的廣告聯播網。這可能代表廣告來源有許多不同的問題,因為廣告來源可能因設定或決策問題而未出價。您可以參閱廣告來源的設定指南,或直接聯絡廣告來源取得支援。
最後,清單底部會列出輸掉出價競價的廣告聯播網。

中介服務刊登序列會根據有效千次曝光出價,將出價競價的勝出廣告來源排進刊登序列。
中介服務刊登序列呼叫廣告來源時,廣告來源就能放送廣告。 如要進一步瞭解出價與中介服務刊登序列的搭配運作方式,請參閱中介服務群組中出價和刊登序列廣告來源的範例 2和範例 3。
進階廣告單元偵錯
排解廣告單元問題時,深入瞭解廣告請求和回應,有助於找出失敗原因,或與 Google 支援團隊分享,協助進行偵錯。輕觸瀑布流鏈頂端的選單圖示,然後選取「分享廣告請求和回應」,即可匯出完整的廣告請求和回應。這樣您就不必在自己的應用程式上執行網路追蹤。
此外,您也可以在與請求字串相同的選單中,輕觸「第三方出價參數」選項,查看解碼後的第三方出價參數。這項功能會提供第三方出價參數的相關詳細資料,協助您偵錯應用程式,或驗證聯播網是否成功收集信號。

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

測試廣告單元
如要測試廣告單元,不必前往應用程式 UI 中的廣告單元,廣告檢查器可直接在廣告單元詳細資料畫面中進行測試。此外,您也可以一次測試多個廣告單元、非同步載入及查看測試廣告請求,甚至執行單一廣告來源測試。
廣告測試
本節說明的廣告檢查器廣告測試是絕佳工具,可驗證基本廣告體驗,並在搭配單一廣告來源測試時,驗證中介服務設定。
準備好測試廣告單元時,請輕觸廣告檢查器畫面頂端的「請求測試廣告」按鈕,觸發廣告檢查器廣告測試。測試結果隨即會顯示在 SDK 請求記錄中,標題「Requested from ad inspector」(從廣告檢查器要求) 下方。

單一廣告來源測試
廣告檢查器提供一項功能,可限制應用程式中的廣告請求,只放送來自單一出價或刊登序列中介服務廣告來源的廣告。藉此確認已正確導入第三方轉接程式,並確認廣告來源已正常放送。
如要啟用這項功能,請切換畫面底部的「單一廣告來源測試」。系統會顯示下列廣告來源選取對話方塊:
您必須先初始化 Google Mobile Ads SDK,才能使用單一廣告來源測試功能。
然後選取要測試的單一廣告來源。選取廣告來源後,畫面上會顯示下列內容:

單一廣告來源測試設定會套用至同一工作階段中,您日後提出的所有廣告請求。不過,這項測試不適用於該工作階段中先前快取的廣告,套用單一廣告來源測試時,建議強制重新啟動應用程式,讓快取廣告失效不顯示,您選的廣告來源則會收到請求。
重新啟動應用程式後,所有廣告單元刊登位置都會嘗試顯示所選聯播網的廣告。在執行單一廣告來源測試時啟動廣告檢查器,會顯示執行中的測試廣告來源:

在單一廣告來源測試模式中,無論所選廣告來源是否已針對所請求的廣告單元完成出價或中介服務設定,所有廣告請求都會嘗試透過該廣告來源供應廣告。如果受測廣告來源不在廣告單元的中介服務刊登序列中,系統就會顯示「未供應」的錯誤訊息。
在單一廣告來源測試中,您可以輕觸廣告單元來查看 SDK 請求記錄。並瞭解在啟用單一廣告來源測試後,廣告來源是否履行廣告請求;如果廣告來源無法載入廣告,系統會顯示錯誤訊息並說明錯誤。
如果您已在某個中介服務刊登序列中加入了所選廣告來源的多個例項,那麼在廣告供應前或刊登序列未有供應就結束時,刊登序列會顯示該廣告來源的各個呼叫例項。
停止單一廣告來源測試
如要停止測試,請關閉切換鈕:

確認訊息隨即會顯示在下列重新啟動畫面中:

建議您在停止測試後強制重新啟動應用程式,以便使測試廣告來源的快取廣告失效。
偵錯隱私權設定
必要條件: Google Mobile Ads SDK 9.6.0 以上版本
如要完成發布商的「歐洲 IAB 資訊公開和同意聲明架構」整合作業,請使用廣告檢查器查看下列在廣告請求中傳遞的隱私權信號:
- 適用 GDPR (
IABTCF_gdprApplies) - 額外同意聲明 (AC) 字串 (
IABTCF_AddtlConsent) - 資訊公開和同意聲明 (TC) 字串 (
IABTCF_TCString)
載入廣告或在廣告檢查器中執行廣告測試後,請輕觸「SDK 請求記錄」下方請求中的選單圖示。接著選取「隱私權信號」選項。
「隱私權信號」畫面會顯示廣告請求中傳遞的隱私權信號。

請參閱「Google 的額外同意聲明技術規格」一文,進一步瞭解額外同意聲明字串。如要查看資訊公開和同意聲明字串:TC 字串的精細同意聲明詳細資料,例如 CMP ID 和與 IAB 相關聯的同意供應商 ID 清單,請按一下「Decode」開啟 IAB GPP 編碼器 / 解碼器。
如果發生任何錯誤,請按照「瞭解隱私權問題」一文的步驟排解問題。
複製整個偵錯輸出內容
廣告檢查器支援複製 JSON 字串,其中包含工具的完整偵錯輸出內容,包括 AdMob 營利應用程式詳細資料、介面卡初始化狀態,以及所有廣告單元的測試結果。
方法是輕觸應用程式圖示七次,直到畫面上顯示「已將廣告檢查工具 JSON 複製到剪貼簿」訊息為止。