中介服務

本指南說明如何將中介服務介面卡整合至 Flutter 應用程式。

必要條件

如要整合廣告格式的中介服務，您必須先將該廣告格式整合至應用程式：

第一次使用中介服務嗎？請參閱中介服務簡介。

初始化 Google Mobile Ads SDK

快速入門指南說明如何初始化 Google 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 flutterSdkPath = {
    def properties = new Properties()
    file("local.properties").withInputStream { properties.load(it) }
    def flutterSdkPath = properties.getProperty("flutter.sdk")
    assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
    return flutterSdkPath
}()

includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

新增合作夥伴聯播網的依附元件

您需要在 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 廣告合作夥伴名單中，新增中介服務合作夥伴。否則合作夥伴可能無法在您的應用程式中放送廣告。

進一步瞭解如何使用 Google User Messaging Platform (UMP) SDK 啟用受限的資料處理模式 (RDP)，以及取得 GDPR 同意聲明。

下一頁
選擇聯播網