Unity Ads Integration Manual

User Manual:

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

DownloadUnity Ads Integration Manual
Open PDF In BrowserView PDF
2018.8

1

Generative Art – Made with Unity

2.x

基本操作与集成手册

内容预览

● Unity后台操作

● 广告代码集成

● 附录

○ Unity ID

○ Services Window

○ 填写Store ID

○ Operate后台

○ Asset Store Package

○ Test Mode

■ Game ID

○ iOS SDK

○ 获得技术支持

■ Placement ID

○ Android SDK

○ 资源链接

■ 广告位设置
■ 自动发送收入报表

2

Unity后台操作
● Unity ID
● Operate后台
○ Game ID
○ Placement ID
○ 广告位设置
○ 自动发送收入报表
●
3

Unity ID
Unity ID是您使用所有Unity
服务的身份识别ID.
如果您还没有Unity ID, 请注
册：
https://id.unity.com/
注册需要您：
● 同意Unity服务条款
● 通过I'm not a robot验证

4

Operate后台
您可以在Operate后台进行
广告位管理，同时我们也为
您提供了丰富的收入分析报
表.
https://operate.dashboard.
unity3d.com/

5

在您创建Project时，Unity会自动为您生成
Game ID.
Game ID是连接SDK与后台的桥梁,广告运营人
员需要把这个Game ID提供给开发人员, 用于
UnityAds SDK的初始化.

Game ID

Game ID也是Unity唯一定位您游戏的身份识别
ID, 向Unity支持咨询问题时, 也需要您提供
GameID, 以便针对游戏为您解决问题.
注意：
Unity Game ID由7位数字组成，它不等同于您
游戏的商店应用ID，请勿混淆使用.
6

创建Project
● 首先为您的游戏新建一个
项目 NEW PROJECT.
● 参考说明根据游戏实际情
况填写Store ID和COPPA
提示：
如果您的游戏不是仅供美国13岁以下儿
童使用的，则无需勾选COPPA，但我们仍
建议您仔细阅读COPPA协议以取得全面
的了解.

7

获取Game ID
在后台左侧导航栏
● 选中Project.
● 选中Monetization
● 选中Platforms
即可见Unity自动为该游戏生
成的Game ID (7位数字格
式).

8

Placement ID
在您创建Project时，Unity也会自动为您生成2个广告位Placement ID, 您也可
以手动添加更多.
一般开发者可能需要使用不同设置的Placement ID来达到不同的广告效果，这
种情况就需要广告运营人员将Placement ID告诉开发人员.

9

获取Placement ID
在后台左侧导航栏
● 选中Project.
● 选中Monetization
● 选中Placements
即可见当前游戏的广告位
Placement ID.

10

添加Placement
Unity默认会自动为每个游戏
生成2个Placement, 您可以
通过ADD PLACEMENT添加
更多.

11

广告位设置
您可以选中广告位Placement
后，在设置页面修改其广告行
为，如右图.
提示：
无论是否允许跳过广告，开发人员都能够在
视频完整观看完成后给予玩家奖励。
不过根据行业惯例，一般建议激励视频设置
为不可跳过。

12

自动发送收入报表
●
●
●
●

选中Operate.
选中Ad Data Export
选中Email & CSV
选中ADD NEW REPORT

提示：
● 支持添加多个报告收件人.
● 如果分割的维度Split by较多（尤其同时
包含国家与其他维度时），报告可能会
很大，或者服务器可能因分析超时而导
致报告无法正常发送.

13

广告代码集成
Unity支持4种集成方式：
● Services Window
● Asset Store Package
● iOS SDK
● Android SDK

14

Services Window
使用Unity开发游戏且Unity版本不低于5.5的开发者，可以在Unity Editor的
Services面板一键开启广告Ads服务.

15

启用Ads服务
*要求Unity版本不低于5.5
首先到Unity Editor>File>Build Settings,
将Platform切换至iOS或Android.(目前广
告服务只支持这2个平台)
然后通过点击Editor面板上的
服务图标开启广告Ads服务.

Unity

开发者可以选择新建一个项目开启广告服
务，或链接已有的项目.

16

广告展示、回调
1.在展示广告 Show 之前，需要先用 IsReady 判断
广告是否已加载完成.
2.为了给与玩家奖励，要在展示广告Show的同时传
入处理观看事件的回调resultCallBack(绑在
绑定广告观看回调

ShowOptions上).
3.在处理回调时，一般判断当玩家观看广告完成时
给予奖励。
提示:
即使可跳过的广告，如果玩家看完广告的时候，也
会触发观看完成的回调。
17

Asset Store Package
使用Unity开发游戏且Unity版本不低于4.6的开发者，可以在Unity AssetStore
官方账号下载最新的UnityAds资源包：
https://assetstore.unity.com/packages/add-ons/services/unity-ads-66123

18

导入广告资源包
*要求Unity版本不低于4.6
提示：
导入后需要到Unity Editor>File>Build Settings, 将Platform切换至iOS或Android.(目前广告服务只支持这2个平台)

19

使用广告资源包
手动初始化广告

集成代码与Services Window唯
一不同处，是需要开发者手动调
用广告初始化语句.
绑定广告观看回调

20

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代码请参考在线文档.
21

导入广告SDK
手动初始化广告

首先拖拽UnityAds.framework到
游戏项目，选择Copy.
绑定广告观看回调

然后在ViewController.h里import
UnityAds库.
提示：
如果没用到delegate方法可以不用conform


22

广告初始化
使用Game ID初始化广告
绑定广告观看回调

调试选项：
setDebugMode查看Log
testMode使用测试广告

23

广告展示
使用Placement ID展示广告
绑定广告观看回调
提示：
● 展示广告 show 之前，需要先用 isReady 判
断广告是否已加载完成.
● 如果广告始终无法ready，可以使用
getPlacementState来检查广告位的状态.
● 在上线后，仍然可以在dashboard调整广告
位是否允许跳过等设置.

24

广告回调
手动初始化广告

通过实现的
方法，可以指定系统的广告回调
函数：
绑定广告观看回调
提示:
● 一般判断当玩家观看广告完成completed时
给予奖励.
观看完毕，奖励用户

● 即使可跳过的广告，如果玩家看完广告的时
候，也会触发观看完成的回调.

25

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部分进行广告集成.
26

导入广告SDK(1/2)
手动初始化广告

新建aar类型Module，选择
unity-ads.aar导入到项目中.

绑定广告观看回调

27

导入广告SDK(2/2)
在app的Module Settings里，添加unity-ads依赖.
手动初始化广告

绑定广告观看回调

28

广告初始化
使用Game ID初始化广告

调试选项：
setDebugMode查看Log
testMode使用测试广告

绑定广告观看回调

重要！
请只初始化一次.
Unity SDK 不支持多进程，且所
有广告操作要放在主线程.

29

广告展示
使用Placement ID展示广告
绑定广告观看回调
提示：
● 展示广告 show 之前，需要先用 isReady 判
断广告是否已加载完成.
● 如果广告始终无法ready，可以使用
getPlacementState来检查广告位的状态.
● 在上线后，仍然可以在dashboard调整广告
位是否允许跳过等设置.

30

广告回调
通过实现IUnityAdsListener的方
法，可以指定广告回调函数：

提示:
● 一般判断当玩家观看广告完成completed时
给予奖励.

观看完毕，奖励用户

● 即使可跳过的广告，如果玩家看完广告的时
候，也会触发观看完成的回调.

31

附录
● 填写Store ID
● Test Mode
● 获得技术支持
● 资源链接

32

填写Store ID
-iOS
iOS游戏的Store ID
是从iTunes store
URL中提取的，如右
图高亮部分：

33

填写Store ID
-Android
Android游戏的Store
ID是从Google Play
store URL中提取的，
如右图高亮部分：

34

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);
35

获取技术支持
Operate后台：
点击
填写表格获得支持，如右图，
这种方式我们可以自动查询您的账户信息，以
便更快速的为您解决问题.

邮件：
unityads-support@unity3d.com
如果您无法使用Contact Support form，您也
可以发邮件获取支持，但需要您提供详情信息
以便问题的定位和解决。
36

资源链接
● 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

37

Unity Ads Support
38
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.4
Linearized                      : No
Warning                         : Root object (4 0 obj) not found at 16
EXIF Metadata provided by EXIF.tools

Navigation menu