本指南說明如何將中介服務轉接器整合至 Flutter 應用程式。
必要條件
您必須先將廣告格式整合至應用程式，才能整合廣告格式的中介服務：
第一次使用中介服務嗎？請參閱中介服務簡介。
初始化 Mobile Ads SDK
快速入門指南會說明如何初始化 Mobile Ads SDK。在初始化呼叫期間，中介服務適配器也會進行初始化。請務必等待初始化作業完成，再載入廣告，以確保每個廣告聯播網都能在第一個廣告請求中完整參與。
以下程式碼範例說明如何在發出廣告要求前，檢查每個轉接程式初始化的狀態。
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
更新 Gradle 設定 (僅限 Android)
將下列程式碼新增至 settings.gradle 檔案，以便使用外掛程式的 Android API：
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
pluginsFile.withInputStream { stream -> plugins.load(stream) }
}
plugins.each { name, path ->
def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
include ":$name"
project(":$name").projectDir = pluginDirectory
}
新增合作夥伴網路的依附元件
您必須將中介服務轉接器及其依附元件新增至 Android 和 iOS 專案。您可以透過更新 Android 上的應用程式層級 build.gradle 檔案，以及 iOS 上的 Podfile 來新增這些元素。Google 在 GitHub 上提供適用於 Android 和 iOS 的開放原始碼轉接程式。
如需在應用程式中新增對應轉接器的詳細指南，請參閱各個合作夥伴網路的 Android 和 iOS 說明文件。
檢查哪個廣告聯播網轉接程式類別載入廣告
下列程式碼範例示範如何記錄橫幅廣告的廣告聯播網類別名稱：
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
搭配中介服務使用橫幅廣告
請務必針對中介服務中使用的橫幅廣告單元，在所有第三方廣告來源 UI 中停用重新整理功能。這樣做可避免重複重新整理，因為 Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理。
搭配中介服務使用原生廣告
以下是實作原生中介服務時，可考慮採用的最佳做法。
- 原生廣告呈現方式政策
- 每個廣告聯播網都有各自的政策。使用中介服務時，請務必記住，您的應用程式仍須遵守提供廣告的中介服務網路的政策。
美國州級隱私權法律和 GDPR
如果您需要遵守《美國州級隱私權法律》或《一般資料保護規則 (GDPR)》，請按照「美國州級法規設定」或「GDPR 設定」中的步驟，在 Ad Manager 隱私權與訊息的美國州或 GDPR 廣告合作夥伴清單中新增中介合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。
進一步瞭解如何啟用受限的資料處理 (RDP)，以及如何使用 Google User Messaging Platform (UMP) SDK 取得 GDPR 同意聲明。