iOS の Vungle 需要
このページでは、iOS アプリケーションで Vungle SDK を使用してスポット広告を統合して表示する詳細な手順について説明します。
前提条件
Vungle Demand を統合する前に、次の SDK バージョンがインストールされていることを確認してください。
- Microsoft Ads SDK: バージョン 9.3.0
- ANVungleAdapter: Vungle 統合に必要
- VungleAds SDK: バージョン 7.3.2
SDK のインストール
Vungle Demand を統合するには、 Mobile SDK と ANVungleAdapter パッケージをインストールする必要があります。 CocoaPods を使用して必要な依存関係をインストールするには、次の手順に従います。
手順 1: CocoaPods をインストールする
CocoaPods をインストールしていない場合は、 CocoaPods.org のインストール ガイドに従ってください。
手順 2: Podfile を作成して構成する
ターミナルまたは任意のコマンド ライン エディターを開きます。
プロジェクト ディレクトリに移動します。
コマンドを実行して、新しい Podfile を作成します。
pod init
テキスト エディターを使用して、新しく作成した Podfile を開きます。
プラットフォームが iOS 12.0 に設定されていることを確認し、[
target
] セクションに次の依存関係を含めます。
Podfile 構成の例
platform :ios, '12.0'
project 'SampleApp'
target 'SampleApp' do
pod 'AppNexusSDK'
pod 'AppNexusSDK/ANVungleAdapter'
end
手順 3: ポッドをインストールする
- 変更を Podfile に保存し、依存関係のインストールに進みます。
- ターミナルで、次のコマンドを実行してポッドをインストールします。
Vungle SDK を初期化する
Vungle SDK を初期化するには、アプリの初期ライフサイクルに次のコードを追加します。 "YOUR_APP_ID" は、Vungle によって提供されるアプリ ID に置き換えます。
例
VungleAds.initWithAppId("YOUR_APP_ID") { error in
if let error = error {
print("VUNGLE - Error initializing SDK: \(error.localizedDescription)")
} else {
print("VUNGLE - SDK initialization successful")
ANVungleSettings.setVungleInitialize(true)
}
}
- 初期化が成功すると、
ANVungleSettings.setVungleInitialize(true)
が設定されます。 - 初期化に失敗すると、
ANVungleSettings.setVungleInitialize(false)
が設定されます。 - 正常に初期化されると、
getBidderToken
メソッドは有効な bidder トークンを返しますが、初期化に失敗した場合はnil
を返します。
スポット オブジェクトを初期化し、必要なキーワード (keyword)を設定する
Vungle の SDK が正常に初期化されると、SDK によって Vungle の入札者トークンが自動的にキャプチャされ、広告要求に含められます。その後、PSP に渡されます。 スポット オブジェクトを初期化し、必要なキーワード (keyword)を設定するには、次の手順に従います。
-
ANInterstitialAd
オブジェクトを初期化します。 - このインスタンスへの参照を適切に保持します。
-
load()
メソッドを呼び出す前に、要求にカスタム キーワード (keyword)を設定します。- キーは文字列である必要があります:
VUNGLE_PLACEMENT_ID_FOR_CSR
。 - 値は Vungle の配置で、収益化の配置にマップする必要があります。
- キーは文字列である必要があります:
コード例
import VungleAdsSDK
import AppNexusSDK
import ANVungleAdapter
var interstitialAd = ANInterstitialAd()
// Initialize the interstitial ad object
interstitialAd = ANInterstitialAd(placementId: "1234567")
// Set the required keyword
interstitialAd.addCustomKeyword(withKey: "VUNGLE_PLACEMENT_ID_FOR_CSR", value: "VUNGLE_PLACEMENT_123")
// Assign a delegate
interstitialAd.delegate = self
// Make a request to load the ad
interstitialAd.load()
クリエイティブをレンダリングする
スポット広告が正常に読み込まれたら、アプリのロジックに基づいてユーザーに表示できます。 次の例では、読み込み時に広告がすぐに表示されます。