React 的高级设置
配置 React 的高级设置，包括用户细分段、自定义参数和价格下限，以优化广告投放和 Monetization。
阅读时间11 分钟最后更新于 2 天前
定义细分段
您现在可以轻松定制广告服务方式以适应指定的受众！您需要将用户的详细信息告知我们的服务器，以便 SDK 知道根据用户所属的细分段提供广告服务。
LevelPlay 支持三种方法将数据传输到服务器以概括用户细分段，即：
- 设备属性：LevelPlay SDK 自动收集与用户设备相关的某些标准参数，例如位置、设备模型、设备制造商、app 版本和操作系统。您无需将这些数据传递给我们。
- 用户属性：必须通过 API 中继全面的用户数据，例如创建日期（请参阅受支持细分段属性的完整列表以及以下描述）。按照说明将用户的详细信息发送给我们，以便我们的 SDK 可以根据您在 LevelPlay 平台上定义的细分段对您的不同用户进行分类。
- 自定义细分段：您可以创建自定义细分段，而无需将用户详细信息传递给我们的服务器，并可为该用户细分段定制广告设置。
注意
如果使用 LevelPlay SDK 7.2.0+，可使用 LevelPlaySegment API 在会话期间更改细分。这将影响下一个加载的广告，并可在加载每个广告单元之前调用，以动态影响瀑布流。您可以在此处了解有关 LevelPlay 细分的更多信息。
通道用户属性
在 LevelPlay 平台上定义细分段后，应将用户的详细信息告知我们的服务器。
从 Unity LevelPlay 聚合软件包导入以下内容：
import { LevelPlaySegment, LevelPlay、} 来自“Unity LevelPlay-mediation”
定义要发送到服务器的属性（这些属性是细分段底部的基础）。 您可以通过以下方法之一传输此信息：
-
如果您熟悉用户所属的细分段，请设置细分段名称：const segment = { segmentName:'YOUR_SEGMENT_NAME' };LevelPlay.setSegment(segment);
-
向我们发送用户详细信息。LevelPlay SDK 提供了一范围标准用户属性，您可以将其设置为将用户属性 API 中的细分段。 请参阅下表以了解支持的细分段属性。const segment：LevelPlaySegment = { level：levelParam、// Int isPaying：isPayingParam、 userCreationDate：dateTimeParam，// 长，毫秒 iapTotal：iapTotalParam，// 双 customParameters：{ customKey1: 'customValue1', customKey2: 'customValue2', customKey3: 'customValue3', customKey4: 'customValue4', customKey5: 'customValue5', },};LevelPlay.setSegment(segment);
支持的细分段属性
细分段属性 | 类型 | 限制 | 描述 |
|---|---|---|---|
| segmentName | 字符串 | - 字母数字 - 最多 32 个字母 | LevelPlay 帐户中细分段的给定名称 |
| 付款 | 布尔值 | 是或否 | - 如果用户在 app 内购买上花费了任何资金，则为 true - 如果用户在 app 内购买上没有花费任何资金，则为 false |
| iap_total | 双倍 | 1-999999.99 | 用户在 app 内购买方面花费的总金额 |
| userCreationDate | 长 | 不能小于 0 | 用户安装 app 的日期（以毫秒为单位） |
| 自定义参数 | key=string、value=string | - LevelPlay 最多支持 5 个自定义参数 - 字母数字 - 最多 32 个字母 | 要发送到我们服务器的任何其他数据 |
奖励服务器到服务器回调的自定义参数
LevelPlay 基于奖励的广告单位支持服务器端事件，以通知您在广告成功完成事件后必须授予用户的奖励。您可以在此处了解更多信息。
除了服务器参数之外，还可以通过客户端共享运行时自定义参数。要实现此目的，请使用 setMetaData API 向 通道自定义参数。自定义参数可以在整个会话中多次更新，覆盖以前的值。
LevelPlay_Rewarded_Server_Params要重置自定义参数，请将 设置为空数组。
LevelPlay_Rewarded_Server_Params实现代码
LevelPlay.setMetaData('LevelPlay_Rewarded_Server_Params', ['key1=value1', 'key2=value2'])
然后，您将收到一个相应的回调，其中包含查询字符串中的自定义键和值。
示例：
http://www.mydomain.com/rewardsCallback?appUserId=[USER_ID]&rewards=[REWARDS]&eventId=[事件_ID]&itemName=[ITEM_NAME]&custom_key1=value1&custom_key2=value2
注意
Min LevelPlay SDK 8.11.0。最多允许 2,048 个字符。
价格地面配置
地面配置 API 允许您为指定的广告单元设置价格地面。通过为每个用户设置价格地面，可以提高定向投放效率、减少延迟并优化广告效果。在创建广告对象时，必须分配价格地面，并应用于该对象的所有后续加载。
注意：此功能的最低 SDK 版本为 8.9.0。
属性 | 类型 | 描述 |
|---|---|---|
| 投标地面 | double | 定义应用于传统实例和出价者的最小 eCPM 的价格（美元）。 |
插页式广告示例
从“Unity-levelplay-mediation”导入 { LevelPlayInterstitialAd }// Create an interstitial ad and set the price floor in USDconst interstitialAd = new LevelPlayInterstitialAd('adUnitId')interstitialAd.setBidFloor(1.23)
此处的完整插页实现
奖励广告服务示例
从“Unity-levelplay-mediation”导入 { LevelPlayRewardedAd }// Create a rewarded ad and set the price floor in USDconst rewardedAd = new LevelPlayRewardedAd('adUnitId')rewardedAd.setBidFloor(1.23)
此处提供完整的奖励广告服务。
横幅广告服务示例
通道作为设置美元价格地面的道具：
bidFloor从“Unity-levelplay-mediation”导入 { LevelPlayBannerAdView、LevelPlayAdSize }// Render a banner with a price floor of 1.23 USD<LevelPlayBannerAdView adUnitId="adUnitId" adSize={LevelPlayAdSize.BANNER} placementName={null} bidFloor={1.23}/>
此处提供了完整的横幅实现。
LevelPlay SDK 报错代码
LevelPlay 提供了报错机制，用于解释 SDK 集成中的任何失败。当出现问题或集成的一个方面未正确完成时，您将收到这些错误。
LevelPlay 报错对象包含报错代码和消息。以下是所有可能的错误及其基于其函数的消息：
错误代码 | 广告单元 | 描述 |
|---|---|---|
| 508 | 不适用 |
|
| 509 | 插页式、奖励视频 | 显示失败：无广告服务展示 |
| 510 | 插页式、奖励视频、横幅 | 加载失败：服务器响应失败 |
| 520 | 插页式、奖励视频 | 显示失败：无互联网连接；已启用 ShouldTrackNetworkState
显示失败：无互联网连接 |
| 524 | 插页式、奖励视频 | 显示失败：放置/位置 %@ 已达到每个节奏定义的限制
显示失败：放置/位置 %@ 已达到其上限 |
| 526 | 插页式、奖励视频 | 显示失败：广告单元已达到每个会话的每日上限 |
| 604 | 横幅 | 无法加载，因为放置/位置已覆盖 |
| 605 | 横幅 | 加载横幅时出现意外异常 |
| 606 | 横幅 | 第一次加载时不在所有网络上填充横幅 |
| 1007 | 插页式、奖励视频 | Auction Fail：拍卖请求未包含所有必需信息 |
| 1022 | 奖励视频 | 显示失败：无法显示另一个 RV 时显示另一个 RV |
| 1023 | 奖励视频 | 显示失败：在没有可用的广告服务可供显示时显示调用的 RV |
| 1035 | Interstitial | 空瀑布 |
| 1036 | 间隙 | 显示失败：显示另一个间隙时无法显示间隙 |
| 1037 | 间隙 | 加载失败：显示另一个间隙时无法加载另一个间隙 |
| 1039 | 间隙 | 调用 show interstitial | 时发生异常