将 ironSource 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 ironSource Ads 的广告，其中涵盖了瀑布流集成。如何将 ironSource Ads 添加到广告单元的中介配置，以及如何将 ironSource Ads SDK 和适配器集成到 Unity 应用中。

支持的集成和广告格式

ironSource Ads 的 Ad Manager 中介适配器具有以下功能：

集成
出价
瀑布流
表现形式
横幅
插页式广告
激励广告
插页式激励广告  1

1 只有瀑布流集成支持此格式。

要求

  • 最新版 Google 移动广告 SDK
  • Unity 4 或更高版本
  • [对于出价]：如需在出价中集成所有受支持的广告格式，请使用 IronSource 的 Google 移动广告中介插件 3.5.1 或更高版本（建议使用最新版本）
  • 如需在 Android 上部署，则要求：
    • Android API 级别 23 或更高级别
  • 如需在 iOS 上部署，则要求：
    • iOS 部署目标版本为 12.0 或更高版本
  • 已配置 Google 移动广告 SDK 的 Unity 项目，该项目应正常运行。如需了解详情，请参阅使用入门。
  • 完成中介入门指南阅读。

第 1 步：在 ironSource Ads 界面中设置配置

注册并登录您的 ironSource Ads 账号。

添加新应用

如需添加新应用，请依次前往广告 > 应用，然后点击添加应用。

填写表单，然后点击添加应用。

记下应用密钥，然后选择您的应用支持的广告格式，并点击继续。

Android

iOS

创建实例

接下来，为添加的应用配置实例。

依次前往广告 > 设置 > 实例。选择相应应用，然后点击创建实例。

出价

填写表单，然后为价格选择出价。点击保存并关闭。

Android

iOS

记下实例 ID。

Android

iOS

瀑布

填写表单，然后点击保存并关闭。

记下实例 ID。

查找 Reporting API 密钥

出价

出价集成不需要执行此步骤。

瀑布

点击“我的账号”页面中的 API 标签页，并记下您的 Secret Key 和 Refresh Token。

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未完成此项操作，请为 Ad Manager 创建 app-ads.txt 文件。

如需为 ironSource 实现 app-ads.txt，请参阅 ironSource 授权转销商。

启用测试模式

按照 ironSource Ads 的集成测试指南中的说明，了解如何启用 ironSource Ads 测试广告。

第 2 步：在 Ad Manager 界面中设置 ironSource Ads 需求

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需查看相关说明，请参阅 iOS 指南中的第 2 步。

将 ironSource Mobile 添加到 GDPR 和美国州级法规广告合作伙伴名单中

请按照欧洲法规设置和美国州级法规设置中的步骤，将 ironSource Mobile 添加到 Ad Manager 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。

第 3 步：导入 ironSource Ads SDK 和适配器

OpenUPM-CLI

如果您已安装 OpenUPM-CLI，则可以运行以下命令，将适用于 Unity 的 Google 移动广告 ironSource 广告中介插件安装到您的项目中（从项目的根目录运行）：

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

在 Unity 项目编辑器中，依次选择 Edit > Project Settings > Package Manager，打开 Unity Package Manager Settings。

在范围内的注册表标签页下，添加 OpenUPM 作为范围内的注册表，并提供以下详细信息：

  • 名称：OpenUPM
  • URL：https://package.openupm.com
  • 范围：com.google

OpenUPM 详细信息

然后，依次前往 Window > Package Manager，打开 Unity Package Manager，并从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google Mobile Ads IronSource Mediation 软件包，然后点击 Install。

从 OpenUPM 安装

Unity 软件包

从更改日志中的下载链接下载适用于 ironSource 广告的 Google 移动广告中介插件的最新版本，然后从 ZIP 文件中提取 GoogleMobileAdsIronSourceMediation.unitypackage。

在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsIronSourceMediation.unitypackage 文件。确保已选择所有文件，然后点击导入。

从 Unity 导入

然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

强制解决

第 4 步：在 ironSource Ads SDK 上实现隐私设置

为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息，并征得他们同意，才能在法律要求的情况下使用 Cookie 或其他本地存储空间，以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。Google 无法自动将用户意见传递给此类广告资源网。

从 ironSource 适配器 Unity 插件版本 2.6.0 开始，ironSource 会自动读取支持 Google 的附加意见征求规范（包括 UMP SDK）的意见征求管理平台设置的 GDPR 意见征求。如需了解详情，请参阅支持 Google UMP 和支持 Google 附加意见征求的 CMP。

美国州级隐私保护法律

美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。

适用于 ironSource 广告的 Google 移动广告中介插件版本 2.2.4 包含 IronSource.SetMetaData() 方法。以下示例代码展示了如何将用户意见信息传递给 ironSource Ads SDK。您必须在初始化 Google 移动广告 SDK 之前设置这些选项，以确保它们能够正确转发到 ironSource 广告 SDK。

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

如需详细了解此方法中可提供的值，请参阅 ironSource Ads 的法规高级设置文档（针对 Android 和 iOS）。

第 5 步：添加必需的代码

Android

Proguard 规则

如果您缩减、混淆处理和优化应用，IronSource Ads 需要为您的项目添加额外的 ProGuard 规则。

构建项目时，请选择 Android 作为平台。然后，打开 Player Settings，并在 Publishing Settings 标签页下选中 User Proguard File。Unity 应显示为您创建的自定义 proguard-user.txt 文件，供您修改。

Unity 用户 Proguard 文件

如需详细了解项目所需的 ProGuard 规则，请参阅 IronSource 广告的 Android SDK 集成指南，并将这些规则添加到 proguard-user.txt 文件中。

iOS

SKAdNetwork 集成

按照 ironSource Ads 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 6 步：测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备，并在 ironSource Ads 界面中启用测试模式。

验证测试广告

若要验证您是否能收到来自 ironSource Ads 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 ironSource Ads (Bidding) 和 ironSource Ads (Waterfall)（ironSource Ads [出价] 和 ironSource Ads [瀑布流]）作为广告来源。

错误代码

如果适配器未能收到来自 ironSource Ads 的广告，发布商可以使用 ResponseInfo 来检查广告响应中归属于以下类的底层错误：

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

以下是当广告加载失败时，ironSource 广告适配器会抛出的代码和随附的消息：

Android

错误代码 原因
101 在 Ad Manager 界面中配置的 ironSource Ads 服务器参数缺失/无效。
102 ironSource Ads 需要 Activity 上下文才能初始化其 SDK。
103 ironSource Ads 只能为每个 ironSource 实例 ID 加载 1 个广告。
105 ironSource Ads 不支持所请求的横幅广告尺寸。
106 ironSource Ads SDK 未初始化。
501-1056 ironSource Ads SDK 错误。如需了解详情，请参阅文档。

iOS

错误代码 原因
101 在 Ad Manager 界面中配置的 ironSource Ads 服务器参数缺失/无效。
102 ironSource 广告适配器不支持所请求的广告格式。
103 已针对此广告资源网配置加载 ironSource 广告。
104 ironSource Ads 不支持所请求的横幅广告尺寸。
508-1037 ironSource Ads SDK 错误。如需了解详情，请参阅文档。

IronSource Unity 中介插件变更日志

3.10.0 版

版本 3.9.1

3.9.0 版

版本 3.8.1

3.8.0 版

3.7.0 版

版本 3.6.1

3.6.0 版

版本 3.5.2

版本 3.5.1

3.5.0 版

3.4.0 版

版本 3.3.1

3.3.0 版

版本 3.2.1

3.2.0 版

版本 3.1.1

3.1.0 版

3.0.1 版

3.0.0 版

版本 2.6.1

版本 2.6.0

版本 2.5.0

版本 2.4.0

版本 2.3.1

版本 2.3.0

版本 2.2.7

版本 2.2.6

版本 2.2.5

版本 2.2.4

版本 2.2.3

版本 2.2.2

版本 2.2.1

版本 2.2.0

版本 2.1.5

版本 2.1.4

版本 2.1.3

版本 2.1.2

版本 2.1.1

版本 2.1.0

版本 2.0.3

版本 2.0.2

版本 2.0.1

版本 2.0.0

1.10.0 版

版本 1.9.1

版本 1.9.0

版本 1.8.2

版本 1.8.1

版本 1.8.0

版本 1.7.0

版本 1.6.0

版本 1.5.0

版本 1.4.0

版本 1.3.2

版本 1.3.1

  • 支持 IronSource Android 适配器版本 6.10.0.0
  • 支持 IronSource iOS 适配器版本 6.8.6.0

版本 1.3.0

  • 支持 IronSource Android 适配器版本 6.10.0.0
  • 支持 IronSource iOS 适配器版本 6.8.4.1.0

版本 1.2.0

  • 支持 IronSource Android 适配器版本 6.9.0.1
  • 支持 IronSource iOS 适配器版本 6.8.4.1.0

版本 1.1.2

  • 支持 IronSource Android 适配器版本 6.8.4.1
  • 支持 IronSource iOS 适配器版本 6.8.4.1

版本 1.1.1

  • 支持 IronSource Android 适配器版本 6.8.4.1
  • 支持 IronSource iOS 适配器版本 6.8.3.0

版本 1.1.0

  • 更新了插件，以支持新的开放式 Beta 版激励广告 API。
  • 支持 IronSource Android 适配器版本 6.8.1.2
  • 支持 IronSource iOS 适配器版本 6.8.0.1

版本 1.0.4

  • 支持 IronSource Android 适配器版本 6.7.11.0
  • 支持 IronSource iOS 适配器版本 6.7.11.0

版本 1.0.3

  • 支持 IronSource Android 适配器版本 6.7.10.0
  • 支持 IronSource iOS 适配器版本 6.7.10.0

版本 1.0.2

  • 支持 IronSource Android 适配器版本 6.7.9.1.1
  • 支持 IronSource iOS 适配器版本 6.7.10.0
  • 修复了与 Chartboost Unity 中介插件的冲突。

版本 1.0.1

  • 支持 IronSource Android 适配器版本 6.7.9.0。
  • 支持 IronSource iOS 适配器版本 6.7.9.2.0。

版本 1.0.0

  • 首次发布！
  • 支持 IronSource Android 适配器版本 6.7.9.0。
  • 支持 IronSource iOS 适配器版本 6.7.9.1.0。