将 Unity Ads 与中介集成

请选择平台： Android（Beta 版） Android iOS Unity Flutter

本指南介绍了如何使用 GMA Next-Gen SDK 通过 AdMob 中介加载和展示来自 Unity Ads 的广告，其中涵盖了出价集成和广告瀑布流集成。本指南还介绍了如何将 Unity Ads 添加到广告单元的中介配置中，以及如何将 Unity Ads SDK 和适配器集成到 Android 应用中。

支持的集成和广告格式

Unity Ads 的中介适配器具有以下功能：

要求

• Android API 级别 24 或更高级别

• [适用于出价]：如需在出价中集成所有支持的广告格式，请使用 Unity 适配器 4.16.0.1 或更高版本（建议使用最新版本）

• 最新版 GMA Next-Gen SDK

• 完成中介 入门指南

第 1 步：在 Unity Ads 界面中设置配置

注册或 登录 Unity Ads。

创建项目

在 Unity Ads 信息中心内，依次前往 Projects 和点击 New。

填写表单，然后点击 Create （创建）以添加项目。

依次前往 Unity Ads Monetization（Unity Ads 创收）和 Get started（开始使用）。

在 New Project （新建项目）模态中，为 Mediation Partner （中介合作伙伴）选择 I will use Mediation （我将使用中介）和 Google Admob ，然后点击 Next （下一步）。

选择广告设置的选项，然后点击 Next （下一步）。

选择展示位置设置，然后点击 Next （下一步）。

填写表单，然后点击 Add project （添加项目）。

记下 Game ID （游戏 ID）。

创建广告单元和展示位置

依次前往 Unity Ads Monetization（Unity Ads 创收）> Placements（展示位置），然后选择您的 项目并点击 Add ad unit（添加广告单元）。

输入 Ad unit name（广告单元名称），然后选择 Platform（平台）和 Ad format（广告格式）。

最后，点击 Add ad unit （添加广告单元）以保存广告单元和展示位置。

查找 Unity Ads Reporting API 密钥

更新 app-ads.txt

应用授权卖方 app-ads.txt 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的 应用广告资源。为避免损失大量广告收入，您需要实现 app-ads.txt 文件。 如果您尚未完成此操作， 请为您的应用设置 app-ads.txt 文件。

如需为 Unity Ads 实现 app-ads.txt，请参阅 首次设置 app-ads.txt。

启用测试模式

您可以在 Unity Ads 信息中心内启用测试模式。依次前往 Unity Ads Monetization （Unity Ads 创收）> Testing （测试）。

您可以点击 Google Play 商店 旁边的修改按钮，启用Override client test mode（替换客户端测试模式），然后选择 Force test mode ON (i.e. use test ads) for all devices（强制所有设备启用测试模式，即使用测试广告），从而强制为您的应用启用测试模式。

或者，您也可以点击 Add Test Device （添加测试设备），为特定设备启用测试模式。

输入测试设备的详细信息，然后点击 Save （保存）。

第 2 步：在 AdMob 界面中设置 Unity Ads 需求

为广告单元配置中介设置

您需要将 Unity Ads 添加到广告单元的中介配置。

首先，登录您的 AdMob 账号。接下来，前往 Mediation （中介）标签页。如果您要修改某个现有中介组，请点击该中介组的名称进行修改，然后跳至将 Unity Ads 添加为广告来源。

若要创建新中介组，请选择 Create Mediation Group （创建中介组）。

输入广告格式和平台，然后点击 Continue （继续）。

为中介组命名，然后选择要定位到的地理位置。接下来，将 中介组状态设置为 Enabled（已启用），然后点击 Add Ad Units（添加广告单元）。

将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后，点击 Done （完成）。

现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元：

将 Unity Ads 添加为广告来源

出价

在 Ad Sources （广告来源）部分中的 Bidding （出价）卡片下，选择 Add ad source （添加广告来源）。然后，选择 Unity Ads 。

点击 如何签署合作伙伴协议 ，然后 与 Unity Ads 建立出价合作伙伴关系。



点击 Acknowledge & agree （确认并同意），然后点击 Continue （继续）。



如果您已为 Unity Ads 创建映射， 可以选择该映射。否则，请点击 Add mapping （添加映射）。



接下来，输入在上一部分获得的 Game ID（游戏 ID）和 Placement ID （展示位置 ID）。然后，点击 Done （完成）。

瀑布流

在 Ad Sources （广告来源）部分中的 Waterfall （瀑布流）卡片下，选择 Add Ad Source （添加广告来源）。

选择 Unity Ads ，然后启用 Optimize （优化）开关。输入在上一部分获得的 API Key （API 密钥）和 Organization core ID （组织核心 ID），以便为 Unity Ads 设置广告来源优化。 然后，为 Unity Ads 输入 eCPM value （有效每千次展示费用值），并点击 Continue （继续）。



如果您已为 Unity Ads 创建映射，可以选择该映射。 否则，请点击 Add mapping （添加映射）。

接下来，输入在上一部分获得的 Game ID （游戏 ID）和 Placement ID （展示位置 ID）。然后，点击 Done （完成）。

将 Unity Ads 添加到 GDPR 和美国州级法规广告合作伙伴名单中

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.17.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.17.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter