中介

本指南介绍了如何将中介适配器与 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 项目。您可以通过更新 Android 上的应用级 build.gradle 文件和 iOS 上的 Podfile 文件来添加这些内容。Google 在 GitHub 中提供了开源适配器 两者的 Android 版iOS

请参阅 AndroidiOS 提供了详细的指导说明如何添加 适配器。

检查哪个广告联盟适配器类加载了广告

以下示例代码演示了如何为以下广告记录广告网络类名称: 横幅广告:

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