React Native 的奖励广告服务集成

先决条件

• 确保已将 React Native Plugin 正确集成到 app。此处概述了集成。
• 确保使用 LevelPlay Initialization 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 监听器：LevelPlayRewardedAdListener = {        onAdLoaded：（adInfo：LevelPlayAdInfo) => {            // Provided when the ad is successfully loaded        },        onAdLoadFailed：（报错：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：（报错：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：（奖励：LevelPlayReward、adInfo：LevelPlayAdInfo) => {            // Provided when the ad is rewarded.其中包含广告单元信息和奖励信息。        }    };    rewardedAd.setListener(listener);}, [rewardedAd]);

LevelPlay 奖励广告回调

获取奖励广告详细信息

先决条件

• SDK 初始化：调用 initSDK 并等待 onInitializationSuccess 回调以确保奖励数据已缓存。
• 广告对象实例：在调用 API 之前，使用有效的 Ad Unit ID 实例化奖励广告对象。
• 最低 SDK 版本：使用 LevelPlay SDK 8.1.0 或更高版本（原生或 Unity 软件包）。

最佳实践

• 初始化成功时调用：调用 getReward 的最佳时间是初始化成功监听器器内部。这样可以确保 UI 在用户进入屏幕时就绪。
• 检查空状态：在更新 UI 之前，请始终验证该数量> 0。如果在初始化期间发生网络报错，这将确保平滑的用户体验。
• 放置/位置精度：确保在 getReward("placementName") 中使用的字符串与 LevelPlay 后台中定义的名称完全匹配。

API 结构

getReward

null

初始设置

• 集成功能：由于奖励数据是在初始 SDK 设置期间获取的，因此 API 调用是即时的，不需要网络请求。
• 编辑器配置：将 app 与 LevelPlay SDK 集成后，API 可以立即使用。测试此功能不需要额外的资源或插件。

了解奖励选择逻辑

• 放置/位置级别：如果在调用中提供了有效的广告放置/位置称，SDK 将返回控制面板中为该广告位放置/位置的指定的奖励。
• 广告单元级别：如果广告放置/位置名称为 null 或未找到，SDK 将回退到为广告单元定义的默认奖励。
• 回退状态：如果在初始化完成之前调用 API，则返回一个字符串名称为空且值为 0 的奖励对象。

动态更新 UI

• 有效金额：在更新 UI 组件之前，请务必验证 reward.amount > 0。
• 事件驱动更新：在初始化成功监听器器中调用 API 以确保 UI 在用户进入屏幕时准确无误。
• 区分大小写：确保代码中的放置/位置名称字符串与 LevelPlay 后台完全匹配；不匹配的字符串将触发器广告单元回退。

getReward API 实现故障排除

• 奖励金额返回 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 rewardAd.showAd('YOUR_放置/位置');}

动态 UserId

• 字字符串必须包含 1-64 个字母数字角色。
• 您将在回调网址中收到一个

  dynamicUserId

  参数以及奖励详细信息。

LevelPlay.setDynamicUserId("userId");

奖励用户

onAdRewarded：（奖励：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 监听器：LevelPlayRewardedAdListener = {    onAdLoaded：（adInfo：LevelPlayAdInfo) => {        // Implement your logic here, for example showing the ad        rewardedAd.showAd()    },    onAdLoadFailed：（报错：LevelPlayAdError) => {        // Implement your logic here...    },    onAdInfoChanged：（adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayed：（adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdDisplayFailed：（报错：LevelPlayAdError、adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClicked：（adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdClosed：（adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    },    onAdRewarded：（奖励：LevelPlayReward、adInfo：LevelPlayAdInfo) => {        // Implement your logic here...    }};useEffect(() => {    rewardedAd.setListener(listener)    rewardedAd.loadAd()}, []);// Rest of component ...// End of component ...

LevelPlay Mediation 演示应用程序

后续步骤

• 添加聚合网络
• 横幅广告服务
• 插页式广告服务
• 原生广告服务