Unity Ads SDK iOS集成指南,unity接入sdk教學(xué)-ESG跨境

Unity Ads SDK  iOS集成指南,unity接入sdk教學(xué)

Unity Ads SDK  iOS集成指南

下載最新版本的 Unity Ads Framework

Unity iOS 2.0 SDK 最低支持 iOS 7.0

大綱

Quickstart 指南

新建游戲項(xiàng)目 Project

代碼集成

Swift

ObjectiveC

高級(jí)操作指南

Quickstart 指南

在Unity Ads Dashboard 新建一個(gè)游戲項(xiàng)目 Project

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

如果您還沒(méi)有 UDN 賬戶，請(qǐng)注冊(cè)

從開(kāi)發(fā)者后臺(tái)選擇 Projects  點(diǎn)擊 NEW PROJECT 新建一個(gè)項(xiàng)目.

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

選中新建的項(xiàng)目  Settings  Project Settings , 您可以看到Unity自動(dòng)為iOS和Android平臺(tái)分別生成的對(duì)應(yīng) GAME ID 。您將會(huì)在初始化 Unity Ads 時(shí)使用對(duì)應(yīng)的 Game ID 。

Locate your Game ID

選中新建的項(xiàng)目  Monetization  Placements , 您可以查看廣告位，Unity會(huì)在您新建項(xiàng)目時(shí)默認(rèn)為您生成2個(gè)廣告位，您也可以手動(dòng)添加更多。

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

rewardedVideo (不可跳過(guò)廣告)

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

Projects  選中一個(gè)項(xiàng)目  Settings  Project Settings  Test Mode  選擇一個(gè)平臺(tái)  Force test mode ON

代碼集成

Swift 集成 Unity Ads

點(diǎn)擊跳轉(zhuǎn)ObjectiveC方式

導(dǎo)入U(xiǎn)nity Ads

下載最新版本的 Unity Ads Framework

拖拽UnityAds.framework到您的項(xiàng)目，添加時(shí)勾選 Copy items.

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

import UnityAds

class GameViewController: UIViewController, UnityAdsDelegate {

在 ViewController 中實(shí)現(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) { }

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

初始化 Unity Ads 和 展示廣告

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

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

override func viewDidLoad() {

super.viewDidLoad()

UnityAds.initialize(1003843, delegate: self)

}

提示：

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

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

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

提示：

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

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

let placement = rewardedVideo

if (UnityAds.isReady(placement)) {

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

UnityAds.show(self, placementId: placement)

}

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

對(duì)看完視頻的玩家給予獎(jiǎng)勵(lì)

對(duì)看完視頻的玩家給與獎(jiǎng)勵(lì)，可以提高玩家的參與度，從而帶來(lái)更高的收入。常見(jiàn)的獎(jiǎng)勵(lì)方式如：

免費(fèi)的游戲貨幣

一定時(shí)長(zhǎng)的性能提速

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

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

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

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

if state != .skipped{

  // 獎(jiǎng)勵(lì)用戶

}

}

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

ObjectiveC 集成 Unity Ads

導(dǎo)入U(xiǎn)nity Ads

下載最新版本的 Unity Ads Framework

拖拽UnityAds.framework到您的項(xiàng)目，添加時(shí)勾選 Copy items.

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

#import UnityAds/UnityAds.h

@interface ViewController : UIViewControllerUnityAdsDelegate

在 ViewController（.m）文件中實(shí)現(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{

}

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

初始化 Unity Ads 和 展示廣告

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

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

(void)viewDidLoad {

[super viewDidLoad];

[UnityAds initialize:@1088169 delegate:self];

}

提示：

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

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

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

提示：

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

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

if ([UnityAds isReady:@rewardedVideo]) {

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

[UnityAds show:self placementId:@rewardedVideo];

}

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

對(duì)看完視頻的玩家給予獎(jiǎng)勵(lì)

對(duì)看完視頻的玩家給與獎(jiǎng)勵(lì)，可以提高玩家的參與度，從而帶來(lái)更高的收入。常見(jiàn)的獎(jiǎng)勵(lì)方式如：

免費(fèi)的游戲貨幣

一定時(shí)長(zhǎng)的性能提速

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

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

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

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

  if (state != kUnityAdsFinishStateSkipped) {

    //獎(jiǎng)勵(lì)用戶

  }

}

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

特別聲明：以上文章內(nèi)容僅代表作者本人觀點(diǎn)，不代表ESG跨境電商觀點(diǎn)或立場(chǎng)。如有關(guān)于作品內(nèi)容、版權(quán)或其它問(wèn)題請(qǐng)于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。