Unity Ads SDK iOS集成指南

小提示：您能找到这篇{Unity Ads SDK iOS集成指南}绝对不是偶然，我们能帮您找到潜在客户，解决您的困扰。如果您对本页介绍的Unity Ads SDK iOS集成指南内容感兴趣，有相关需求意向欢迎拨打我们的服务热线，或留言咨询，我们将第一时间联系您！

< font-size: 16px;">

< font-size: 16px;">下载最新版本的 Unity Ads Framework

< font-size: 16px;">Unity iOS 2.0 SDK 最低支持 iOS 7.0

< font-size: 16px;">大纲

< font-size: 16px;">Quickstart 指南

< font-size: 16px;">新建游戏项目 Project

< font-size: 16px;">代码集成

< font-size: 16px;">Swift

< font-size: 16px;">Objective-C

< font-size: 16px;">高级操作指南

< font-size: 16px;">Quickstart 指南

< font-size: 16px;">在Unity Ads Dashboard 新建一个游戏项目 Project

< font-size: 16px;">使用您的 UDN 账户登录 UnityAds开发者操作台.

< font-size: 16px;">如果您还没有 UDN 账户，请注册

< font-size: 16px;">从开发者后台选择 Projects > 点击 NEW PROJECT 新建一个项目.

< font-size: 16px;">提示： 如果您的游戏在美国发布且专门供美国13岁以下的儿童使用，依据美国儿童隐私保护法，您需要点击COPPA勾选框。全年龄段适用的游戏则不需要勾选此项。

< font-size: 16px;">选中新建的项目 > Settings > Project Settings , 您可以看到Unity自动为iOS和Android平台分别生成的对应 GAME ID 。您将会在初始化 Unity Ads 时使用对应的 Game ID 。

< font-size: 16px;">Locate your Game ID

< font-size: 16px;">选中新建的项目 > Monetization > Placements , 您可以查看广告位，Unity会在您新建项目时默认为您生成2个广告位，您也可以手动添加更多。

< font-size: 16px;">video (默认广告位 / 5秒后允许用户跳过广告)

< font-size: 16px;">rewardedVideo (不可跳过广告)

< font-size: 16px;">可选： 通过Platform的设置选项开启测试模式以接收测试广告，游戏发布上线前，请您务必记得回到此处关闭测试模式，以免影响您的广告收入。

< font-size: 16px;">Projects > 选中一个项目 > Settings > Project Settings > Test Mode > 选择一个平台 > Force test mode ON

< font-size: 16px;">代码集成

< font-size: 16px;">Swift 集成 Unity Ads

< font-size: 16px;">点击跳转Objective-C方式

< font-size: 16px;">导入Unity Ads

< font-size: 16px;">下载最新版本的 Unity Ads Framework

< font-size: 16px;">拖拽UnityAds.framework到您的项目，添加时勾选 Copy items.

< font-size: 16px;">在 ViewController 中导入UnityAds，并实现 UnityAdsDelegate 协议

< font-size: 16px;">import UnityAds

< font-size: 16px;">class GameViewController: UIViewController, UnityAdsDelegate {

< font-size: 16px;">在 ViewController 中实现UnityAdsDelegate 协议的如下回调方法

< font-size: 16px;">unityAdsReady

< font-size: 16px;">unityAdsDidStart

< font-size: 16px;">unityAdsDidError

< font-size: 16px;">unityAdsDidFinish

< font-size: 16px;">func unityAdsReady(_ placementId: String) { }

< font-size: 16px;">func unityAdsDidStart(_ placementId: String) { }

< font-size: 16px;">func unityAdsDidError(_ error: UnityAdsError, withMessage message: String) { }

< font-size: 16px;">func unityAdsDidFinish(_ placementId: String, with state: UnityAdsFinishState) { }

< font-size: 16px;">到此步骤，您的项目应该可以成功通过编译。

< font-size: 16px;">初始化 Unity Ads 和 展示广告

< font-size: 16px;">使用 UnityAds.initialize() 初始化SDK。

< font-size: 16px;">将您从开发者后台获取的 Game ID 以String类型，以及代表ViewController的 self 作为参数传入：

< font-size: 16px;">override func viewDidLoad() {

< font-size: 16px;">  super.viewDidLoad()

< font-size: 16px;">  UnityAds.initialize("1003843", delegate: self)

< font-size: 16px;">}  

< font-size: 16px;">提示：

< font-size: 16px;">Unity Ads 初始化一般需要至少10秒，建议您尽量在游戏生命周期的早期进行初始化。

< font-size: 16px;">Unity Ads 只初始化一次. SDK 2.0 的网络重连功能更加可靠. 您可以在没有网络连接的情况下尝试初始化, 之后 SDK 会在网络可用的时候再请求广告.

< font-size: 16px;">检查广告加载完成 ready 后，选择一个合法的 Placement ID 作为参数，和 self 一起传入 UnityAds.show() 来展示广告。

< font-size: 16px;">提示：

< font-size: 16px;">如果不指定 Placement ID，则展示 Default placement ID, 您可以在开发者后台查看您的 Default placement ID。

< font-size: 16px;">Unity Ads SDK 2.0 在任何一次调用展示(show)方法时候, 都需要传入一个 ViewController 作为参数 (如示例中的self ).

< font-size: 16px;">let placement = "rewardedVideo"

< font-size: 16px;">if (UnityAds.isReady(placement)) {

< font-size: 16px;">  //广告加载完成 且 广告位合法

< font-size: 16px;">  UnityAds.show(self, placementId: placement)

< font-size: 16px;">}

< font-size: 16px;">到此步骤，您应该可以在运行时成功观看到广告展示。

< font-size: 16px;">对看完视频的玩家给予奖励

< font-size: 16px;">对看完视频的玩家给与奖励，可以提高玩家的参与度，从而带来更高的收入。常见的奖励方式如：

< font-size: 16px;">免费的游戏货币

< font-size: 16px;">一定时长的性能提速

< font-size: 16px;">挑战失败后继续游戏

< font-size: 16px;">游戏道具 或 解锁关卡

< font-size: 16px;">通过在 unityAdsDidFinish() 回调方法里检查广告视频没有被跳过，确认玩家观看完整视频后再给与奖励。

< font-size: 16px;">func unityAdsDidFinish(_ placementId: String, with state: UnityAdsFinishState) {

< font-size: 16px;">  if state != .skipped{

< font-size: 16px;">    // 奖励用户

< font-size: 16px;">  }

< font-size: 16px;">}

< font-size: 16px;">到此步骤，您应该可以成功展示广告和奖励用户。

< font-size: 16px;">Objective-C 集成 Unity Ads

< font-size: 16px;">导入Unity Ads

< font-size: 16px;">下载最新版本的 Unity Ads Framework

< font-size: 16px;">拖拽UnityAds.framework到您的项目，添加时勾选 Copy items.

< font-size: 16px;">在 ViewController（.h）文件中导入UnityAds，并实现 UnityAdsDelegate 协议

< font-size: 16px;">#import "UnityAds/UnityAds.h"

< font-size: 16px;">@interface ViewController : UIViewController<UnityAdsDelegate>

< font-size: 16px;">在 ViewController（.m）文件中实现UnityAdsDelegate 协议的如下回调方法

< font-size: 16px;">- (void)unityAdsReady:(NSString *)placementId{

< font-size: 16px;">}

< font-size: 16px;">- (void)unityAdsDidError:(UnityAdsError)error withMessage:(NSSt网站广州开发ring *)message{

< font-size: 16px;">}

< font-size: 16px;">- (void)unityAdsDidStart:(NSString *)placementId{

< font-size: 16px;">}

< font-size: 16px;">- (void)unityAdsDidFinish:(NSString *)placementId withFinishState:(UnityAdsFinishState)state{

< font-size: 16px;">}

< font-size: 16px;">到此步骤，您的项目应该可以成功通过编译。

< font-size: 16px;">初始化 Unity Ads 和 展示广告

< font-size: 16px;">使用 UnityAds.initialize() 初始化SDK。

< font-size: 16px;">将您从开发者后台获取的 Game ID 以String类型，以及代表ViewController的 self 作为参数传入：

< font-size: 16px;">- (void)viewDidLoad {

< font-size: 16px;">  [super viewDidLoad];

< font-size: 16px;">  [UnityAds initial微商客源引流方法ize:@"1088169" delegate:self];

< font-size: 16px;">}  

< font-size: 16px;">提示：

< font-size: 16px;">Unity Ads 初始化一般需要至少10秒，建议您尽量在游戏生命周期的早期进行初始化。

< font-size: 16px;">Unity Ads 只初始化一次. SDK 2.0 的网络重连功能更加可靠. 您可以在没有网络连接的情况下尝试初始化, 之后 SDK 会在网络可用的时候再请求广告.

< font-size: 16px;">检查广告加载完成 ready 后，选择一个合法的 Placement ID 作为参数，和 self 一起传入 UnityAds.show() 来展示广告。

< font-size: 16px;">提示：

< font-size: 16px;">如果不指定 Placement ID，则展示 Default placement ID, 您可以在开发者后台查看您的 Default placement ID。

< font-size: 16px;">Unity Ads SDK 2.0 在任何一次调用展示(show)方法时候, 都需要传入一个 ViewController 作为参数 (如示例中的self ).

< font-size: 16px;">if ([UnityAds isReady:@"rewardedVideo"]) {

< font-size: 16px;">  //广告加载完成 且 广告位合法

< font-size: 16px;">  [UnityAds show:self placementId:@"rewardedVideo"];

< font-size: 16px;">}

< font-size: 16px;">到此步骤，您应该可以在运行时成功观看到广告展示。

< font-size: 16px;">对看完视频的玩家给予奖励

< font-size: 16px;">对看完视频的玩家给与奖励，可以提高玩家的参与度，从而带来更高的收入。常见的奖励方式如：

< font-size: 16px;">免费的游戏货币

< font-size: 16px;">一定时长的性能提速

< font-size: 16px;">挑战失败后继续游戏

< font-size: 16px;">游戏道具 或 解锁关卡

< font-size: 16px;">通过在 unityAdsDidFinish() 回调方法里检查广告视频没有被跳过，确认玩家观看完整视频后再给与奖励。

< font-size: 16px;">- (void)unityAdsDidFinish:(NSString *)placementId withFinishState:(UnityAdsFinishState)state{

< font-size: 16px;">    if (state != kUnityAdsFinishStateSkipped) {

< font-size: 16px;">        //奖励用户

< font-size: 16px;">    }

< font-size: 16px;">}

< font-size: 16px;">到此步骤，您应该可以成功展示广告和奖励用户。