Google Bidding 実装ガイド

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

Google Bidder では、以下のステップ 1 を完了すると自動セットアップツールを使用できるようになります。自動セットアップツールはアプリと Bidder プレースメントを作成し、AdMob からプレースメントの詳細を取得します。そのため、LevelPlay と AdMob の管理画面を行ったり来たりする必要はありません。あるいは、セットアップ全体を手動で行うこともできます。

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

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

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

次に、AdMob アカウントにアプリを追加する必要があります。

アプリを追加する

• AdMob アカウントにログインし、ダッシュボードで「 Apps 」> 「 Add app 」をクリックします。
• モーダルが表示されるので、アプリを検索するか、アプリを手動で追加するか、収益化する既存のアプリを選択します。
  
  
  Note: Note: ironSource アカウントなどと同様に、プラットフォーム（ iOS + Android ）ごとに固有の AdMob アプリケーションが必要です。
• 広告ユニットのフォーマットから、インタースティシャル、動画リワード、またはバナーを選択し、詳細を入力します。
  
• インタースティシャル
  • Ad unit name：配信する広告ユニットを認識しやすいように、広告ユニットには直感的な名前を付けることをお勧めします。
  • Partner bidding：別のメディエーションプラットフォームで bidder を使用していることを示すボックスをオンにします。
    
• 動画リワード
  • Ad unit name：配信する広告ユニットを認識しやすいように、広告ユニットには直感的な名前を付けることをお勧めします。
  • Partner bidding：別のメディエーションプラットフォームで bidder を使用していることを示すボックスをオンにします。
    
• バナー
  • Ad unit name：配信する広告ユニットを認識しやすいように、広告ユニットには直感的な名前を付けることをお勧めします。
  • Partner bidding：別のメディエーションプラットフォームで bidder を使用していることを示すボックスをオンにします。

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

LevelPlay で Google bidding をセットアップするには以下 2 つの方法があります：

• 自動セットアップ – Google アカウントでログインすると、新しいアプリケーションと bidder プレースメントが自動的に作成され、必要なすべての設定が Google AdMob プラットフォームから取得されます。
• 手動 – LevelPlay と Google AdMob の両方の管理画面を行き来して必要な情報を取得し、入力します。

自動セットアップ

• LevelPlay にログインし、LevelPlay サイドナビゲーションバー ➣ Setup ➣ Networks に移動します。
• Network のリストから Google AdMob を選択します。

• 「 Login with Google 」をクリックし、承認された Google アカウントでログインします。
• すでにログインしている場合は、「 reset login 」をクリックします（新たにログインする必要があります）

• ログインしたら、「 Google bidder auto-setup 」をオンに切り替えます。

• 「 Instances 」ページで、Google からのインタースティシャル、動画リワード、またはバナー広告を配信するアプリを選択します。

• 「 Add Bidder 」ボタンをクリックすると、AdMobプラットフォーム上に新しいアプリと Bidding Ad Unit が自動的に作成され、Ad Unit ID がインポートされます。すでにアプリに App ID がアタッチされている場合、Ad Unit ID パラメータ値が設定されていない Ad Unit が少なくとも1つあれば、自動セットアップツールを使用できます。この場合、新しい Bidding Ad Unit が作成されます。

「 Save 」をクリックし、すべての設定を承認・受諾します。保存せずにモジュールを閉じると、AdMob プラットフォーム上にアセットが作成されますが、データは LevelPlay プラットフォーム上にインポートされません。

手動セットアップ

• LevelPlay にログインし、LevelPlay サイドナビゲーションバー ➣ Setup ➣ Networks に移動します。
• 「 Available Networks 」から「 Google AdMob 」を選択します。

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

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

• • 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 の Google AdMob アカウント設定に入力します。
  
• 次に、Unity LevelPlay メディエーションで AdMob を配信するアプリを選択します。
• アドネットワークの設定リストから AdMob を選択し、ツールの「 Setup 」ボタンまたは「編集」アイコンをクリックします。次に、インタースティシャル、動画リワード、またはバナーの設定に「 App ID 」と「 Ad Unit ID 」を挿入します。
  

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

Unity Network Manager（推奨）

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

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

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

Android (Manual Resolve)

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

AdMob App ID を追加する

Android
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 アプリ ID をアプリの plist に追加します。
あるいは、この変更をプログラムで行うこともできます。

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

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

Android プラグイン手動実装

1. AdMob アダプターをダウンロード：
   こちらからAdMob アダプターと SDK (AAR) をダウンロードします。
2. AdMob ファイルを Unity プロジェクトに追加：
   ファイルを Assets/Plugins/Android にインポートします。
3. 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. Info.plist を更新する

AdMob SDK v7.42.0（アダプター v4.3.3 iOS/Unity）以降、こちらで説明されているように、パブリッシャーは AdMob App ID をアプリの plist に追加する必要があります。
あるいは、この変更をプログラムで行うこともできます。

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

「 GADApplicationIdentifier 」の値を、ステップ 3 で取得した App ID の値に置き換えます。
この設定が漏れていると、AdMob の SDK に起因するクラッシュが発生します。詳細については、AdMob のガイドを参照してください。

ステップ 6. 追加設定

子供向けアプリの設定 – 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 Bidding 広告を配信する準備ができました。