i-mobile とメディエーションを統合する

このガイドでは、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 アカウントに登録またはログインします。

[サイト/アプリ管理] タブと、アプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。

フォームに入力し、[新規登録] ボタンをクリックします。

新しい広告スポットを作成するには、[サイト/アプリ管理] タブでアプリを選択します。

[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。

create_ad_spot

次に、フォームに広告スポット名（Ad Spot name）、広告スポットサイズ（Ad Spot size）などの詳細情報を入力します。[新規登録] ボタンをクリックします。

new_ad_spot_form

新しい広告枠が作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

ad_spot_list

パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後でアド マネージャー UI でメディエーション用に i-mobile を構成する際に必要になります。

ステップ 2: アド マネージャーの管理画面で i-mobile デマンドを設定する

広告ユニットのメディエーション設定を構成する

アド マネージャー アカウントにログインします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。

収益グループの一意の名前を入力し、ステータスを [有効] に設定し、広告フォーマットを選択し、広告枠タイプを [モバイルアプリ] に設定します。[ターゲティング > 広告枠] セクションで、メディエーションを追加する広告ユニットを [広告枠] と [モバイルアプリ] で選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

i-mobile の収益パートナーをすでにご利用の場合は、そのパートナーを選択できます。そうでない場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] として [i-mobile] を選択し、一意の名前を入力して、[メディエーション] を有効にします。

[データの自動収集] をオンにして、ログイン名と API パスワードを入力します。

[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [iOS]、[ステータス] として [有効] を選択します。前のセクションで取得したパブリッシャー ID、メディア ID、スポット ID を入力します。次に、[デフォルト CPM] の値を入力します。

完了したら、ページの下部にある [保存] をクリックします。

ステップ 3: i-mobile SDK とアダプタをインポートする

プロジェクトの 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: 実装をテストする

テスト広告を有効にする

アド マネージャーでテストデバイスを登録してください。 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 アド マネージャーの管理画面で設定された 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。