# Google Bidding 集成

> 使用 LevelPlay SDK 将 Google 竞价作为聚合网络集成到 React 本地 app程序中。

本指南将逐步说明如何将 Google 设置为 LevelPlay Mediation 上的竞价网络。

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

## 先决条件##prerequisites

确保已将 LevelPlay 的[奖励视频](/grow/levelplay/sdk/react/rewarded-ads-integration/.md)、[插页式](/grow/levelplay/sdk/react/interstitial-integration/.md)或[横幅](/grow/levelplay/sdk/react/banner-integration/.md)广告服务正确集成到应用程序中。

## 创建 AdMob 帐户##create-an-admob-account

1. 要通过 LevelPlay Mediation 访问 Google 的广告库存，您需要[创建 AdMob 帐户](https://www.google.com/admob/)。
2. 建议将 AdMob 帐户的时间调整为 UTC，以便与 LevelPlay 平台保持一致。这将确保准确的报告。[了解更多信息](https://support.google.com/admob/answer/7276705?hl=en)。

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

## 在 AdMob 中创建应用程序和广告单元##create-an-application-and-ad-unit-in-admob

### 添加 app##add-your-app

1. 登录 AdMob 帐户。在控制面板上，选择 **Apps**，然后**添加 app**。
2. 此时将显示一个模态，您可以在其中搜索 app、手动添加 app 或直接选择现有 app 进行变现。

> **Note:**
>
> 您需要每个平台（iOS Android）都有一个唯一的 AdMob 应用程序，就像您的 LevelPlay 帐户一样。

3. 选择插页式、奖励视频或横幅作为广告单元格式，并输入相关详细信息。

### 配置广告单元设置##configure-ad-unit-settings

**插页式视频**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

![Google AdMob 后台中的插页式广告单元配置。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-interstitial.png)

**奖励视频**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

![Google AdMob 后台中的奖励视频广告单元配置。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-rewarded.png)

![Google AdMob 后台中的合作伙伴出价复选框。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step2-partner-bidding.png)

**横幅广告**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

**插页式视频**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

**奖励视频**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

**横幅广告**

* **Ad unit name（广告单元名称）**：直观地命名广告单元，以便很容易识别为您即将投放的广告单元
* 合作**伙伴出价**：选中此复选框表示您正在另一个聚合平台上使用竞价

## 在 LevelPlay 网络设置模块中激活 Google##activate-google-in-your-levelplay-network-setup-module

### 自动设置##auto-setup

1. 登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > **Setup** > **Networks**
2. 从可用广告网络列表中选择 Google AdMob

![Google 竞价的 LevelPlay SDK Networks 设置页面。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-levelplay-setup.png)

3. 选择 **Login with Google**（使用 Google 登录），然后使用您批准的 Google 帐户登录
4. 如果您已经登录，请选择 **重置登录**（需要新登录）

![LevelPlay Google 竞价设置页面上的 Login with Google 按钮。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-login.png)

5. 登录后，在 **Google 自动设置出价**器上切换

![在 LevelPlay 中用于 Google 竞价的自动设置出价器开关。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-auto-setup-toggle.png)

6. 现在转到 **Instances** 页面，然后选择要运行 Google 插页式、奖励式或横幅广告服务的应用。

![LevelPlay Google 竞价设置页面上的实例选择。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-instances-selection.png)

7. 选择 **Add Bidder**（添加出价者）可在 AdMob 平台上自动创建新应用和出价广告位，并导入 **Ad Unit ID（广告单元 ID**）。如果有一个已经所挂的**app ID**，如果至少有一个没有 **Ad unit ID** 参数值的放置/位置，则可以使用自动设置工具。在这种情况下，将创建新的竞价放置/位置。
8. 选择 **保存** 以批准并接受所有配置。如果关闭模块而不保存，则会在 AdMob 平台上创建资源，而不会将数据导入 LevelPlay 平台。

![LevelPlay Google 竞价设置页面上的 Add Bidder 按钮。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-step3-add-bidder.png)

> **Important:**
>
> Google 出价者实例的状态与 LevelPlay 广告服务出价者的状态相同（按广告格式）。例如，如果您未使用 LevelPlay 广告服务出价器获取奖励视频，则不会针对 Google 网络自动激活该出价器。

### 手动设置##manual-setup

1. 登录 LevelPlay 帐户，然后转到 LevelPlay 侧导航栏 > **Setup** > **Networks**
2. 从可用广告网络列表中选择 Google AdMob

为了使 AdMob 能够与 LevelPlay SDK 正常工作，需要将 AdMob 帐户中的一些数据插入到 LevelPlay 网络设置模块中：

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

获取此信息时，必须将 AdMob 的参数配置为 LevelPlay。

#### App ID（应用 ID）##app-id

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

#### 广告单元 ID##ad-unit-id

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

#### 客户端 ID 和 客户端 Secret##client-id-and-client-secret

1. 要获取**客户端 ID** 和**客户端密钥**，请访问 [**Google API Manager**](https://console.cloud.google.com/apis)。
2. 选择页面左上角的 **API 项目**下拉选单，选择 **Create a project**（创建项目）或选择已为此 app 创建的项目。如果要为此创建新项目，请在出现的对话框中提供**项目名称**、**计费帐户**和 **Location**，然后选择 **Create**。
3. 在左侧栏中，选择 **Credentials**，然后选择 **OAuth consent screen** 选项卡。提供**商品名称**并选择 **保存**。
4. 在左侧栏中，选择 **Dashboard**（后台），然后选择 **启用 API 和服务**。
5. 接下来，启用 **AdMob API**。
6. 选择左侧栏中的 **Credentials** 选项卡。选择 **Create credentials** 下拉列表并选择 **OAuth Client ID**
7. 选择 **Web application**，并为 app 提供名称。在以下字段中，必须输入至少一个**授权重定向 URI** 的`https://developers.google.com/oauthplayground`。例如：
   * **授权 JavaScript 来源**：`https://YOUR_NAMESPACE`（可选）
   * **授权重定向 URI**：`https://developers.google.com/oauthplayground`
8. 选择 **Create**，随后将显示**客户端 ID** 和**客户端密钥**。

#### 刷新令牌##refresh-token

1. 要获取**刷新令牌**，请访问 [**OAuth 2.0 Playground**](https://developers.google.com/oauthplayground/#step1\&scopes=https%3A//www.googleapis.com/auth/adwords\&url=https%3A//\&content_type=application/json\&http_method=GET\&useDefaultOauthCred=checked\&oauthEndpointSelect=Google\&oauthAuthEndpointValue=https%3A//accounts.google.com/o/oauth2/auth\&oauthTokenEndpointValue=https%3A//www.googleapis.com/oauth2/v3/token\&includeCredentials=unchecked\&accessTokenType=bearer\&autoRefreshToken=unchecked\&accessType=offline\&forceAprovalPrompt=checked\&response_type=code)。
2. 选择右上角的**设置图标**。取消选中标记为**强制批准提示词**的复选框，并选中 **Use your own OAuth credentials**（使用您自己的 OAuth 凭据）。输入**客户端 ID** 和**客户端密钥**。
3. 接下来，在**步骤 1 中：选择 & Authorize APIS**，输入 `https://www.googleapis.com/auth/admob.report` 并选择 **Authorize APIs**。
4. 授权项目访问 AdMob 数据
5. 然后，您应该会收到**步骤 1** 中的**授权代码**，并可以选择**令牌交换授权代码**按钮。然后，您将获得 **Refresh 令牌**以及 **Access Token**。

拥有所有这些参数后，请将它们输入 **LevelPlay** 上的 **Google AdMob** 帐户设置

1. 接下来，转到 **Instances** 页面。在页面顶部选择要通过 **Google** 竞价运行 LevelPlay 的 Mediation 的应用程序。
2. 从 **Ad Networks** 的设置列表中选择 **Google**，然后选择 **Define** 图标。然后在 **Interstitial**、**Rewarded Video** 或 **Banner Settings** 下插入 **app ID** 和 **Ad Unit ID**。

## 将 AdMob 适配器添加到构建中##add-the-admob-adapter-to-your-build

使用适用于 [Android](/grow/levelplay/sdk/android/networks/guides/google-admob/.md) 和 [iOS](/grow/levelplay/sdk/ios/networks/guides/google-admob/.md) 的原生适配器继续集成。

## 验证广告网络集成##verify-your-ad-network-integration

LevelPlay SDK 提供了一种简单的方法来验证聚合集成是否已成功完成。要验证 LevelPlay 和其他广告网络的集成，请遵循本[文档](/grow/levelplay/sdk/react/integration-helper.md)。

您现在可以在应用程序中投放 AdMob 广告服务了！

## 后续步骤##next-steps

要利用其他聚合广告网络，请集成[适配器](/grow/levelplay/sdk/react/mediation-networks.md)并按照我们的集成指南进行操作。