このガイドでは、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 UI で設定をセットアップする
[サイト / アプリ管理(サイト / アプリケーション管理)] タブとアプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。
フォームに入力し、[新規登録] ボタンをクリックします。
新しい広告スポットを作成するには、[サイト / アプリ管理] タブでアプリを選択します。
[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。
次に、フォームに広告スポット名(Ad Spot name)、広告スポットサイズ(Ad Spot size)などの詳細情報を入力します。[新規登録] ボタンをクリックします。
新しい広告スポットを使用できるようになりました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。
パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後で AdMob 管理画面でメディエーション用に i-mobile を構成するときに必要になります。
ステップ 2: Ad Manager UI で i-mobile デマンドを設定する
ステップ 3: i-mobile SDK とアダプタをインポートする
CocoaPods を使用する(推奨)
プロジェクトの Podfile に次の行を追加します。
pod 'GoogleMobileAdsMediationIMobile'
コマンドラインから次のコマンドを実行します。
pod install --repo-update
手動による統合
- i-mobile SDK の最新バージョンをダウンロードし、プロジェクトで
ImobileSdkAds.framework
をリンクします。 - 変更履歴のダウンロード リンクから、プロジェクトの
IMobileAdapter.framework
から最新バージョンの i-mobile アダプタをダウンロードします。
ステップ 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 | UI で設定した Ad Manager i-mobile サーバー パラメータがないか、無効です。 |
102 | リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。 |
103 | i-mobile で広告を表示できませんでした。 |
104 | i-mobile から空のネイティブ広告配列が返されました。 |
105 | i-mobile でネイティブ広告アセットをダウンロードできませんでした。 |
106 | i-mobile では、同じ Spot ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
i-mobile iOS メディエーション アダプターの変更履歴
バージョン 2.3.4.1
- コンポーネントが 4 つではなく 3 つになるように
CFBundleShortVersionString
を更新しました。
構築およびテストに使用したバージョン:
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- 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 Kubernetes Engine
- 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。