本指南說明如何使用應用程式內預覽功能和 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 中會顯示要求，您也可以查看放送廣告的更多資訊。
