将 IronSource 与中介集成

本指南面向希望使用 Google 移动广告 SDK 通过中介加载和展示 ironSource 广告的发布商。 其中介绍了如何将 ironSource 添加到广告单元的中介配置、如何设置广告来源优化功能,以及如何将 ironSource SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

AdMob 针对 ironSource 的中介适配器具有以下功能:

集成
出价
瀑布
格式
横幅
插页式广告
激励广告
插页式激励广告
原生

要求

  • Android API 级别 19 或更高级别
  • 最新版 Google 移动广告 SDK

第 1 步:设置 ironSource

注册登录您的 ironSource 帐号。

如需将应用添加到 ironSource 信息中心,请点击新建应用按钮。

输入应用详情

选择 移动应用,输入应用的Google Play 网址,然后点击导入应用信息。应用信息显示后,点击添加应用按钮。

如果您的应用不可用,请选择 App Not Live in App Store 并为您的应用提供临时名称。选择 Android作为平台,然后点击添加应用

记下新的 App Key,此密钥在应用添加后显示。您需要使用此值来设置AdMob 广告单元 ID。在相应 Live 标签页中选择您的应用支持的广告格式。然后,点击完成

实例 ID

接下来,为您添加的应用配置网络实例;ironSource 支持为激励广告和插页式广告使用多个网络实例。

从左侧导航栏中导航到广告单元和展示位置页面,在应用列表中选择您的应用,然后点击修改按钮。

选择添加网络实例链接,输入实例名称,然后点击保存

创建实例后,实例 ID 会列在实例 ID 字段中。

除了应用密钥实例 ID 之外,您还需要使用 ironSource 密钥刷新令牌来设置AdMob 广告单元 ID。

转到 ironSource 发布商信息中心内的我的帐号,然后点击 API 标签页。记下您的密钥刷新令牌

第 2 步:为广告单元 AdMob 配置中介设置

要将 ironSource 添加到广告单元的中介配置中,请先登录您的 AdMob 帐号

接下来,转到中介标签页。如果您已有要修改的中介组,请点击该中介组的名称进行修改,然后直接将 ironSource 添加为广告来源

要创建新的中介组,请选择创建中介组

输入广告格式和平台,然后点击继续

为中介组命名,然后选择要定位到的地理位置。 接下来,将中介组状态设置为已启用,然后点击添加广告单元

将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后,点击完成

现在,您应该会看到“广告单元”卡片中填充了您选择的广告单元,如下所示:

将 ironSource 添加为广告来源

广告来源卡片中,选择添加广告联盟。然后选择 ironSource

接下来,启用优化功能,然后输入在上一部分获得的密钥刷新令牌,以为 ironSource 设置广告来源优化功能。 然后输入 eCPM 值,并点击继续

输入在上一部分获得的应用密钥实例 ID

使用激励广告

在激励广告单元的设置中,提供奖励金额和奖励类型的值。然后,为确保无论投放哪个广告联盟,您都能向用户提供相同的奖励,请选中 应用于中介组中的所有广告联盟复选框。

如果您不应用此设置,则 ironSource 适配器在创建展示位置时,会传回 ironSource 信息中心中指定的奖励。

如需详细了解如何为 AdMob 广告单元设置奖励值,请参阅创建广告单元

第 3 步:导入 ironSource SDK 和适配器

在应用级 build.gradle 文件中,将以下 ironSource Maven 代码库和实现依赖项添加到最新版本的 ironSource SDK 和适配器中:

repositories {
    google()
    mavenCentral()
    maven {
        url 'https://android-sdk.is.com/'
    }
}

...

dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.0.0'
    implementation 'com.google.ads.mediation:ironsource:7.2.2.1'
}
...

手动集成

  1. 下载最新版本的 ironSource Android SDK,并将其添加到项目中。

  2. 转到 Google 的 Maven 代码库中的 IronSource 适配器工件。选择最新版本,下载 IronSource 适配器的 .aar 文件,并将其添加到您的项目。

第 4 步:需要其他代码

应用生命周期

在每个 Activity 中替换 onPause()onResume() 方法,以调用相应的 ironSource 方法,如下所示:

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)
}

ProGuard 规则

如果您缩减、混淆处理和优化应用,IronSource 需要您的项目的其他 ProGuard 规则。如需了解详情,请参阅 IronSource' 的 Android SDK 集成指南

第 5 步:测试您的实现效果

如需在 ironSource 上启用测试广告,请运行广告集成应用,并检查日志以查找如下所示的消息:

将您的 GAID(即设备的广告 ID)复制到剪贴板。

转到 MONETIZE 标签页,然后点击 Testing 按钮。接下来,点击 New Test Device 按钮。

输入上一步中的设备名称广告 ID。 然后,点击保存

新添加的测试设备列在测试设备下。您可以根据需要在此模块中启用或停用测试广告

可选步骤

根据 Google《欧盟地区用户意见征求政策》,您必须确保向欧洲经济区 (EEA) 内的用户披露与使用设备标识符和个人数据有关的信息,以及征得这些用户的同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时,您必须指明中介链中可能会收集、接收或使用个人数据的广告联盟,并提供各个广告联盟的使用情况信息。Google 目前无法自动将用户的意见传递给此类网络。

以下部分介绍了如何为 ironSource 启用或停用个性化广告。

在 SDK 版本 6.7.9 中,ironSource添加 Consent API。以下示例代码将针对以下规则设置用户意见征求: true 。如果您选择调用此方法,建议您在通过 Google 移动广告 SDK 请求广告之前执行此操作。

import com.ironsource.mediationsdk.IronSource;
...

IronSource.setConsent(true);

如需了解详情,请参阅 ironSource 的管理用户意见征求文档。

将 ironSource 添加到 GDPR 广告合作伙伴列表中

按照 GDPR 设置 中的步骤将 ironSource Mobile 添加到AdMob 界面中的 GDPR 广告合作伙伴列表。

错误代码

如果适配器未能收到来自 ironSource 的广告,则发布商可以使用以下类中的ResponseInfo.getAdapterResponse() 检查来自广告响应的根本错误:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

广告加载失败时, ironSource 适配器抛出的代码和附带的消息如下:

错误代码 原因
101 AdMob 界面中配置的 ironSource 服务器参数缺失/无效。
102 ironSource 需要 Activity 上下文来初始化其 SDK。
103 每个 ironSource 实例 ID 只能加载 1 个广告。
501-1056 ironSource SDK 错误。如需了解详情,请参阅这份文档
101 AdMob 界面中配置的 ironSource 服务器参数缺失/无效。
102 ironSource 适配器不支持请求的广告格式。
103 已为此网络配置加载了 ironSource 广告。
508-1037 ironSource SDK 错误。如需了解详情,请参阅这份文档

IronSource Android 中介适配器变更日志

版本 7.2.3.0(进行中)

  • 验证了与 ironSource SDK 7.2.3 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.3。

版本 7.2.2.1.0

  • 验证了与 ironSource SDK 版本 7.2.2.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.2.1。

版本 7.2.2.0

  • 验证了与 ironSource SDK 版本 7.2.2 的兼容性。
  • compileSdkVersiontargetSdkVersion 更新到了 API 31。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
  • 已将最低的 Android API 级别更新为 19。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.2。

版本 7.2.1.1.0

  • 验证了与 ironSource SDK 版本 7.2.1.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.6.0
  • IronSource SDK 版本 7.2.1.1。

7.2.1.0 版

  • 验证了与 ironSource SDK 7.2.1 版兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.6.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.6.0
  • IronSource SDK 版本 7.2.1。

版本 7.2.0.0

  • 验证了与 ironSource SDK 版本 7.2.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 7.2.0 版。

7.1.14.0 版

  • 验证了与 ironSource SDK 版本 7.1.14 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.14。

7.1.13.0 版

  • 验证了与 ironSource SDK 版本 7.1.13 的兼容性。
  • 更新了适配器,以使用新的 AdError API。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.13。

版本 7.1.12.2.0

  • 经验证与 ironSource SDK 版本 7.1.12.2 兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.5.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.12.2。

版本 7.1.12.1.0

  • 验证了与 ironSource SDK 版本 7.1.12.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.12.1。

7.1.12.0 版

  • 验证了与 ironSource SDK 版本 7.1.12 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.12。

版本 7.1.11.1.0

  • 经验证与 ironSource SDK 版本 7.1.11.1 兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.11.1。

7.1.11.0 版

  • 验证了与 ironSource SDK 版本 7.1.11 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.4.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.11。

7.1.10.0 版

  • 验证了与 ironSource SDK 版本 7.1.10 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.3.0。
  • IronSource SDK 版本 7.1.10。

7.1.9.0 版

  • 验证了与 ironSource SDK 版本 7.1.9 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.3.0。
  • IronSource SDK 7.1.9 版。

7.1.8.0 版

  • 验证了与 ironSource SDK 版本 7.1.8 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 版本 7.1.8。

7.1.7.0 版

  • 经验证与 ironSource SDK 7.1.7 版兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 7.1.7 版。

版本 7.1.6.1.0

  • 验证了与 ironSource SDK 版本 7.1.6.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 版本 7.1.6.1。

7.1.6.0 版

  • 经验证与 ironSource SDK 7.1.6 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.1.0
  • IronSource SDK 7.1.6 版。

版本 7.1.5.1.0

  • 验证了与 ironSource SDK 版本 7.1.5.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.0.0
  • IronSource SDK 版本 7.1.5.1。

7.1.5.0 版

  • 验证了与 ironSource SDK 7.1.5 的版本兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.0.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.0.0
  • IronSource SDK 7.1.5 版。

7.1.4.0 版

  • 经验证与 ironSource SDK 7.1.4 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.8.0。
  • IronSource SDK 7.1.4 版。

7.1.3.0 版

  • 验证了与 ironSource SDK 版本 7.1.3 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.8.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.8.0。
  • IronSource SDK 版本 7.1.3。

7.1.2.0 版

  • 新增了对插页式激励广告的支持。
  • 验证了与 ironSource SDK 版本 7.1.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.2。

版本 7.1.0.2.0

  • 验证了与 ironSource SDK 版本 7.1.0.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.0.2。

版本 7.1.0.1.0

  • 验证了与 ironSource SDK 版本 7.1.0.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.7.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.0.1。

版本 7.0.4.1.0

  • 验证了与 ironSource SDK 版本 7.0.4.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.6.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.6.0。
  • IronSource SDK 版本 7.0.4.1。

7.0.4.0 版

  • 验证了与 ironSource SDK 版本 7.0.4 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.5.0。
  • IronSource SDK 7.0.4 版。

版本 7.0.3.1.0

  • 验证了与 ironSource SDK 版本 7.0.3.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.5.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.5.0。
  • IronSource SDK 版本 7.0.3.1。

版本 7.0.2.0

  • 验证了与 ironSource SDK 版本 7.0.2 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.4.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.4.0。
  • IronSource SDK 版本 7.0.2。

版本 7.0.1.1.0

  • 验证了与 ironSource SDK 版本 7.0.1.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 7.0.1.1。

7.0.0.0 版

  • 验证了与 ironSource SDK 版本 7.0.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 7.0.0。

6.18.0.0 版

  • 验证了与 ironSource SDK 版本 6.18.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 6.18.0。

6.17.0.1 版

  • 添加了描述性错误代码以及适配器加载/显示失败的原因。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.2.0 版。
  • IronSource SDK 版本 6.17.0。

6.17.0.0 版

  • 验证了与 ironSource SDK 版本 6.17.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.17.0。

6.16.2.0 版

  • 验证了与 ironSource SDK 版本 6.16.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.16.2。

6.16.1.0 版

  • 验证了与 ironSource SDK 6.16.1 的版本兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.1.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.16.1。

6.16.0.0 版

  • 已验证与 ironSource SDK 版本 6.16.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.1。
  • IronSource SDK 版本 6.16.0。

6.15.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.15.0.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.0.1。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.1。
  • IronSource SDK 版本 6.15.0.1。

6.15.0.0 版

  • 验证了与 ironSource SDK 版本 6.15.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.0.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.0。
  • IronSource SDK 版本 6.15.0。

6.14.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.14.0.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.14.0.1。

6.14.0.0 版

  • 已验证与 ironSource SDK 版本 6.14.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.14.0。

6.13.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.13.0.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.13.0.1。

6.12.0.0 版

  • 验证了与 ironSource SDK 版本 6.12.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.12.0。

6.11.0.0 版

  • 验证了与 ironSource SDK 版本 6.11.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.11.0。

6.10.0.0 版

  • 验证了与 ironSource SDK 版本 6.10.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.2.0。

6.9.1.0 版

  • 验证了与 ironSource SDK 版本 6.9.1 的兼容性。

6.9.0.1 版

  • 修复了 ironSource 适配器,以移除对实例 ID 的锁定。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.1.1。

6.9.0.0 版

  • 验证了与 ironSource SDK 版本 6.9.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.1.0。

6.8.4.1 版

  • 新增了对请求多个插页式广告的支持。

6.8.4.0 版

  • 验证了与 ironSource SDK 版本 6.8.4 的兼容性。

6.8.1.2 版

  • 修复了以下问题:如果先加载插页式广告,则始终无法加载激励广告。

6.8.1.1 版

  • 更新了适配器,以支持新的公开 Beta 版 API。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 17.2.0。

6.8.1.0 版

  • 验证了与 ironSource SDK 版本 6.8.1 的兼容性。

6.7.12.0 版

  • 验证了与 ironSource SDK 版本 6.7.12 的兼容性。

6.7.11.0 版

  • 验证了与 ironSource SDK 版本 6.7.11 的兼容性。

6.7.10.0 版

  • 验证了与 ironSource SDK 版本 6.7.10 的兼容性。

版本 6.7.9.1.1

  • 更新了适配器,以调用 onRewardedVideoComplete() 广告事件。

6.7.9.1.0 版

  • 验证了与 ironSource SDK 版本 6.7.9.1 的兼容性。

6.7.9.0 版

  • 经验证与 ironSource SDK 版本 6.7.9 兼容。

6.7.8.0 版

  • 验证了与 ironSource SDK 版本 6.7.8 的兼容性。

6.7.7.0 版

  • 为每个广告单元初始化一次 IronSource SDK。
  • 添加了在 onPauseonResume 方法中将 Activity 传递给 IronSource SDK 的选项。
  • 验证了与 ironSource SDK 版本 6.7.0 的兼容性。

6.7.5.0 版

  • 初始版本。
,

本指南面向希望使用 Google 移动广告 SDK 通过中介加载和展示 ironSource 广告的发布商。 其中介绍了如何将 ironSource 添加到广告单元的中介配置、如何设置广告来源优化功能,以及如何将 ironSource SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

AdMob 针对 ironSource 的中介适配器具有以下功能:

集成
出价
瀑布
格式
横幅
插页式广告
激励广告
插页式激励广告
原生

要求

  • Android API 级别 19 或更高级别
  • 最新版 Google 移动广告 SDK

第 1 步:设置 ironSource

注册登录您的 ironSource 帐号。

如需将应用添加到 ironSource 信息中心,请点击新建应用按钮。

输入应用详情

选择 移动应用,输入应用的Google Play 网址,然后点击导入应用信息。应用信息显示后,点击添加应用按钮。

如果您的应用不可用,请选择 App Not Live in App Store 并为您的应用提供临时名称。选择 Android作为平台,然后点击添加应用

记下新的 App Key,此密钥在应用添加后显示。您需要使用此值来设置AdMob 广告单元 ID。在相应 Live 标签页中选择您的应用支持的广告格式。然后,点击完成

实例 ID

接下来,为您添加的应用配置网络实例;ironSource 支持为激励广告和插页式广告使用多个网络实例。

从左侧导航栏中导航到广告单元和展示位置页面,在应用列表中选择您的应用,然后点击修改按钮。

选择添加网络实例链接,输入实例名称,然后点击保存

创建实例后,实例 ID 会列在实例 ID 字段中。

除了应用密钥实例 ID 之外,您还需要使用 ironSource 密钥刷新令牌来设置AdMob 广告单元 ID。

转到 ironSource 发布商信息中心内的我的帐号,然后点击 API 标签页。记下您的密钥刷新令牌

第 2 步:为广告单元 AdMob 配置中介设置

要将 ironSource 添加到广告单元的中介配置中,请先登录您的 AdMob 帐号

接下来,转到中介标签页。如果您已有要修改的中介组,请点击该中介组的名称进行修改,然后直接将 ironSource 添加为广告来源

要创建新的中介组,请选择创建中介组

输入广告格式和平台,然后点击继续

为中介组命名,然后选择要定位到的地理位置。 接下来,将中介组状态设置为已启用,然后点击添加广告单元

将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后,点击完成

现在,您应该会看到“广告单元”卡片中填充了您选择的广告单元,如下所示:

将 ironSource 添加为广告来源

广告来源卡片中,选择添加广告联盟。然后选择 ironSource

接下来,启用优化功能,然后输入在上一部分获得的密钥刷新令牌,以为 ironSource 设置广告来源优化功能。 然后输入 eCPM 值,并点击继续

输入在上一部分获得的应用密钥实例 ID

使用激励广告

在激励广告单元的设置中,提供奖励金额和奖励类型的值。然后,为确保无论投放哪个广告联盟,您都能向用户提供相同的奖励,请选中 应用于中介组中的所有广告联盟复选框。

如果您不应用此设置,则 ironSource 适配器在创建展示位置时,会传回 ironSource 信息中心中指定的奖励。

如需详细了解如何为 AdMob 广告单元设置奖励值,请参阅创建广告单元

第 3 步:导入 ironSource SDK 和适配器

在应用级 build.gradle 文件中,将以下 ironSource Maven 代码库和实现依赖项添加到最新版本的 ironSource SDK 和适配器中:

repositories {
    google()
    mavenCentral()
    maven {
        url 'https://android-sdk.is.com/'
    }
}

...

dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.0.0'
    implementation 'com.google.ads.mediation:ironsource:7.2.2.1'
}
...

手动集成

  1. 下载最新版本的 ironSource Android SDK,并将其添加到项目中。

  2. 转到 Google 的 Maven 代码库中的 IronSource 适配器工件。选择最新版本,下载 IronSource 适配器的 .aar 文件,并将其添加到您的项目。

第 4 步:需要其他代码

应用生命周期

在每个 Activity 中替换 onPause()onResume() 方法,以调用相应的 ironSource 方法,如下所示:

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)
}

ProGuard 规则

如果您缩减、混淆处理和优化应用,IronSource 需要您的项目的其他 ProGuard 规则。如需了解详情,请参阅 IronSource' 的 Android SDK 集成指南

第 5 步:测试您的实现效果

如需在 ironSource 上启用测试广告,请运行广告集成应用,并检查日志以查找如下所示的消息:

将您的 GAID(即设备的广告 ID)复制到剪贴板。

转到 MONETIZE 标签页,然后点击 Testing 按钮。接下来,点击 New Test Device 按钮。

输入上一步中的设备名称广告 ID。 然后,点击保存

新添加的测试设备列在测试设备下。您可以根据需要在此模块中启用或停用测试广告

可选步骤

根据 Google《欧盟地区用户意见征求政策》,您必须确保向欧洲经济区 (EEA) 内的用户披露与使用设备标识符和个人数据有关的信息,以及征得这些用户的同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时,您必须指明中介链中可能会收集、接收或使用个人数据的广告联盟,并提供各个广告联盟的使用情况信息。Google 目前无法自动将用户的意见传递给此类网络。

以下部分介绍了如何为 ironSource 启用或停用个性化广告。

在 SDK 版本 6.7.9 中,ironSource添加 Consent API。以下示例代码将针对以下规则设置用户意见征求: true 。如果您选择调用此方法,建议您在通过 Google 移动广告 SDK 请求广告之前执行此操作。

import com.ironsource.mediationsdk.IronSource;
...

IronSource.setConsent(true);

如需了解详情,请参阅 ironSource 的管理用户意见征求文档。

将 ironSource 添加到 GDPR 广告合作伙伴列表中

按照 GDPR 设置 中的步骤将 ironSource Mobile 添加到AdMob 界面中的 GDPR 广告合作伙伴列表。

错误代码

如果适配器未能收到来自 ironSource 的广告,则发布商可以使用以下类中的ResponseInfo.getAdapterResponse() 检查来自广告响应的根本错误:

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

广告加载失败时, ironSource 适配器抛出的代码和附带的消息如下:

错误代码 原因
101 AdMob 界面中配置的 ironSource 服务器参数缺失/无效。
102 ironSource 需要 Activity 上下文来初始化其 SDK。
103 每个 ironSource 实例 ID 只能加载 1 个广告。
501-1056 ironSource SDK 错误。如需了解详情,请参阅这份文档
101 AdMob 界面中配置的 ironSource 服务器参数缺失/无效。
102 ironSource 适配器不支持请求的广告格式。
103 已为此网络配置加载了 ironSource 广告。
508-1037 ironSource SDK 错误。如需了解详情,请参阅这份文档

IronSource Android 中介适配器变更日志

版本 7.2.3.0(进行中)

  • 验证了与 ironSource SDK 7.2.3 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.3。

版本 7.2.2.1.0

  • 验证了与 ironSource SDK 版本 7.2.2.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.2.1。

版本 7.2.2.0

  • 验证了与 ironSource SDK 版本 7.2.2 的兼容性。
  • compileSdkVersiontargetSdkVersion 更新到了 API 31。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
  • 已将最低的 Android API 级别更新为 19。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 21.0.0。
  • IronSource SDK 版本 7.2.2。

版本 7.2.1.1.0

  • 验证了与 ironSource SDK 版本 7.2.1.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.6.0
  • IronSource SDK 版本 7.2.1.1。

7.2.1.0 版

  • 验证了与 ironSource SDK 7.2.1 版兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.6.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.6.0
  • IronSource SDK 版本 7.2.1。

版本 7.2.0.0

  • 验证了与 ironSource SDK 版本 7.2.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 7.2.0 版。

7.1.14.0 版

  • 验证了与 ironSource SDK 版本 7.1.14 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.14。

7.1.13.0 版

  • 验证了与 ironSource SDK 版本 7.1.13 的兼容性。
  • 更新了适配器,以使用新的 AdError API。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.13。

版本 7.1.12.2.0

  • 经验证与 ironSource SDK 版本 7.1.12.2 兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.5.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.5.0。
  • IronSource SDK 版本 7.1.12.2。

版本 7.1.12.1.0

  • 验证了与 ironSource SDK 版本 7.1.12.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.12.1。

7.1.12.0 版

  • 验证了与 ironSource SDK 版本 7.1.12 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.12。

版本 7.1.11.1.0

  • 经验证与 ironSource SDK 版本 7.1.11.1 兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.11.1。

7.1.11.0 版

  • 验证了与 ironSource SDK 版本 7.1.11 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.4.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.4.0。
  • IronSource SDK 版本 7.1.11。

7.1.10.0 版

  • 验证了与 ironSource SDK 版本 7.1.10 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.3.0。
  • IronSource SDK 版本 7.1.10。

7.1.9.0 版

  • 验证了与 ironSource SDK 版本 7.1.9 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.3.0。
  • IronSource SDK 7.1.9 版。

7.1.8.0 版

  • 验证了与 ironSource SDK 版本 7.1.8 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 版本 7.1.8。

7.1.7.0 版

  • 经验证与 ironSource SDK 7.1.7 版兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 7.1.7 版。

版本 7.1.6.1.0

  • 验证了与 ironSource SDK 版本 7.1.6.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.2.0。
  • IronSource SDK 版本 7.1.6.1。

7.1.6.0 版

  • 经验证与 ironSource SDK 7.1.6 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.1.0
  • IronSource SDK 7.1.6 版。

版本 7.1.5.1.0

  • 验证了与 ironSource SDK 版本 7.1.5.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.0.0
  • IronSource SDK 版本 7.1.5.1。

7.1.5.0 版

  • 验证了与 ironSource SDK 7.1.5 的版本兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 20.0.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 20.0.0
  • IronSource SDK 7.1.5 版。

7.1.4.0 版

  • 经验证与 ironSource SDK 7.1.4 版兼容。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.8.0。
  • IronSource SDK 7.1.4 版。

7.1.3.0 版

  • 验证了与 ironSource SDK 版本 7.1.3 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.8.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.8.0。
  • IronSource SDK 版本 7.1.3。

7.1.2.0 版

  • 新增了对插页式激励广告的支持。
  • 验证了与 ironSource SDK 版本 7.1.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.2。

版本 7.1.0.2.0

  • 验证了与 ironSource SDK 版本 7.1.0.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.0.2。

版本 7.1.0.1.0

  • 验证了与 ironSource SDK 版本 7.1.0.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.7.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.7.0。
  • IronSource SDK 版本 7.1.0.1。

版本 7.0.4.1.0

  • 验证了与 ironSource SDK 版本 7.0.4.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.6.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.6.0。
  • IronSource SDK 版本 7.0.4.1。

7.0.4.0 版

  • 验证了与 ironSource SDK 版本 7.0.4 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.5.0。
  • IronSource SDK 7.0.4 版。

版本 7.0.3.1.0

  • 验证了与 ironSource SDK 版本 7.0.3.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.5.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.5.0。
  • IronSource SDK 版本 7.0.3.1。

版本 7.0.2.0

  • 验证了与 ironSource SDK 版本 7.0.2 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.4.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.4.0。
  • IronSource SDK 版本 7.0.2。

版本 7.0.1.1.0

  • 验证了与 ironSource SDK 版本 7.0.1.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 7.0.1.1。

7.0.0.0 版

  • 验证了与 ironSource SDK 版本 7.0.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 7.0.0。

6.18.0.0 版

  • 验证了与 ironSource SDK 版本 6.18.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.3.0。
  • IronSource SDK 版本 6.18.0。

6.17.0.1 版

  • 添加了描述性错误代码以及适配器加载/显示失败的原因。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.2.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.2.0 版。
  • IronSource SDK 版本 6.17.0。

6.17.0.0 版

  • 验证了与 ironSource SDK 版本 6.17.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.17.0。

6.16.2.0 版

  • 验证了与 ironSource SDK 版本 6.16.2 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.16.2。

6.16.1.0 版

  • 验证了与 ironSource SDK 6.16.1 的版本兼容。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.1.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.1.0。
  • IronSource SDK 版本 6.16.1。

6.16.0.0 版

  • 已验证与 ironSource SDK 版本 6.16.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.1。
  • IronSource SDK 版本 6.16.0。

6.15.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.15.0.1 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.0.1。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.1。
  • IronSource SDK 版本 6.15.0.1。

6.15.0.0 版

  • 验证了与 ironSource SDK 版本 6.15.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 19.0.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 19.0.0。
  • IronSource SDK 版本 6.15.0。

6.14.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.14.0.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.14.0.1。

6.14.0.0 版

  • 已验证与 ironSource SDK 版本 6.14.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.14.0。

6.13.0.1.0 版

  • 验证了与 ironSource SDK 版本 6.13.0.1 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.13.0.1。

6.12.0.0 版

  • 验证了与 ironSource SDK 版本 6.12.0 的兼容性。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.12.0。

6.11.0.0 版

  • 验证了与 ironSource SDK 版本 6.11.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.3.0。

构建和测试时使用的工具:

  • Google 移动广告 SDK 版本 18.3.0。
  • IronSource SDK 版本 6.11.0。

6.10.0.0 版

  • 验证了与 ironSource SDK 版本 6.10.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.2.0。

6.9.1.0 版

  • 验证了与 ironSource SDK 版本 6.9.1 的兼容性。

6.9.0.1 版

  • 修复了 ironSource 适配器,以移除对实例 ID 的锁定。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.1.1。

6.9.0.0 版

  • 验证了与 ironSource SDK 版本 6.9.0 的兼容性。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 18.1.0。

6.8.4.1 版

  • 新增了对请求多个插页式广告的支持。

6.8.4.0 版

  • 验证了与 ironSource SDK 版本 6.8.4 的兼容性。

6.8.1.2 版

  • 修复了以下问题:如果先加载插页式广告,则始终无法加载激励广告。

6.8.1.1 版

  • 更新了适配器,以支持新的公开 Beta 版 API。
  • 将所需的最低 Google 移动广告 SDK 版本更新为 17.2.0。

6.8.1.0 版

  • 验证了与 ironSource SDK 版本 6.8.1 的兼容性。

6.7.12.0 版

  • 验证了与 ironSource SDK 版本 6.7.12 的兼容性。

6.7.11.0 版

  • 验证了与 ironSource SDK 版本 6.7.11 的兼容性。

6.7.10.0 版

  • 验证了与 ironSource SDK 版本 6.7.10 的兼容性。

版本 6.7.9.1.1

  • 更新了适配器,以调用 onRewardedVideoComplete() 广告事件。

6.7.9.1.0 版

  • 验证了与 ironSource SDK 版本 6.7.9.1 的兼容性。

6.7.9.0 版

  • 经验证与 ironSource SDK 版本 6.7.9 兼容。

6.7.8.0 版

  • 验证了与 ironSource SDK 版本 6.7.8 的兼容性。

6.7.7.0 版

  • 为每个广告单元初始化一次 IronSource SDK。
  • 添加了在 onPauseonResume 方法中将 Activity 传递给 IronSource SDK 的选项。
  • 验证了与 ironSource SDK 版本 6.7.0 的兼容性。

6.7.5.0 版

  • 初始版本。