# Android 高级设置 > 为 Android 配置高级设置，包括用户细分段、自定义参数和价格下限，以优化广告投放和 Monetization。 ## 定义细分段##define-segments 您现在可以轻松定制广告服务方式以适应指定的受众！您需要将用户的详细信息告知我们的服务器，以便 SDK 知道根据用户所属的细分段提供广告服务。 LevelPlay SDK 支持三种方法将数据传输到服务器以概括用户细分段，即： * **设备属性**：LevelPlay SDK 自动收集与用户设备相关的某些标准参数，例如位置、设备模型、设备制造商、app 版本和操作系统。您无需将这些数据传递给我们。 * **用户属性**：必须通过 API 中继全面的用户数据（例如年龄、性别和创建日期）。（请参阅受支持的细分段属性的完整列表，并在下一部分中进行描述。）按照说明向我们发送用户的详细信息，以便我们的 SDK 可以根据您在 LevelPlay 平台上定义的细分段对您的不同用户进行分类。 * **自定义细分段**：您可以创建自定义细分段，而无需将用户详细信息传递给我们的服务器，并可为该用户细分段定制广告设置。 动态细分 如果使用 LevelPlay SDK 7.2.0+，可使用 LevelPlaySegment API 在会话期间更改细分。 这将影响下一个加载的广告，并可在加载每个广告单元之前调用，以动态影响瀑布流 。您可以在[此处](/grow/levelplay/platform/settings/segments.md)了解有关 LevelPlay 细分的更多信息。 ### 通道用户属性##pass-user-properties 在 LevelPlay 平台上定义细分段后，您需要将用户的详细信息告知我们的服务器。 定义要发送到服务器的属性（这些属性是细分段底部的基础）。您可以通过以下方法之**一**传输此信息： 1. 如果您熟悉用户所属的细分段，请输入细分段名称： ```java mLPSegment.setSegmentName(name); ``` 2. 向我们发送用户详细信息。LevelPlay SDK 提供了一范围标准用户属性，您可以将其设置为将用户属性 API 中的细分段。向下滚动查看支持用户细分段属性的表。 ```java // Create segment object mLPSegment = new LevelPlaySegment(); // Set user's level mLPSegment.setLevel(level); // Set user creation date mLPSegment.setUserCreationDate(date); // Set user's total in-app purchases mLPSegment.setIAPTotal(iapt); // Set user's paying status mLPSegment.setIsPaying(isPaying); ``` 此外，每个细分段最多可以设置 5 个自定义用户属性： ```java // Set custom parameters (up to 5) mLPSegment.setCustom(key, value); ``` 接下来，要根据细分段投放广告单位来定制用户的广告体验，请使用细分段名称或用户属性调用以下函数： ```java LevelPlay.setSegment(mLPSegment); ``` ### **支持的用户细分段属性**##**supported-user-segment-properties** | 细分段属性 | 类型 | 限制 | 描述 | | ---------------- | ----------------------- | ----------------------------------------- | ------------------------------------------------------------- | | segmentName | 字符串 | 最多 32 个字母数字 | LevelPlay 帐户中细分段的给定名称 | | 付款 | 布尔值 | True 或 False | 如果用户在 app 内购买上花费了任何资金，则为 true 如果用户在 app 内购买上没有花费任何资金，则为 false | | iap\_total | 双倍 | 1-999999.99 | 用户在 app 内购买方面花费的总金额 | | userCreationDate | 长 | 不能小于 0 | 用户安装 app 的日期（以毫秒为单位） | | 自定义参数 | key=string、value=string | LevelPlay SDK 支持最多 5 个自定义参数，字母数字最多 32 个字母 | 要发送到我们服务器的任何其他数据 | 注册到以下回调以接收用户所属的细分段名称。如果回调字符串（细分段名称）返回空，则 LevelPlay 细分段模块中找不到用户的相关细分段。 ```java SegmentListener onSegmentReceived(字符串段){} ``` ## 奖励服务器到服务器回调的自定义参数##custom-parameters-for-rewarded-server-to-server-callbacks LevelPlay 基于奖励的广告单位支持服务器端事件，以通知您在广告成功完成事件后必须授予用户的奖励。在[此处](/grow/levelplay/platform/settings/server-to-server-callback.md)了解更多信息。 除了服务器参数之外，还可以通过客户端共享运行时自定义参数。要实现此目的，请使用 **setMetaData** API 将自定义参数通道到 **LevelPlay\_Rewarded\_Server\_Params**。自定义参数可以在整个会话中多次更新，覆盖以前的值。 要重置自定义参数，请将 **LevelPlay\_Rewarded\_Server\_Params** 设置为空数组。 ### 实现代代码例##example-implementation-code 1. **Java** ```java LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", List.of("key1=value1", "key2=value2")); ``` 2. **Kotlin** ```kotlin LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", listOf("key1=value1", "key2=value2")) ``` 然后，您将收到相应的回调。示例： ```text http://www.mydomain.com/rewardsCallback?appUserId=[USER_ID]&rewards=[REWARDS]&eventId=[事件_ID]&itemName=[ITEM_NAME]&custom_key1=value1&custom_key2=value2 ``` > **Note:** > > Min LevelPlay SDK 8.11.0。最多允许 2,048 个字符。 ## **价格地面配置**##**price-floor-configuration** 地面配置 API 允许您为指定的广告单元设置价格地面。通过为每个用户设置价格地面，可以提高定向投放效率、减少延迟并优化广告效果。 在创建广告对象时，必须分配价格地面，并应用于该对象的所有后续加载。 注意：Min SDK 8.9.0 | 属性 | 类型 | 描述 | | :--- | :----- | :----------------------------- | | 投标地面 | double | 定义应用于传统实例和出价者的最小 eCPM 的价格（美元）。 | ### 插页式广告示例##interstitial-ads-example ```java // Define a price floor configuration var adConfig = new LevelPlayInterstitialAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build(); // Apply the configuration to an interstitial ad unit var interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig); ``` [此处](/grow/levelplay/sdk/android/interstitial-integration.md)提供了完整的插补实现。 ### 奖励广告服务示例##rewarded-ads-example ```java // Define a price floor configuration val adConfig = LevelPlayRewardedAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build() // Apply the configuration to a rewarded ad unit val rewardAd = LevelPlayRewardedAd("adUnitId", adConfig) ``` [此处](/grow/levelplay/sdk/android/rewarded-ads-integration.md)提供完整的奖励广告服务。 ### 横幅广告服务示例##banner-ads-example ```java // Define a price floor configuration var adConfig = new LevelPlayBannerAd.Config.Builder() .setBidFloor(1.23) // 以美元设置价格地面 .build(); // Apply the configuration to a banner ad unit var bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig); ``` [此处](/grow/levelplay/sdk/android/banner-integration.md)提供了完整的横幅广告服务。 ## **LevelPlay SDK 报错代码**##**levelplay-sdk-error-codes** 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 | | 1035 | Interstitial | **空瀑布** | | 1036 | 间隙 | **显示失败**：显示另一个间隙时无法显示间隙 | | 1037 | 间隙 | **加载失败**：显示另一个间隙时无法加载另一个间隙 | | 1039 | 间隙 | 调用 show interstitial |