このガイドでは、Google Mobile Ads SDK を使用して AdMob メディエーションで i-mobile の広告を読み込んで表示する方法について説明します。ウォーターフォール統合についても説明します。広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを iOS アプリに統合する方法について説明します。
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されます。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは翻訳され、英語の同義語が括弧内に示されています。
サポートされている統合と広告フォーマット
i-mobile のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 単価設定 | |
| 滝 | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| ネイティブ | |
要件
- iOS デプロイ ターゲットが 12.0 以降
最新の Google Mobile Ads SDK
メディエーションのスタートガイドを完了していること
ステップ 1: i-mobile UI で設定を行う
[サイト/アプリ管理] タブと、アプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。
フォームに入力し、[新規登録] ボタンをクリックします。
新しい広告スポットを作成するには、[サイト/アプリ管理] タブでアプリを選択します。
[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。
次に、フォームに広告スポット名（Ad Spot name）、広告スポットサイズ（Ad Spot size）などの詳細情報を入力します。[新規登録] ボタンをクリックします。
新しい広告枠が作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。
パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後で AdMob 管理画面でメディエーション用に i-mobile を構成するときに必要になります。
ステップ 2: AdMob 管理画面で i-mobile デマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に i-mobile を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを変更する場合は、そのメディエーション グループの名前をクリックして編集し、i-mobile を広告ソースとして追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
選択した広告ユニットが広告ユニットカードに表示されます。
i-mobile を広告ソースとして追加する
[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[i-mobile] を選択します。
[i-mobile] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したログイン名と API パスワードを入力して、i-mobile の広告ソースの最適化を設定します。次に、i-mobile の eCPM 値を入力し、[続行] をクリックします。
i-mobile のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したパブリッシャー ID、メディア ID、スポット ID を入力します。[完了] をクリックします。
ステップ 3: i-mobile SDK とアダプタをインポートする
CocoaPods を使用する（推奨）
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationIMobile'
コマンドラインから次のコマンドを実行します。
pod install --repo-update手動による統合
- i-mobile SDK の最新バージョンをダウンロードし、プロジェクトで
ImobileSdkAds.frameworkをリンクします。 - 変更ログのダウンロード リンクから i-mobile アダプターの最新バージョンをダウンロードし、プロジェクトの
IMobileAdapter.frameworkをリンクします。
ステップ 4: 必要なコードを追加する
SKAdNetwork の統合
i-mobile のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録してください。 i-mobile では、テスト用のSpot ID、Media ID、Publisher ID を提供しています。テスト用 ID は こちらで確認できます。
テスト広告を確認する
i-mobile からテスト広告が配信されていることを確認するには、広告インスペクタで i-mobile（ウォーターフォール）広告ソースを使用して単一の広告ソースをテストします。
省略可能なステップ
ネイティブ広告を使用する
広告のレンダリング
i-mobile アダプタは、GADNativeAd に次のネイティブ広告のフィールドについてを入力します。
| フィールド | i-mobile アダプタによって常に含まれるアセット |
|---|---|
| 広告見出し | |
| 画像 | |
| 本文 | |
| アプリのアイコン | 1 |
| 行動を促すフレーズ | |
| 評価 | |
| ストア | |
| 価格 |
1 ネイティブ広告の場合、i-mobile SDK はアプリアイコン アセットを提供しません。代わりに、i-mobile アダプタはアプリアイコンに透明な画像を配置します。
エラーコード
アダプターが i-mobile から広告を受信できない場合、パブリッシャーは次のクラスの GADResponseInfo.adNetworkInfoArray を使用して、広告レスポンスから根本的なエラーを確認できます。
| 形式 | クラス名 |
|---|---|
| バナー | IMobileAdapter |
| インタースティシャル | IMobileAdapter |
| ネイティブ | GADMediationAdapterIMobile |
広告の読み込みに失敗したときに i-mobile アダプターからスローされるコードとそれに付随するメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| 0-10 | i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。 |
| 101 | AdMob 管理画面で設定された i-mobile サーバー パラメータが存在しないか、無効です。 |
| 102 | リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。 |
| 103 | i-mobile で広告を表示できませんでした。 |
| 104 | i-mobile から空のネイティブ広告配列が返されました。 |
| 105 | i-mobile でネイティブ広告アセットをダウンロードできませんでした。 |
| 106 | i-mobile では、同じスポット ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
i-mobile iOS メディエーション アダプターの変更履歴
バージョン 2.3.4.1
CFBundleShortVersionStringを更新し、4 つではなく 3 つのコンポーネントを使用するようにしました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.10.0。
- i-mobile SDK バージョン 2.3.4。
バージョン 2.3.4.0
- i-mobile SDK 2.3.4 との互換性を確認しました。
adSDKVersionで i-mobile SDK バージョンを返すサポートを追加しました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.2.0。
- i-mobile SDK バージョン 2.3.4。
バージョン 2.3.3.0
- i-mobile SDK 2.3.3 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.1.0。
- i-mobile SDK バージョン 2.3.3。
バージョン 2.3.2.1
- バナー、インタースティシャル、ネイティブ広告の実装から、非推奨の
willBackgroundApplicationデリゲート メソッドを削除しました。 - iOS の最小バージョンが 12.0 に引き上げられました。
- Google Mobile Ads SDK バージョン 11.0 以降が必要になりました。
IMobileAdapter.xcframework内のフレームワークにInfo.plistを含めました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 11.0.1。
- i-mobile SDK バージョン 2.3.2。
バージョン 2.3.2.0
- i-mobile SDK 2.3.2 との互換性を確認しました。
armv7アーキテクチャのサポートを削除しました。- iOS の最小バージョンが 11.0 に引き上げられました。
- Google Mobile Ads SDK バージョン 10.4.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.4.0。
- i-mobile SDK バージョン 2.3.2。
バージョン 2.3.1.0
- i-mobile SDK 2.3.1 との互換性が確認されました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.3.0。
- i-mobile SDK バージョン 2.3.1。
バージョン 2.3.0.1
- Google Mobile Ads SDK バージョン 10.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 10.0.0。
- i-mobile SDK バージョン 2.3.0。
バージョン 2.3.0.0
- i-mobile SDK 2.3.0 との互換性が確認されました。
- Google Mobile Ads SDK バージョン 9.8.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.13.0。
- i-mobile SDK バージョン 2.3.0。
バージョン 2.2.0.1
- Google Mobile Ads SDK バージョン 9.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 9.0.0。
- i-mobile SDK バージョン 2.2.0。
バージョン 2.2.0.0
- i-mobile SDK バージョン 2.2.0 との互換性が確認されました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 8.13.0。
- i-mobile SDK バージョン 2.2.0。
バージョン 2.1.0.1
- Google Mobile Ads SDK バージョン 8.0.0 以降への依存関係を緩和。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 8.4.0。
- i-mobile SDK バージョン 2.1.0。
バージョン 2.1.0.0
- i-mobile SDK バージョン 2.1.0 との互換性を確認しました。
- Google Mobile Ads SDK バージョン 8.1.0 以降が必要になりました。
.xcframework形式を使用するようにアダプターを更新しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 8.1.0。
- i-mobile SDK バージョン 2.1.0。
バージョン 2.0.33.1
- 標準化されたアダプタのエラーコードとメッセージを追加しました。
- アダプタで、同じ i-mobile スポット ID を使用する複数のインタースティシャル広告のリクエストが制限されるようになりました。
- ネイティブ広告がタップされたときに、アダプタが
-nativeAdWillLeaveApplication:コールバックを転送するようになりました。 - Google Mobile Ads SDK バージョン 7.68.0 以降が必要になりました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 7.68.0。
- i-mobile SDK バージョン 2.0.33。
バージョン 2.0.33.0
- i-mobile SDK バージョン 2.0.33 との互換性を確認しました。
- Google Mobile Ads SDK バージョン 7.65.0 以降が必要になりました。
- iOS の最小バージョンが 9.0 に引き上げられました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 7.65.0。
- i-mobile SDK バージョン 2.0.33。
バージョン 2.0.32.0
- i-mobile SDK バージョン 2.0.32 との互換性を確認しました。
- Google Mobile Ads SDK バージョン 7.60.0 以降が必要になりました。
- アダプティブ バナーのリクエスト サイズに合わせて 320x50 と 320x100 の広告をスケーリングするサポートを追加しました。
- i386 アーキテクチャのサポートを削除しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 7.60.0。
- i-mobile SDK バージョン 2.0.32。
バージョン 2.0.31.0
- i-mobile SDK バージョン 2.0.31 との互換性を確認しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 7.53.1。
- i-mobile SDK バージョン 2.0.31。
バージョン 2.0.29.0
- 初回リリース
- バナー広告、インタースティシャル広告、ネイティブ広告のサポートを追加しました。
構築およびテストに使用したバージョン
- Google Mobile Ads SDK バージョン 7.52.0。
- i-mobile SDK バージョン 2.0.29。