Unity 聚合到 Unity LevelPlay 迁移指南
从 Unity 聚合迁移到 Unity LevelPlay 的过程中，您可以使用以下两种资源：
- 本指南中概述的迁移流程。
- 该 YouTube 视频教程展示的步骤。
您可以将以下内容从 Unity 聚合迁移到 Unity LevelPlay：
- 将瀑布流从 Unity Monetization（变现）后台迁移到 LevelPlay 后台。
- 将代码从 Unity 聚合 Advertisement with Mediation 包迁移到 Unity LevelPlay Ads Mediation 包。
重要：最好是遵照两种流程，以便将设置从聚合完全迁移到 Unity LevelPlay。
瀑布流迁移
将瀑布流迁移到 LevelPlay 后台。
注意：Unity 聚合和 LevelPlay 表示相同的功能，只是名称不同。如需查看直接比较情况，请参阅 ironSource 知识中心中的迁移术语。
先决条件
您需要 ironSource 帐户。
注意：创建 ironSource 帐户时，需要经过审核。最后的验证步骤可能会要求您提供财务机构详细信息；只有计划将 ironSource 作为 LevelPlay 广告网络使用的用户需要提供此信息。
如需了解更多信息，请参阅有关帐户待审核的 ironSource 帮助文章。
迁移流程
注意：在 Unity Monetization（变现）后台上切换聚合合作伙伴前，建议您在 LevelPlay 后台上检查瀑布流。切换聚合合作伙伴后，您将失去对特定于 Unity 聚合的页面的访问权限，但使用旧版本应用的用户仍可享受广告服务。如需了解更多信息，请参阅在切换聚合合作伙伴前检查瀑布流。
要访问后台 迁移指南 并将 Unity 聚合项目迁移到 Unity LevelPlay，请完成以下步骤：
从 Unity Monetization（变现）后台，选择项目级别页面 > Start migration（开始迁移）。
注意：您还可以通过在二级导航菜单中选择 Monetization（变现）后台 > Migration Guide（迁移指南） 来访问 迁移指南。
完成迁移指南中的步骤，以迁移瀑布流。
重要：如果在进行迁移时对瀑布流做出更改，这些更改不会更新到 LevelPlay 后台中。
后续步骤：完成对瀑布流的迁移后，请参阅验证 LevelPlay 中的实例和值。
在切换聚合合作伙伴前检查瀑布流
完成迁移后，除非 切换聚合合作伙伴，否则仍然可以访问瀑布流。切换聚合合作伙伴后，您将失去对特定于 Unity 聚合的页面的访问权限，但使用旧版本应用的用户仍可享受广告服务。
您可以下载瀑布流当前的配置，以便检查。
- 从 Monetization（变现）后台中选择 Waterfall（瀑布流）。
- 选择瀑布流。
- 选择 CSV Tools（CSV 工具）> Download Waterfall Configuration（下载瀑布流配置）。
验证 LevelPlay 中的实例和值
注意：Unity 聚合中的 序列项 在 LevelPlay 中被称作 实例。请参阅 ironSource 知识中心中的迁移术语，查看更多比较情况。
LevelPlay 网络实例
LevelPlay 不支持使用某些广告网络创建实例，这意味着某些 Unity 聚合序列项可能在 LevelPlay 后台上不显示，具体视 ironSource 帐户设置而定。迁移后，以下实例可能在 LevelPlay 上不显示：
- Unity Bidding
- AdColony eCPM
- AdMob eCPM
- ironSource eCPM
- Liftoff Monetize eCPM
要了解更多有关网络实例的信息，请参阅 ironSource 知识中心中的 ironSource 实例。
更新占位符值
Unity 聚合和 Unity LevelPlay 并不要求使用相同的序列项和实例创建值。要从 Unity 聚合中迁移序列项，某些实例可以使用临时占位符值集，这些实例在迁移完成后需要更新。
例如，下图显示 LevelPlay 中 AdColony 实例的配置。SDK 密钥 具备 占位符值，因为在 Unity 聚合中，创建序列项时对此值不做要求。迁移流程完成后，您需要为此实例更新有效的占位符值。
以下示例包含 占位符值，需要在迁移完成后进行更新：
- Applovin eCPM（非竞价）
- Meta 竞价
- Liftoff Monetize 竞价
如需了解更多信息，请参阅 ironSource 知识中心中的设置额外实例（可选）。
代码迁移
注意：该迁移工具支持 ironSource 7.2.3 至 7.3.0。
要从 Unity 聚合 Advertisement with Mediation 包迁移到 Unity LevelPlay Ads Mediation 包，请完成以下操作：
安装 Ads Mediation 包
- 在 Unity 编辑器中打开项目，然后转至 Window（窗口）> Package Manager（包管理器）。
- 选择 Packages（包）> Unity Registry（Unity 注册表）。
- 从包列表中选择 Ads Mediation，然后选择最近经验证的版本。
- 选择 Install（安装）。
如果未能自动提取 LevelPlay 包，可能是项目中现有的脚本错误所致。要手动提取 .unitypackage 文件，请在 Project（项目） 窗口中选择 Packages（包）> Ads Mediation（广告聚合）> LevelPlay > Editor（编辑器）> IronSource_IntegrationManager。
注意：如果出现提示，Unity 建议导入 Mobile Dependency Resolver（移动依赖项解析器）。
删除 Advertisement with Mediation 包
- 在 Unity 编辑器中打开项目，然后转至 Window（窗口）> Package Manager（包管理器）。
- 选择 Packages（包）> In Project（项目内）。
- 选择 Advertisement with Mediation > Remove（删除）。
- 在 **Project（项目）**窗口中，选择 Assets（资产）> Editor（编辑器）。
- 单击右键，以删除 MediationAdapterDependencies XML 文件。
注意：如果已安装，请从 Assets（资产） 中删除 Mobile Dependency Resolver（移动依赖项解析器）。
导入迁移工具
- 下载 Unity Mediation to Unity LevelPlay SDK Migration Tool
- 提取归档文件。
注意：您可能需要文件归档器工具，来提取文件。
- 在 Unity 编辑器中，打开要导入资产包的项目。
- 选择 Assets（资产）> Import Package（导入包）> Custom Package（自定义包）。
- 选择 UnityMediationToUnityLevelPlaySDKMigrationTool.unitypackage > Open（打开） - 结果：Import Unity Package（导入 Unity 包） 窗口会显示安装就绪的所选项目。
- 取消选择不要导入的项目，然后选择 Import（导入）。
注意：如需了解更多信息，请参阅导入本地资产包。
后续步骤： 如需了解更多信息，请参阅 ironSource 知识中心中的从 Unity 聚合迁移到 Unity LevelPlay。
初始化 SDK
重要：如果遇到提示依赖项 Unity.Services.Core 缺失的错误，请移除对该程序集和 UnityServices.InitalizeAsync() 的所有引用，因为该错误表明 Unity 聚合是唯一使用该核心服务的包。
- 查找
UnityServices.InitalizeAsync() - 添加 LevelPlay 初始化
IronSource.Agent.init(appKey)
现在，您可以根据需要运行和修改应用，以供测试。
迁移代码
- 以 Unity 控制台中过时警告消息为指南，将 Unity 聚合集成代码替换为相应的 LevelPlay API 调用。
- 从项目中删除迁移工具文件夹 UnityMediationToUnityLevelPlaySDKMigrationTool.unitypackage。
要了解更多有关 Unity LevelPlay 的信息，请参阅 ironSource 知识中心中的 Unity LevelPlay 文档。