Reactネイティブ向けリワード広告インテグレーション

前提条件

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

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

import {    LevelPlayRewardedAd,    type LevelPlayRewardedAdListener,    type LevelPlayAdInfo,    type LevelPlayAdError,    type LevelPlayReward} 'unity-levelplay-mediation' からconst [rewardedAd, setRewardedAd] = useState<LevelPlayRewardedAd>(new LevelPlayRewardedAd('YOUR_AD_UNIT_ID'))useEffect(() => {    const listener:LevelPlayRewardedAdListener = {        onAdLoaded: (adInfo:LevelPlayAdInfo) => {            // Provided when the ad is successfully loaded        },        onAdLoadFailed: (error:LevelPlayAdError) => {            // Provided when the ad fails to load.広告単位情報が含まれている        },        onAdInfoChanged: (adInfo:LevelPlayAdInfo) => {            // Provided when the ad info is updated.別の広告がロードされ、CPM/レートが高い場合に利用可能        },        onAdDisplayed: (adInfo:LevelPlayAdInfo) => {            // Provided when the ad is displayed        },        onAdDisplayFailed: (error:LevelPlayAdError、adInfo：LevelPlayAdInfo) => {            // Provided when the ad fails to be displayed        },        onAdClicked: (adInfo:LevelPlayAdInfo) => {            // Provided when the user clicks on the ad        },        onAdClosed: (adInfo:LevelPlayAdInfo) => {            // Provided when the ad is closed        },        onAdRewarded: (reward:LevelPlayReward, adInfo:LevelPlayAdInfo) => {            // Provided when the ad is rewarded.広告単位情報と報酬情報が含まれます。        }    };    rewardedAd.setListener(listener);}, [rewardedAd]);

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

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

前提条件

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

ベストプラクティス

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

API 構造体

getReward

null

初期設定

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

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

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

UIの動的更新

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

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

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

リワード型広告のロード

rewardedAd.loadAd();

リワード広告の表示

// Show ad without placementrewardedAd.showAd();// Show ad with placementrewardedAd.showAd('YOUR_PLACEMENT');

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

// Check that ad is ready and that the placement is not capped (both APIs are async)const isReady = await rewardedAd.isAdReady();const isPlacementCapped = await LevelPlayRewardedAd.isPlacementCapped('YOUR_PLACEMENT');if (isReady && !isPlacementCapped) {  await rewardedAd.showAd('YOUR_PLACEMENT');}

Dynamic UserId

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

  dynamicUserId

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

LevelPlay.setDynamicUserId("userId");

ユーザーの報酬

onAdRewarded: (reward:LevelPlayReward, adInfo:LevelPlayAdInfo) => {    // Provided when the ad is rewarded.広告単位情報と報酬情報が含まれる}

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

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

import {    LevelPlayRewardedAd,    type LevelPlayRewardedAdListener,    type LevelPlayAdInfo,    type LevelPlayAdError,    type LevelPlayReward} 'unity-levelplay-mediation' からconst [rewardedAd, setRewardedAd] = useState<LevelPlayRewardedAd>(new LevelPlayRewardedAd('YOUR_AD_UNIT_ID'))const listener:LevelPlayRewardedAdListener = {    onAdLoaded: (adInfo:LevelPlayAdInfo) => {        // Implement your logic here, for example showing the ad        rewardedAd.showAd()    },    onAdLoadFailed: (error:LevelPlayAdError) => {        // Implement your logic here...    },    onAdInfoChanged: (adInfo:LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayed: (adInfo:LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayFailed: (error:LevelPlayAdError、adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClicked: (adInfo:LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClosed: (adInfo:LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdRewarded: (reward:LevelPlayReward, adInfo:LevelPlayAdInfo) => {        // Implement your logic here...    }};useEffect(() => {    rewardedAd.setListener(listener)    rewardedAd.loadAd()}, []);// Rest of component ...// End of component ...

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

次のステップ

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