このページは Cloud Translation API によって翻訳されました。

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

パブリッシャー 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 を入力します。[完了] をクリックします。

注: 広告ソースの最適化では、メディエーションネットワークの eCPM を正確に計算するのに十分なデータが収集されるまでに数日かかります。最適化が完了するまでの間、広告ソースの最適化ステータスは PENDING になります。このため、ネットワークの eCPM 値を手動で設定する必要があります。eCPM を計算できるようになると、広告ソースが自動的に eCPM の更新を開始します。

ステップ 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 アダプタによって常に含まれるアセット
広告見出し
画像
本文
アプリのアイコン	¹
行動を促すフレーズ
評価
ストア
価格

¹ ネイティブ広告の場合、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 を使用して複数のインタースティシャル広告をリクエストすることはできません。