# Unity LevelPlay 聚合 本指南将逐步指导您如何在 Unity LevelPlay 聚合中设置 Chartboost。 ## 平台集成 & 支持广告类型 请按照 LevelPlay 官方指南集成 LevelPlay 聚合 SDK 和 Chartboost LevelPlay SDK 适配器： [**iOS 集成**](http://developers.ironsrc.com/ironsource-mobile/ios/chartboost-mediation-guide/#step-4) [**Android 集成**](http://developers.ironsrc.com/ironsource-mobile/android/chartboost-mediation-guide/#step-5) [**Unity 集成**](http://developers.ironsrc.com/ironsource-mobile/unity/chartboost-mediation-guide/#step-5) ## 支持的集成和广告格式 Unity LevelPlay SDK 对外开放了原生的 Chartboost SDK 接口，所以你可以在 Unity LevelPlay SDK 之外访问所有的原生 Chartboost 插屏广告 ，激励视频广告和横幅广告的方法。 | 功能 | 支持 | |:---------------:|:---------:| | **集成方式** | | 竞价 | ✓ | | 瀑布流 | ✓ | | **广告格式** | | 横幅广告 | ✓ | | 插屏广告 | ✓ | | 激励广告 | ✓ | ## 第 1 步：在 Chartboost 界面中设置配置 [注册](https://platform.chartboost.com/signup) Chartboost 账户，并在账号通过验证后 [登录](https://platform.chartboost.com/login)。然后，前往[Apps Management](https://platform.chartboost.com/apps/overview)（应用管理） 。 ![](/assets/images/articles/chartboost_dashboard_apps.png) 点击 **+ Add new app** （添加新应用）按钮来创建您的应用。详情请参阅 [添加应用](https://docs.chartboost.com/zh/monetization/publishing/adding-your-first-app-and-campaign/#adding-apps)。 ![](/assets/images/articles/apps_management.png) 填写表单的其余部分，然后点击 **+ Add app** （添加应用）按钮以完成应用创建。 ![](/assets/images/articles/new_app_form.png) 应用创建后，您将进入其信息中心。记下应用的 **App ID** 和 **App Signature**。 ![](/assets/images/articles/Chartboost_appIDappSignature.png) 请确保您的应用成功通过 [应用审核](https://docs.chartboost.com/zh/monetization/publishing/publisher-app-review/)。 ## 第 2 步：在 Unity LevelPlay 后台激活 Chartboost 广告位 如果 Chartboost 尚未在您的 LevelPlay 账户中激活，请前往 [Unity LevelPlay 后台 > Setup > Networks](https://platform.ironsrc.com/partners/next/networks)，找到 **Chartboost**，然后点击 **Setup**（设置）。 ![](/assets/images/articles/UnityLevelPlay_LevelPlayDashboard_activateChartboostNetwork.png) 输入您的 Chartboost User ID 和 User Signature。 [点击此处了解如何找到它们](https://docs.chartboost.com/en/faq/analytics/#where-do-i-find-my-user-id-and-user-signature)。点击 "Save"。 ![](/assets/images/articles/UnityLevelPlay_LevelPlayDashboard_activateChartboostNetworkUserId.png) ## 第 3 步：在 Chartboost 和 Unity LevelPlay 后台设置竞价和/或瀑布流广告位 Unity LevelPlay 支持 Chartboost 竞价和 Chartboost 瀑布流。请按照以下指南为您偏好的模式设置 Chartboost 广告位： * [设置 Chartboost 竞价广告位](#如何在-unity-levelplay-中设置-chartboost-竞价广告位) * [设置 Chartboost 瀑布流广告位](#如何在-unity-levelplay-中设置-chartboost-瀑布流广告位) ## 如何在 Unity LevelPlay 中设置 Chartboost 竞价广告位 **1. 创建竞价广告位**：在您的 Chartboost 后台，为您的应用 [创建 Chartboost 广告位](https://docs.chartboost.com/en/monetization/publishing/ad-locations/)。 * 将 **Ad Location Type**（广告位类型） 设置为 **Bidding**(竞价)。 * 记下**Ad Location Name**(广告位名称)，您在 LevelPlay 的设置中会需要它。 ![](/assets/images/articles/UnityLevelPlay_ChartboostDashboard_bidding_adLocation.png) **2. 在聚合中设置竞价广告位**： 在您的 Unity LevelPlay 后台， 2.1 导航至 **LevelPlay 后台 > Setup > Instances**，选择您的应用，然后在 **Bidding** 部分下点击 **Chartboost**。 ![](/assets/images/articles/UnityLevelPlay_LevelPlayDashboard_biddingNetwork.png) 您将看到一个对话框，允许您输入 Chartboost 的参数： ![](/assets/images/articles/UnityLevelPlay_setupBiddingInstance.png) 2.2 输入您的 Chartboost **App ID** 和 **App Signature**。 * *这些信息可以在 Chartboost 后台的 **[Apps Management](https://platform.chartboost.com/apps/overview)**(应用管理) 下找到。* ![](/assets/images/articles/Chartboost_appIDappSignature.png) 2.3 点击 "+ Add Instance" 并选择一个广告格式。 在 **Location** 字段中，输入来自您 Chartboost 后台对应的广告位名称。*重要提示：此名称必须完全匹配。* 您可以在 **Instance Name** 字段中为该广告位指定任何自定义名称。 ![](/assets/images/articles/UnityLevelPlay_ChartboostDashboard_biddingAdLocation.png) 2.4 在 “Mediation groups” 字段中，在适用的聚合组上激活该广告位。 2.5. 为每种广告格式重复这些步骤，然后点击 **Save**。 您已全部设置完毕！Chartboost 现在已作为竞价平台启用。 ## 如何在 Unity LevelPlay 中设置 Chartboost 瀑布流广告位 ### 1. 设置 Chartboost 广告位 如果您尚未将 Chartboost 设置为广告平台，请按照 Unity LevelPlay [Chartboost 聚合集成指南](https://developers.ironsrc.com/ironsource-mobile/android/chartboost-mediation-guide/){:target="_blank"} 中的指导添加 Chartboost 作为广告平台。 - 登录到您的 [Unity LevelPlay平台](https://platform.ironsrc.com/partners/login){:target="_blank"}，然后导航到 Setup > SDK Networks（设置 > SDK平台）。从应用程序列表中选择所需的应用。在右侧找到非竞价选项下的 Chartboost，然后点击设置以创建 Chartboost 广告位。 ![](/assets/images/articles/UnityLevelPlay_SDKNetworkSetup_waterfallNetworkSetup.png) - 在 **App ID** 和 **App Signature** 框中输入您的 Chartboost **App ID** 和 **App Signature**。在您的 [Chartboost平台](https://platform.chartboost.com/){:target="_blank"} 中，导航到 **Apps Management（应用程序管理）**并选择应用程序。App ID 和 App Signature 将显示在右侧栏下的 **App information（应用信息）**中。 ![](/assets/images/articles/Chartboost_appIDappSignature.png) ![](/assets/images/articles/UnityLevelPlay_AppSetting_waterfall_appidappsig.png) - 选择广告类型。Chartboost 支持 Unity LevelPlay 的激励视频、插屏广告和横幅广告。 ![](/assets/images/articles/UnityLevelPlay_AppSettings_waterfall_adtype.png) - 为 **Location（广告位）**输入一个值。在 Chartboost 平台中，这也被称为**广告位置**。登录到您的 [Chartboost平台](https://platform.chartboost.com/){:target="_blank"}。导航到 **Monetization** 并选择应用程序。将Chartboost **广告位置**名称输入到 Unity LevelPlay **广告位**字段中。如果没有列出广告位置，则需要在继续之前 [创建新的广告位置](/zh/monetization/publishing/ad-locations/)。 - **广告位置名称**不能超过80个字符。注意：Chartboost [应用程序国家API](/en/advertising/reference/analytics-methods/) 可以提供按 `adLocation` （广告位置）值进行数据划分的统计数据，这些广告位置的展示量必须要超过一个活动阈值（例如，通常约为展示大约10个不同广告素材），否则它们将不会被拆分，而是汇总在 `other` （其他）分组中。 ![](/assets/images/articles/Chartboost_adLocationName.png) - 设置一个国家组。了解有关在 Unity LevelPlay 中 [创建自定义国家组](https://developers.is.com/ironsource-mobile/air/mediation-management-3/#step-4){:target="_blank"} 的更多信息。 ![](/assets/images/articles/UnityLevelPlay_AppSetting_waterfall_country.png) - 设置费率以手动为此广告位的瀑布流排序分配价格。此字段是可选的。了解有关Unity LevelPlay 的 [费率设置](https://developers.is.com/ironsource-mobile/air/mediation-management-3/#step-3){:target="_blank"} 的更多信息。 ![](/assets/images/articles/UnityLevelPlay_AppSetting_waterfall_rate.png) - 继续到添加更多的 Chartboost 广告位部分去添加更多的 Chartboost 广告位。否则，单击保存并继续到下一部分。 #### 添加更多的Chartboost广告位（可选） - 要添加更多的 Chartboost 广告位，请点击 **+Add Network Instance（添加广告平台广告位）**。 ![](/assets/images/articles/UnityLevelPlay_AppSetting_waterfall_addNetworkInstance.png) - 当您有多个广告位时，Unity LevelPlay 将要求您设置一个**广告位名称**。我们建议使用**Location（位置）**名称作为**广告位名称**。 ![](/assets/images/articles/UnityLevelPlay_AppSetting_waterfall_instanceName.png) - 为新广告位输入另一个**Location（位置）**（在 Chartboost 平台中，这也被称为 **Ad Location（广告位置）**）。 - 设置一个国家组。 - 输入费率金额（可选）。 - 重复以上步骤以从 Chartboost 添加多达10个不同的广告位。完成后点击**Save（保存）**。 ### 2. 在聚合群组里使用 Chartboost 广告位 如果您在 Unity LevelPlay 中有不止一个聚合群组，请记住在每个希望展示 Chartboost 广告的聚合群组中包含所有 Chartboost 广告位。 ![](/assets/images/articles/UnityLevelPlay_MediationManagement_groups.png) - 为确保包含 Chartboost 广告位，请登录到 [Unity LevelPlay 平台](https://platform.ironsrc.com/partners/login){:target="_blank"}，跳转到 **Setup** > **SDK Networks**，从应用程序列表中点击所需的应用，找到 **Non Bidding** 下的Chartboost，然后点击 **Edit（编辑）**图标。 ![](/assets/images/articles/UnityLevelPlay_SDKNetworkSetup_edit.png) - 点击 **Mediation Groups（聚合群组）**下拉菜单，勾选您希望包含 Chartboost广告位的所有群组。这必须对每个广告位都进行。默认情况下，所有群组都将被包括。 ![](/assets/images/articles/UnityLevelPlay_SDKNetworkSetup_appSettingCountry.png) - 当您完成设置后，点击 **Save** 保存。 ### 3. 手动排序并置顶 Chartboost 广告位 当您在 Unity LevelPlay 聚合群组中有多个广告位时，您可以手动排列每个广告位的顺序，使用此工具将 Chartboost 置顶。 要在 Unity LevelPlay 瀑布流中手动排序广告位，请登录 [Unity LevelPlay 平台](https://platform.ironsrc.com/partners/login){:target="_blank"}，然后导航至 **Management（管理）** > **Mediation（聚合）**。 1. 从应用程序列表中点击所需的应用。 2. 在群组列表中点击所需的 **Mediation Group（聚合群组）**。 3. 点击所需的广告类型（激励视频、插屏广告、横幅广告）。 _请注意，默认情况下，Unity LevelPlay 会选定激励视频的标签页。_ ![](/assets/images/articles/UnityLevelPlay_MediationManagement_tiers.png) 以下步骤以激励视频为例，插屏广告和横幅广告的设置过程也是一样的。 - 将一个 tier（广告层级）设置为 **Manual（手动）**，然后将 Chartboost 拖放到该层级中。 - 一旦您在此层级放置了某广告源的一个广告位，您的应用将优先于任何较低层级从该广告源获取广告，但不会优先于任何更高层级。 - 在手动优先级范围内,广告位将根据您放置它们的顺序进行投放，不考虑 eCPM 或填充率。 确保您已正确手动排列所有 Chartboost 广告位的顺序。任何处于较低层级的广告位都将在瀑布流中于较高层级之后被获取广告。在按 CPM 排序或优化选项内，Unity LevelPlay 将选择当前排名最高的 eCPM 或填充率的广告位来提供广告。 - 如果您有多个聚合群组，您将需要对包含 Chartboost 广告位的每个群组重复第 3 步设置。 - 要将 Chartboost 置顶，将 Chartboost 广告位拖放到最高层级的顶部。 现在，聚合群组中的广告位就可以请求来自 Chartboost 的多个广告位的广告了（按照预设的排名先后顺序）。