本指南說明如何使用應用程式內預覽功能和 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 使用者介面，確認裝置是否已連結。也可以讓其他人存取你的裝置。
應用程式內預覽
請按照這篇文章的步驟，將廣告素材推送至已連結的裝置。請確定推送的廣告素材屬於有效委刊項，且該委刊項會指定您要廣告素材的廣告版位。
從 UI 推送廣告素材後，在裝置上再次觸發偵錯選項選單，並再次選取「Creative Preview」。這個步驟可讓 SDK 檢查 Ad Manager，驗證裝置連結是否成功，並取得您推送的廣告素材相關資訊。如果裝置連結先前成功，偵錯選單會立即關閉。如果連結失敗，系統會提示您再次連結帳戶。
最後，在要預覽的版位載入廣告，以查看廣告素材。
推送工具
按照「在 Ad Manager 中檢查廣告放送」一節中的步驟，排解廣告放送問題。如果您已順利完成這些步驟，請務必在 Ad Manager 使用者介面中查看這項要求，並進一步瞭解放送的廣告。
