本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 来自 ironSource Ads 的广告 中介,涵盖广告瀑布流 集成其中介绍了如何将 ironSource 广告添加到广告单元的 中介配置,以及如何集成 ironSource 广告 SDK 和适配器 Flutter 应用内。
支持的集成和广告格式
ironSource Ads 的 AdMob 中介适配器 以下功能:
集成 | |
---|---|
出价 | 1 |
瀑布 | |
表现形式 | |
横幅 | 2 |
插页式广告 | |
激励广告 | |
插页式激励广告 | 2 |
1 出价集成已处于 封闭式 Beta 版,请联系您的客户经理以申请访问权限。
2 此格式 在广告瀑布流集成中受支持
要求
- 最新版 Google 移动广告 SDK
- Flutter 3.7.0 或更高版本
- 在 Android 上部署
<ph type="x-smartling-placeholder">
- </ph>
- Android API 级别 21 或更高级别
- 在 iOS 上部署
<ph type="x-smartling-placeholder">
- </ph>
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 配置的有效 Flutter 项目 移动广告 SDK。请参阅 如需了解详情,请开始使用。
- 完成中介流程 入门指南
第 1 步:在 ironSource 广告界面中设置配置
第 2 步:在界面中设置 ironSource 广告需求 AdMob
为广告单元配置中介设置
将 ironSource Mobile 添加到 GDPR 和美国州级法规广告合作伙伴列表
第 3 步:导入 ironSource Ads SDK 和适配器
通过 pub.dev 进行集成
(仅限 Android)将以下代码库添加到项目的 android
目录中的 build.gradle
文件中:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
将以下依赖项与最新版本的
IronSource
软件包的
pubspec.yaml
文件:
dependencies:
gma_mediation_ironsource: ^1.0.0
手动集成
下载适用于
IronSource
的最新版 Google 移动广告中介插件,解压缩下载的文件,然后将解压缩的插件文件夹及其内容添加到您的 Flutter 项目中。然后,通过添加以下依赖项在 pubspec.yaml
文件中引用该插件:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
第 4 步:在 ironSource 广告 SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 对设备标识符和个人数据的使用。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
适用于 ironSource Ads 的 Google 移动广告中介插件
包含
GmaMediationIronsource().SetConsent()
方法。以下示例代码展示了如何将
意见征求信息。如果您选择调用此方法,
方法,建议您在通过
Google 移动广告 SDK。
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
请参阅关于 IronSource Ads 的文档 法规高级设置 了解详情。
美国州级隐私保护法律
美国州级隐私保护法 要求向用户提供 以拒绝“销售”交易用户自己的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal”(不出售我的个人数据) 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法将此设置应用于每个广告, 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
适用于 ironSource Ads 的 Google 移动广告中介插件
包含
GmaMediationIronsource().setDoNotSell
方法。以下示例代码展示了如何将
意见征求信息。必须先设置这些选项,
您将 Google 移动广告初始化
SDK
以确保它们正确转发到 ironSource Ads SDK。
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
请参阅 ironSource Ads 的关于法规高级设置的文档 Android 版 和 iOS 以了解更多详情,以及可在方法中提供的值。
第 5 步:添加所需的代码
Android
Proguard 规则
如果您缩减、混淆处理和优化应用, IronSource Ads 需要针对您的项目添加额外的 ProGuard 规则。
咨询
IronSource Ads 的 Android SDK 集成指南
如需详细了解项目所需的 ProGuard 规则,
然后将这些规则添加到您的 proguard-user.txt
文件中。
应用生命周期
替换以下各项中的 onPause()
和 onResume()
方法:
您的活动调用相应的 ironSource Ads 方法,如下所示:
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
SKAdNetwork 集成
请按照 ironSource Ads 文档中的说明,将 SKAdNetwork 标识符添加到您的
项目的 Info.plist
文件。
第 6 步:测试实现效果
启用测试广告
请务必为AdMob 注册您的测试设备,并在 IronSource 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自 IronSource 的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 ironSource Ads (Waterfall)
错误代码
如果适配器未能接收来自 ironSource Ads 的广告,发布商可以检查
使用
ResponseInfo
(位于
以下类:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
以下是 ironSource Ads 抛出的代码和附带消息 适配器:
Android
错误代码 | 原因 |
---|---|
101 | 界面中配置的 ironSource 广告服务器参数 AdMob 缺失/无效。 |
102 | ironSource Ads 需要一个 Activity 上下文来初始化其 SDK。 |
103 | ironSource Ads 只能为每个 ironSource 实例 ID 加载 1 个广告。 |
105 | ironSource Ads 不支持请求的横幅广告尺寸。 |
106 | ironSource Ads SDK 未初始化。 |
501-1056 | ironSource 广告 SDK 错误。请参阅文档 了解详情。 |
iOS
错误代码 | 原因 |
---|---|
101 | 界面中配置的 ironSource 广告服务器参数 AdMob 缺失/无效。 |
102 | ironSource 广告适配器不支持所请求的广告格式。 |
103 | 已针对此广告联盟配置加载了一个 ironSource 广告。 |
104 | ironSource Ads 不支持请求的横幅广告尺寸。 |
508-1037 | ironSource 广告 SDK 错误。请参阅文档 了解详情。 |
ironSource Flutter 中介适配器更新日志
1.0.0
- 初始版本。
- 已验证与 ironSource Android 适配器版本 8.0.0.0 的兼容性
- 已验证与 ironSource iOS 适配器版本 8.0.0.0.0 的兼容性
- 使用 Google 移动广告 Flutter 插件 5.1.0 版进行构建和测试。