文档

​
​

Development

User Acquisition

Monetization

工业

LevelPlay SDK - Android

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - Android

Unity LevelPlay
​
​
Android SDK
  • 开始使用
  • 法规和设置
    • 法规高级设置
    • Android 高级设置
    • 展示级别收入集成
    • 集成 AdInfo 的 LevelPlay 监听器
  • 广告格式
  • 聚合网络
  • 测试集成
  1. 实现游戏增长
  2. Unity LevelPlay
  3. LevelPlay SDK
  4. 适用于 Android 开发者的 LevelPlay SDK

Android 高级设置

为 Android 配置高级设置,包括用户细分段、自定义参数和价格下限,以优化广告投放和 Monetization。
阅读时间12 分钟
最后更新于 2 天前

定义细分段

您现在可以轻松定制广告服务方式以适应指定的受众!您需要将用户的详细信息告知我们的服务器,以便 SDK 知道根据用户所属的细分段提供广告服务。
LevelPlay SDK 支持三种方法将数据传输到服务器以概括用户细分段,即:
  • 设备属性:LevelPlay SDK 自动收集与用户设备相关的某些标准参数,例如位置、设备模型、设备制造商、app 版本和操作系统。您无需将这些数据传递给我们。
  • 用户属性:必须通过 API 中继全面的用户数据(例如年龄、性别和创建日期)。(请参阅受支持的细分段属性的完整列表,并在下一部分中进行描述。)按照说明向我们发送用户的详细信息,以便我们的 SDK 可以根据您在 LevelPlay 平台上定义的细分段对您的不同用户进行分类。
  • 自定义细分段:您可以创建自定义细分段,而无需将用户详细信息传递给我们的服务器,并可为该用户细分段定制广告设置。
动态细分
如果使用 LevelPlay SDK 7.2.0+,可使用 LevelPlaySegment API 在会话期间更改细分。
这将影响下一个加载的广告,并可在加载每个广告单元之前调用,以动态影响瀑布流 。您可以在此处了解有关 LevelPlay 细分的更多信息。

通道用户属性

在 LevelPlay 平台上定义细分段后,您需要将用户的详细信息告知我们的服务器。
定义要发送到服务器的属性(这些属性是细分段底部的基础)。您可以通过以下方法之一传输此信息:
  1. 如果您熟悉用户所属的细分段,请输入细分段名称:
mLPSegment.setSegmentName(name);
  1. 向我们发送用户详细信息。LevelPlay SDK 提供了一范围标准用户属性,您可以将其设置为将用户属性 API 中的细分段。向下滚动查看支持用户细分段属性的表。
// Create segment objectmLPSegment = new LevelPlaySegment();// Set user's levelmLPSegment.setLevel(level);// Set user creation datemLPSegment.setUserCreationDate(date);// Set user's total in-app purchasesmLPSegment.setIAPTotal(iapt);// Set user's paying statusmLPSegment.setIsPaying(isPaying);
此外,每个细分段最多可以设置 5 个自定义用户属性:
// Set custom parameters (up to 5)mLPSegment.setCustom(key, value);
接下来,要根据细分段投放广告单位来定制用户的广告体验,请使用细分段名称或用户属性调用以下函数:
LevelPlay.setSegment(mLPSegment);

支持的用户细分段属性

细分段属性

类型

限制

描述

segmentName字符串最多 32 个字母数字LevelPlay 帐户中细分段的给定名称
付款布尔值True 或 False如果用户在 app 内购买上花费了任何资金,则为 true 如果用户在 app 内购买上没有花费任何资金,则为 false
iap_total双倍1-999999.99用户在 app 内购买方面花费的总金额
userCreationDate长不能小于 0用户安装 app 的日期(以毫秒为单位)
自定义参数key=string、value=stringLevelPlay SDK 支持最多 5 个自定义参数,字母数字最多 32 个字母要发送到我们服务器的任何其他数据
注册到以下回调以接收用户所属的细分段名称。如果回调字符串(细分段名称)返回空,则 LevelPlay 细分段模块中找不到用户的相关细分段。
SegmentListener onSegmentReceived(字符串段){}

奖励服务器到服务器回调的自定义参数

LevelPlay 基于奖励的广告单位支持服务器端事件,以通知您在广告成功完成事件后必须授予用户的奖励。在此处了解更多信息。
除了服务器参数之外,还可以通过客户端共享运行时自定义参数。要实现此目的,请使用 setMetaData API 将自定义参数通道到 LevelPlay_Rewarded_Server_Params。自定义参数可以在整个会话中多次更新,覆盖以前的值。
要重置自定义参数,请将 LevelPlay_Rewarded_Server_Params 设置为空数组。

实现代代码例

LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", List.of("key1=value1", "key2=value2"));
LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", listOf("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 允许您为指定的广告单元设置价格地面。通过为每个用户设置价格地面,可以提高定向投放效率、减少延迟并优化广告效果。
在创建广告对象时,必须分配价格地面,并应用于该对象的所有后续加载。
注意:Min SDK 8.9.0

属性

类型

描述

投标地面double定义应用于传统实例和出价者的最小 eCPM 的价格(美元)。

插页式广告示例

// Define a price floor configurationvar adConfig = new LevelPlayInterstitialAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build();// Apply the configuration to an interstitial ad unitvar interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig);
此处提供了完整的插补实现。

奖励广告服务示例

// Define a price floor configurationval adConfig = LevelPlayRewardedAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build()// Apply the configuration to a rewarded ad unitval rewardAd = LevelPlayRewardedAd("adUnitId", adConfig)
此处提供完整的奖励广告服务。

横幅广告服务示例

// Define a price floor configurationvar adConfig = new LevelPlayBannerAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build();// Apply the configuration to a banner ad unitvar bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig);
此处提供了完整的横幅广告服务。

LevelPlay SDK 报错代码

LevelPlay SDK 提供了一种报错反馈机制来解释 SDK 集成中的任何失败。当出现问题或集成的某些方面未正确完成时,您将收到这些错误。
LevelPlay 报错对象包含报错代码和消息。以下是所有可能的错误及其基于其函数的消息:
时发生异常

错误代码

广告单元

描述

508不适用
  • 聚合/网络初始化失败
  • 在非 Demand Only 模式下调用 Demand Only API
  • 在 Demand Only 模式下调用非 Demand Only API
509插页式、奖励视频显示失败:无广告服务展示
510插页式、奖励视频、横幅加载失败:服务器响应失败
520插页式、奖励视频
显示失败:无互联网连接;已启用 ShouldTrackNetworkState 显示失败:无互联网连接
524插页式、奖励视频
显示失败:放置/位置 %@ 已达到每个节奏定义的限制 显示失败:放置/位置 %@ 已达到其上限
526插页式、奖励视频显示失败:广告单元已达到每个会话的每日上限
604横幅无法加载,因为放置/位置已覆盖
605横幅加载横幅时出现意外异常
606横幅第一次加载时不在所有网络上填充横幅
1007插页式、奖励视频Auction Fail:拍卖请求未包含所有必需信息
1022奖励视频显示失败:无法显示另一个 RV 时显示另一个 RV
1023奖励视频显示失败:在没有可用的广告服务可供显示时显示调用的 RV
1035Interstitial空瀑布
1036间隙显示失败:显示另一个间隙时无法显示间隙
1037间隙加载失败:显示另一个间隙时无法加载另一个间隙
1039 间隙 调用 show interstitial

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • 定义细分段

      • 通道用户属性

      • 支持的用户细分段属性

    • 奖励服务器到服务器回调的自定义参数

      • 实现代代码例

    • 价格地面配置

      • 插页式广告示例

      • 奖励广告服务示例

      • 横幅广告服务示例

    • LevelPlay SDK 报错代码


报告此页面的问题