UnityAds.h
ライブラリを使用して, 動画リワード広告, 非リワード型動画広告, インタースティシャル広告, バナー広告などの基本的な広告コンテンツを実装します。
#import "UnityAds.h"
この記事は以下の API ドキュメントを含んでいます。
クラス
列挙型
UnityAdsBannerPosition
UnityAdsInitializationError
UnityAdsLoadError
UnityAdsShowError
UnityAdsError
デリゲート
UnityAdsInitializationDelegate
UnityAdsLoadDelegate
UnityAdsShowDelegate
UADSBannerDelegate
UADSBannerAdRefreshViewDelegate
クラス
UnityAds
#import <UnityAds/UnityAds.h>
この名前空間は, 動画リワード広告, 非リワード型動画広告, インタースティシャル広告, バナー広告などの基本的な広告コンテンツを実装するために使用します。
initialize
+ (void) initialize: (NSString *)gameId testMode: (BOOL)testMode initializationDelegate: (nullable id<UnityAdsInitializationDelegate>)initializationDelegate; }
指定された ゲーム ID, テストモード のステータス, 初期化デリゲートを使用して, 広告サービスを初期化します。
パラメーター | 説明 |
---|---|
gameId | プラットフォーム固有のプロジェクトの Unity ゲーム識別子。Monetization (収益化) ダッシュボード から見つけることができます。 |
testMode | テストモードを使用すると, 実際の広告を表示することなく, インテグレーションをテストできます。テストモードで初期化するには |
initializationDelegate | 任意で
|
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 | 任意で |
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 | 任意で |
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 | バナーオブジェクトの |
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 |
|
kUnityAdsLoadErrorNoFill | ネットワークに利用可能なコンテンツがなかったため広告のロードに失敗しました。 |
kUnityAdsLoadErrorTimeout | 指定の時間内に広告をロードできませんでした。 |
UnityAdsShowCompletionState
typedef NS_ENUM (NSInteger, UnityAdsShowCompletionState)
広告が終了した原因を表す列挙型です。
値 | 説明 |
---|---|
kUnityShowCompletionStateSkipped | ユーザーが広告をスキップしたことを示します。 |
kUnityShowCompletionStateCompleted | 広告が最後まで再生されたことを示します。これは一般的にユーザーが広告全体を視聴したことで報酬を受け取ることができることを示します。 |
UnityAdsShowError
typedef NS_ENUM (NSInteger, UnityAdsShowError)
広告ユニット の表示に失敗した理由を表す列挙型。
値 | 説明 |
---|---|
kUnityShowErrorNotInitialized | SDK が初期化されていなかったため広告の表示に失敗しました。 |
kUnityShowErrorNotReady | 広告ユニットの準備ができていなかったため広告の表示に失敗しました。 |
kUnityShowErrorVideoPlayerError | メディアプレイヤーのエラーにより広告の表示に失敗しました。 |
kUnityShowErrorInvalidArgument |
|
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 | 初期化の失敗の原因となった
|
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 | 表示失敗の原因となった |
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 | エラーの原因となった |
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 | エラーの原因となった |
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 | エラーに関連するメッセージです。 |