本指南說明如何使用應用程式內預覽功能和 Ad Manager 放送工具來偵錯廣告放送。
應用程式內預覽功能可讓您檢查在行動應用程式中顯示的廣告素材。如果廣告素材會與應用程式互動、具有獨特行為,或需要應用程式進行部分顯示作業 (包括原生廣告素材和 MRAID),這項預覽功能就非常實用。
Ad Manager 廣告放送工具會提供已放送廣告的相關資訊,因此如果系統放送了非預期的廣告,請使用廣告放送工具找出原因。
必要條件
備妥應用程式
偵錯時,您必須與 SDK 的偵錯選項選單互動。建議您在應用程式中加入下列函式,並根據使用者操作觸發此函式,以便開啟選單:
Java
public class MainActivity extends AppCompatActivity { ... @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Initialize the Mobile Ads SDK. MobileAds.initialize(this); } ... // Opens a debug menu. Call this method based on a user action. // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID. public void openDebugMenu() { MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID"); } }
Kotlin
class MainActivity : AppCompatActivity() { ... override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Initialize the Mobile Ads SDK. MobileAds.initialize(this) } ... // Opens a debug menu. Call this method based on a user action. // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID. fun openDebugMenu() { MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID") } }
只要是 Ad Manager 帳戶中的有效廣告單元,即可開啟偵錯選項選單。
另一種開啟選單的方式,是用兩指長按廣告素材,但這項操作不適用於所有廣告格式 (例如原生廣告),而且在滑動時,請務必小心不要點按廣告。呼叫上述方法會更加穩健。
連結裝置
新增開啟偵錯選項選單的功能後,請執行應用程式並觸發上述函式。系統會開啟下列選單:
選取「Creative Preview」即可連結裝置。系統會開啟瀏覽器,並自動導向至可登入 Ad Manager 的瀏覽器。登入後,請為裝置命名,以便在 Ad Manager 帳戶中註冊。然後按一下「驗證」。
此時,您可以前往 Ad Manager 使用者介面,確認裝置是否已連結。你也可以讓其他人存取你的裝置。
應用程式內預覽
請按照這篇文章的步驟,將廣告素材推送至已連結的裝置。請確認推送的廣告素材是有效委刊項的一部分,且指定的廣告版位為您希望放送廣告素材的位置。
從使用者介面推送廣告素材後,請再次觸發裝置上的偵錯選項選單,並再次選取「Creative Preview」。這個步驟可讓 SDK 檢查 Ad Manager,驗證裝置連結是否成功,並取得您推送的廣告素材相關資訊。如果裝置連結先前成功,偵錯選單會立即關閉。如果連結失敗,系統會提示您再次連結帳戶。
最後,請為要預覽的版位載入廣告,以便查看廣告素材。
推送工具
請按照「在 Ad Manager 中檢查廣告放送情形」一文中的步驟,排解廣告放送問題。如果您已順利完成這些步驟,請注意 Ad Manager UI 中會顯示要求,您也可以查看放送廣告的更多資訊。