此页面由 Cloud Translation API 翻译。

中介

本指南介绍了如何将中介适配器与 Flutter 应用。

前提条件

在为广告格式集成中介之前，您需要先将广告格式：

第一次使用中介功能？已读中介简介。

初始化移动广告 SDK

快速入门指南介绍了如何初始化移动广告 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 项目。您可以通过更新应用级别 build.gradle 进行添加文件在 Android 上，在 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 还会触发一次刷新将基于横幅广告单元的刷新频率

结合使用原生广告和中介

以下是植入原生广告时需要考虑的一些最佳做法中介。

原生广告展示政策: 每个广告网络都有自己的政策。使用中介功能时，请务必请注意，您的应用仍需遵守参与中介的广告联盟。

美国州级隐私保护法律和 GDPR

如果您需要遵守美国州/省/自治区/直辖市隐私权法律或一般数据保护条例 (GDPR)，请遵循美国州级法规中的步骤设置或 GDPR 设置以添加您的 Ad Manager 中的“隐私权”页面和消息功能美国各州或 GDPR 广告合作伙伴列表。否则，可能会导致合作伙伴无法在您的应用中投放广告

详细了解如何启用“受限的数据处理” (RDP) 以及遵守 GDPR 通过 Google User Messaging Platform (UMP) 征求用户意见 SDK。

选择广告网络