ドキュメント

サポート

Unity Ads Monetization

Android developer monetization guide

iOS developer monetization guide

Privacy consent setup

Unity Ads Monetization

Unity Ads iOS SDK API リファレンス

Access the Unity Ads SDK public API reference to view available classes, methods, and properties you can use in Objective-C or Swift to integrate and control ad behavior in your iOS app.
読み終わるまでの所要時間 8 分最終更新 2ヶ月前
UnityAds.h
ライブラリを使用して, 動画リワード広告, 非リワード型動画広告, インタースティシャル広告, バナー広告などの基本的な広告コンテンツを実装します。 
#import "UnityAds.h"
この記事は以下の API ドキュメントを含んでいます。 クラス 列挙型 デリゲート

クラス

UnityAds

#import <UnityAds/UnityAds.h>
この名前空間は, 動画リワード広告, 非リワード型動画広告, インタースティシャル広告, バナー広告などの基本的な広告コンテンツを実装するために使用します。

initialize

+ (void) initialize: (NSString *)gameId
    testMode: (BOOL)testMode
    initializationDelegate: (nullable id<UnityAdsInitializationDelegate>)initializationDelegate;
}
指定された ゲーム ID, テストモード のステータス, 初期化デリゲートを使用して, 広告サービスを初期化します。

パラメーター

説明

gameId
プラットフォーム固有のプロジェクトの Unity ゲーム識別子。Monetization (収益化) ダッシュボード から見つけることができます。
testMode
テストモードを使用すると, 実際の広告を表示することなく, インテグレーションをテストできます。テストモードで初期化するには 
true
を使用します。
initializationDelegate
任意で 
UnityAdsInitializationDelegate
 コールバックを使用して SDK を有効にします (バージョン 3.7.0 以降)。

load

+ (void)load: (NSString *)placementId options: (UADSLoadOptions *)options loadDelegate: (nullable id<UnityAdsLoadDelegate>)loadDelegate {
  [UADSLoadModule.sharedInstance loadForPlacementID: placementId
                                            options: options
                                       loadDelegate: loadDelegate];
}
指定された 広告ユニット の広告コンテンツをロードします。
show
 を呼び出す前に, 
load
を呼び出す必要があります。

パラメーター

説明

placementId
広告コンテンツと共にロードする広告ユニットの識別子。
options
広告のロード動作を変更するための オプション のコレクション。
loadDelegate
任意で 
UnityAdsLoadDelegate
 コールバックを使用して広告コンテンツをロードします (バージョン 3.7.0 以降)。

isReady

+ (BOOL)isReady: (NSString *)adUnitId {
    return [UnityServices isSupported] && [UnityServices isInitialized] && [UADSPlacement isReady: adUnitId];
}
広告を指定した 広告ユニット に表示する準備が整っている場合は, 
YES
を返します。SDK 初期化時に 
enablePerPlacementLoad
を有効にした場合, 
show
 を呼び出す前に 
load
を呼び出す必要があります。

パラメーター

説明

adUnitId
クエリを実行する広告ユニットの識別子。
.

show

+ (void)show: (UIViewController *)viewController placementId: (NSString *)placementId showDelegate: (nullable id<UnityAdsShowDelegate>)showDelegate {
    	[self show: viewController
          adUnitId: placementId
    	   options: [UADSShowOptions new]
   	  showDelegate: showDelegate];
}
指定した 広告ユニット にロードされた広告コンテンツを表示します。

パラメーター

説明

placementId
表示する広告ユニットの識別子。
options
広告の表示動作を変更するためのオプションのコレクション。
showDelegate
任意で 
UnityAdsShowDelegate
 コールバックを使用してコンテンツを表示します (バージョン 3.7.0 以降)。

addDelegate

+ (void)addDelegate: (__nullable id<UnityAdsDelegate>)delegate {
    [UADSProperties addDelegate: delegate];
}
Unity Ads のコールバックを受け取るリスナーデリゲートを追加します。バージョン 3.1.0 以降では, 複数のリスナーを登録できます。これは メディエーション の顧客にとって特に便利です。

パラメーター

説明

delegate
Unity Ads コールバックの リスナー。

removeDelegate

+ (void)removeDelegate: (id<UnityAdsDelegate>)delegate {
    [UADSProperties removeDelegate: delegate];
}
アクティブな 
UnityAdsDelegate
 リスナーを削除します。

パラメーター

説明

delegate
Unity Ads コールバックの リスナー。

setDebugMode

+ (BOOL)getDebugMode {
    return [UnityServices getDebugMode];
}
SDK からのログ出力数を制御します。より堅実にログを残すには, 
YES
に設定します。

getDebugMode

+ (void)getDebugMode: (BOOL)enableDebugMode {
    [UnityServices setDebugMode: enableDebugMode];
}
SDK がデバッグモードの場合は 
YES
, それ以外の場合は 
NO
を返します。

getVersion

+ (NSString *)getVersion {
    return [UnityServices getVersion];
}
Unity Ads SDK の現在のバージョンを返します。

isInitialized

+ (BOOL)isInitialized {
    return [USRVSdkProperties isInitialized];
}
SDK が正常に初期化された場合は 
YES
, それ以外の場合は 
NO
を返します。

UADSLoadOptions

#import <UnityAds/UADSBaseOptions.h>

@interface UADSLoadOptions : UADSBaseOptions

@property (nonatomic, readwrite) NSString *adMarkup;

@end
このクラスには, 
load
 メソッドに追加する任意のメタデータが含まれています。サードパーティのメディエーションのヘッダー入札を使用しているお客様は, Unity ネットワークからの入札者が広告オークションで落札した場合にこれを使用する必要があります。

setAdMarkup

- (void)setAdMarkup: (NSString *)adMarkup
このメソッドは, 入札者サービスから返される広告マークアップを取得します。Unity の広告ネットワークからの入札者がヘッダー入札オークションで落札すると, Unity Ads SDK はメディエーションエクスチェンジから広告マークアップを受け取ります。広告マークアップ文字列には, Unity が広告をロードおよび表示するために必要な情報が含まれています。

UADSBannerView

@interface UADSBannerView : UIView
バナー広告を実装 するには, このクラスを使用します。Unity Ads バージョン 3.3 以降は, 1 つの 広告ユニット を介した複数のバナーインスタンスに対応しています。

initWithPlacementId

-(instancetype)initWithPlacementId:(NSString *)placementId size:(CGSize)size;
広告ユニット ID とバナーサイズを使用してバナービューを実装します。
initWithPlacementId
を呼び出してオブジェクトを初期化してから, 
load
 を呼び出して広告コンテンツをロードします。バナーオブジェクトが 
UADSBannerViewDelegate
 リスナーを介してライフサイクルイベントにアクセスすることに注意してください。

パラメーター

説明

placementId
バナーの広告ユニット ID。
size
バナーオブジェクトの 
サイズ
。最小サポートサイズは 320 ピクセル × 50 ピクセルです。

load

- (void)load;
バナーに広告をリクエストするための基本メソッドです。

列挙型

UnityAdsPlacementState

typedef NS_ENUM(NSInteger, UnityAdsPlacementState)
広告ユニット の状態を表す列挙型。

値

説明

kUnityAdsPlacementStateReady
広告ユニットは広告を表示できる状態になっています。
kUnityAdsPlacementStateNotAvailable
広告ユニットを利用できません。
kUnityAdsPlacementStateDisabled
広告ユニットが無効になっています。
kUnityAdsPlacementStateWaiting
広告ユニットは準備中です。
kUnityAdsPlacementStateNoFill
広告ユニットに表示する広告がありません。

UnityAdsFinishState

typedef NS_ENUM(NSInteger, UnityAdsFinishState)
ユーザーと広告とのインタラクションの状態を表す列挙型。広告が完了すると, SDK がこの値を 
unityAdsDidFinish
 コールバックメソッドに渡します。

値

説明

kUnityAdsFinishStateError
Unity のエラーにより広告を最後まで表示できなかったことを示します。
kUnityAdsFinishStateSkipped
ユーザーが広告をスキップしたことを示します。
kUnityAdsFinishStateCompleted
広告の再生が完了したことを示します。

UnityAdsInitializationError

typedef NS_ENUM (NSInteger, UnityAdsInitializationError)
SDK の初期化に失敗した理由を表す列挙型です。

値

説明

kUnityInitializationErrorInternalError
環境または内部サービスが原因でエラーが発生しました。
kUnityInitializationErrorInvalidArgument
Initialize メソッド内の無効な引数が原因でエラーが発生しました。
kUnityInitializationErrorAdBlockerDetected
URL がブロックされたことが原因でエラーが発生しました。

UnityAdsLoadError

typedef NS_ENUM (NSInteger, UnityAdsLoadError)
広告ユニット のロードが失敗した理由を表す列挙型。

値

説明

kUnityAdsLoadErrorInitializeFailed
SDK が初期化されていないことによって広告のロードに失敗しました。
kUnityAdsLoadErrorInternal
Unity Ads の内部サービスエラーによって広告のロードに失敗しました。
kUnityAdsLoadErrorInvalidArgument
load
 メソッド内の無効な引数により広告のロードに失敗しました。
kUnityAdsLoadErrorNoFill
ネットワークに利用可能なコンテンツがなかったため広告のロードに失敗しました。
kUnityAdsLoadErrorTimeout
指定の時間内に広告をロードできませんでした。

UnityAdsShowCompletionState

typedef NS_ENUM (NSInteger, UnityAdsShowCompletionState)
広告が終了した原因を表す列挙型です。

値

説明

kUnityShowCompletionStateSkipped
ユーザーが広告をスキップしたことを示します。
kUnityShowCompletionStateCompleted
広告が最後まで再生されたことを示します。これは一般的にユーザーが広告全体を視聴したことで報酬を受け取ることができることを示します。

UnityAdsShowError

typedef NS_ENUM (NSInteger, UnityAdsShowError)
広告ユニット の表示に失敗した理由を表す列挙型。

値

説明

kUnityShowErrorNotInitialized
SDK が初期化されていなかったため広告の表示に失敗しました。
kUnityShowErrorNotReady
広告ユニットの準備ができていなかったため広告の表示に失敗しました。
kUnityShowErrorVideoPlayerError
メディアプレイヤーのエラーにより広告の表示に失敗しました。
kUnityShowErrorInvalidArgument
show
 メソッド内の無効な引数により広告の表示に失敗しました。
kUnityShowErrorNoConnection
インターネット接続エラーにより広告の表示に失敗しました。
kUnityShowErrorAlreadyShowing
広告がすでに表示されていたため広告の表示に失敗しました。
kUnityShowErrorInternalError
Unity Ads の内部サービスエラーによって広告の表示に失敗しました。

UnityAdsError

typedef NS_ENUM (NSInteger, UnityAdsError)
unityAdsDidError
 コールバックを通じて発生した Unity Ads のエラーの原因を表す列挙型。

値

説明

kUnityAdsErrorNotInitialized = 0
Unity Ads サービスは現在初期化されません。
kUnityAdsErrorInitializedFailed
初期化プロセスでエラーが発生しました。
kUnityAdsErrorInvalidArgument
無効なパラメーターにより, Unity Ads の初期化が失敗しました。
kUnityAdsErrorVideoPlayerError
ビデオプレイヤーの障害によってエラーが発生しました。
kUnityAdsErrorInitSanityCheckFail
無効な環境により Unity Ads サービスの初期化が失敗しました。
kUnityAdsErrorAdBlockerDetected
広告ブロッカーによりエラーが発生しました。
kUnityAdsErrorFileIoError
ファイルの読み取りまたは書き込みができないためにエラーが発生しました。
kUnityAdsErrorDeviceIdError
不正なデバイス識別子のためにエラーが発生しました。
kUnityAdsErrorShowError
広告を表示しようとした際にエラーが発生しました。
kUnityAdsErrorInternalError
Unity Ads サービス内部でエラーが発生しました。

UnityAdsBannerPosition

バナー広告のアンカーとして設定可能な位置を表す列挙型。

値

説明

kUnityAdsBannerPositionTopLeft
バナーを画面の左上に固定します。
kUnityAdsBannerPositionTopCenter
バナーを画面の上部中央に固定します。
kUnityAdsBannerPositionTopRight
バナーを画面の右上に固定します。
kUnityAdsBannerPositionBottomLeft
バナーを画面の左下に固定します。
kUnityAdsBannerPositionBottomCenter
バナーを画面の下部中央に固定します。
kUnityAdsBannerPositionBottomRight
バナーを画面の右下に固定します。
kUnityAdsBannerPositionCenter
バナーを画面の中央に固定します。
kUnityAdsBannerPositionNone
バナーを固定しません。

デリゲート

UnityAdsInitializationDelegate

@protocol UnityAdsInitializationDelegate <NSObject>
- (void)initializationComplete;
- (void)initializationFailed: (UnityAdsInitializationError)error withMessage: (NSString *)message;
@end
このデリゲートは 
initialize
 の結果をハンドルするために実装します。

initializationComplete

このコールバックメソッドは, SDK が問題なく初期化されたときのロジックをハンドルします。

initializationFailed

このコールバックメソッドは, SDK の初期化が失敗したときのロジックをハンドルします。

パラメーター

説明

error
初期化の失敗の原因となった 
UnityAdsInitializationError
。
message
エラーに関連するメッセージです。

UnityAdsLoadDelegate

@protocol UnityAdsLoadDelegate <NSObject>
- (void)unityAdsAdLoaded: (NSString *)placementId;
- (void)unityAdsAdFailedToLoad: (NSString *)placementId
                     withError: (UnityAdsLoadError)error
                   withMessage: (NSString *)message;
@end
このデリゲートは 
load
 の結果をハンドルするために実装します。

unityAdsAdLoaded

このコールバックメソッドは, 広告ユニット が正常にロードされたときのロジックをハンドルします。

パラメーター

説明

placementId
コンテンツをロードした広告ユニットの識別子。

unityAdsAdFailedToLoad

このコールバックメソッドは, 広告ユニット のロードが失敗したときのロジックをハンドルします。

パラメーター

説明

placementId
コンテンツのロードに失敗した広告ユニットの識別子。
error
ロード失敗の原因となった UnityAdsLoadError。
message
エラーに関連するメッセージです。

UnityAdsShowDelegate

@protocol UnityAdsShowDelegate <NSObject>
- (void)unityAdsShowComplete: (NSString *)adUnitId withFinishState: (UnityAdsShowCompletionState)state;
- (void)unityAdsShowFailed: (NSString *)adUnitId withError: (UnityAdsShowError)error withMessage: (NSString *)message;
- (void)unityAdsShowStart: (NSString *)adUnitId;
- (void)unityAdsShowClick: (NSString *)adUnitId;
@end
このデリゲートは 
show
 の結果をハンドルするために実装します。

unityAdsShowComplete

このコールバックメソッドは, 広告視聴終了時のロジックをハンドルします。

パラメーター

説明

adUnitId
コンテンツを表示している広告ユニットの識別子。
state
広告がスキップされたか, 完全視聴したかを示します。

unityAdsShowStart

このコールバックメソッドは, 広告再生開始時のロジックをハンドルします。

パラメーター

説明

adUnitId
コンテンツを表示している 広告ユニット の識別子。

unityAdsShowClick

このコールバックメソッドは, ユーザーが広告をクリックしたときのロジックをハンドルします。

パラメーター

説明

adUnitId
コンテンツを表示している 広告ユニット の識別子。

unityAdsShowFailed

このコールバックメソッドは, 広告ユニット のコンテンツの表示が失敗したときのロジックをハンドルします。

パラメーター

説明

adUnitId
コンテンツの表示に失敗した広告ユニットの識別子。
error
表示失敗の原因となった 
UnityAdsShowError
。
messageエラーに関連するメッセージです。

UnityAdsDelegate

@protocol UnityAdsDelegate <NSObject>
- (void)unityAdsReady: (NSString *)placementId;
- (void)unityAdsDidError: (UnityAdsError)error withMessage: (NSString *)message;
- (void)unityAdsDidStart: (NSString *)placementId;
- (void)unityAdsDidFinish: (NSString *)placementId
          withFinishState: (UnityAdsFinishState)state;
@end
このデリゲートは広告のさまざまな状態をハンドルするために実装します。リワード広告 のロジックを定義するには, これをスクリプトに実装します。

unityAdsReady

指定された 広告ユニット を通じて表示する広告コンテンツの準備ができているときのロジックを指定します。

パラメーター

説明

placementId
準備ができている広告ユニットの識別子。

unityAdsDidError

エラーによって広告コンテンツの表示に失敗したときのロジックを指定します。

パラメーター

説明

error
エラーの原因となった 
UnityAdsError
。
message
エラーに関連するメッセージです。

unityAdsDidStart

プレイヤーが広告の表示をトリガーしたときのロジックを指定します。

パラメーター

説明

placementId
広告を表示している 広告ユニット の識別子。

unityAdsDidFinish

プレイヤーが広告を最後まで見たときのロジックを指定します。

パラメーター

説明

placementId
表示が完了した広告ユニットの識別子。
state
表示している広告の 結果として生成されたユーザーイベント。

UADSBannerDelegate

@protocol UADSBannerViewDelegate <NSObject>

@optional
- (void)bannerViewDidLoad: (UADSBannerView *)bannerView;
- (void)bannerViewDidClick: (UADSBannerView *)bannerView;
- (void)bannerViewDidLeaveApplication: (UADSBannerView *)bannerView;
- (void)bannerViewDidError: (UADSBannerView *)bannerView error: (UADSBannerError *)error;
@end
このデリゲートは Unity Ads のバナーイベントからのコールバックを提供します。

bannerViewDidLoad

このコールバックは, バナーが広告コンテンツを正常にロードしたときに発生します。

bannerViewDidClick

このコールバックは, ユーザーがバナー広告をクリックしたときに発生します。

bannerViewDidLeaveApplication

このコールバックは, ユーザーがアプリを終了したことでバナーが閉じられたときに発生します。

bannerViewDidError

このコールバックは, UnityAdsBanner でエラーが発生したときに発生します。

パラメーター

説明

error
エラーの原因となった 
UADSBannerError
。

UADSBannerAdRefreshViewDelegate

@protocol UADSBannerAdRefreshViewDelegate <NSObject>

@optional
- (void)unityAdsRefreshBannerDidLoad: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidNoFill: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidShow: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidHide: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidClick: (UADSBannerAdRefreshView *)bannerAdRefreshView;
- (void)unityAdsRefreshBannerDidError: (UADSBannerAdRefreshView *)bannerAdRefreshView message: (NSString *)message;
@end
このデリゲートは Unity Ads のバナーの再読み込みイベントからのコールバックを提供します。

unityAdsRefreshBannerDidLoad

バナーがロードされ, ビュー階層に配置される準備が整ったときに呼び出されます。

unityAdsRefreshBannerDidNoFill

バナーに広告コンテンツがないときに呼び出されます。

unityAdsRefreshBannerDidShow

バナーがユーザーに表示されているときに呼び出されます。

unityAdsRefreshBannerDidHide

バナーがユーザーに表示されていないときに呼び出されます。

unityAdsRefreshBannerDidClick

ユーザーがバナー広告をクリックしたときに呼び出されます。

unityAdsRefreshBannerDidError

UnityAdsBanner
でエラーが発生したときに呼び出されます。

パラメーター

説明

message
エラーに関連するメッセージです。