Google Ad Manager 実装ガイド

Unity LevelPlay メディエーションで Google Ad Manager をアドネットワークとして配信するには、以下の手順に従ってください。

ステップ 1. Google Ad Manager アカウントを作成する

1. Unity LevelPlay メディエーションを通じて Google Ad Manager の広告を配信するには、Ad Manager アカウントを作成します。
2. Google Ad Manager で収益化するには、Google AdSense アカウントを作成する必要があります。
3. AdSense アカウントを Ad Manager アカウントに接続します。

ステップ 2. Google Ad Manager で広告枠を作成する

1. Google AdManager ガイドはこちらで確認します。
2. オーダー：
   1. 少なくとも 1 つの「オーダー」を追加します。
   2. AdSense を広告主としてオーダーに接続します。
3. 広告申込情報
   1. 希望のオーダー内で、収益化したい広告ユニットごとに広告申込情報を追加します (Int / RV / BN / NTV BN)。
   2. 動画広告申込情報を選択します。
   3. 広告申込情報のタイプ = Ad Exchange
4. アプリ
   1. アプリケーションは AdMob アカウントから自動的に追加されます。
   2. 追加されない場合は、新しいアプリケーションを作成します。（インベントリ > アプリ > アプリの追加）
5. 広告ユニット
   1. 価格帯ごとに広告ユニットを追加します。

ステップ 3. LevelPlay で Google Ad Manager をアクティベートする

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

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

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

• LevelPlay にログインし、「 Monetize 」 ➣ 「 SETUP 」 ➣ 「 SDK Networks 」に移動します。
  
• 「 Available Networks 」のリストから Google Ad Manager を選択し、「 API Key 」、「 Client ID 」、「 Client Secret 」、「 Refresh Token 」 を入力します。または、「 Login with Google 」オプションをクリックします。
  

Login with Google

「 Save 」をクリックすると Ad Manager が有効になり、「 Available Networks 」に表示されます。

• Unity LevelPlay メディエーションで Ad Manager を配信するアプリを選択します。
• アドネットワークの設定リストから「 Ad Manager 」を選択し、ツールの「 Setup 」をクリックします。インタースティシャル、動画リワード、またはバナーの設定に「 App ID 」と「 Ad Unit ID 」を入力します。

• Reporting API の連携を確認します。Reporting API を通じて連携がチェックされ、「 Verified 」、「 Failed 」、「 No Response 」のうち、いずれかの応答が返されます。「 Verified 」が表示されない場合は、実装と入力した情報を再確認し、「 Verified 」が表示されるまで「 Retry 」をクリックします。

ステップ 4. AdMob アダプターをビルドに追加する

LevelPlay Network Manager（推奨）

SDK の実装が完了すると、LevelPlay Network Manager を使用して AdMob アダプターをダウンロードできます。

Unity 開発プラットフォームで、Ads Mediation > Network Manager へ移動します。

すでに最新バージョンのアダプターが実装されている場合は、アクションボタンが「 Updated 」に変更され、無効になります。

Android (Manual Resolve)

変更を適用するには、必ず「 Resolve 」プロセスを使用してください。これにより、選択されたネットワークに関連するすべてのアーティファクトがダウンロードされます。詳細については、こちらの手順を参照してください。

AdMob App ID を追加する

Android
AdMob SDK v17.0.0（アダプター v4.3.1）以降、パブリッシャーは AdMob App ID を AndroidManifest の <application> タグ内に追加する必要があります。

<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 SDK v7.42.0（アダプター v4.3.3）以降、こちらで説明されているように、パブリッシャーは AdMob App ID をアプリの plist に追加する必要があります。

あるいは、この変更をプログラムで行うこともできます。

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

「 GADApplicationIdentifier 」の値を、ステップ 3 で取得した App ID の値に置き換えます。

Android プラグイン手動実装

1. AdMob アダプターをダウンロード：
   こちらから AdMob アダプターと AdMob SDK (AAR) をダウンロードします。
2. AdMob ファイルを Unity プロジェクトに追加：
   アダプターファイルを Assets/Plugins/Android. にインポートします。
3. Android ドキュメントに記載されているマニフェストアクティビティを追加します。
4. AdMob App ID を AndroidManifest の <application> タグの子要素として追加します。

   <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 プラグイン手動実装

1. AdMob アダプターと SDK ファイルをダウンロード：
   こちらから AdMob アダプターと SDK をダウンロードします。
2. AdMob アダプターを Unity プロジェクトに追加：
   アダプターファイルを Assets/Plugins/iOS にインポートします。
3. SDK を Xcode プロジェクトに追加：
   Unity3D は XCFrameworks をサポートしていないため、SDK の XCFrameworks を Xcode プロジェクトに直接追加してください。
4. こちらのドキュメントに従って、AdMob App ID をアプリの plist に追加します。
   あるいは、この変更をプログラムで行うこともできます。

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

   「 GADApplicationIdentifier 」の値を、手順 3 で取得した App ID の値に置き換えます。

ステップ 5. 追加設定

子供向けアプリの設定 – COPPA

Unity LevelPlay メディエーションでは、パブリッシャーは AdMob の子供向け設定を AdMob ネットワークに直接伝えることができます。
この機能は、ironSource SDK 6.14.0 以降、AdMob Unity アダプター 4.3.12 以降を使用して有効になります。

AdMob の setTagForChildDirectedTreatment にパラメータ「 True 」を設定するには、次の構文を使用します：

 IronSource.Agent.setMetaData("AdMob_TFCD","true");

AdMob の setTagForChildDirectedTreatment にパラメータ「 False 」を設定するには、次の構文を使用します：

 IronSource.Agent.setMetaData("AdMob_TFCD","false");

AdMob ネットワークでの子供向けアプリの設定についての詳細は、こちらをご覧ください。

同意年齢に満たないユーザー – GDPR

Unity LevelPlay メディエーションでは、パブリッシャーは AdMob ネットワークの「ヨーロッパの同意年齢に満たないユーザー向けのタグ（TFUA）」 の設定が可能です。
この機能は、ironSource SDK 6.14.0 以降、AdMob Unity アダプター 4.3.12 以降を使用して有効になります。

setTagForUnderAgeOfConsent を「 True 」に設定するには、次の構文を使用します：

 IronSource.Agent.setMetaData("AdMob_TFUA","true");

setTagForUnderAgeOfConsent を「 False 」に設定するには、次の構文を使用します：

 IronSource.Agent.setMetaData("AdMob_TFUA","false");

AdMob ネットワークでの子供向けアプリの設定についての詳細は、こちらをご覧ください。

広告コンテンツのフィルタリング

Unity LevelPlay メディエーションでは、パブリッシャーは AdMob ネットワークと通信し、すべての広告リクエストに対して広告コンテンツのレーティングを最大化できます。
この機能は、ironSource SDK 7.12.0 以降、AdMob Unity アダプター 4.3.23 以降を使用して有効になります。

maxAdContentRating を設定するには、次の構文を使用します：

IronSource.Agent.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 ネットワークでの広告コンテンツレーティングプロパティについての詳細は、こちらをご覧ください。

コンテンツ URL マッピングのサポート

Unity LevelPlay は、アプリ向けの Google のコンテンツマッピングをサポートしており、「 Google_Content_Mapping 」設定を使用して URL を共有できます。この機能は、ironSource SDK 7.7.0 以降、AdMob Unity アダプター 4.3.58 以降を使用して有効になります。Google のコンテンツマッピングについての詳細は、こちらをご覧ください。

単一コンテンツの URL を渡すには、次の構文を使用します：

IronSource.Agent.setMetaData("Google_Content_Mapping","https://www.example.com");

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

IronSource.Agent.setMetaData("Google_Content_Mapping",["https://www.expamle1.com","https://www.example2.com"]);

完了！
これで、アプリで Google Ad Manager 広告を配信する準備が完了しました。