このガイドでは、Google Mobile Ads SDK でメディエーションを使用して i-mobile の広告を読み込んで表示する方法を説明します。ウォーターフォールの統合についても説明します。また、広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを iOS アプリに統合する方法についても取り上げます。
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語の同等の単語が括弧で囲まれて翻訳されています。
サポートされている統合と広告フォーマット
i-mobile 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | |
| ウォーターフォール | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| ネイティブ | |
要件
- iOS のデプロイ対象のバージョンが 12.0 以降であること
Google Mobile Ads SDK のバージョンが最新であること
メディエーションのスタートガイドの手順を完了していること
ステップ 1: i-mobile の管理画面で構成を設定する
[サイト／アプリ管理] タブとアプリのプラットフォームのボタンをクリックして、i-mobile ダッシュボードにアプリを追加します。
フォームに記入し、[新規登録] ボタンをクリックします。
新しい広告枠を作成するには、[サイト/アプリ管理] タブでアプリを選択します。
[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。
次に、広告スポット名、広告スポット サイズなどの詳細を入力してフォームに記入します。[新規登録] ボタンをクリックします。
新しい広告枠が作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。
パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後でアド マネージャー UI でメディエーション用に i-mobile を設定する際に必要になります。
app-ads.txt を更新する
Authorized Sellers for Apps app-ads.txt は、承認されたチャネルでのみアプリ広告枠を販売できるようにする IAB Tech Lab が推進しているイニシアチブです。広告収益の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。
i-mobile に app-ads.txt を実装するには、よくある質問をご覧ください。
ステップ 2: アド マネージャーの管理画面で i-mobile のデマンドを設定する
広告ユニットのメディエーション設定を構成する
アド マネージャー アカウントにログインします。
[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。
収益グループの固有の名前を入力し、[ステータス] を [有効] に設定します。広告フォーマットを選択し、[広告枠タイプ] を [モバイルアプリ] に設定します。 [ターゲティング > 広告枠] セクションで、メディエーションを追加する [広告枠] と [モバイルアプリ] の広告ユニットを選択します。
次に、[収益パートナーを追加] ボタンをクリックします。
i-mobile の収益パートナーをすでにお持ちの場合は、それを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。
[広告ネットワーク] で [i-mobile] を選択し、一意の名前を入力して、[メディエーション] を有効にします。
[Automatic data collection] をオンにして、[Login name] と [API Password] を入力します。
[収益パートナー] を選択したら、[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [iOS]、[ステータス] で [有効] を選択します。前のセクションで取得したパブリッシャー ID、メディア ID、スポット ID を入力します。次に、[デフォルト CPM] の値を入力します。
完了したら、ページの下部にある [保存] をクリックします。
ステップ 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 のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを登録してください。i-mobile はテスト用のスポット ID、メディア 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 | アド マネージャー UI で設定された i-mobile サーバー パラメータがないか、無効です。 |
| 102 | リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致していません。 |
| 103 | i-mobile が広告を表示できませんでした。 |
| 104 | i-mobile が空のネイティブ広告配列を返しました。 |
| 105 | i-mobile でネイティブ広告のアセットをダウンロードできませんでした。 |
| 106 | i-mobile では、同じスポット ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
i-mobile iOS メディエーション アダプタの変更履歴
次のバージョン
- -fobjc-arc と -fstack-protector-all を有効にします。
バージョン 2.3.4.2
- Google Mobile Ads SDK バージョン 12.0.0 以降が必要になりました。
構築およびテストに使用したバージョン:
- Google Mobile Ads SDK バージョン 12.0.0。
- i-mobile SDK バージョン 2.3.4。
バージョン 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。