啟用測試廣告

選取平台： Android iOS Unity Flutter

本指南說明如何在廣告整合功能中啟用測試廣告。開發期間建議啟用測試廣告來檢查點擊行為，以免影響預訂廣告活動的統計資料，或造成廣告主需支付 Ad Exchange 費用。

修課條件

完成入門指南步驟。

示範廣告單元

最快的測試方式是使用 Google 提供的試用版廣告單元。這些廣告單元與您的 Ad Manager 帳戶無關，使用時不會導致帳戶產生無效流量。

以下是示範廣告單元，指向各格式適用的測試廣告素材：

廣告格式	示範廣告單元 ID
應用程式開啟頁面廣告	`/21775744923/example/app-open`
自動調整橫幅廣告	`/21775744923/example/adaptive-banner`
固定大小橫幅廣告	`/21775744923/example/fixed-size-banner`
插頁式廣告	`/21775744923/example/interstitial`
獎勵廣告	`/21775744923/example/rewarded`
插頁式獎勵廣告	`/21775744923/example/rewarded-interstitial`
原生	`/21775744923/example/native`
原生影片廣告	`/21775744923/example/native-video`

重點：這些測試廣告單元已在 Ad Manager 中設為放送直接銷售廣告，而這類廣告不會傳回 AdChoices。

啟用測試裝置

如要以實際放送的廣告進行更嚴謹的測試，可將裝置設為測試裝置，並使用您在 Ad Manager 使用者介面中建立的廣告單元 ID。

請按照下方步驟，將裝置新增為測試裝置。

以程式輔助方式新增測試裝置

如要註冊測試裝置，請完成下列步驟：

載入已整合廣告的應用程式，並提出廣告請求。
檢查 Logcat 輸出內容，看是否有類似以下內容的訊息，指出裝置 ID 及如何將裝置新增為測試裝置：
```
I/Ads: Use RequestConfiguration.Builder.setTestDeviceIds(Arrays.asList("33BE2250B43518CCDA7DE426D04EE231"))
to get test ads on this device."
```
將測試裝置 ID 複製到剪貼簿。

修改程式碼以呼叫 RequestConfiguration.Builder.setTestDeviceIds()，並傳遞測試裝置 ID 清單。

Java

List<String> testDeviceIds = Arrays.asList("TEST_DEVICE_ID");
RequestConfiguration configuration =
    new RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build();
MobileAds.setRequestConfiguration(configuration);RequestConfigurationSnippets.java

Kotlin

val testDeviceIds = listOf("TEST_DEVICE_ID")
val configuration = RequestConfiguration.Builder().setTestDeviceIds(testDeviceIds).build()
MobileAds.setRequestConfiguration(configuration)RequestConfigurationSnippets.kt

將 TEST_DEVICE_ID 替換為測試裝置 ID。

您可以檢查 isTestDevice()，確認裝置已妥善新增為測試裝置。

重新執行應用程式。如果是 Google 廣告，則廣告 (橫幅、插頁式或獎勵影片) 頂端中間會顯示「測試廣告」標籤：

注意： 須使用 11.6.0 以上版本的 SDK，才會有「測試廣告」標籤。

如果是原生進階廣告，標題素材資源會加上「測試廣告」字串。

有「測試廣告」標籤的廣告都可以放心點按。所有對測試廣告的請求、曝光和點擊，都不會計入帳戶報表。

使用中介服務進行測試

Google 的範例廣告單元只會顯示 Google Ads。如要測試中介服務設定，須啟用測試裝置。

中介服務廣告「不會」顯示「測試廣告」標籤。您有責任確保各個中介服務聯播網皆已啟用測試廣告，以免聯播網偵測到無效活動而標記您的帳戶。詳情請參閱各聯播網的中介服務指南。

如果不確定中介服務廣告聯播網的轉接程式是否支援測試廣告，開發期間應避免點到該聯播網的廣告，這是最保險的做法。您可以對任何廣告格式使用 getMediationAdapterClassName() 方法，找出是哪個廣告聯播網放送現在這則廣告。