SDK导入与初始化

1. 将 HyperBid 集成至 Unity 项目

首先，请下载最新版本的 HyperBid SDK：

环境要求：

• Unity 2020.3.34f1 及以上版本
• Android 平台：最低支持 Android 6.0，API Level 23
• iOS 平台：最低支持 iOS 12，需使用 Xcode 16.2

1.1 启用 Gradle 模板

为优化依赖管理流程，建议在 Unity 编辑器中启用 Android 构建的 Gradle 模板功能。

操作路径： File > Build Settings... > Player Settings... > Android > Publishing Settings > Build

确保勾选 如下 ② ~ ⑥ 选项。

1.2 导入 SDK 包

请按以下步骤将 HyperBid 导入您的 Unity 项目：

1. 确保目标项目已在 Unity 编辑器中打开
2. 双击已下载的 .unitypackage 文件；或通过菜单 Assets > Import Package > Custom package... 手动导入

Unity 将加载并解析该包，随后弹出确认对话框，列出即将导入的文件清单。点击 Import 按钮完成导入。

2. 配置 SDK 设置

通过设置窗口可配置Google Ads 应用 ID

操作路径： HyperBid > Settings

各配置项说明如下：

💡 Tips

如果有接入使用Admob，您必须添加GoogleAds AppId

3. 安装广告平台适配器

如需接入更多广告平台，请前往 HyperBid > HyperBid Dependency Manager 打开依赖管理器。

该界面将展示所有可用的适配器列表及当前 HyperBid 版本信息。

点击目标适配器旁的 Install 按钮，HyperBid 将自动完成下载与导入。

重要提示： 适配器安装完成后，务必执行 EDM4U 依赖解析以更新 Gradle 模板。

操作路径： Assets > External Dependency Manager > Android Resolver > Force Resolve

此步骤将确保所有依赖项正确纳入最终的 Android 构建产物。更多信息请参阅 Google EDM4U 官方仓库。

4. Unity 2021 及更早版本的兼容性处理（可选）

在 Unity 2021 或更早版本中集成 Google Ads 适配器时，Android 构建可能出现以下错误：

AAPT: error: unexpected element <property> found in <manifest><application>.

该错误源于 GMA SDK 22.5.0 引入的新 <property> 元素，而旧版 Android Gradle Plugin (AGP) 不支持此特性。

解决方案：

1. 前往 HyperBid > Settings
2. 勾选 Enable GMA properties tag fix
3. 在 mainTemplate.gradle 文件中添加以下代码：

gradle.projectsEvaluated {
    apply from: 'HyperBidPlugin.androidlib/validate_dependencies.gradle'
}

5. 示例Demo

• 1. 在完成上述的安装广告平台适配器后，请前往 HyperBid > Configure Build Simulation Scenes 点击
     
• 2. 在Build Profiles > Scene List中将会自动勾选如下图所示的示例Scenes，打包真机运行即可体验
• 3. 示例Code可参考如下图所示：

6. 初始化SDK

McSdkCallbacks.OnSdkInitializedEvent += sdkConfiguration =>
{
    Debug.Log("McSDK Initialized: " + sdkConfiguration.ToString());
    Debug.Log("McSDK Mediation Config: " + McSdk.GetMediationConfig());
};

McSdk.InitializeSdk("your app id", "your app key");

7. 预制策略

建议配置预置策略，提高应用首次启动的广告加载效果