UnityAds

Service

2022年09月26日 11:19

Unity 账户创建

1.进入Unity官网，创建并登录您的Unity账户。

2.登录账户后，点击 控制面板进入创建app步骤。

Unity应用程序创建

1.进入Projects板块，选择Create project开始创建应用程序。

2.进入Monetization板块，选择左侧导航栏Organization Overview并点击Get started开始创建广告应用程序。

3.依次选择对应的选项后按ok保存。

请确保选择Third Party Mediation 和Other选项

若您的应用尚未发布请选择My app is not live in an app store yet
若您的应用已发布请在对应的平台填写对应的app链接，若只发布一个平台，请在另外一个平台选择I don’t publish on Apple App Store或I don’t publish on Google Play Store
若您的应用未发布在Google Play和App Store请选择I don’t publish on Apple App Store和I don’t publish on Google Play Store

Unity广告位创建

1.Monetization下的Ad Units 模块，点击Add ad unit添加广告位点击进入Project板块后，Unity会默认创建一个video广告位（即插屏视频广告位）和一个rewardedVideo广告位（激励视频广告位）。

2.填写Ad Unit Name ，选择展示平台和需要创建的广告位形式后点击Create。

4.编辑广告位设置后，进行保存。

Placement ID：您可以自行定义您的Placement ID，我们建议您命名为: Placement ID_Ad Network Name_ Country。（例如：6539_Unity_USA_40）
Status：及Placement状态，Enabled为开启、Disabled为关闭。
Ad types：点击后可选择接受的广告素材类型，包括Video（视频）、Display（图片）、Playable（试玩），推荐勾选视频和试玩。
Muting：指广告播放时是否为静音状态，推荐选择Audio not muted（非静音）。
Allow skip：是否允许广告可跳过。激励视频广告位选择No（不可跳过）。插屏视频一般选择Yes（可跳过）。

OpenMediation后台配置

Ad Network配置

1.进入OpenMediation后台，点击左侧导航栏Ad Network→在Unity后方点击Edit。

2.填写相关信息后点击Save。

Game ID：您可以在Unity后台Monetization页面中Ad units模块获取Game ID。
Currency：选择Unity后台报表中的相应货币单位。
API Key：您可以通过以下步骤获取API Key。
- 在Monetization 页面 API Management 模块Monetization Stats API Access后方获取API Key，若没有自动生成，可点击Create API Key生成。
Organization core ID：您可以在Unity后台的Organization Settings中获取。

Instance 配置

1.点击左侧导航栏Mediation→选择对应广告位→Add Instance。

2.填写相应信息后保存设置。

Ad Network：选择Unity。
Instance Name：您可以自行定义您的广告单元名称，我们建议您命名为 Placement ID_Ad Network Name_ Country 例如：6539_Unity_USA_40
Unit ID：您可以进入 Placement界面获取，即Placement ID。

Unity测试模式

开启测试模式进行测试非常重要，我们强烈建议您在应用发布前通过以下方式进行测试。

1.点击Settings下拉菜单进入Project Settings页面，选择Test mode模块。选择应用对应平台之后，勾选Override client test mode，并选择Force test mode ON (i.e. use test ads) for all devices。点击save后即为开启测试模式。

2.添加测试设备

Platform：手机系统平台
Device name：您可自行定义
Advertising ID ：Android为手机的GAID、IOS为手机的IDFA

添加 SDK 和 Adapter 到项目中

Android

1. 添加 UnityAds SDK

将下面的脚本添加到您的 application-level build.gradle 文件中 dependencies 分段内。

implementation 'com.unity3d.ads:unity-ads:+'

2. 添加 UnityAds 适配器

Adapter 的集成支持 Maven（Gradle依赖）自动下载和手动下载两种方式。

Gradle 依赖

将下面的脚本添加到您的 application-level build.gradle 文件中 dependencies 分段内。

implementation 'com.openmediation.adapters:unity:+'

手动下载

点击下载 UnityAds Adapter。
在工程中的 build.gradle 中添加 Adapter 依赖。

3. 仅针对使用 ProGuard

如果您将 ProGuard 与 UnityAds 适配器一起使用，则必须将以下代码添加到 ProGuard 配置中 (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt)：

-keepattributes SourceFile,LineNumberTable
 -keepattributes JavascriptInterface
 -keep class android.webkit.JavascriptInterface {
     *;
 }
 -keep class com.unity3d.** {
     *;
 }

iOS

OpenMediation 支持 Cocoapods 和手动下载两种方式。

Cocoapods

使用 Cocoapods 集成 Unity SDK，请在podfile中输入一下命令即可。

pod 'UnityAds'