Flutter のリワード広告インテグレーション

前提条件

• Flutter プラグインをアプリケーションに統合します。
• LevelPlay 初期化 API を使用して SDK を初期化していることを確認します。
• LevelPlay ダッシュボードで AdUnitID を見つけます。

リワード型の作成とイベントへの登録

onInitSuccess

final LevelPlayRewardedAd _rewardedAd = LevelPlayRewardedAd(adUnitId: [YOUR_AD_UNIT_ID]);@overridevoid initState() {    super.initState();    _rewardedAd.setListener(this);}// LevelPlayRewardedAdListener methods@overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {}@overridevoid onAdLoadFailed(LevelPlayAdError error) {} @overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {}@overridevoid onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {}@override void onAdClosed(LevelPlayAdInfo adInfo) {}@overridevoid onAdClicked(LevelPlayAdInfo adInfo) {} @overridevoid onAdInfoChanged(LevelPlayAdInfo adInfo) {}@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {}

LevelPlay リワード広告コールバック

• onAdLoaded

  : 広告が正常にロードされたときに提供されます。

• onAdLoadFailed

  : 広告のロードに失敗したときに提供されます。広告単位情報が含まれている

• onAdDisplayed

  : 広告が表示されるときに提供されます。これはインプレッションに相当します

• onAdDisplayFailed

  (任意):広告の表示に失敗したときに提供されます。

• onAdRewarded

  : 広告に報酬が支払われるときに提供されます。広告単位情報と報酬情報が含まれます。

• onAdClicked

  (任意):ユーザーが広告をクリックしたときに提供されます。

• onAdClosed

  : 広告が閉じられたときに提供されます。

• onAdInfoChanged

  (任意):広告情報が更新されたときに提供されます。別の広告がロードされ、CPM/レートが高い場合に利用可能

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

前提条件

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

ベストプラクティス

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

API 構造体

getReward

• placementName

  : LevelPlay ダッシュボードで定義されている配置の一意のの識別子。

  null

  を渡して、広告単位のデフォルトの報酬を取得します。

初期設定

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

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

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

UIの動的更新

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

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

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

リワード型広告のロード

_rewardedAd.loadAd();

リワード広告の表示

// Show ad without placement_rewardedAd.showAd();// Show ad with placement_rewardedAd.showAd(placement: [YOUR_PLACEMENT]);

広告の準備ができていることを確認

• isAdReady

  : 広告のロードが成功し、広告単位が上限に達していない場合は true、それ以外の場合は false を返します。

• isPlacementCapped

  : 有効な配置に上限がある場合に true を返します。配置が有効でないか、上限がない場合、この API は false を返します。

// Check that ad is ready and that the placement is not capped if(_rewardedAd.isAdReady() && !LevelPlayRewardedAd.isPlacementCapped([YOUR_PLACEMENT])) {     _rewardedAd.showAd(placement:[YOUR_PLACEMENT]);}

Dynamic UserId

• 文字列 値は 1 ~ 64 文字の英数字である必要があります。
• コールバックURLで報酬の詳細とともに

  dynamicUserId

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

LevelPlay.setDynamicUserId("userId");

ユーザーの報酬

onAdRewarded

onAdRewarded

onAdClosed

onAdClosed

onAdRewarded

@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {    // Implement logic to grant the reward to the user}

複数の広告単位リワード型API

IronSource

LevelPlayRewardedAd

loadRewardedVideo

loadAd

showRewardedVideo

showAd

isRewardedVideoPlacementCapped

isPlacementCapped

isRewardedVideoAvailable

isAdReady

placement.getRewardName

reward.name

placement.getRewardAmount

reward.amount

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

final LevelPlayRewardedAd _rewardedAd = LevelPlayRewardedAd(adUnitId:'YOUR_AD_UNIT_ID');@overridevoid initState() {    super.initState();    _rewardedAd.setListener(this);    _rewardedAd.loadAd();}@overridevoid onAdRewarded(LevelPlayReward reward, LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdClicked(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdClosed(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdDisplayFailed(LevelPlayAdError error, LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdDisplayed(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdInfoChanged(LevelPlayAdInfo adInfo) {    // Implement your logic here...}@overridevoid onAdLoadFailed(LevelPlayAdError error) {    // Implement your logic here...}@overridevoid onAdLoaded(LevelPlayAdInfo adInfo) {    // Implement your logic here, for example showing the ad    _rewardedAd.showAd();}// Rest of the widget// End of widget...