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 アダプターをビルドに追加する

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

iOS

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

Cocoapods

AdMob アダプターと SDK を CocoaPods で実装するには、Podfile に次の行を入力します。

pod 'IronSourceAdMobAdapter','4.3.60.0'

Manual Download

1. AdMob アダプターをダウンロード
   AdMob アダプターをビルドに追加します。最新の AdMob アダプターはこちらで確認が可能です。
   Admob アダプターには AdMob SDK は含まれていないため、AdMob SDK は別途追加する必要があります。
2. AdMob XCFramework をプロジェクトに追加
   • アダプターと SDK をダウンロードした後、アダプターと SDK XCFramework ファイルを Xcode プロジェクトにドロップします。
   • XCFramework を使用せずにフレームワークをインポートする場合は、ネイティブバナー用のリソースファイルをドロップします。
3. Target ➣ Build Settings ➣ Architectures を開き、Xcode プロジェクトが Base SDK バージョン 8.0 以降を使用していること、および armv6 アーキテクチャを使用していないことを確認します。
4. Linker Flags:
   以下のリンカーフラグを Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags に追加します：
   -ObjC

ステップ 5. Info.plist を更新する

AdMob SDK v7.42.0（アダプター v4.3.3）以降、こちらで説明されているように、パブリッシャーは 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 iOS アダプター 4.3.11 以降を使用して有効になります。

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

 [IronSource setMetaDataWithKey:@"AdMob_TFCD" value:@"true"];

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

 [IronSource setMetaDataWithKey:@"AdMob_TFCD" value:@"false"];

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

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

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

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

[IronSource setMetaDataWithKey:@"AdMob_TFUA" value:@"true"];

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

[IronSource setMetaDataWithKey:@"AdMob_TFUA" value:@"false"];

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

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

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

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

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

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

[IronSource setMetaDataWithKey:@"Google_Content_Mapping" value:@"https://www.example.com"];

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

[IronSource setMetaDataWithKey:@"Google_Content_Mapping" value:@[@"https://www.example1.com",@"https://www.example2.com"];

ステップ 7. ネイティブ広告を有効にする（クローズドベータ版）

リソースバンドル
リソースバンドルにさまざまなバナーサイズのネイティブバナーカスタムビューが含まれています。次の手順に従って、リソースバンドルをプロジェクトに追加します：

1. プロジェクトのターゲットをクリックします。
2. 「 Build Phases 」タブに移動します。
3. 「 Copy Bundle Resources 」を開き、「 + 」アイコンをクリックします。
4. ISAdMobResources.bundle を選択し、「 Add 」をクリックします。

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