Unityパッケージのリワード広告インテグレーション

前提条件

• LevelPlay Unity パッケージがアプリケーションに正しく統合されていることを確認します。インテグレーションの概要はこちらです。
• LevelPlay 初期化 API を使用して SDK を初期化していることを確認します。
• LevelPlay ダッシュボードで AdUnitID を見つけます。

Rewarded Adオブジェクトの作成

// Create Rewarded Ad object LevelPlayRewardedAd rewardedAd = new LevelPlayRewardedAd(rewardedAdUnitId);

LevelPlayRewardedAd

Config

// 任意設定パラメーターを使用LevelPlayRewardedAd(string adUnitId, Config config = null)

Config

adUnitId

価格帯での作成

LevelPlayRewardedAd

Config

// Create Rewarded Ad object with Price Floor in config.var configBuilder = new LevelPlayRewardedAd.Config.Builder();configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar rvConfig = configBuilder.Build();LevelPlayRewardedAd RewardedAd = new LevelPlayRewardedAd(RewardedAdUnitId, rvConfig);

リワードイベントに登録

• リワード広告をロードする前にリスナーを設定することをお勧めします。
• 各リワード広告には、独自のリスナー実装が必要です。
• コールバックはメインスレッドで実行されます。

// Register to Rewarded eventsRewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;// OptionalRewardedAd.OnAdClicked += RewardedOnAdClickedEvent;RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;// Implement the eventsvoid RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) {}void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) {}void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) {}

LevelPlay 広告情報

リワード広告の詳細を取得する

前提条件

• SDK 初期化：initSDK を呼び出し、onInitializationSuccess コールバックが報酬データがキャッシュされていることを確認します。
• 広告オブジェクトインスタンス：API を呼び出す前に、有効な広告単位 ID でリワード広告オブジェクトをインスタンス化します。
• 最低 SDK バージョン:LevelPlay SDK バージョン 8.1.0 以上 (ネイティブまたは Unity パッケージ) を使用する。

ベストプラクティス

• 初期化成功時の呼び出し：getReward を呼び出し最適なタイミングは、初期化化成功リスナーのすぐ内側です。これにより、ユーザーが画面に入った瞬間に UI が準備されます。
• 空のステートをチェックします。UI を更新する前に、必ず 0 を超える値を確認してください。これにより、初期化期化中にネットワークワークエラーが発生しても滑らかななユーザー体験が保証されます。
• 配置精度:getReward("placementName") で使用される文字文字列が LevelPlay ダッシュボードで定義された名前と正確に一致していることを確認します。

API 構造体

getReward

public LevelPlayReward getReward(String placementName)

null

初期設定

• 統合特徴:報酬データはSDKの初期設定中に取得されるため、API呼び出しは瞬時に行われ、ネットワークリクエストを必要としません。
• エディター設定:アプリケーションを LevelPlay SDK と統合すると、API はすぐに使用できます。この機能をテストするために追加のアセットやプラグインは必要ありません。

報酬選択ロジックについて

• 配置レベル:呼び出しで有効な配置名が指定されている場合、SDKはダッシュボードでその配置に設定された特定の報酬を返します。
• 広告単位レベル：配置名が null の場合、または見つからない場合は、SDK は広告単位に定義されたデフォルトの報酬にフォールバックします。
• フォールバック状態:初期化が完了する前に API が呼び出された場合は、空の文字列列名と金額 0 の報酬オブジェクトが返されます。

UIの動的更新

• 検証量:UI コンポーネントを更新する前に、reward.amount が 0 を超えていることを常に確認してください。
• イベント主導型更新:初期化成功リスナー内で API を呼び出して、ユーザーが画面に入った瞬間に UI が正確であることを確認します。
• 大文字と小文字の区別:コード内の配置名の文字文字列が LevelPlay ダッシュボードと正確に一致していることを確認します。文字列が一致しないと、広告単位のフォールフォールバックがトリガーされます。

報酬データ例の取得

/// <summary> /// Retrieves the reward associated with the ad./// Use this method to obtain the reward configured for the ad unit or placement.ザ /// placement-specific reward takes precedence over the ad unit reward when a valid placement name /// is provided./// </summary> /// <param name="placement">The placement name to retrieve the reward for, or null to use the ad unit's reward.</param> /// <returns>A <see cref="LevelPlayReward"/> object.失敗した場合、空の報酬を返します (name: "" と amount:0).</returns> LevelPlayReward reward = rewardedAd.getReward("battle_screen");// Update UI dynamicallyif (reward.Amount > 0 && !string.IsNullOrEmpty(reward.Name)) {    rewardButton.text = $"クリックして {reward.Amount} を取得 {reward.Name}";} else {    rewardButton.text = "Watch for Rewards";}

getReward API 実装のトラブルシューティング

• Reward amount は 0 を返します。これは通常、onInitializationSuccess コールバックの前に API が呼び出された場合に発生します。ゲーム内報酬のクエリを実行する前に、SDKの準備が完全にできていることを確認します。
• 間違った報酬タイプ:複数のプレースメントがあるかどうかを確認します。配置名のスペルに誤りがある場合、SDKはデフォルトで特定の配置報酬ではなくプライマリ広告単位の報酬を使用します。

リワード型広告のロード

// Load rewarded adRewardedAd.LoadAd();

リワード広告の表示

• プレースメントを使用している場合は、後述のプレースメントのセクションで示すように、ShowAd APIで配置名を渡します。
• 広告がユーザーに正常に表示されたら、ロードステップを繰り返して別の広告をロードできます。

// Show ad without placementRewardedAd.ShowAd();// Show ad with placementRewardedAd.ShowAd(placementName: "placementName");

広告の準備ができているか確認

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

Placements

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

Dynamic UserId

• 文字列 値は 1 ~ 64 文字の英数字でなければなりません。
• コールバックURLで報酬の詳細とともに

  dynamicUserId

  パラメーターを受け取ります。

LevelPlay.SetDynamicUserId("userId");

ユーザーの報酬

// Subscribe to the OnAdRewarded eventRewardedAd.OnAdRewarded += (adInfo, adReward) =>{    // Grant the reward to the user    Debug.Log($"Ad Completed: {adInfo.PlacementName}, Reward: {adReward.Name} - {adReward.Amount}");    GrantReward(adReward.Name, adReward.Amount);};// Example method to process the rewardprivate void GrantReward(文字列 rewardName, int rewardAmount){    // TODO:ユーザーに報酬を付与するロジックを実装する    Debug.Log($"Granting reward: {rewardName} with amount: {rewardAmount}");}

リワード広告の完全な実装例

public class RewardedAdSample {    private LevelPlayRewardedAd RewardedAd;    void CreateRewardedAd() {        // Create RewardedAd instance        RewardedAd = new LevelPlayRewardedAd("RewardedAdUnitId");        // Subscribe RewardedAd events        RewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;        RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;        RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;        RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;        RewardedAd.OnAdClicked += RewardedOnAdClickedEvent;        RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;        RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;        RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;    }    void LoadRewardedAd() {        // Load or reload RewardedAd        RewardedAd.LoadAd();    }    void ShowRewardedAd() {        // Show RewardedAd, check if the ad is ready before showing        if (RewardedAd.IsAdReady()) {            RewardedAd.ShowAd();        }    }    // Implement RewardedAd events    void RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) { }    void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { }    void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) { }    void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }}

LevelPlay Mediation デモアプリケーション

次のステップ

• メディエーションネットワークの追加
• インタースティシャル広告
• バナー広告