Google AdMob 実装ガイド

このガイドでは、Unity LevelPlay メディエーションで AdMob と AdMob ネイティブをアドネットワークとして設定する方法を説明します。

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

1. Unity LevelPlay メディエーションを通じて AdMob のバナーとネイティブ広告を配信するには、AdMob でアカウントを作成する必要があります。
2. ironSource プラットフォームに合わせて、AdMob アカウントのタイムゾーンを UTC に設定することをおすすめします。これにより、レポートの正確性が保証されます。詳細はこちら。

ステップ 2. Admob でアプリケーションと広告ユニットを作成する

次に、アプリを追加し、AdMob アカウントに広告ユニットを設定する必要があります。

アプリを追加する

• AdMob アカウントにログインし、ダッシュボードで「 Apps 」をクリックします。
• モーダルが表示されるので、アプリを検索するか、アプリを手動で追加するか、収益化する既存のアプリを選択します。
  
  
  Note: ironSource アカウントと同様に、プラットフォーム（ iOS + Android ）ごとに固有の AdMob アプリケーションが必要です。
• 広告ユニットのフォーマットから、インタースティシャル、動画リワード、バナー、またはネイティブアドバンス（バナー用のネイティブ広告）を選択し、詳細を入力します。
  
• インタースティシャル
  • Ad Type：インタースティシャルではテキスト、画像、ビデオ、リッチメディアがサポートされているため、2 つのボックスをオンのままにすることができます。
  • Ad unit name：Unity LevelPlay メディエーションで AdMob インタースティシャルを配信する広告ユニットとして認識しやすいように、広告ユニットには直感的な名前を付けることをお勧めします。
    
• 動画リワード
  • Ad unit name：Unity LevelPlay メディエーションで AdMob の動画リワードを配信する広告ユニットとして認識しやすいように、広告ユニットに直感的な名前を付けることをお勧めします。
    
• バナー
  • Ad Unit Name：Unity LevelPlay メディエーションで AdMob のバナーを配信する広告ユニットとして認識しやすいように、広告ユニットに直感的な名前を付けることをお勧めします。
  • eCPM floor：国とウォーターフォールの戦略に基づいて eCPM 値を有効にして入力します。

• ネイティブバナー

バナーのネイティブ広告を使用すると、Google AdMob からのネイティブ広告の在庫へアクセスできます。これは、Google のネイティブとバナー両方の在庫にアクセスすることで、バナーのパフォーマンスを向上できることを意味します。

• • Ad unit name：わかりやすい名前を入力します。
  • Advanced settings：「 Image 」と「 Video 」両方を選択します。
  • eCPM floor：国とウォーターフォールの戦略に基づいて eCPM 値を有効にして入力します。

App ID と Ad Unit ID を取得し、後で使用できるように保存します。次に、「 Done 」をクリックします。

ステップ 3. LevelPlay ネットワークモジュールで AdMob をアクティベートする

LevelPlay の「 SDK Networks 」ページで AdMob を設定する際に Google アカウントにログインすると、AdMob インタースティシャル、リワードビデオ、バナー、ネイティブ広告の実行に必要なパラメータが自動的に取得されます。

AdMob が ironSource SDK で正しく動作するためには、AdMob アカウントのいくつかのデータを「 LevelPlay Networks 」モジュールに設定する必要があります：

この情報を取得したら、LevelPlay で AdMob のパラメータを設定する必要があります。上記の情報を正しく入力すると、AdMob の広告在庫と Unity LevelPlay メディエーションのレポートデータを最大限に活用できるようになります。

• • 1. App ID
       App ID を取得するには、AdMob プラットフォームの左側のサイドバーにある「 Apps 」 タブに移動し、「 App settings 」をクリックします。アプリケーションの設定と App ID が表示されます。
       
    2. Ad Unit ID
       Ad Unit ID を取得するには、Admob プラットフォームの左側のサイドバーにある「 Apps 」 タブに移動し、「 Ad Units 」をクリックします。アプリケーションの広告ユニットと Ad Unit ID が表示されます。
       
    3. Client ID  and Client Secret
       1. Client ID と Client Secret を取得するには、Google の API マネージャーに移動します。
       2. ページの左上にある「 API Project 」ドロップダウンをクリックし、「 Create a project 」を選択するか、このアプリ用に既に作成したプロジェクトを選択します：
          この目的のため新しいプロジェクトを作成する場合は、表示されるダイアログ ボックスに「 Project Name 」、「 Billing account 」、「 Location 」を入力し、「 Create 」をクリックします：
          
       3. 左側のサイドバーで、「 Credentials 」を選択し、「 OAuth consent screen 」タブを選択します。このページでは、製品名を入力します。 「 Product Name 」をクリックします。「 Save 」をクリックします：
       4. 左側のサイドバーで「 Dashboard 」を選択し、「 ENABLE APIS AND SERVICES 」に移動します：
          
       5. 次に、AdMob API を有効にします：
          
       6. 左側のサイドバーで「 Credentials 」タブを選択します。「 Create Credentials 」ドロップダウンをクリックし、「 OAuth client ID 」を選択します。
       7. 「 Web application 」を選択し、アプリの名前を指定します。以下のフィールドに、少なくとも 1 つの承認済みリダイレクト URI として https://developers.google.com/oauthplayground を入力する必要があります。以下例：
          • Authorized JavaScript origins: https://YOUR_NAMESPACE (Optional)
          • Authorized redirect URI: https://developers.google.com/oauthplayground
       8. 「 Create 」をクリックすると、「 Client ID 」と「 Client Secret 」が表示されます：
          
    4. Refresh Token
       1. 「 Refresh Token 」を取得するには、「 OAuth 2.0 Playground 」に移動します。
       2. 右上隅にある設定アイコンをクリックします。 「 Force approval prompt 」というラベルの付いたボックスのチェックを外し、「 Use your own OAuth credentials 」にチェックを入れます。「 Client ID 」と「 Client Secret 」を入力します。
          
       3. 次に、「 Step 1: Select & Authorize APIs 」で、「 https://www.googleapis.com/auth/admob.report 」と入力し、「 Authorize APIs 」をクリックします：
          
       4. プロジェクトに AdMob データへのアクセスを許可します。
       5. Step 1 で認証コードを受け取り、「 Exchange authorization code for tokens 」 ボタンをクリックできるようになります。次に、「 Refresh Token 」と「 Access Token 」を取得します。
          

LevelPlay で AdMob パラメータを設定する

• • • これらのパラメータをすべて取得したら、LevelPlay にログインし、Monetize ➣ SETUP ➣ SDK Networks に移動します。
      
    • 「 Manage Networks 」のリストから 「 AdMob 」 を選択し、Admob の「 Client ID 」、「 Client Secret 」、および「 Refresh Token 」 を入力するか、「 Login with Google 」オプションをクリックします。
      
      Login with Google:
    • 「 Save 」をクリックします。 AdMob と AdMob ネイティブが「 Available Networks 」で有効になります。
      
    • 次に、Unity LevelPlay メディエーションで AdMob を配信するアプリを選択します。
    • アドネットワークの設定リストから AdMob を選択し、ツールの「 Setup 」ボタンまたは「編集」アイコンをクリックします。次に、インタースティシャル、動画リワード、またはバナーの設定に「 App ID 」と「 Ad Unit ID 」を挿入します。
      
    • Reporting API の連携を確認します。この列では、Reporting API を通じて連携がチェックされ、「 Verified 」、「 Failed 」、「 No Response 」のうち、いずれかの応答が返されます。実装と入力した情報を再確認し、「 Verified 」が表示されるまで「 Retry 」をクリックします。

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

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

1. 「 allprojects -> repositories 」ブロック内に次の行があることを確認してください。

   allprojects {
       repositories {
          flatDir {
              dirs 'libs'
          }
          google()
       }
   }

2. 次の依存関係を「 dependencies 」ブロックに追加します。

   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   }

Android

ironSource SDK は、Gradle の依存関係と手動ダウンロードメカニズムの両方をサポートしています。

AdMob アダプターを Gradle で実装する：

• • 1. 次の Maven URL がアプリモジュールの build.gradle スクリプトに存在することを確認してください。（1 度の定義ですべてのアダプターに対して有効です）

       repositories {
           google()
           maven {
               url "https://android-sdk.is.com/"
           }
       }
       

    2. アダプターの Maven 名をアプリモジュールの build.gradle スクリプトに追加します：
       

       implementation 'com.google.android.gms:play-services-ads:23.5.0'
       implementation 'com.ironsource.adapters:admobadapter:4.3.47'

手動ダウンロードで AdMob アダプターを実装する：

• • 1. dMob アダプターをダウンロード：
       AdMob アダプターをビルドに追加します。最新の AdMob アダプターはこちらで確認が可能です。
       重要！ Admob アダプターには AdMob SDK は含まれていません。AdMob SDK は別途直接追加する必要があります。
    2. AdMob アダプターをプロジェクトに追加：
       アダプターをダウンロードした後、Admob アダプターの jar を Android プロジェクトの libs フォルダーにドロップします。
       
    3. Gradle ビルドファイルの「 dependencies 」セクションに以下を必ず追加してください。
       

       implementation 'com.google.android.gms:play-services-ads:23.5.0'
       implementation 'com.ironsource.adapters:admobadapter:4.3.47'

ステップ 5. AndroidManifest.xml を更新する

ironSource Android SDK v6.17.0（AdMob Android アダプター v4.3.10）以降、AdMob アダプターは AAR としてリリースされています。 Jar での実装を維持する場合のみ、マニフェストへ以下を追加してください。

Manifest Permissions:

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Manifest Activities:
以下の Activity を、manifestAdditions の <application> タグ内に追加します：

<activity android:name="com.google.android.gms.ads.AdActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" android:theme="@android:style/Theme.Translucent" />

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 のガイドを参照してください。

ステップ 6. 追加設定

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

IronSource.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 Android アダプター 4.3.41 以降を使用して有効になります。Google のコンテンツマッピングについての詳細は、こちらをご覧ください。

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

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

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

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

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