檢查行動應用程式廣告放送情形

查看哪些廣告有資格放送到您的行動應用程式內容中，進一步瞭解 Google Ad Manager 廣告選擇流程，或解決與廣告放送相關的問題。

連結裝置可查看廣告請求和放送詳情，使用廣告檢查器 ^(測試版)  或 Ad Manager 的廣告放送工具則可協助您排解廣告放送問題，以便與聯播網中的其他使用者分享詳細資料。

以下是 Ad Manager 廣告放送工具經常回答的一些問題：

• 哪些廣告已放送到我的網頁中？
• 為何這些廣告得以放送，而其他廣告卻無法放送？
• 我的委刊項和廣告素材是否設定正確？
• 我的委刊項為何進度落後或根本沒有放送？

開始使用

如要在行動應用程式中檢查廣告放送情形，您必須先將行動裝置連結到 Ad Manager。

連結行動應用程式

1. 在行動裝置上開啟您的應用程式，然後找出您 Ad Manager 聯播網放送的廣告。
2. 用兩根手指按住廣告即可開啟偵錯選單。

   請務必小心，以免重複輕觸廣告素材，導致系統將意外點擊事件誤認為無效活動。

   如果偵錯手勢不適用於我的廣告素材，該怎麼辦？

   某些廣告素材 (例如自訂原生廣告) 與偵錯手勢不相容。如要採用替代解決方法，請在行動應用程式的程式碼中加入特殊函式，觸發應用程式內選單。例如，您可以將這個函式加到特殊的按鈕或手勢中。

   請參閱 iOS 版或 Android 版的開發人員說明文件。

3. 輕觸偵錯選單中的「疑難排解」。

   一旦啟用，疑難排解功能就會保持開啟。

4. 如果這是您第一次在行動裝置上檢查此應用程式的廣告放送情形，系統會提示您登入 Ad Manager，確認您是聯播網中的活躍使用者，而且有權查看廣告放送資訊。

   使用您的 Ad Manager 使用者名稱和密碼登入，然後為您的裝置選擇一個名稱，以便在 Ad Manager 中輕鬆辨識。

連結行動裝置後，您可以使用廣告檢查器 (Beta 版) 或 Ad Manager 的廣告放送工具來排解廣告放送問題。

刪除已連結的行動裝置

如果連結裝置的顯示設定為「私人」，就只有建立裝置的使用者，或以該使用者身分操作的「管理員」，才能刪除裝置。如果顯示設定為「公開」，則具備「管理員」角色的所有使用者都能刪除裝置，不必以其他使用者的身分操作。

如何從 Ad Manager 帳戶中移除任何已連結的裝置：

1. 登入 Google Ad Manager。
2. 依序點按「管理」>「存取權與授權」>「連結的裝置」。
3. 選取要移除的裝置，然後按一下「刪除」。

廣告檢查器 ^(測試版) 

廣告檢查器是最新版 Google Mobile Ads SDK (iOS 8.10.0 或以上版本) 所包含的新功能，會顯示廣告放送深入分析資訊，並讓您即時測試在應用程式中重疊顯示的第三方收益夥伴。完全不需使用程式碼。

您可以使用廣告檢查器，直接在裝置上檢查廣告單元的下列情形：

• 檢查廣告是否正常供應
• 找出錯誤並查看詳細的問題解決方法
• 查看每項請求的公開出價廣告來源或中介服務詳情
• 查看第三方廣告來源 SDK 轉接程式的狀態

使用廣告檢查器收集廣告資料

連結行動裝置後，廣告檢查器就會自動開始檢查應用程式的廣告放送情形。除非您取消連結裝置並重新啟動應用程式，否則廣告檢查器將保持開啟。

您也可以透過 API 呼叫，在測試裝置上啟用廣告檢查器。詳情請參閱 Android 版或 iOS 版的開發人員說明文件。

1. 在行動裝置上重新載入行動應用程式頁面，或開始使用該應用程式。
2. 與應用程式互動 (按下按鈕、輕觸介面或進行其他互動)，確保有足夠的廣告請求可供分析。在開始排解問題之前載入的廣告不會顯示在廣告檢查器中。

   如果您的應用程式會預先擷取廣告，您可能會在應用程式啟動時看到一組廣告請求。

3. 使用偵錯選單、手勢或自訂 API 呼叫在測試裝置上叫用廣告檢查器後，您會看到「廣告單元」分頁，其中按照最新的活動順序列出應用程式的廣告單元 (無論是否已顯示廣告)。系統還會顯示用於檢查第三方 SDK 轉接程式的分頁。

   您可以在偵錯選單中變更廣告檢查器設定，選擇透過手勢叫用檢查器重疊畫面，而不是透過兩指長按的方式。如此一來，當廣告是由第三方聯播網放送，或廣告素材與兩指長按不相容時，您還是可以叫用檢查器。

   您必須等廣告單元完成至少一項請求後，才會看到完整的廣告單元清單。

4. 輕觸廣告單元即可查看 SDK 請求記錄，其中列出針對最新廣告請求供應廣告後的公開出價或中介服務設定詳情。您可以在此展開每個未供應廣告的收益夥伴，查看未供應廣告錯誤的詳細資料。

如果是第三方收益夥伴，則會由收益夥伴直接傳送錯誤訊息。如要進一步瞭解這些錯誤的詳情，請洽詢第三方收益夥伴。

瞭解 SDK 轉接程式的問題

如要查看 SDK 轉接程式的狀態，請按一下「轉接程式」分頁標籤。

在檢查第三方廣告來源的 SDK 轉接程式時，可能會發現兩個問題。

SDK 轉接程式問題	說明
找不到轉接程式	部分第三方廣告來源會需要 SDK 及其 GMA SDK 專用的轉接程式，才能載入並顯示該來源中的廣告。這個錯誤代表 GMA SDK 找不到您的第三方轉接程式或 SDK。請檢查您是否已正確安裝 SDK 轉接程式。進一步瞭解適用於 Android和 iOS 的相關說明。
未初始化	每個第三方廣告來源 SDK 轉接程式，都必須在程式碼集內透過必要參數來明確初始化。請務必正確遵循整合指南中的指示。如要瞭解特定的初始化錯誤，請參閱第三方廣告來源文件中的說明。進一步瞭解適用於 Android和 iOS 的相關說明。

使用廣告檢查器測試個別收益夥伴

您可以使用廣告檢查器來測試單一第三方收益夥伴或公開出價收益夥伴的設定，並可確認是否已正確導入第三方中介服務轉接程式，以及收益夥伴是否正常放送廣告。

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

如何開始測試：

1. 切換應用程式底部的「單一廣告來源測試」。
2. 選取要測試的收益夥伴。
3. 強制重新啟動應用程式，如此可確保系統清除應用程式廣告快取，以便針對測試工作階段中的每個廣告請求進行測試。
   如果是 Android 裝置，通常可透過手機的設定應用程式來強制重新啟動應用程式。詳情請洽裝置製造商。如果您使用 Apple 裝置，請參閱這篇文章，瞭解如何強制重新啟動 iOS 應用程式。

如果單一廣告來源測試已啟用廣告檢查器，日後的所有廣告請求都會嘗試從所選收益夥伴傳回廣告。

在測試模式中，無論收益夥伴是否與特定廣告單元建立關聯，所有廣告請求都會嘗試透過所選收益夥伴取得廣告。也就是說，如果您測試的收益夥伴不在廣告單元的中介服務刊登序列中，系統會顯示「未供應廣告」的錯誤訊息，並指出廣告單元未設定使用該收益夥伴。

SDK 廣告請求供應廣告錯誤

在單一廣告來源測試中，您可以輕觸廣告單元來查看 SDK 請求記錄。這項資訊可讓您瞭解單一廣告來源測試啟用之後，收益夥伴是否已針對廣告請求供應廣告。如果收益夥伴未針對請求供應廣告，系統就會顯示錯誤訊息，詳細說明未供應廣告錯誤的原因。

• 找不到 SDK 信號：部分收益夥伴可能需要安裝及正確設定 SDK 和轉接程式，才能使用出價功能。請參閱 Android 版和 iOS 版相關的 SDK 需求條件。
• 未提供任何使用者同意聲明：如果使用者未提供必要的同意聲明，收益夥伴可能就不符合出價要求的資格。這可能是預期中的行為。請參閱 Ad Manager 政策，進一步瞭解如何導入同意聲明工具 (例如 GDPR)。
• 未傳回廣告：收益夥伴可能決定不針對廣告請求出價，或不符合出價資格。以下幾個原因都可能造成這個問題：
  • 收益夥伴只能在特定情況下 (例如特定地理區域) 出價；
  • 收益夥伴可能沒有符合出價要求條件的廣告；
  • 或收益夥伴端發生未預期的系統錯誤或逾時。

單一廣告來源測試會在 60 分鐘後自動失效。

在 Ad Manager 中檢查廣告放送情形

1. 在電腦上登入 Google Ad Manager。

   請確認電腦和裝置都登入相同的 Ad Manager 帳戶和聯播網。

2. 依序點按「廣告放送」>「廣告放送工具」>「應用程式廣告」。
3. 在表格中選取您在最近一次工作階段中連結的裝置。

模擬廣告請求

連結裝置以啟動檢查程序並開啟 Ad Manager 之後，就可以收集廣告放送的詳細資料。如果是在完成上述步驟之前載入的任何廣告，Ad Manager 將不會顯示相關詳細資料。

1. 在行動裝置上重新載入或開啟應用程式。當應用程式載入廣告時，Ad Manager 會顯示廣告放送資訊。
2. 在「廣告放送工具」的「應用程式廣告」中，每一列都代表一個廣告版位和廣告請求。按一下資料列，展開更多詳細資料。
3. 如果系統放送的廣告與您預期的不同，您可以按一下 [模擬請求] 來判斷背後原因。

廣告請求的相關資訊

• Div：標識廣告版位在網頁上顯示的位置，例如「top」。
• 請求的大小：廣告請求中定義的所有大小。
• 鍵/值：廣告請求中定義的所有鍵/值。按一下「查看全部」即可查看完整清單。

安全信號的相關資訊  ^(測試版) 

這項資訊會顯示廣告請求中包含的安全信號，以及聯播網已啟用但未顯示在廣告請求中的信號。

• 信號名稱：傳遞的信號名稱
• SDK 和版本
• 信號健康狀態：指出信號是否存在 (已成功傳遞)、空白、未偵測到，或已啟用，但缺少。

進一步瞭解已放送的廣告

• 需求管道：用來選取廣告的方法，例如「公開出價」或「廣告伺服器」。進一步瞭解需求管道。
• 廣告主、訂單、委刊項、廣告素材名稱和 ID。按一下 ID 即可在 Ad Manager 中開啟。
• 委刊項類型
• 廣告素材大小
• 廣告素材類型

封鎖 Ad Exchange/AdSense 廣告或回報問題

您可以封鎖 Ad Exchange 和 AdSense 廣告素材，或回報潛在問題。按一下「廣告素材詳細資料」分頁標籤，然後按一下「建議」旁邊的下列其中一個選項：

只有在啟用「查看及封鎖 Ad Exchange 廣告素材」使用者角色權限時，「封鎖廣告素材」分頁才會顯示。

• 封鎖廣告：不允許放送廣告素材。封鎖的廣告將出現在「廣告素材審核」中的「已封鎖」分頁上。
• 舉報違規：向 Google 提交可能違規的廣告素材。我們將審查該廣告素材，並告訴您審查結果。

其他廣告素材類型不提供這些按鈕，但在這種情況下，我們會於後續步驟中提供建議。

分享詳細資料

您可以與有權存取聯播網的使用者分享詳細資料。方便您與他人合作，針對您的委刊項擬定疑難排解計畫。

1. 在「疑難排解」頁面顯示的詳情上方，按一下「分享這個工作階段」。
2. 按一下「複製網址」。網址便會複製到剪貼簿，供您貼到其他位置。
3. 將網址傳送給有權存取您聯播網的使用者，請對方將網址貼到瀏覽器中。

模擬廣告請求

模擬結果會顯示再次針對這個廣告版位發出請求時，哪個委刊項會勝出。如果是未預期的委刊項，則會提供勝出原因。請變更指定目標和廣告代碼資訊，試著讓所需的委刊項在模擬中勝出。

按一下「模擬請求」，Ad Manager 就會執行模擬作業並提供下列詳細資料。

「模擬請求」功能不會保留在頁面或伺服器狀態的資訊。因此，競爭排除條件、路障型廣告和展示頻率上限不會與原始請求相符。

原始請求

這個部分會重現您在「疑難排解」頁面所選廣告請求的實際放送情況，包括：

• 廣告請求詳細資料：勝出委刊項目的請求和指定目標資訊。
• 勝出委刊項詳細資料：勝出委刊項的放送詳情。
• 查看未放送的原因：查看為何這個委刊項符合資格，但系統卻選擇並放送其他委刊項。進一步瞭解可能未放送的原因。

模擬

顯示您再次向此廣告版位發出請求的結果。

廣告請求詳細資料

模擬作業的請求和指定目標資訊，預設為目前的設定。

勝出的委刊項

在模擬中勝出的委刊項放送詳情。

搜尋您原本預期會勝出的委刊項

如果未預期的委刊項在模擬中勝出，您可以搜尋預期會勝出的委刊項，然後按一下「前往」。系統會顯示勝出委刊項的詳細資料，以及您搜尋的委刊項未放送的原因。

進一步瞭解委刊項未放送的原因

重新執行模擬

您可以在「廣告請求詳細資料」下方變更指定目標和廣告代碼資訊，然後按一下「重新執行模擬」，看看勝出的委刊項是否改變。如果最後找到可讓所需委刊項勝出的模擬參數，就可以回頭更新實際的指定目標和廣告代碼資訊。

為什麼模擬勝出的委刊項與原來勝出的委刊項不同？

有幾個可能的原因會造成這種情況，以下列舉部分原因說明：

• 執行每一個實際或模擬請求時，許多因素都瞬息萬變。因此，當您在不同時間執行請求時，包括執行時間、目標、要競爭的新委刊項等因素都已產生變化。
• 廣告選擇程序可能會導致每次請求放送的委刊項都不一樣。
• 模擬程序一次只會考慮一個廣告版位。因此，如果原本勝出委刊項的請求是具備多個廣告版位 (例如路障型廣告) 的一部分，就無法在模擬中勝出。
• 委刊項已經達到展示頻率上限。
• 委刊項已經達成放送目標。

為什麼我的委刊項放送率未達 100%？

分配曝光放送次數時，Ad Manager 會同時參考委刊項的投放速度設定和嘗試將放送最佳化的 Ad Manager 放送速度規則。變更放送速度可能會影響流量和放送情形。

如果您認為委刊項放送不正常，請嘗試使用委刊項放送疑難排解工具，或進一步瞭解放送速度。

允許其他人存取您的裝置 ^(選用) 

在預設情況下，已連結的裝置是不公開的。也就是說，只有您可以在 Ad Manager 中使用這些裝置。如果您想讓其他人也能透過這些裝置排解疑難，可以更新 Ad Manager [管理] 部分的設定。

1. 登入 Google Ad Manager。
2. 依序點按「管理」>「存取權與授權」>「連結的裝置」。
3. 在「顯示設定」欄中按一下儲存格，然後在下拉式選單中選取「公開」。