# Google Ad Managerインテグレーション

> LevelPlay のメディエーションプラットプラットフォームを使用して、Google Ad Manager を React ネイティブ アプリケーションに広告ネットワークワークとして統合します。

> **Important:**
>
> 以下のドキュメントでは、Unity が開発、所有、または運用するものではない製品またはサービス ("サードパーティ製品") を取り上げます。
> その情報は、古かったり、不完全であったりする可能性がありますが、利便性のために提供しています。
> サードパーティ製品を使用する際は、その製品の規約に従うものとします。
> Unity はそれらの製品に関して一切保証を行わず、その使用によって生じた損害や損失 (サードパーティプロバイダーのコンテンツ、広告、製品、資料に関する問題を含む) について責任を負いません。

以下の手順に従って、Google Ad Manager を Unity LevelPlay メディエーションの広告ネットワークとして稼働させます。

## 前提条件##prerequisites

* リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。

  **Integration guides:**

  * [リワード広告](/grow/levelplay/sdk/react/rewarded-ads-integration.md)
  * [インタースティシャル](/grow/levelplay/sdk/react/interstitial-integration.md)
  * [バナー](/grow/levelplay/sdk/react/banner-integration.md)

## ステップ 1. Google Ad Manager アカウントの作成

1. Unity LevelPlay のメディエーションを介して Google Ad Manager 広告インベントリにアクセスするには、[Ad Manager アカウントを作成](https://admanager.google.com/home/)します。
2. Google 広告マネージャーで収益を得るには、Google AdSense アカウントを作成する必要があります
3. AdSense アカウントを Ad Manager アカウントに接続する

## ステップ 2. Google Ad Manager でのインベントリの作成

1. Google AdManager ガイドは[こちら](https://support.google.com/admanager/answer/6238692?hl=en)にあります。
2. 注文:
   1. 少なくとも 1 つの注文を追加する
   2. AdSense を広告主として注文に接続する
3. ラインアイテム
   1. 収益化したい広告単位ごとにライン項目を追加します(Int/RV/BN/NTV BN)
   2. ビデオ ライン項目の選択
   3. Line item type (ライン項目タイプ) = Ad exchange (広告交換)
4. アプリ
   1. アプリケーションは Admob アカウントから自動的に追加されます。
   2. そうでない場合は、新しいアプリケーションを作成します (インベントリ (インベントリ) > Apps (アプリ) > Add アプリケーション (アプリを追加))。
5. 広告ユニット
   1. 価格ポイントごとに広告単位を追加

## ステップ 3. LevelPlay アカウントで **Google Ad Manager** をアクティベート

LevelPlay SDK Networks 設定ページで Ad Manager を設定するときに、Google アカウントにサインインします。これにより、Ad Managerのインタースティシャル広告、リワード広告、バナーを実行するために必要なすべてのパラメーターが自動的に取得されます。

1. Google Ad Manager アカウントで、以下の情報を取得します。 

| App ID (アプリ ID) | Ad Manager ダッシュボードでアプリケーションに割り当てられた一意のの ID                                                                     |
| --------------- | -------------------------------------------------------------------------------------------------------------- |
| APIキー           | Ad Manager アカウントの一意の識別子。これにより、Unity LevelPlay Mediation は Ad Manager アカウントからパフォーマンスデータをインポートし、レポートと最適化に使用できます。 |
| 広告単位 ID         | Ad Manager ダッシュボードでアプリケーションの広告単位に割り当てられた一意のの ID                                                                |
| クライアント ID       | アカウントと広告単位の関係を指定する一意の識別子                                                                                       |
| クライアントシークレット    | クライアント ID とペアになる秘密鍵                                                                                            |
| リフレッシュトークン      | クライアントアプリケーションがすでに受け取っている更新トークン                                                                                |

2. LevelPlay アカウントで Google Ad Manager のパラメータを設定します。

* ironsource アカウントにログインし、**［Monetize**］＞ ［**設定**］＞ ［**SDK Networks］** に移動します。

![SDK ネットワーク](/api/media?file=/grow/media/images/Level-Play-SDK.jpg)

* 「使用**可能なネットワーク**」のリストから「Google Ad Manager」を選択し、Ad Manager の **API キー**、**クライアント** **ID**、**クライアントシークレット、**および**更新トークン**を入力するか、「**Login with Google**」オプションを選択します。

![ログイン認証情報](/api/media?file=/grow/media/images/1-1.png)

![Login with Google](/api/media?file=/grow/media/images/2.png)

* **Save** (保存) を選択します。Ad Manager が有効になり、**Available Ad Networks** テーブルにリストされます。
* 広告ネットワークの設定リストから Ad Manager を選択し、ツールの **Define** (定義) ボタンを選択します。**インタースティシャル設定**、**リワード設定**、または**バナー設定**の下に**App ID**と**広告単位\*\*\*\*ID**を挿入します。
  ![アプリケーションと広告単位設定](/api/media?file=/grow/media/images/4.png) - Reporting APIとのインテグレーションを確認します。この列では、Reporting API によるインテグレーションを確認し、3 つの応答を返します。検証済み、失敗、無反応。**検証済み**(Verified) が表示されない場合は、インテグレーションと入力した情報を再確認し、**検証済み** (Verified) が表示されるまで 再試行(**Retry**) を選択します。

## ステップ 4. ビルドへの AdMob アダプタの追加##step-4.-add-the-admob-adapter-to-your-build

[Android](/grow/levelplay/sdk/android/networks/guides/google-ad-manager.md)および[iOS](/grow/levelplay/sdk/ios/networks/guides/google-ad-manager.md)用のネイティブ アダプターを使用して、インテグレーションを継続します。

## ステップ 5.追加ステップ##step-5.-additional-steps

以下のオプションを使用する場合は、LevelPlay SDK を初期化する**前**に `LevelPlay.setMetaData` を呼び出します。

### 子ども向け設定 - COPPA##child-directed-setting---coppa

LevelPlay メディエーションを使用すると、パブリッシャーは AdMob の子ダイレクト設定を AdMob ネットワークに直接通知できます。この特徴は、LevelPlay SDK 6.14.0 以降、AdMob アダプター 4.3.9 以降 (Android) / 4.3.11 以降 (iOS) を使用して有効化されます。

以下の構文を使用して、AdMob の **setTagForChildDirectedTreatment** にパラメーター true を設定します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('AdMob_TFCD', ['true'])
```

以下の構文を使用して、AdMob の **setTagForChildDirectedTreatment** にパラメーター false を設定します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('AdMob_TFCD', ['false'])
```

AdMob の下の Child-directed 設定の詳細については、[こちら](https://developers.google.com/admob/android/targeting#child-directed_setting)を参照してください。

### 同意年齢に満たないユーザー - GDPR##users-under-the-age-of-consent---gdpr

LevelPlay メディエーションを使用すると、パブリッシャーは AdMob ネットワークに TFUA (ヨーロッパの同意年齢に満たないユーザー) リクエストのタグを付けることができます。この特徴は、LevelPlay SDK 6.14.0 以降、AdMob アダプター 4.3.9 以降 (Android) / 4.3.11 以降 (iOS) を使用して有効化されます。

以下の構文を使用して、**setTagForUnderAgeOfConsent** を true に設定します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('AdMob_TFUA', ['true'])
```

以下の構文を使用して、**setTagForUnderAgeOfConsent** を false に設定します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('AdMob_TFUA', ['false'])
```

AdMob の同意年齢に満たないユーザーの詳細については、[こちら](https://developers.google.com/admob/android/targeting#users_under_the_age_of_consent)を参照してください。

### 広告コンテンツフィルタリング##ad-content-filtering

LevelPlay メディエーションを使用すると、パブリッシャーは AdMob ネットワークと通信して、すべての広告リクエストに対する最大広告コンテンツ評価を設定できます。この特徴は、LevelPlay SDK 7.12.0 以降、AdMob アダプター 4.3.23 以降 (Android) / 4.3.28 以降 (iOS) を使用して有効化されます。

maxAdContentRating を設定するには、以下の構文を使用します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

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 の広告コンテンツレーティングの詳細については、[こちら](https://developers.google.com/admob/android/targeting#ad_content_filtering)を参照してください。

### コンテンツ URL マッピング サポート##content-url-mapping-support

LevelPlay は、Google のアプリケーション用コンテンツマッピングをサポートしており、「Google\_コンテンツ\_マッピング」設定を使用して URL を共有できます。この特徴は、LevelPlay SDK 7.7.0 以降、AdMob アダプター 4.3.41 以降 (Android) / 4.3.51 以降 (iOS) を使用して有効化されます。Google のコンテンツマッピングの詳細については、[こちら](https://support.google.com/admob/answer/11050896)を参照してください。

単一コンテンツの URL を渡すには：

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('Google_Content_Mapping', ['https://www.example.com'])
```

複数の URL をサポートするには、同じキーを使用し、最大 4 つの URL を共有します。

```js
「Unity-levelplay-mediation」からのインポート{ LevelPlay }

LevelPlay.setMetaData('Google_Content_Mapping', [
  'https://www.example.com',
  'https://www.example2.com',
])
```

## 広告ネットワークインテグレーションの確認##verify-your-ad-network-integration

LevelPlay SDK を使用すると、メディエーションのインテグレーションが正常に完了したことを簡単に確認できます。LevelPlay SDK とその他の Ad Networks のインテグレーションを検証するには、この[ドキュメント](/grow/levelplay/sdk/react/integration-helper.md)に従ってください。

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

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