Unity Ads 集成
通过创建帐户、添加 app 和配置广告位，将 Unity Ads 集成为 Unity LevelPlay 上的广告网络。
阅读时间4 分钟最后更新于 2 天前
重要
以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
这些信息可能已过时或不完整，仅为方便您参考才提供。
您对任何第三方产品的使用均受产品自身条款的约束。
Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。
本指南将逐步说明如何在 Unity LevelPlay 上将 Unity Ads 设置为广告网络。
对于 Unity Ads 网络，在完成以下步骤 1 后，可使用自动设置工具。自动设置工具将创建 app 和出价者放置/位置并从 Unity Ads 检索放置/位置详细信息，因此无需在 LevelPlay 和 Unity Ads 平台之间切换。或者，也可以手动完成整个设置。
注意
要查看此聚合网络的适配器更改日志，请参阅 Unity 聚合网络。
先决条件
确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：
- Unity Ads 支持 Android 操作系统版本 4.4（API 级别 19）及更高版本
- Unity Ads SDK 4.7.1+ 需要最低编译 SDK 版本 33，以及最低 Kotlin 版本 1.7.0+
步骤 1. 设置 Unity Ads
在设置 Unity Ads 之前，请完成以下步骤：
注意
完成步骤 1 后，可以跳到步骤 4，并使用自动出价器设置工具在 Unity LevelPlay 上启动并运行 Unity Ads 出价器。如果希望继续进行手动设置，请继续执行步骤 2。
步骤 2.在 Unity Ads 上创建项项目
按照以下步骤在 Unity Ads 上创建 app：
创建 app
-
在 Unity Monetization Dashboard 上，选择 Projects（项目）。
-
选择 **Organization，**然后选择 Projects
-
选择 Create project（创建项目）
-
输入项目名称和 COPPA 定位
-
选择 Create project（创建项目）
要变现项目，需要在控制面板中启用 Unity Ads。要从 Monetization（变现）后台的二级导航菜单中选择 Get started（开始使用）。
为项目初始化 Unity Ads 时，必须选择聚合提供商。选择 I plan to use Mediation（我计划使用聚合）。然后在 Choose your Mediation Partner 下选择 Unity LevelPlay。
创建广告单元
使用广告单元可显示游戏中触发广告内容的事件：
- 从左侧导航菜单中，选择 Monetization（变现）> Ad Units（广告单位）。
- 选择 Add Ad Unit（添加广告单元）以显示创建模式
- 输入广告单元名称，然后选择平台（iOS 或 Android）和广告格式（奖励广告服务、插页式广告或横幅广告）。
- 选择 Create（创建）以保存您的广告单元
添加放置/位置
创建项目后，导航到 Monetization > Placements，并记下这两个平台的游戏 ID。
要创建新的放置/位置，请选择 添加放置/位置。
注意
虽然 Unity Ads 在首次创建项项目会自动创建“默认” 广告位，但我们建议为每个 Unity Ads 聚合配置创建新的唯一广告位。
步骤 3.获取凭据
您需要从 Unity Ads 平台检索以下详细信息才能在 LevelPlay 上完成设置：
- API 密钥
- 组织核心 ID
- 密钥 ID
- Secret key
导航到 Set up > API Management，并记下 API Key。
然后，导航到组织设置并记下组织核心 ID。
要获取密钥 ID 和密钥，请导航到 **Monetization，**然后导航到 **API Management。**选择 Create LevelPlay 服务帐户，随后将显示一个模式，其中包含您的密钥 ID 和密钥。请务必保存密钥，因为在关闭模态后将无法再次获取密钥。
步骤 4.在 LevelPlay 配置 Unity Ads
获得所有这些参数后，日志 LevelPlay 帐户。
-
转到“Mediation”>“Setup”>“SDK Networks”。
-
从可用网络列表中选择 Unity Ads
-
在相关字段中输入 Unity Ads API Key 和 Organizational Core ID
-
要激活自动设置功能，请在 Unity Ads 自动设置工具上切换。这将启用在 Unity Ads 平台上自动创建 app 和出价者的放置/位置，并允许 LevelPlay 从 Unity Ads 检索放置/位置详细信息
-
切换自动设置工具后，输入密钥 ID 和密钥（从步骤 3 开始）。然后，选择 保存
注意
如果打开自动设置工具，仍然可以在 LevelPlay 上手动配置 Unity Ads 出价。
步骤 5：在 app 级别设置 Unity Ads
传统瀑布流设置
- 从 SDK Networks 页面左侧的列表中选择要集成的app程序
- 在广告单元行中，选择 Setup，然后在相关广告单元设置下输入游戏 ID 和放置/位置 ID
- 然后，您将在设置控制面板 (Setup Dashboard) 上看到 Unity Ads 已激活。
出价人设置
有两种方法可以在 LevelPlay 上设置 Unity Ads 出价人：
- Auto-setup - 在 Unity Monetize（变现）后台上自动创建新 app 和广告位，并在 LevelPlay 上填充所有必要的设置
- Manual - 在 LevelPlay 和 Unity Ads 平台上手动输入必要的 app 详细信息
自动设置
-
选择要在 Unity Ads 中运行插页式广告、奖励广告或横幅广告服务的app。然后在 Unity Ads 行中选择 define 图标
-
选择 Add Bider（添加出价者）可在 Unity Ads 平台上自动创建新的 app 和竞价广告位，并导入游戏 ID 和放置/位置 ID。如果有一个已经所挂的游戏 ID 已附加到 app，如果至少有 1 个没有放置/位置 ID 参数值的放置/位置，则可以使用自动设置工具。在这种情况下，将创建新的竞价放置/位置（用于游戏 ID 插入）
选择 保存 以批准并接受所有配置。如果未保存模块，则会在 Unity Ads 平台上创建资源，而不会将数据导入 LevelPlay 平台。
**重要信息：**Unity Ads 出价者实例的状态与 ironSource 广告服务出价者的状态相同（按广告单元）。例如，如果您不使用 ironsource 广告服务出价器获取奖励广告服务，则不会针对 Unity Ads 网络自动激活此出价器。要激活奖励广告服务的 Unity Ads 竞价实例，请选择 Unity Ads 行并在广告单元上切换。
手动设置
-
选择要从 Unity Ads 运行插页式广告服务或奖励广告的app
-
从 Ad Networks 的设置列表中选择 Unity Ads，选择 define 图标，然后在相关字段中插入游戏 ID 和放置/位置 ID
-
选择 保存
现在，您将看到 Unity Ads 在帐户中选择的广告单位处于激活状态。
步骤 6。将 Unity Ads 适配器添加到构建中
Unity Network Manager（推荐）
完成 SDK 集成后，可使用 Unity Network Manager 下载 Unity Ads 适配器。
在 Unity 开发平台中，转到广告服务聚合 > Network Manager。
如果您已经拥有最新版本的适配器，则操作按钮将更改为 " Updated " 并已禁用。
Android（手动解析）
要应用更改，请确保使用“Resolve”过程。这将根据您的选择下载所有相关工件。有关详细信息，请参阅此处的说明。
仅适用于 ProGuard 用户 (Android)
如果将 ProGuard 与 Unity Ads 适配器结合使用，必须将以下代码添加 ProGuard 配置中：
# Keep filenames and line numbers for stack traces##keep-filenames-and-line-numbers-for-stack-traces-keepattributes SourceFile、LineNumberTable# Keep JavascriptInterface for WebView bridge##keep-javascriptinterface-for-webview-bridge-keepattributes JavascriptInterface# Sometimes keepattributes is not enough to keep annotations##sometimes-keepattributes-is-not-enough-to-keep-annotations-keep 类 Android.webkit.JavascriptInterface { *;}# Keep all classes in Unity Ads package##keep-all-classes-in-unity-ads-package-keep class com.unity3d.ads。** { *;}# Keep all classes in Unity Services package##keep-all-classes-in-unity-services-package- 保留类 com.unity3d.服务。** { *;}-dontwarn com.google.ar.core。**-dontwarn com.unity3d.services.**-dontwarn com. ironsource.adapters.unityads。**
iOS Update 属性列表文件 (Info.plist)
Unity Ads SDK 3.4.8+ 要求在 app 属性列表文件 (Info.plist) 中包含 Unity Ads ad network ID。在此处了解有关 Unity Ads SKAdNetwork IDs 文档的更多信息。
Android 插件手册集成
注意
Unity Ads 的 Unity 插件目前仅支持视频广告服务。
-
下载 Unity Ads 适配器从此处下载适配器。
-
将 Unity Ads 文件添加到 Unity 项目将文件导入 Assets/Plugins/Android/。
注意
为了适应 Unity 版本 5.5 中的更改，LevelPlay 插件版本 6.7.1 要求为插件和聚合适配器单独添加 Android 清单。如果要更新插件或当前在6.7.1上运行，请务必添加Android 文档中注明的清单活动。
iOS 插件手动集成
注意
Unity Ads 的 Unity 插件目前仅支持视频广告服务。
-
下载 Unity Ads iOS 适配器和 SDK请参阅 iOS 调解网络。
-
将 Unity Ads 文件添加到 Unity 项目解压缩文件后，将适配器和 SDK 文件导入 Assets/Plugins/iOS。
我们的 Unity 插件会自动将必要的框架添加到 Xcode 项目中。
步骤 7。Unity Ads 附加设置
用户级别 COPPA
Unity LevelPlay 允许发布者将 Unity Ads 用户级别的 COPPA 设置直接传达给 Unity Ads 网络。此功能是使用 LevelPlay SDK 7.1.12+、Unity Ads Adapter 4.3.15+ 已启用的。
使用以下语法设置 Unity Ads user.nonBehavioral 标志（参数为 true）：
LevelPlay.SetMetaData("UnityAds_coppa","true");
使用以下语法设置 Unity Ads user.nonBehavioral 标志（参数为 False）：
LevelPlay.SetMetaData("UnityAds_coppa","false");
评估广告网络集成
-
验证您的广告网络与我们的 Integration Helper 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
-
使用以下布尔值管理集成聚合广告网络的调试日志：LevelPlay.SetAdaptersDebug(true);设置为 TRUE 时，这行代码将启用调试日志，以帮助您排除所有允许的聚合广告网络的问题。 在 app 与我们的广告单位上线之前，请删除此代码！SDK 6.5.2 及更高版本支持。
您现在可以在应用程序中投放 Unity Ads 广告服务。
后续步骤
要通过 LevelPlay Mediation 利用其他广告网络，请集成适配器，然后遵循我们的集成指南。