インタースティシャルインテグレーション
SDKの初期化、初期化後のインタースティシャル広告オブジェクトの作成、広告イベントをハンドルするリスナーの実装によって、Unityにインタースティシャル広告を統合します。
読み終わるまでの所要時間 9 分最終更新 6日前
Unity LevelPlay Interstitial は、全画面の広告単位です。通常は、アプリケーションのライフサイクル中の自然な遷移ポイントで機能します。
注
このドキュメントは SDK 8.4.0 以降に関連するものです。
前提条件
- LevelPlay SDK がアプリケーションに正しく統合されていることを確認します。インテグレーションの概要はこちらです。
- LevelPlay 初期化 API を使用して SDK を初期化していることを確認します。
- LevelPlay ダッシュボードで AdUnitID を見つけます。
インタースティシャル広告オブジェクトの作成
インタースティシャル広告オブジェクトの作成は、OnInitSuccess コールバックの受信後に実行する必要があります。
オブジェクトは、セッションを通じて複数のロードと表示をハンドルできる再利用可能なインスタンスです。作成後、同じ広告単位の広告をロードおよび表示するために使用する必要があります。
より高度な実装では、必要に応じて複数のインタースティシャル広告オブジェクトを作成できます。
オブジェクトを作成するには、以下を呼び出します。
// Create Interstitial Ad objectLevelPlayInterstitialAd interstitialAd = new LevelPlayInterstitialAd(interstitialAdUnitId);
注
LevelPlayInterstitialAdConfig// Use optional Config parameterLevelPlayInterstitialAd(string adUnitId, Config config = null)
特別な設定が必要ない場合は、パラメーターを省略してのみを渡すことができます。
ConfigadUnitId価格帯での作成
// Create Interstitial Ad object with Price Floor in config.var configBuilder = new LevelPlayInterstitialAd.Config.Builder();configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar isConfig = configBuilder.Build();LevelPlayInterstitialAd InterstitialAd = new LevelPlayInterstitialAd(InterstitialAdUnitId, isConfig);
インタースティシャルイベントに登録
コードに LevelPlayInterstitialAdListener を実装して、広告配信に関する情報を取得します。
- インタースティシャル広告をロードする前にリスナーを設定することをお勧めします。
- 各インタースティシャル広告には、独自のリスナー実装が必要です。
- コールバックはメインスレッドで実行されます。
// Register to interstitial eventsinterstitialAd.OnAdLoaded += InterstitialOnAdLoadedEvent;interstitialAd.OnAdLoadFailed += InterstitialOnAdLoadFailedEvent;interstitialAd.OnAdDisplayed += InterstitialOnAdDisplayedEvent;interstitialAd.OnAdDisplayFailed += InterstitialOnAdDisplayFailedEvent;interstitialAd.OnAdClicked += InterstitialOnAdClickedEvent;interstitialAd.OnAdClosed += InterstitialOnAdClosedEvent;interstitialAd.OnAdInfoChanged += InterstitialOnAdInfoChangedEvent;// Implement the eventsvoid InterstitialOnAdLoadedEvent(LevelPlayAdInfo adInfo){}void InterstitialOnAdLoadFailedEvent(LevelPlayAdError error){}void InterstitialOnAdDisplayedEvent(LevelPlayAdInfo adInfo){}void InterstitialOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error){}void InterstitialOnAdClickedEvent(LevelPlayAdInfo adInfo){}void InterstitialOnAdClosedEvent(LevelPlayAdInfo adInfo){}void InterstitialOnAdInfoChangedEvent(LevelPlayAdInfo adInfo){}
LevelPlay 広告情報
LevelPlayAdInfo パラメーターには、ロードされた広告に関する情報が含まれます。
実装と使用可能なフィールドの詳細については、こちらを参照してください。
ロード インタースティシャル広告
インタースティシャル広告をロードするには、LoadAd を使用します。
// Load interstitial adinterstitialAd.LoadAd();
インタースティシャル広告の表示
LevelPlayInterstitialAdListener API を使用して OnAdLoaded コールバックを受信した後にインタースティシャル広告を表示します。
- プレースメントを使用している場合は、後述のプレースメントのセクションで示すように、ShowAd APIで配置名を渡します。
- ユーザーに広告が正常に表示されたら、ロードステップを繰り返して別の広告をロードできます。
// Show ad without placementinterstitialAd.ShowAd();// Show ad with placementinterstitialAd.ShowAd(placementName: "placementName");
広告の準備ができているか確認
表示の失敗を避け、広告が正しく表示されるようにするために、ShowAd API を呼び出す前に以下の API を使用することをお勧めします。
IsAdReady – 広告のロードが成功し、広告単位が上限に達していない場合は true、それ以外の場合は false を返します。
IsPlacementCapped – 有効な配置に上限がある場合に true を返します。配置が有効でないか、上限がない場合、この API は false を返します。
// Check that ad is ready and that the placement is not cappedif (interstitialAd.IsAdReady() && !LevelPlayInterstitialAd.IsPlacementCapped(placementName)){ interstitialAd.ShowAd(placementName);}
Placements
LevelPlay ダッシュボードでは、インタースティシャルのプレースメント ペーシングとプレースメント キャップをサポートします。
インタースティシャル広告にプレースメントが設定されている場合は、ShowAd メソッドを呼び出して特定の配置の広告を配信します。
// Check that ad is ready and that the placement is not cappedif (interstitialAd.IsAdReady() && !LevelPlayInterstitialAd.IsPlacementCapped(placementName)){ interstitialAd.ShowAd(placementName);}
インタースティシャル広告の完全な実装例
public class InterstitialAdSample { private LevelPlayInterstitialAd interstitialAd; void CreateInterstitialAd() { //Create InterstitialAd instance interstitialAd= new LevelPlayInterstitialAd("interstitialAdUnitId"); //Subscribe InterstitialAd events interstitialAd.OnAdLoaded += InterstitialOnAdLoadedEvent; interstitialAd.OnAdLoadFailed += InterstitialOnAdLoadFailedEvent; interstitialAd.OnAdDisplayed += InterstitialOnAdDisplayedEvent; interstitialAd.OnAdDisplayFailed += InterstitialOnAdDisplayFailedEvent; interstitialAd.OnAdClicked += InterstitialOnAdClickedEvent; interstitialAd.OnAdClosed += InterstitialOnAdClosedEvent; interstitialAd.OnAdInfoChanged += InterstitialOnAdInfoChangedEvent; } void LoadInterstitialAd() { //Load or reload InterstitialAd interstitialAd.LoadAd(); } void ShowInterstitialAd() { //Show InterstitialAd, check if the ad is ready before showing if (interstitialAd.IsAdReady()) { interstitialAd.ShowAd(); } } //Implement InterstitialAd events void InterstitialOnAdLoadedEvent(LevelPlayAdInfo adInfo) { } void InterstitialOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) { } void InterstitialOnAdClickedEvent(LevelPlayAdInfo adInfo) { } void InterstitialOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { } void InterstitialOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { } void InterstitialOnAdClosedEvent(LevelPlayAdInfo adInfo) { } void InterstitialOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }}
LevelPlay Mediation デモアプリケーション
インテグレーション Demo (インテグレーションデモ) アプリケーションは、アプリケーションにインタースティシャル広告単位 API を統合する方法を示します。
インテグレーションテストスイートとのインテグレーションを確認します。
エディター内でインテグレーションをテストできます。Unity エディターで模擬広告をプレビューする方法については、『 プレビュー模擬広告ガイド 』を参照してください。
次のステップ
インテグレーション ガイドに従って、追加のインタースティシャル広告ネットワークを統合したり、追加の広告フォーマットを設定したりできます。