Google 竞价集成

使用自动设置工具或手动配置将 Google 设置为 Unity LevelPlay Mediation 上的竞价网络。

阅读时间7 分钟

最后更新于 2 天前

重要

以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。这些信息可能已过时或不完整，仅为方便您参考才提供。您对任何第三方产品的使用均受产品自身条款的约束。 Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

本指南将分步介绍如何在 Unity LevelPlay Mediation 中将 Google 设置为竞价网络。

对于 Google 出价者，完成以下步骤 1 后，即可使用自动设置工具。自动设置工具可创建 app 和出价者放置/位置，并从 AdMob 检索放置/位置详细信息，因此无需在 LevelPlay 和 AdMob 平台之间切换。或者，也可以手动完成整个设置。

注意

要查看此聚合网络的适配器更改日志，请参阅 Unity 聚合网络。

先决条件

确保已将 LevelPlay 的奖励广告服务、插页式广告或横幅广告正确集成到应用程序中。

从 LevelPlay SDK 7.2.7+ 版本开始支持 Google 竞价。

从 AdMob SDK 7.69.0+ 开始，AdMob 使用 XCFramework。如果要使用 CocoaPods 进行 AdMob 集成，请确保您有 CocoaPods 版本 1.9.0+。

AdMob 支持 Android 操作系统版本 4.1（API 级别 16）及更高版本。所需的 Gradle 构建具为 3.5.4。

AdMob SDK 支持 iOS 版本 10+，并将在 iOS 版本 11+ 上为用户提供广告服务。

步骤 1.创建 AdMob 帐户

要通过 Unity LevelPlay Mediation 访问 Google 的广告库存，您需要创建 AdMob 帐户。
建议将 AdMob 帐户的时间调整为 UTC，以便与 Unity LevelPlay 平台保持一致。这将确保准确的报告。了解更多信息。

注意

完成步骤 1 后，可以跳到步骤 3 并使用自动出价器设置工具在 Unity LevelPlay 上启动并运行 Google 出价。如果希望继续进行手动设置，请继续执行步骤 2。

步骤 2.在 AdMob 中创建应用程序和广告单元

接下来，必须将app程序添加到 AdMob 帐户。

添加 app

登录 AdMob 帐户。在控制面板上，选择 Apps，然后添加 app。
此时将显示一个模态，您可以在其中搜索 app、手动添加 app 或直接选择现有 app 进行变现。您需要每个平台（iOS Android）都有一个唯一的 AdMob 应用程序，类似于 Ironsource 帐户。
选择插页式、奖励式或横幅作为广告单元格式，并输入相关详细信息。
插页式视频
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价
奖励广告
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价
横幅广告
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价

步骤 3.在 LevelPlay 网络设置模块中激活 Google

有两种方法可以在 LevelPlay 上设置 Meta Audience Network：

自动设置 - 使用 Google 帐户登录，以自动创建新的应用程序和竞价广告位，并从 Google AdMob 平台中提取所有必要的配置设置
Manual - 在 LevelPlay 和 Google AdMob 平台之间来回切换以检索和输入必要的信息。

自动设置

登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > Setup > Networks
从可用广告网络列表中选择 Google AdMob
选择 Login with Google（使用 Google 登录），然后使用您批准的 Google 帐户登录
如果您已经登录，请选择重置登录**（需要新登录）**
登录后，在 Google 自动设置出价器上切换
现在转到 Instances 页面，然后选择要运行 Google 插页式、奖励式或横幅广告服务的应用。
选择 Add Bidder（添加出价人）可在 AdMob 平台上自动创建新应用和出价广告位，并导入 Ad Unit ID（广告单元 ID）。如果已所挂的到app程序的app程序 ID，如果至少有 1 个广告放置/位置没有 Ad unit ID 参数值，则可以使用自动设置工具。在这种情况下，将创建新的竞价放置/位置。
选择保存以批准并接受所有配置。如果关闭模块而不保存，则会在 AdMob 平台上创建资源，而不会将数据导入 LevelPlay 平台。

Google 出价者实例的状态与 ironSource 广告服务出价者的状态相同（按广告格式）。例如，如果您不使用 ironsource 广告服务出价器来获取奖励广告服务，则不会在 Google 网络中自动激活该出价器。

手动设置

登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > Setup > Networks
从可用广告网络列表中选择 Google AdMob
将以下数据输入 LevelPlay 网络设置模块以启用 AdMob 集成 LevelPlay SDK：

数据	描述
App ID（应用 ID）	Admob 后台上分配给 app 的唯一 ID。
广告单元 ID	Admob 后台上分配给 app 广告单元的唯一 ID。
Client ID（客户端 ID）	这是指定帐户与广告单元之间关系的唯一标识符。
客户端密钥	与客户端 ID 配对的密钥
刷新令牌	这是客户端应用程序已收到的刷新令牌。

请参阅以下说明将这些 AdMob 参数集成到 LevelPlay 中：

App ID

1.要获取 app ID，请转到 Admob 平台上左侧栏的“Apps”选项卡，然后选择 App Settings。然后，您将看到应用程序的设置以及 app ID。

Ad Unit ID

Ad Unit ID 要获取您的 Ad Unit ID，请转到 Admob 平台上左侧栏的“Apps”选项卡，然后选择 **Ad 单位。然后，您将看到应用程序的广告单位以及 Ad Unit ID。

Client ID and Client Secret

1.要获取 客户端 ID 和客户端密钥，请访问 Google API Manager。 2.选择页面左上角的 **API 项目下拉选单选单，选择 Create a 项目或选择已为此app程序创建的项目。如果要为此创建新项目，请在出现的对话框中提供项目 name、**Billing 帐户和 Location，然后选择 Create。 3.在左侧栏中，选择 Credentials，然后选择 OAuth consent screen 选项卡。然后，提供 Product Name 并选择保存。 4.在左侧栏中，选择 Dashboard，然后选择 启用 APIs and 服务。 5.接下来，启用 AdMob API。 6.选择左侧栏中的 Credentials 选项卡。选择 Create credentials 下拉选单选单，然后选择 OAuth 客户端 ID。 7.选择 Web application，并提供 app 的名称。在以下字段中，必须输入至少一个 授权重定向 URI 的 https://developers.google.com/oauthplayground。例如：

授权的 JavaScript 来源：
```
https://YOUR_NAMESPACE **(Optional)**
```
授权重定向 URI： https://developers.google.com/oauthplayground

选择 Create,，此时将显示 客户端 ID 和 客户端 Secret。

Refresh Token

1.要检索 Refresh Token，请访问 OAuth 2.0 Playground。 2.选择右上角的设置图标。取消选中标记为 力 approval 提示词的复选框，并选中 Use your own OAuth credentials。输入 客户端 ID 和客户端 Secret。 3.接下来，在 步骤 1 中：选择 & Authorize APIS，输入 https://www.googleapis.com/auth/admob.report，然后选择 Authorize APIs。 4.授权项目访问 AdMob 数据 5.然后，您应该会收到步骤 1 中的授权代码，并可以选择 Exchange authorization 代码 for tokens 按钮。然后，您将获得 Refresh token 和 Access Token。

拥有所有这些参数后，请将它们输入 LevelPlay 上的 Google AdMob 帐户设置。
接下来，转到 Instances 页面。在页面顶部选择要使用 Google 竞价运行 Unity LevelPlay 聚合的app。
从 Ad Networks 的设置列表中选择 Google，然后选择 Tool Define 图标。然后在 Interstitial、Rewarded ads Video 或 Banner Settings 下插入 App ID 和 Ad Unit ID。

步骤 4.将 Admob 适配器添加到构建中

Unity Integration Manager（推荐）

完成 SDK 集成后，可使用 Unity Integration Manager 下载 AdMob 适配器。

在 Unity 开发平台中，转到 LevelPlay > Integration Manager。

如果您已经拥有最新版本的适配器，则操作按钮将更改为 " Updated " 并已禁用。

Android（手动解析）

要应用更改，请确保使用“Resolve”过程。这将根据您的选择下载所有相关工件。有关详细信息，请参阅此处的说明。

添加 AdMob app ID

Android

将您的 AdMob app ID 作为

<application></application>

标签的子项添加到 app 的 AndroidManifest：


<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"           android:value="[ADMOB_APP_ID]"/>

将

[ADMOB_APP_ID]

替换为您在步骤 3 中获取的 app ID 值。否则会导致 AdMob 的 SDK 引发的崩溃。如需了解更多信息，请参阅 AdMob 指南。

iOS

将 AdMob app ID 添加到 app 的 plist（如此处所述）。或者，可以通过编程方式做出此更改


<key>GADApplicationIdentifier</key><string>[APP_ID]</string>

将

GADApplicationIdentifier

值替换为您在步骤 3 中获取的 app ID 值。

步骤 5。Update Info.plist（适用于 iOS）

从适用于 iOS 的 AdMob SDK V7.42.0 **（适配器版本 4.3.3 + iOS/Unity）**开始，AdMob 的 SDK 要求发布者将其 AdMob app ID 添加到 app 的 plist 中，如此处所述。或者，可以通过编程方式做出此更改


<key>GADApplicationIdentifier</key><string>[APP_ID]</string>

将

GADApplicationIdentifier

值替换为您在步骤 3 中获取的 app ID 值。否则会导致 AdMob 的 SDK 引发的崩溃。如需了解更多信息，请参阅 AdMob 指南。

步骤 6。其他步骤

面向子项的设置 - COPPA

Unity LevelPlay 聚合允许发布者将 AdMob 面向儿童的设置直接传达给 AdMob 网络。此功能是使用 LevelPlay SDK 6.14.0+、AdMob Unity 适配器 4.3.12+ 已启用的。

使用以下语法，使用参数“True”设置 AdMob setTagForChildDirectedTreatment：


 LevelPlay.SetMetaData("AdMob_TFCD","true");

使用以下语法，使用参数“False”设置 AdMob setTagForChildDirectedTreatment：


 LevelPlay.SetMetaData("AdMob_TFCD","false");

要了解有关 AdMob 网络下面向儿童的设置的更多信息，请访问此处。

Unity LevelPlay 聚合允许发布者与 AdMob 网络进行通信，AdMob 网络是 Tag For Users under the Age of Consent in Europe (TFUA) 请求。此功能是使用 LevelPlay SDK 6.14.0+、AdMob Unity 适配器 4.3.12+ 已启用的。

使用以下语法将 setTagForUnderAgeOfConsent 设置为“True”：


 LevelPlay.SetMetaData("AdMob_TFUA","true");

使用以下语法将 setTagForUnderAgeOfConsent 设置为“False”：


 LevelPlay.SetMetaData("AdMob_TFUA","false");

要了解有关 AdMob 网络下面向儿童的设置的更多信息，请访问此处。

广告内容过滤

Unity LevelPlay 聚合允许发布者与 AdMob 网络通信，为所有广告请求提供最高广告内容评级。此功能是使用 LevelPlay SDK 7.12.0+、AdMob Android 适配器 4.3.23+ 已启用的。

使用以下语法设置 maxAdContentRating：


LevelPlay.SetMetaData("AdMob_MaxContentRating","MAX_AD_CONTENT_RATING_G");

此属性的可能值基于 Google 定义的数字内容标签分类：

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

要了解有关 AdMob 网络下的 Ad Content Rating 属性的更多信息，请访问此处。

内容网址映射支持

Unity LevelPlay 支持 Google 的应用程序内容映射，并允许使用“Google_Content_Mapping”设置共享 URL。此功能是使用 LevelPlay SDK 7.7.0+、AdMob Adapter 4.3.58+ 已启用的。在此处了解有关 Google 内容映射的更多信息。

要通道单内容网址，请使用以下语法：


LevelPlay.SetMetaData("Google_Content_Mapping","https://www.example.com");

要支持多个 URL，请使用相同的密钥并共享最多 4 个 URL：


LevelPlay.SetMetaData("Google_Content_Mapping",new[] {"https://www.example1.com","https://www.example2.com"});

验证广告网络集成

要验证 LevelPlay SDK 和其他广告网络的集成情况，请遵循本文档。

后续步骤

要利用其他聚合广告网络，请集成适配器并按照我们的集成指南进行操作。

Google 竞价集成

使用自动设置工具或手动配置将 Google 设置为 Unity LevelPlay Mediation 上的竞价网络。

阅读时间7 分钟

最后更新于 2 天前

重要

本指南将分步介绍如何在 Unity LevelPlay Mediation 中将 Google 设置为竞价网络。

注意

要查看此聚合网络的适配器更改日志，请参阅 Unity 聚合网络。

先决条件

确保已将 LevelPlay 的奖励广告服务、插页式广告或横幅广告正确集成到应用程序中。

从 LevelPlay SDK 7.2.7+ 版本开始支持 Google 竞价。

从 AdMob SDK 7.69.0+ 开始，AdMob 使用 XCFramework。如果要使用 CocoaPods 进行 AdMob 集成，请确保您有 CocoaPods 版本 1.9.0+。

AdMob 支持 Android 操作系统版本 4.1（API 级别 16）及更高版本。所需的 Gradle 构建具为 3.5.4。

AdMob SDK 支持 iOS 版本 10+，并将在 iOS 版本 11+ 上为用户提供广告服务。

步骤 1.创建 AdMob 帐户

要通过 Unity LevelPlay Mediation 访问 Google 的广告库存，您需要创建 AdMob 帐户。
建议将 AdMob 帐户的时间调整为 UTC，以便与 Unity LevelPlay 平台保持一致。这将确保准确的报告。了解更多信息。

注意

完成步骤 1 后，可以跳到步骤 3 并使用自动出价器设置工具在 Unity LevelPlay 上启动并运行 Google 出价。如果希望继续进行手动设置，请继续执行步骤 2。

步骤 2.在 AdMob 中创建应用程序和广告单元

接下来，必须将app程序添加到 AdMob 帐户。

添加 app

登录 AdMob 帐户。在控制面板上，选择 Apps，然后添加 app。
此时将显示一个模态，您可以在其中搜索 app、手动添加 app 或直接选择现有 app 进行变现。您需要每个平台（iOS Android）都有一个唯一的 AdMob 应用程序，类似于 Ironsource 帐户。
选择插页式、奖励式或横幅作为广告单元格式，并输入相关详细信息。
插页式视频
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价
奖励广告
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价
横幅广告
- Ad unit name（广告单元名称）：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
- 合作伙伴出价：选中此复选框表示您正在另一个聚合平台上使用竞价

步骤 3.在 LevelPlay 网络设置模块中激活 Google

有两种方法可以在 LevelPlay 上设置 Meta Audience Network：

自动设置 - 使用 Google 帐户登录，以自动创建新的应用程序和竞价广告位，并从 Google AdMob 平台中提取所有必要的配置设置
Manual - 在 LevelPlay 和 Google AdMob 平台之间来回切换以检索和输入必要的信息。

自动设置

登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > Setup > Networks
从可用广告网络列表中选择 Google AdMob
选择 Login with Google（使用 Google 登录），然后使用您批准的 Google 帐户登录
如果您已经登录，请选择重置登录**（需要新登录）**
登录后，在 Google 自动设置出价器上切换
现在转到 Instances 页面，然后选择要运行 Google 插页式、奖励式或横幅广告服务的应用。
选择 Add Bidder（添加出价人）可在 AdMob 平台上自动创建新应用和出价广告位，并导入 Ad Unit ID（广告单元 ID）。如果已所挂的到app程序的app程序 ID，如果至少有 1 个广告放置/位置没有 Ad unit ID 参数值，则可以使用自动设置工具。在这种情况下，将创建新的竞价放置/位置。
选择保存以批准并接受所有配置。如果关闭模块而不保存，则会在 AdMob 平台上创建资源，而不会将数据导入 LevelPlay 平台。

手动设置

登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > Setup > Networks
从可用广告网络列表中选择 Google AdMob
将以下数据输入 LevelPlay 网络设置模块以启用 AdMob 集成 LevelPlay SDK：

数据	描述
App ID（应用 ID）	Admob 后台上分配给 app 的唯一 ID。
广告单元 ID	Admob 后台上分配给 app 广告单元的唯一 ID。
Client ID（客户端 ID）	这是指定帐户与广告单元之间关系的唯一标识符。
客户端密钥	与客户端 ID 配对的密钥
刷新令牌	这是客户端应用程序已收到的刷新令牌。

请参阅以下说明将这些 AdMob 参数集成到 LevelPlay 中：

App ID

1.要获取 app ID，请转到 Admob 平台上左侧栏的“Apps”选项卡，然后选择 App Settings。然后，您将看到应用程序的设置以及 app ID。

Ad Unit ID

Ad Unit ID 要获取您的 Ad Unit ID，请转到 Admob 平台上左侧栏的“Apps”选项卡，然后选择 **Ad 单位。然后，您将看到应用程序的广告单位以及 Ad Unit ID。

Client ID and Client Secret

授权的 JavaScript 来源：
```
https://YOUR_NAMESPACE **(Optional)**
```
授权重定向 URI： https://developers.google.com/oauthplayground

选择 Create,，此时将显示 客户端 ID 和 客户端 Secret。

Refresh Token

拥有所有这些参数后，请将它们输入 LevelPlay 上的 Google AdMob 帐户设置。
接下来，转到 Instances 页面。在页面顶部选择要使用 Google 竞价运行 Unity LevelPlay 聚合的app。
从 Ad Networks 的设置列表中选择 Google，然后选择 Tool Define 图标。然后在 Interstitial、Rewarded ads Video 或 Banner Settings 下插入 App ID 和 Ad Unit ID。

步骤 4.将 Admob 适配器添加到构建中

Unity Integration Manager（推荐）

完成 SDK 集成后，可使用 Unity Integration Manager 下载 AdMob 适配器。

在 Unity 开发平台中，转到 LevelPlay > Integration Manager。

如果您已经拥有最新版本的适配器，则操作按钮将更改为 " Updated " 并已禁用。

Android（手动解析）

要应用更改，请确保使用“Resolve”过程。这将根据您的选择下载所有相关工件。有关详细信息，请参阅此处的说明。

添加 AdMob app ID

Android

将您的 AdMob app ID 作为

<application></application>

标签的子项添加到 app 的 AndroidManifest：


<meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"           android:value="[ADMOB_APP_ID]"/>

将

[ADMOB_APP_ID]

替换为您在步骤 3 中获取的 app ID 值。否则会导致 AdMob 的 SDK 引发的崩溃。如需了解更多信息，请参阅 AdMob 指南。

iOS

将 AdMob app ID 添加到 app 的 plist（如此处所述）。或者，可以通过编程方式做出此更改


<key>GADApplicationIdentifier</key><string>[APP_ID]</string>

将

GADApplicationIdentifier

值替换为您在步骤 3 中获取的 app ID 值。

步骤 5。Update Info.plist（适用于 iOS）


<key>GADApplicationIdentifier</key><string>[APP_ID]</string>

将

GADApplicationIdentifier

值替换为您在步骤 3 中获取的 app ID 值。否则会导致 AdMob 的 SDK 引发的崩溃。如需了解更多信息，请参阅 AdMob 指南。

步骤 6。其他步骤

面向子项的设置 - COPPA

Unity LevelPlay 聚合允许发布者将 AdMob 面向儿童的设置直接传达给 AdMob 网络。此功能是使用 LevelPlay SDK 6.14.0+、AdMob Unity 适配器 4.3.12+ 已启用的。

使用以下语法，使用参数“True”设置 AdMob setTagForChildDirectedTreatment：


 LevelPlay.SetMetaData("AdMob_TFCD","true");

使用以下语法，使用参数“False”设置 AdMob setTagForChildDirectedTreatment：


 LevelPlay.SetMetaData("AdMob_TFCD","false");

要了解有关 AdMob 网络下面向儿童的设置的更多信息，请访问此处。

使用以下语法将 setTagForUnderAgeOfConsent 设置为“True”：


 LevelPlay.SetMetaData("AdMob_TFUA","true");

使用以下语法将 setTagForUnderAgeOfConsent 设置为“False”：


 LevelPlay.SetMetaData("AdMob_TFUA","false");

要了解有关 AdMob 网络下面向儿童的设置的更多信息，请访问此处。

广告内容过滤

使用以下语法设置 maxAdContentRating：


LevelPlay.SetMetaData("AdMob_MaxContentRating","MAX_AD_CONTENT_RATING_G");

此属性的可能值基于 Google 定义的数字内容标签分类：

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

要了解有关 AdMob 网络下的 Ad Content Rating 属性的更多信息，请访问此处。

内容网址映射支持

要通道单内容网址，请使用以下语法：


LevelPlay.SetMetaData("Google_Content_Mapping","https://www.example.com");

要支持多个 URL，请使用相同的密钥并共享最多 4 个 URL：


LevelPlay.SetMetaData("Google_Content_Mapping",new[] {"https://www.example1.com","https://www.example2.com"});

验证广告网络集成

要验证 LevelPlay SDK 和其他广告网络的集成情况，请遵循本文档。

后续步骤

要利用其他聚合广告网络，请集成适配器并按照我们的集成指南进行操作。

Google 竞价集成

先决条件

步骤 1.创建 AdMob 帐户

步骤 2.在 AdMob 中创建应用程序和广告单元

添加 app

步骤 3.在 LevelPlay 网络设置模块中激活 Google

自动设置

手动设置

数据

描述

App ID

Ad Unit ID

Client ID and Client Secret

Refresh Token

步骤 4.将 Admob 适配器添加到构建中

Unity Integration Manager（推荐）

Android（手动解析）

添加 AdMob app ID

Android

iOS

步骤 5。Update Info.plist（适用于 iOS）

步骤 6。其他步骤

面向子项的设置 - COPPA

未满同意年龄的用户 - GDPR

广告内容过滤

内容网址映射支持

验证广告网络集成

后续步骤

Google 竞价集成

先决条件

步骤 1.创建 AdMob 帐户

步骤 2.在 AdMob 中创建应用程序和广告单元

添加 app

步骤 3.在 LevelPlay 网络设置模块中激活 Google

自动设置

手动设置

数据

描述

App ID

Ad Unit ID

Client ID and Client Secret

Refresh Token

步骤 4.将 Admob 适配器添加到构建中

Unity Integration Manager（推荐）

Android（手动解析）

添加 AdMob app ID

Android

iOS

步骤 5。Update Info.plist（适用于 iOS）

步骤 6。其他步骤

面向子项的设置 - COPPA

未满同意年龄的用户 - GDPR

广告内容过滤

内容网址映射支持

验证广告网络集成

后续步骤