Unity Ads SDK  iOS集成指南,unity接入sdk教學

Unity Ads SDK  iOS集成指南

下載最新版本的 Unity Ads Framework

Unity iOS 2.0 SDK 最低支持 iOS 7.0

大綱

Quickstart 指南

新建游戲項目 Project

代碼集成

Swift

ObjectiveC

高級操作指南

Quickstart 指南

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

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

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

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

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

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

Locate your Game ID

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

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

rewardedVideo (不可跳過廣告)

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

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

代碼集成

Swift 集成 Unity Ads

點擊跳轉ObjectiveC方式

導入Unity Ads

下載最新版本的 Unity Ads Framework

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

在 ViewController 中導入UnityAds，并實現 UnityAdsDelegate 協議

import UnityAds

class GameViewController: UIViewController, UnityAdsDelegate {

在 ViewController 中實現UnityAdsDelegate 協議的如下回調方法

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) { }

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

初始化 Unity Ads 和 展示廣告

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

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

override func viewDidLoad() {

super.viewDidLoad()

UnityAds.initialize(1003843, delegate: self)

}

提示：

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

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

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

提示：

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

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

let placement = rewardedVideo

if (UnityAds.isReady(placement)) {

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

UnityAds.show(self, placementId: placement)

}

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

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

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

免費的游戲貨幣

一定時長的性能提速

挑戰失敗后繼續游戲

游戲道具 或 解鎖關卡

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

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

if state != .skipped{

  // 獎勵用戶

}

}

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

ObjectiveC 集成 Unity Ads

導入Unity Ads

下載最新版本的 Unity Ads Framework

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

在 ViewController（.h）文件中導入UnityAds，并實現 UnityAdsDelegate 協議

#import UnityAds/UnityAds.h

@interface ViewController : UIViewControllerUnityAdsDelegate

在 ViewController（.m）文件中實現UnityAdsDelegate 協議的如下回調方法

(void)unityAdsReady:(NSString *)placementId{

}

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

}

(void)unityAdsDidStart:(NSString *)placementId{

}

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

}

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

初始化 Unity Ads 和 展示廣告

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

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

(void)viewDidLoad {

[super viewDidLoad];

[UnityAds initialize:@1088169 delegate:self];

}

提示：

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

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

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

提示：

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

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

if ([UnityAds isReady:@rewardedVideo]) {

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

[UnityAds show:self placementId:@rewardedVideo];

}

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

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

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

免費的游戲貨幣

一定時長的性能提速

挑戰失敗后繼續游戲

游戲道具 或 解鎖關卡

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

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

  if (state != kUnityAdsFinishStateSkipped) {

    //獎勵用戶

  }

}

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

特別聲明：以上文章內容僅代表作者本人觀點，不代表ESG跨境電商觀點或立場。如有關于作品內容、版權或其它問題請于作品發表后的30日內與ESG跨境電商聯系。