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

このガイドでは、Google Mobile Ads SDK でメディエーションを使用して i-mobile の広告を読み込んで表示する方法を説明します。ウォーターフォール統合についても説明します。また、広告ユニットのメディエーション設定に i-mobile を追加する方法と、i-mobile SDK とアダプタを Flutter アプリに統合する方法についても取り上げます。

i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語の同等の単語が括弧で囲まれて翻訳されています。

サポートされている統合と広告フォーマット

i-mobile 用のアド マネージャー メディエーション アダプタには、次の機能があります。

統合
入札単価
ウォーターフォール
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

  • Google Mobile Ads SDK のバージョンが最新であること
  • Flutter 3.7.0 以降
  • Android にデプロイするには
    • Android API レベル 23 以上
  • iOS にデプロイする場合
    • iOS のデプロイ対象のバージョンが 12.0 以降であること
  • Google Mobile Ads SDK で構成された動作中の Flutter プロジェクト。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドの手順を完了していること

ステップ 1: i-mobile の管理画面で構成を設定する

i-mobile アカウントに登録するか、ログインします。

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

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 のデマンドを設定する

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

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS のガイドの手順 2 をご覧ください。

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

pub.dev を介した統合

パッケージの pubspec.yaml ファイルに、i-mobile SDK とアダプタの最新バージョンを含む次の依存関係を追加します。

dependencies:
  gma_mediation_imobile: ^

手動による統合

i-mobile 向けの Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（およびそのコンテンツ）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

ステップ 4: 追加のコードが必要

Android

i-mobile の統合に、追加のコードは必要ありません。

iOS

SKAdNetwork の統合

i-mobile のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

ステップ 5: 実装をテストする

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録してください。i-mobile はテスト用のスポット ID、メディア ID、パブリッシャー ID を提供しています。こちらで確認できます。

テスト広告を確認する

i-mobile からテスト広告を受信していることを確認するには、i-mobile（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが i-mobile から広告を受信できなかった場合は、次のクラスの ResponseInfo を使用して、広告レスポンスから根本原因のエラーを確認できます。

Android

形式 クラス名
バナー com.google.ads.mediation.imobile.IMobileAdapter
インタースティシャル com.google.ads.mediation.imobile.IMobileAdapter
ネイティブ com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

形式 クラス名
バナー IMobileAdapter
インタースティシャル IMobileAdapter
ネイティブ GADMediationAdapterIMobile

広告の読み込みに失敗した場合に i-mobile アダプタがスローするコードとメッセージは次のとおりです。

Android

エラーコード 理由
0-99 i-mobile SDK がエラーを返しました。詳しくは、コードをご覧ください。
101 i-mobile では、広告を読み込むために Activity コンテキストが必要です。
102 アド マネージャー UI で設定された i-mobile サーバー パラメータが存在しないか、無効です。
103 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致していません。
104 i-mobile のネイティブ広告読み込み成功コールバックが空のネイティブ広告リストを返しました。

iOS

エラーコード 理由
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 Flutter メディエーション アダプタの変更履歴

バージョン 1.0.1

バージョン 1.0.0