中介服務

本指南說明如何將中介服務轉接程式與 Flutter 應用程式。

先備知識

您必須先整合 導入應用程式後

第一次使用中介服務嗎?已讀 中介服務簡介

初始化 Mobile Ads SDK

快速入門指南將說明如何初始化行動廣告 SDK。 在初始化呼叫期間,中介服務轉接程式也會 Pod 都會經過初始化請務必等待初始化完成, 為了確保使用者能完整參與 發出第一個廣告請求

以下程式碼範例說明如何查看每個轉接程式的初始化作業 未送出廣告請求前的狀態。

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 專案只要更新應用程式層級 build.gradle,即可新增分級 檔案 (Android) 和 Podfile (iOS)Google 在 GitHub 中提供開放原始碼轉接程式 兩者皆是 AndroidiOS

詳情請參閱 AndroidiOS 。 轉接程式。

查看哪個廣告聯播網轉接程式類別載入廣告

以下程式碼範例示範如何記錄以下項目的廣告聯播網類別名稱: 橫幅廣告:

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) 並取得 GDPR 同意 Google User Messaging Platform (UMP) SDK