# Google Bidding インテグレーション

> LevelPlay SDK を使用して、Google Bidding をメディエーションネットワークとして Flutter アプリケーションに統合します。

このガイドでは、Unity LevelPlay Mediation で Google を入札者ネットワークとして設定する手順をステップごとに説明します。

Google入札者様は、以下のステップ1を完了したときに自動設定ツールを使用できます。自動設定ツールはアプリケーションと入札者の配置を作成し、AdMobから配置の詳細を取得するため、LevelPlayとAdMobのプラットフォームを切り替える必要はありません。または、設定全体を手動で完了することもできます。

## AdMob アカウントの作成##create-an-admob-account

1. Unity LevelPlay Mediation を通じて Google の広告インベントリにアクセスするには、AdMob で[アカウントを作成](https://www.google.com/admob/)する必要があります。
2. Unity LevelPlay プラットフォームに合わせて AdMob アカウントのタイムゾーンを UTC に調整することをお勧めします。これにより、正確なレポートが保証されます。[詳細](https://support.google.com/admob/answer/7276705?hl=en)

> **Important:**
>
> ステップ1を完了したら、ステップ3にスキップして自動入札設定ツールを使用して、Unity LevelPlayでGoogle入札を開始して実行できます。手動設定を続行する場合は、ステップ 2 に進みます。

## AdMobでのアプリケーションと広告単位の作成##create-an-application-and-ad-unit-in-admob

### アプリケーションの追加##add-your-app

1. AdMob アカウントにログインします。ダッシュボードで、**Apps**、**Add application**を選択します。
2. モーダルが表示されます。ここで、アプリケーションの検索、アプリケーションの手動追加、既存のアプリケーションを選択して収益化できます。

> **Note:**
>
> LevelPlay アカウントと同様に、プラットフォーム (iOS + Android) ごとに一意の AdMob アプリケーションが必要です。

3. 広告単位形式としてinterstitial、rewarded video、またはbannersを選択し、関連する詳細を入力します。

### 広告単位設定##ad-unit-configuration

**Interstitial (インタースティシャル)**

* **広告ユニット名**: 広告単位に直感的な名前を付け、配信する広告単位として認識しやすくします。
* **パートナー入札**:チェックボックスをオンにして、別のメディエーションプラットフォームで入札を使用していることを示します。

![Google AdMob ダッシュボードのインタースティシャル広告単位設定。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-flutter-step2-interstitial.png)

**動画リワード**

* **広告ユニット名**: 広告単位に直感的な名前を付け、配信する広告単位として認識しやすくします。
* **パートナー入札**:チェックボックスをオンにして、別のメディエーションプラットフォームで入札を使用していることを示します。

![Google AdMob ダッシュボードのリワード型動画広告の単位設定。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-flutter-step2-rewarded.png)

**バナー**

* **広告ユニット名**: 広告単位に直感的な名前を付け、配信する広告単位として認識しやすくします。
* **パートナー入札**:チェックボックスをオンにして、別のメディエーションプラットフォームで入札を使用していることを示します。

## LevelPlay ネットワーク設定モジュールで Google をアクティベート##activate-google-in-your-levelplay-network-setup-module

LevelPlay で Google 設定を行うには 2 つの方法があります。

* **自動設定** – Googleアカウントにログインして、新しいアプリケーションと入札プレースメントを自動的に作成し、Google AdMobプラットフォームから必要な設定をすべて取得します。
* **手動** – LevelPlay プラットフォームと Google AdMob プラットフォーム間で必要な情報を取得して入力します。

### 自動設定##auto-setup

1. LevelPlay アカウントにログインし、LevelPlay サイドのナビゲーション バー> **設定**> **Networks** に移動します。
2. 使用可能な広告ネットワークのリストから**Google AdMob**を選択します。

![Google 入札用の LevelPlay SDK Networks 設定ページ。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-flutter-step3-levelplay.png)

3. **Login with Google**を選択し、承認済みのGoogleアカウントでログインします。
4. すでにログインしている場合は、**リセット ログイン**を選択します(新しいログインが必要です)。
5. ログインしたら、**Google自動設定入札**者をトグル
6. **Instances**ページに移動し、Googleのインタースティシャル広告、リワード広告、バナー広告を実行するアプリケーションを選択します。
7. 「**Add Bidder(**入札を追加)」を選択すると、AdMobプラットフォームに新しいアプリケーションと入札プレースメントが自動的に作成され、**広告単位ID**がインポートされます。アプリケーションにすでに**App ID**がアタッチされている場合、**広告単位ID**パラメーター値を指定せずに配置が1つ以上あれば自動設定ツールを使用できます。この場合、新しい入札配置が作成されます。
8. **Save (保存**) を選択して、すべての設定を承認および承認します。保存せずにモジュールを閉じると、データを LevelPlay プラットフォームにインポートせずに AdMob プラットフォームにアセットが作成されます。

![Google 入札の自動設定オプション。](/api/media?file=grow/media/levelplay/networks/guides/google-bidding-flutter-step3-auto-setup.png)

> **Important:**
>
> Google 入札者インスタンスの状態は、広告形式では LevelPlay Ads 入札者の状態と同じです。例えば、動画のリワード広告に LevelPlay Ads 入札者を使用しない場合、Google ネットワークでは自動的にアクティブ化されません。

### 手動設定##manual-setup

1. LevelPlay アカウントにログインし、LevelPlay サイドのナビゲーション バー> **設定**> **Networks** に移動します。
2. 使用可能な広告ネットワークのリストから**Google AdMob**を選択します。

AdMob が LevelPlay SDK で正しく動作するためには、AdMob アカウントのデータの一部を LevelPlay ネットワーク設定モジュールに挿入する必要があります。

| **パラメーター**          | **説明**                                      |
| ------------------- | ------------------------------------------- |
| **App ID (アプリ ID)** | Admob のダッシュボードでアプリケーションに割り当てられた一意の ID。      |
| **広告単位 ID**         | Admob のダッシュボードでアプリケーションの広告単位に割り当てられた一意の ID。 |
| **クライアント ID**       | これは、アカウントと広告単位の関係を指定する一意の識別子です。             |
| **クライアントシークレット**    | クライアント ID とペアになる秘密鍵                         |
| **リフレッシュトークン**      | これは、クライアントアプリケーションがすでに受信した更新トークンです。         |

この情報を取得したら、AdMob のパラメーターを LevelPlay に設定する必要があります。

#### App ID (アプリ ID)##app-id

**App ID** を取得するには、Admob のプラットフォームの左側のサイドバーにある **Apps** (アプリケーション) タブに移動し、**アプリケーション設定**を選択します。アプリケーションの設定と**App ID**が表示されます。

#### 広告単位 ID##ad-unit-id

**広告単位 ID** を取得するには、Admob のプラットフォームの左側のサイドバーにある **Apps (アプリケーション**) タブに移動し、**Ad Units (広告単位**) を選択します。アプリケーションの広告単位と**広告単位 ID** が表示されます。

#### クライアント ID とクライアントシークレット##client-id-and-client-secret

1. **クライアントID**と**クライアントシークレット**を取得するには、[**GoogleのAPIマネージャ**](https://console.cloud.google.com/apis)にアクセスします。

2. ページの左上にある **API Project** ドロップダウンを選択し、**Create a project** を選択するか、このアプリケーション用にすでに作成したプロジェクトを選択します。

   この目的で新しいプロジェクトを作成する場合は、表示されるダイアログボックスに**プロジェクト名**、**課金アカウント**、および**場所**を入力し、**Create (作成**) を選択します。

3. 左側のサイドバーで、**［Credentials］** を選択し、［**OAuth consent screen**］ タブを選択します。**Product Name** (製品名) を入力し、**Save (保存**) を選択します。

4. 左側のサイドバーで、「**ダッシュボード**」を選択し、「**Enable APIs and services**」に移動します。

5. 次に、**AdMob API** を有効にします。

6. 左側のサイドバーで**Credentials**タブを選択します。**Create Credentials** ドロップダウンを選択し、**OAuth client ID** を選択します。

7. **ウェブアプリケーション**を選択し、アプリケーション**名**を指定します。下のフィールドに、少なくとも 1 つの **Authorized リダイレクト URI** の`https://developers.google.com/oauthplayground`を入力する必要があります。例を次に示します。
   * **Authorized JavaScript origins**：`https://YOUR_NAMESPACE` (任意)
   * **Authorized リダイレクト 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** をオンにします。**クライアント ID** と**クライアントシークレット**を入力。
3. 次に、**ステップ 1:& Authorize APIs を選択し**、`https://www.googleapis.com/auth/admob.report` と入力して **Authorize APIs** を選択します。
4. プロジェクトに AdMob データへのアクセスを許可します。
5. 次に、**ステップ1**から**承認コード**を受け取り、**Exchange承認コード for tokens**ボタンを選択できるようになります。次に、**更新トークン**と**アクセストークン**が取得されます。

**これらのパラメータをすべて設定したら、LevelPlay の Google AdMob アカウント設定に入力します。**

1. 次に、**Instances** (インスタンス) ページに移動します。Unity LevelPlay の Mediation を Google 入札で実行するページ上部のアプリケーションを選択します。
2. **広告ネットワーク**の設定リストから**Google**を選択し、**定義**アイコンを選択します。次に、**Interstitial**, **Rewarded Video**または**Banner Settings**に**App ID**と**広告単位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 とその他の Ad Networks のインテグレーションを検証するには、この[ドキュメント](/grow/levelplay/sdk/flutter/integration-helper.md)を参照してください。

これで、アプリケーション内で AdMob Ads を配信する準備が整いました。

### 次のステップ##next-steps

追加のメディエーション広告ネットワークを活用するには、[アダプタ](/grow/levelplay/sdk/flutter/mediation-networks.md)を統合し、インテグレーションガイドに従います。