本指南介绍了如何将中介适配器与 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。
请参阅 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。