本指南說明如何整合中介服務轉接程式與 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(),
);
橫幅廣告中介服務
對於 Ad Manager 中介服務中使用的橫幅廣告單元,請務必停用所有第三方廣告聯播網 UI 中的重新整理功能。由於 Ad Manager 也會根據橫幅廣告單元的重新整理頻率觸發重新整理作業,因此這樣可以避免重複重新整理。
原生廣告中介服務
以下是導入原生中介服務時,可考慮的一些最佳做法。
- 原生廣告展示政策
- 每個廣告聯播網都有各自的政策。使用中介服務時,請務必注意應用程式仍必須遵守提供廣告的中介服務聯播網政策。
美國州級隱私權法律和 GDPR
如果您需要遵守美國各州隱私權法律或一般資料保護法規 (GDPR),請按照美國州級法規設定或 GDPR 設定中的步驟,在 Ad Manager「隱私權與訊息」的美國州別或 GDPR 廣告合作夥伴清單中新增中介服務合作夥伴。否則可能會導致合作夥伴無法在您的應用程式上放送廣告。
進一步瞭解如何啟用受限的資料處理 (RDP),並透過 Google User Messaging Platform (UMP) SDK 取得 GDPR 同意聲明。