Unity Ads SDK iOS集成指南

下載最新版本的 Unity Ads Framework

Unity iOS 2.0 SDK 最低支持 iOS 7.0

大綱

Quickstart 指南

新建游戲項目 Project

代碼集成

Swift

Objective-C

高級操作指南

Quickstart 指南

在Unity Ads Dashboard 新建一個游戲項目 Project

使用您的 UDN 賬戶登錄 UnityAds開發(fā)者操作臺.

如果您還沒有 UDN 賬戶，請注冊

從開發(fā)者后臺選擇 Projects > 點擊 NEW PROJECT 新建一個項目.

提示： 如果您的游戲在美國發(fā)布且專門供美國13歲以下的兒童使用，依據(jù)美國兒童隱私保護法，您需要點擊COPPA勾選框。全年齡段適用的游戲則不需要勾選此項。

選中新建的項目 > Settings > Project Settings , 您可以看到Unity自動為iOS和Android平臺分別生成的對應(yīng) GAME ID 。您將會在初始化 Unity Ads 時使用對應(yīng)的 Game ID 。

Locate your Game ID

選中新建的項目 > Monetization > Placements , 您可以查看廣告位，Unity會在您新建項目時默認(rèn)為您生成2個廣告位，您也可以手動添加更多。

video (默認(rèn)廣告位 / 5秒后允許用戶跳過廣告)

rewardedVideo (不可跳過廣告)

可選： 通過Platform的設(shè)置選項開啟測試模式以接收測試廣告，游戲發(fā)布上線前，請您務(wù)必記得回到此處關(guān)閉測試模式，以免影響您的廣告收入。

Projects > 選中一個項目 > Settings > Project Settings > Test Mode > 選擇一個平臺 > Force test mode ON

代碼集成

Swift 集成 Unity Ads

點擊跳轉(zhuǎn)Objective-C方式

導(dǎo)入Unity Ads

下載最新版本的 Unity Ads Framework

拖拽UnityAds.framework到您的項目，添加時勾選 Copy items.

在 ViewController 中導(dǎo)入UnityAds，并實現(xiàn) UnityAdsDelegate 協(xié)議

import UnityAds

class GameViewController: UIViewController, UnityAdsDelegate {

在 ViewController 中實現(xiàn)UnityAdsDelegate 協(xié)議的如下回調(diào)方法

unityAdsReady

unityAdsDidStart

unityAdsDidError

unityAdsDidFinish

func unityAdsReady(_ placementId: String) { }

func unityAdsDidStart(_ placementId: String) { }

func unityAdsDidError(_ error: UnityAdsError, withMessage message: String) { }

func unityAdsDidFinish(_ placementId: String, with state: UnityAdsFinishState) { }

到此步驟，您的項目應(yīng)該可以成功通過編譯。

初始化 Unity Ads 和 展示廣告

使用 UnityAds.initialize() 初始化SDK。

將您從開發(fā)者后臺獲取的 Game ID 以String類型，以及代表ViewController的 self 作為參數(shù)傳入：

override func viewDidLoad() {

  super.viewDidLoad()

  UnityAds.initialize("1003843", delegate: self)

}  

提示：

Unity Ads 初始化一般需要至少10秒，建議您盡量在游戲生命周期的早期進行初始化。

Unity Ads 只初始化一次. SDK 2.0 的網(wǎng)絡(luò)重連功能更加可靠. 您可以在沒有網(wǎng)絡(luò)連接的情況下嘗試初始化, 之后 SDK 會在網(wǎng)絡(luò)可用的時候再請求廣告.

檢查廣告加載完成 ready 后，選擇一個合法的 Placement ID 作為參數(shù)，和 self 一起傳入 UnityAds.show() 來展示廣告。

提示：

如果不指定 Placement ID，則展示 Default placement ID, 您可以在開發(fā)者后臺查看您的 Default placement ID。

Unity Ads SDK 2.0 在任何一次調(diào)用展示(show)方法時候, 都需要傳入一個 ViewController 作為參數(shù) (如示例中的self ).

let placement = "rewardedVideo"

if (UnityAds.isReady(placement)) {

  //廣告加載完成 且 廣告位合法

  UnityAds.show(self, placementId: placement)

}

到此步驟，您應(yīng)該可以在運行時成功觀看到廣告展示。

對看完視頻的玩家給予獎勵

對看完視頻的玩家給與獎勵，可以提高玩家的參與度，從而帶來更高的收入。常見的獎勵方式如：

免費的游戲貨幣

一定時長的性能提速

挑戰(zhàn)失敗后繼續(xù)游戲

游戲道具 或 解鎖關(guān)卡

通過在 unityAdsDidFinish() 回調(diào)方法里檢查廣告視頻沒有被跳過，確認(rèn)玩家觀看完整視頻后再給與獎勵。

func unityAdsDidFinish(_ placementId: String, with state: UnityAdsFinishState) {

  if state != .skipped{

    // 獎勵用戶

  }

}

到此步驟，您應(yīng)該可以成功展示廣告和獎勵用戶。

Objective-C 集成 Unity Ads

導(dǎo)入Unity Ads

下載最新版本的 Unity Ads Framework

拖拽UnityAds.framework到您的項目，添加時勾選 Copy items.

在 ViewController（.h）文件中導(dǎo)入UnityAds，并實現(xiàn) UnityAdsDelegate 協(xié)議

#import "UnityAds/UnityAds.h"

@interface ViewController : UIViewController<UnityAdsDelegate>

在 ViewController（.m）文件中實現(xiàn)UnityAdsDelegate 協(xié)議的如下回調(diào)方法

- (void)unityAdsReady:(NSString *)placementId{

}

- (void)unityAdsDidError:(UnityAdsError)error withMessage:(NSString *)message{

}

- (void)unityAdsDidStart:(NSString *)placementId{

}

- (void)unityAdsDidFinish:(NSString *)placementId withFinishState:(UnityAdsFinishState)state{

}

到此步驟，您的項目應(yīng)該可以成功通過編譯。

初始化 Unity Ads 和 展示廣告

使用 UnityAds.initialize() 初始化SDK。

將您從開發(fā)者后臺獲取的 Game ID 以String類型，以及代表ViewController的 self 作為參數(shù)傳入：

- (void)viewDidLoad {

  [super viewDidLoad];

  [UnityAds initialize:@"1088169" delegate:self];

}  

提示：

Unity Ads 初始化一般需要至少10秒，建議您盡量在游戲生命周期的早期進行初始化。

Unity Ads 只初始化一次. SDK 2.0 的網(wǎng)絡(luò)重連功能更加可靠. 您可以在沒有網(wǎng)絡(luò)連接的情況下嘗試初始化, 之后 SDK 會在網(wǎng)絡(luò)可用的時候再請求廣告.

檢查廣告加載完成 ready 后，選擇一個合法的 Placement ID 作為參數(shù)，和 self 一起傳入 UnityAds.show() 來展示廣告。

提示：

如果不指定 Placement ID，則展示 Default placement ID, 您可以在開發(fā)者后臺查看您的 Default placement ID。

Unity Ads SDK 2.0 在任何一次調(diào)用展示(show)方法時候, 都需要傳入一個 ViewController 作為參數(shù) (如示例中的self ).

if ([UnityAds isReady:@"rewardedVideo"]) {

  //廣告加載完成 且 廣告位合法

  [UnityAds show:self placementId:@"rewardedVideo"];

}

到此步驟，您應(yīng)該可以在運行時成功觀看到廣告展示。

對看完視頻的玩家給予獎勵

對看完視頻的玩家給與獎勵，可以提高玩家的參與度，從而帶來更高的收入。常見的獎勵方式如：

免費的游戲貨幣

一定時長的性能提速

挑戰(zhàn)失敗后繼續(xù)游戲

游戲道具 或 解鎖關(guān)卡

通過在 unityAdsDidFinish() 回調(diào)方法里檢查廣告視頻沒有被跳過，確認(rèn)玩家觀看完整視頻后再給與獎勵。

- (void)unityAdsDidFinish:(NSString *)placementId withFinishState:(UnityAdsFinishState)state{

    if (state != kUnityAdsFinishStateSkipped) {

        //獎勵用戶

    }

}

到此步驟，您應(yīng)該可以成功展示廣告和獎勵用戶。