廣告素材預覽與廣告素材；放送工具

本指南說明如何使用應用程式內預覽和 Ad Manager 廣告放送工具，對廣告放送進行偵錯。

應用程式內預覽功能可讓您檢查在行動應用程式中呈現的廣告素材。如果廣告素材會與應用程式互動、具有獨特的行為，或是依賴應用程式進行某些顯示 (包括原生廣告素材和 MRAID)，這項預覽就特別實用。

Ad Manager 廣告放送工具會提供廣告放送資訊；因此，如果廣告放送未預期的，請使用放送工具找出原因。

先備知識

  • Google Mobile Ads SDK 10.2.0 以上版本。
  • 存取 Google 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 帳戶註冊裝置。然後按一下「Verify」(驗證)。

此時，您可以在 Ad Manager UI 中確認裝置是否已連結。也可以讓其他人存取你的裝置。

應用程式內預覽

按照步驟將廣告素材推送至已連結的裝置。請確定推送的廣告素材屬於有效委刊項，且該委刊項會指定您要廣告素材的廣告版位。

從 UI 推送廣告素材後，在裝置上再次觸發偵錯選項選單，並再次選取「Creative Preview」。這個步驟可讓 SDK 檢查 Ad Manager，驗證裝置連結是否成功，並取得您推送的廣告素材相關資訊。如果裝置連結先前成功，偵錯選單會立即關閉。如果連結失敗，系統會提示您再次連結帳戶。

最後，在要預覽的版位載入廣告，以查看廣告素材。

廣告放送工具

按照「在 Ad Manager 中檢查廣告放送情形」一節中的步驟，排解廣告放送問題。如果您已成功完成步驟，請求會顯示在 Ad Manager UI 中，方便您查看所放送廣告的詳細資訊。