开始

介绍

概述

OpenMediation SaaS 聚合平台提供多样化的变现功能，包括支持原生广告、插屏广告、横幅广告、激励视频广告、开屏广告和交叉推广等多种广告形式，聚合多家主流 AdNetworks 的广告流量。

支持平台

SDK 支持 Android 和 iOS 操作系统，同时提供 Unity 和 Cocos 插件。具体来说，目前支持版本 4.1(API Level 16+)及以上的 Android 系统，和版本9及以上的 iOS 系统。Unity 插件要求 Unity Editor 版本为 2019.4 或以上。Cocos 插件要求 Cocos Creator 版本为 2.4.3。

OpenMediation SDK 包括一个核心组件库，并配合不同的适配器（Adapter）和第三方广告平台的 SDK 来交互访问其全部广告库存。这种架构既能增加灵活性又能降低包大小。

插件

Unity 插件和 Cocos 插件不能单独使用，应与 Android 版或 iOS 版 OpenMediation SDK 配合使用。在 Unity Editor 或 Cocos Creator 中将插件导入您的项目，并针对 Android 或 iOS 构建来测试集成。

智能广告聚合

全新设计的 OpenMediation SDK 携带多项创新的智能化广告技术和全面优化的API接口设计，在广告加载、缓存、展示以及Waterfall、初始化等多个方面进行了全方位的重构和智能化升级，确保应用内广告的高填充率和高收益。OpenMediation始终致力于为移动应用开发者提供最佳的广告聚合解决方案。
在重新架构的SDK版本中，激励视频和插屏类型广告的加载与库存管理是自动进行，开发者不再需要手动调用load方法，SDK智能库存引擎会主动进行广告的预加载和缓存，维护广告库存的高可用。同时，新的SDK API接口更加易于使用，在应用的任何广告场景中检查库存状态并直接进行广告展示即可。开发者可以更加关注于应用逻辑本身，而无需对广告的加载、缓存花费额外的精力。

In-app Bidding

支持符合 IAB 规范的竞价协议，以通过实时竞价最大化收入。 OpenMediation 内置了对 AdTiming、Mintegral、Helium、Vungle 和 PubNative 竞价的支持。通过消除对拍卖服务器的需要，基于客户端的投标拍卖解决方案带来了灵活性和便利性。 拍卖过程与传统瀑布完美结合，在瀑布开始之前，通过竞价会从支持 In-app Bidding 的 AdNetworks 选出一个出价获胜者。 然后基于历史数据出价的 waterfall 中选出的获胜者与 In-app Bidding 出价获胜者进行比较，确定最终获胜者。

集成 OpenMediation

接下来让您可以将通过以下几个简单的步骤将 OpenMediation SDK 集成到您的应用程序中。 当您成功集成 OpenMediation SDK 后您可以聚合更多的第三方广告网络添加到您的应用中。

步骤如下：

1、获取 OpenMediation 平台凭证

在开始将 OpenMediation SDK 集成到您的 APP 之前，您需要先在 OpenMediation 平台中获取 AppKey 和 PlacementID。 在 OpenMediation 平台注册账号并添加您的应用。根据自身需求创建广告位，您可以创建多个广告位，进入菜单 Setup ->Placements 可以查看到所有的广告位信息。

2、添加 OpenMediation SDK 到项目

OpenMediation 支持 Gradle 依赖机制来集成我们的 SDK。 您可以在本文中找到我们最新的 SDK 和演示程序。

3、集成广告网络

OpenMediation聚合平台支持从多个广告网络展示广告，通过将广告请求发给多个平台，筛选最佳广告进行展示，这有助于最大化提升您的广告收益。

您可以参考以下文章添加支持的广告网络：

• AdTiming
• AdMob
• Facebook
• UnityAds
• Vungle
• AdColony
• AppLovin
• Tapjoy
• Chartboost
• Mintegral
• Pangle
• ironSource
• TencentAds
• PubNative

4、集成广告单元

到目前为止，我们都已准备好让您的应用为第一个广告单元做好准备。 一般来说，所有类型的广告都需要以下 4 个步骤，不过有些在 Android 或 iOS 上可能是可选的。

第 1 步：初始化一个广告对象并注册广告监听。主要针对横幅和原生广告类型，其他广告类型无须初始化广告对象。

第 2 步：加载广告。 您无需为奖励视频和插页式广告等广告单元手动调用加载方法，因为 SDK 会自动缓存广告。

第 3 步：投放广告。 推荐的广告投放方式是先检查广告的可用性，然后再向用户展示广告。

您可以参考以下文章：

• 激励视频
• 插屏广告
• 横幅广告
• 原生广告
• 交叉推广
• 开屏广告

高级设置

这里还有一些额外的设置，他们有的用来帮助您的广告符合GDPR CCPA和COPPA的隐私规定，有的用于将转化和应用内购买数据与 OpenMediation 同步，以帮助提升您的广告收益，请务必仔细阅读。

GDPR

OpenMediation 严格遵守IAB欧洲发布的的移动应用CMPAPI v1.0: 透明度与同意框架。

COPPA

为保护儿童，AdTiming不向年纪小于13岁的用户投放广告。因此，也提醒您必须勾选遵守COPPA规范选项。

CCPA

OpenMediation 聚合平台（Android SDK版本2.0.0及更高版本）支持发布商根据《加利福尼亚消费者隐私法》（CCPA）限制最终用户的个人信息销售。

细分流量

您需要将用户的详细信息告知我们的服务器，以便SDK能够根据用户所属的细分来投放广告。
在 OpenMediation 平台上定义用户详细信息后，您应该将用户的详细信息通知给我们的服务器。

iOS 14相关设置

随着iOS 14正式推出，您需要提前准备并及时更新您的app，以确保您的App在iOS 14中的广告变现收益。具体请参考链接。

OpenMediation为您提供了各Network平台的SKAdNetwork Ids汇总信息，为了方便接入也提供了Manager管理器工具，方便您在工程中添加。

错误诊断

如果在 SDK 初始化和加载或展示广告过程中发生任何异常或没有填充等，SDK 将返回错误代码并引发广告单元的 InitCallback 和 AdListener 回调。 按照我们的错误与诊断检查您的集成代码。

开启测试模式测试您的集成

OpenMediation 提供了SDK 测试模式，您可以在指定的设备上进行广告的下载和展示测试，以此来评估和检查 SDK 集成，测试模式会在不影响在线APP的版本和收益的情况下进行。

请转到 OpenMediation 前台将您的设备添加为测试设备，然后打开测试模式进行测试。

需要注意的是，默认情况下广告网络的配置一个小时重置一次。为了避免应用缓存的影响，您需要在开始广告测试之前重启应用。

有关OpenMediation集成更多详细信息，请参考快速指导。