Unity Ads Integration Manual

User Manual:

Open the PDF directly: View PDF .
Page Count: 38

Generative Art – Made with Unity

基本操作与集成手册

2018.8

2.x

●Unity后台操作

○Unity ID

○Operate后台

■Game ID

■Placement ID

■广告位设置

■自动发送收入报表

内容预览

●广告代码集成

○Services Window

○Asset Store Package

○iOS SDK

○Android SDK

●附录

○填写Store ID

○Test Mode

○获得技术支持

○资源链接

●Unity ID

●Operate后台

○Game ID

○Placement ID

○广告位设置

○自动发送收入报表

●

Unity后台操作

Unity ID

Unity ID是您使用所有Unity

服务的身份识别ID.

如果您还没有Unity ID, 请注

册：

https://id.unity.com/

注册需要您：

●同意Unity服务条款

●通过I'm not a robot验证

Operate后台

您可以在Operate后台进行

广告位管理，同时我们也为

您提供了丰富的收入分析报

表.

https://operate.dashboard.

unity3d.com/

Game ID

在您创建Project时，Unity会自动为您生成

Game ID.

Game ID是连接SDK与后台的桥梁,广告运营人

员需要把这个Game ID提供给开发人员, 用于

UnityAds SDK的初始化.

Game ID也是Unity唯一定位您游戏的身份识别

ID, 向Unity支持咨询问题时, 也需要您提供

GameID, 以便针对游戏为您解决问题.

注意：

Unity Game ID由7位数字组成，它不等同于您

游戏的商店应用ID，请勿混淆使用.

创建Project

●首先为您的游戏新建一个

项目 NEW PROJECT.

●参考说明根据游戏实际情

况填写Store ID和COPPA

提示：

如果您的游戏不是仅供美国13岁以下儿

童使用的，则无需勾选COPPA，但我们仍

建议您仔细阅读COPPA协议以取得全面

的了解.

获取Game ID

在后台左侧导航栏

●选中Project.

●选中Monetization

●选中Platforms

即可见Unity自动为该游戏生

成的Game ID (7位数字格

式).

Placement ID

在您创建Project时，Unity也会自动为您生成2个广告位Placement ID, 您也可

以手动添加更多.

一般开发者可能需要使用不同设置的Placement ID来达到不同的广告效果，这

种情况就需要广告运营人员将Placement ID告诉开发人员.

获取Placement ID

在后台左侧导航栏

●选中Project.

●选中Monetization

●选中Placements

即可见当前游戏的广告位

Placement ID.

添加Placement

Unity默认会自动为每个游戏

生成2个Placement, 您可以

通过ADD PLACEMENT添加

更多.

广告位设置

您可以选中广告位Placement

后，在设置页面修改其广告行

为，如右图.

提示：

无论是否允许跳过广告，开发人员都能够在

视频完整观看完成后给予玩家奖励。

不过根据行业惯例，一般建议激励视频设置

为不可跳过。

自动发送收入报表

●选中Operate.

●选中Ad Data Export

●选中Email & CSV

●选中ADD NEW REPORT

提示：

●支持添加多个报告收件人.

●如果分割的维度Split by较多（尤其同时

包含国家与其他维度时），报告可能会

很大，或者服务器可能因分析超时而导

致报告无法正常发送.

Unity支持4种集成方式：

●Services Window

●Asset Store Package

●iOS SDK

●Android SDK

广告代码集成

Services Window

使用Unity开发游戏且Unity版本不低于5.5的开发者，可以在Unity Editor的

Services面板一键开启广告Ads服务.

启用Ads服务

*要求Unity版本不低于5.5

首先到Unity Editor>File>Build Settings,

将Platform切换至iOS或Android.(目前广

告服务只支持这2个平台)

然后通过点击Editor面板上的 Unity

服务图标开启广告Ads服务.

开发者可以选择新建一个项目开启广告服

务，或链接已有的项目.

广告展示、回调

1.在展示广告 Show 之前，需要先用 IsReady 判断

广告是否已加载完成.

2.为了给与玩家奖励，要在展示广告Show的同时传

入处理观看事件的回调resultCallBack(绑在

ShowOptions上).

3.在处理回调时，一般判断当玩家观看广告完成时

给予奖励。

提示:

即使可跳过的广告，如果玩家看完广告的时候，也

会触发观看完成的回调。

绑定广告观看回调

Asset Store Package

使用Unity开发游戏且Unity版本不低于4.6的开发者，可以在Unity AssetStore

官方账号下载最新的UnityAds资源包：

https://assetstore.unity.com/packages/add-ons/services/unity-ads-66123

导入广告资源包

*要求Unity版本不低于4.6

提示：

导入后需要到Unity Editor>File>Build Settings, 将Platform切换至iOS或Android.(目前广告服务只支持这2个平台)

使用广告资源包

集成代码与Services Window唯

一不同处，是需要开发者手动调

用广告初始化语句.

绑定广告观看回调

手动初始化广告

iOS SDK

在iOS(Xcode)项目环境下的开发者，可以在Unity官方GitHub账号下载最新的iOS

SDK (UnityAds.framework)，使用Objective-C或Swift进行广告集成：

https://github.com/Unity-Technologies/unity-ads-ios/releases

SDK 最低支持 iOS 7.0

此处仅讲解Obj-C方法，Swift代码请参考在线文档.

导入广告SDK

首先拖拽UnityAds.framework到

游戏项目，选择Copy.

然后在ViewController.h里import

UnityAds库.

提示：

如果没用到delegate方法可以不用conform

绑定广告观看回调

手动初始化广告

广告初始化

使用Game ID初始化广告

调试选项：

setDebugMode查看Log

testMode使用测试广告

绑定广告观看回调

广告展示

使用Placement ID展示广告

提示：

●展示广告 show 之前，需要先用 isReady 判

断广告是否已加载完成.

●如果广告始终无法ready，可以使用

getPlacementState来检查广告位的状态.

●在上线后，仍然可以在dashboard调整广告

位是否允许跳过等设置.

绑定广告观看回调

广告回调

通过实现<UnityAdsDelegate>的

方法，可以指定系统的广告回调

函数：

提示:

●一般判断当玩家观看广告完成completed时

给予奖励.

●即使可跳过的广告，如果玩家看完广告的时

候，也会触发观看完成的回调.

绑定广告观看回调

手动初始化广告

观看完毕，奖励用户

Android SDK

在Android Studio项目环境下的开发者，可以在Unity官方GitHub账号下载最新的

Android SDK (unity-ads.aar)进行广告集成：

https://github.com/Unity-Technologies/unity-ads-android/releases

SDK 最低支持 API 16 (Android 4.1)

无法使用.aar的开发者则需参考在线文档integrating without Android Studio部分进行广告集成.

导入广告SDK(1/2)

新建aar类型Module，选择

unity-ads.aar导入到项目中.绑定广告观看回调

手动初始化广告

导入广告SDK(2/2)

在app的Module Settings里，添加unity-ads依赖.

绑定广告观看回调

手动初始化广告

广告初始化

使用Game ID初始化广告

调试选项：

setDebugMode查看Log

testMode使用测试广告

重要！

请只初始化一次.

Unity SDK 不支持多进程，且所

有广告操作要放在主线程.

绑定广告观看回调

广告展示

使用Placement ID展示广告

提示：

●展示广告 show 之前，需要先用 isReady 判

断广告是否已加载完成.

●如果广告始终无法ready，可以使用

getPlacementState来检查广告位的状态.

●在上线后，仍然可以在dashboard调整广告

位是否允许跳过等设置.

绑定广告观看回调

广告回调

通过实现IUnityAdsListener的方

法，可以指定广告回调函数：

提示:

●一般判断当玩家观看广告完成completed时

给予奖励.

●即使可跳过的广告，如果玩家看完广告的时

候，也会触发观看完成的回调.

观看完毕，奖励用户

●填写Store ID

●Test Mode

●获得技术支持

●资源链接

附录

iOS游戏的Store ID

是从iTunes store

URL中提取的，如右

图高亮部分：

填写Store ID

-iOS

填写Store ID

-Android

Android游戏的Store

ID是从Google Play

store URL中提取的，

如右图高亮部分：

Test Mode

Unity支持通过添加测试设备、平台设置、代码方式获取测试广告.

测试结束后请务必关闭测试广告，以免影响您的变现收入.

优先级: Test Devices > Platform Settings > 代码

Test Devices

Operate > Ad Data > Export > Test Devices

Platform Settings

Operate > Project > Platform > Settings

iOS SDK

[UnityAds setDebugMode:true];

Android SDK

UnityAds.setDebugMode(true);

绑定广告观看回调

获取技术支持

Operate后台：

点击填写表格获得支持，如右图，

这种方式我们可以自动查询您的账户信息，以

便更快速的为您解决问题.

邮件：

unityads-support@unity3d.com

如果您无法使用Contact Support form，您也

可以发邮件获取支持，但需要您提供详情信息

以便问题的定位和解决。

37

●Unity ID: http://id.unity.com/

●Operate后台: https://operate.dashboard.unity3d.com

●Asset Package下载: https://assetstore.unity.com/packages/add-ons/services/unity-ads-66123

●iOS SDK下载: https://github.com/Unity-Technologies/unity-ads-ios/releases

●Android SDK下载: https://github.com/Unity-Technologies/unity-ads-android/releases

●Unity Ads在线文档 [英文]: http://unityads.unity3d.com/help/index

●Unity Ads在线文档 [中文]: https://github.com/unity-cn/unityads-help-cn/wiki

●常见问题FAQ：https://github.com/unity-cn/unityads-help-cn/wiki/monetization

●广告技术支持: unityads-support@unity3d.com

资源链接

38

Unity Ads Support

Unity Ads Integration Manual

Navigation menu

Versions of this User Manual:

Views

Navigation